@primer-io/primer-js 1.0.8 → 1.1.0

package/dist/primer-loader.d.ts

@@ -1,41 +1,7 @@
+import { ContextProvider } from '@lit/context';
 import { Task, initialState } from '@lit/task';
 import { CSSResult, LitElement, PropertyValues, ReactiveController, ReactiveControllerHost, SVGTemplateResult, TemplateResult, nothing } from 'lit';
 
-export type CardNetwork = {
-	displayName: string;
-	network: string;
-};
-export type CardNetworksContextType = {
-	detectedCardNetwork: CardNetwork | null;
-	selectableCardNetworks: CardNetwork[];
-	isLoading: boolean;
-} | null;
-/**
- * SDK state representation
- */
-export type SdkState = {
-	isSuccessful: boolean;
-	isProcessing: boolean;
-	/**
-	 * SDK/component initialization errors.
-	 * This represents errors from the Primer JS layer itself (e.g., configuration errors,
-	 * component initialization failures), not payment processing errors.
-	 */
-	primerJsError: Error | null;
-	isLoading: boolean;
-	/**
-	 * Payment processing failure information.
-	 * Contains structured error details from failed payment attempts.
-	 * Includes error code, message, diagnostics ID, and additional metadata.
-	 */
-	paymentFailure: {
-		code: string;
-		message: string;
-		diagnosticsId?: string | null;
-		data?: Record<string, unknown>;
-	} | null;
-};
-export type SdkStateContextType = SdkState | null;
 declare const PaymentInstrumentType: {
 	readonly WORLDPAY_IDEAL: "WORLDPAY_IDEAL";
 	readonly AUTOMATED_CLEARING_HOUSE: "AUTOMATED_CLEARING_HOUSE";
@@ -604,6 +570,7 @@ declare enum HeadlessManagerType {
 	NATIVE = "NATIVE",
 	REDIRECT = "REDIRECT",
 	KLARNA = "KLARNA",
+	ADYEN_KLARNA = "ADYEN_KLARNA",
 	ACH = "ACH",
 	BLIK = "BLIK"
 }
@@ -1082,6 +1049,33 @@ export interface IBlikPaymentMethodManager {
 		blikCode: string;
 	}): Promise<void>;
 }
+/**
+ * Adyen Klarna payment option
+ */
+export interface AdyenKlarnaPaymentOption {
+	id: string;
+	label: string;
+}
+/**
+ * Adyen Klarna Payment Method Manager
+ *
+ * Unlike direct Klarna integration, Adyen Klarna uses a redirect flow
+ * with payment type selection (Pay Now, Pay Later, etc.)
+ */
+export interface IAdyenKlarnaPaymentMethodManager {
+	/**
+	 * Get available payment options
+	 */
+	getPaymentOptions(): AdyenKlarnaPaymentOption[];
+	/**
+	 * Select a payment option
+	 */
+	selectOption(optionId: string): void;
+	/**
+	 * Start the payment flow with the selected option
+	 */
+	start(): Promise<void>;
+}
 export interface HeadlessVaultManager {
 	fetchVaultedPaymentMethods(): Promise<VaultedPaymentMethod[]>;
 	deleteVaultedPaymentMethod(id: string): Promise<void>;
@@ -1163,7 +1157,10 @@ export interface KlarnaPaymentMethodManagerOptions {
 export interface AchPaymentMethodManagerOptions {
 	onCollectBankAccountDetailsComplete?: () => void;
 }
-export type PaymentMethodManagerOptions = CardPaymentMethodManagerOptions | KlarnaPaymentMethodManagerOptions | AchPaymentMethodManagerOptions;
+export interface AdyenKlarnaPaymentMethodManagerOptions {
+	onPaymentOptionsChange?: (options: AdyenKlarnaPaymentOption[]) => void;
+}
+export type PaymentMethodManagerOptions = CardPaymentMethodManagerOptions | KlarnaPaymentMethodManagerOptions | AdyenKlarnaPaymentMethodManagerOptions | AchPaymentMethodManagerOptions;
 export interface CheckoutStyle {
 	fontFaces?: Array<{
 		fontFamily?: string;
@@ -1230,6 +1227,7 @@ export interface PrimerHeadlessCheckout {
 	createPaymentMethodManager(type: "PAYPAL" | "GOOGLE_PAY" | "APPLE_PAY", options?: PaymentMethodManagerOptions): Promise<INativePaymentMethodManager | null>;
 	createPaymentMethodManager(type: "STRIPE_ACH", options?: AchPaymentMethodManagerOptions): Promise<IAchPaymentMethodManager | null>;
 	createPaymentMethodManager(type: "KLARNA", options?: PaymentMethodManagerOptions): Promise<IKlarnaPaymentMethodManager | null>;
+	createPaymentMethodManager(type: "ADYEN_KLARNA", options?: AdyenKlarnaPaymentMethodManagerOptions): Promise<IAdyenKlarnaPaymentMethodManager | null>;
 	createPaymentMethodManager(type: PaymentMethodType, options?: PaymentMethodManagerOptions): Promise<IRedirectPaymentMethodManager | null>;
 	createVaultManager(): HeadlessVaultManager;
 	getSDKUtilities(): HeadlessSDKUtilities;
@@ -1451,6 +1449,38 @@ export interface PrimerCheckoutOptions {
 	 * @default window.location.hostname
 	 */
 	merchantDomain?: string;
+	/**
+	 * Configuration for redirect-based payment methods.
+	 *
+	 * Controls the return URL behavior for payment methods that require a redirect
+	 * to an external page (e.g. PayPal, Klarna, and most APMs), whether to force
+	 * a full-page redirect instead of opening the flow in a popup where supported,
+	 * and how to handle users closing the redirect popup.
+	 *
+	 * @example
+	 * ```typescript
+	 * redirect: {
+	 *   returnUrl: 'https://merchant.example.com/checkout/return',
+	 *   forceRedirect: true,
+	 * }
+	 * ```
+	 */
+	redirect?: {
+		/**
+		 * URL the payment method redirects back to after the customer completes
+		 * (or cancels) the flow on the external page.
+		 *
+		 * If omitted, the SDK uses the current page URL.
+		 */
+		returnUrl?: string;
+		/**
+		 * Whether to force a full-page redirect for payment methods that would
+		 * otherwise open in a popup.
+		 *
+		 * @default false
+		 */
+		forceRedirect?: boolean;
+	};
 	/**
 	 * Configuration for card payment method options.
 	 * Controls the display and validation of card form fields.
@@ -1640,6 +1670,11 @@ export interface PrimerCheckoutOptions {
 	 * ```
 	 */
 	klarna?: KlarnaOptions;
+	adyenKlarna?: {
+		buttonOptions?: {
+			text?: string;
+		};
+	};
 	/**
 	 * Configuration for payment method vaulting (save for later use).
 	 *
@@ -1861,35 +1896,10 @@ export interface PrimerCheckoutOptions {
 	 */
 	enabledPaymentMethods?: typeof PaymentMethodType.PAYMENT_CARD | typeof PaymentMethodType.PAYPAL | (typeof PaymentMethodType.ADYEN_BLIK)[];
 }
-export type InitializedManager = {
-	type: typeof PaymentMethodType.STRIPE_ACH;
-	manager: IAchPaymentMethodManager;
-} | {
-	type: typeof PaymentMethodType.PAYMENT_CARD;
-	manager: ICardPaymentMethodManager;
-} | {
-	type: typeof PaymentMethodType.KLARNA;
-	manager: IKlarnaPaymentMethodManager;
-} | {
-	type: RedirectPaymentMethodTypes;
-	manager: IRedirectPaymentMethodManager;
-} | {
-	type: typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY;
-	manager: INativePaymentMethodManager;
-} | {
-	type: typeof PaymentMethodType.ADYEN_BLIK;
-	manager: IBlikPaymentMethodManager;
-};
 /**
  * Native payment method types (sent with managerType: 'NATIVE' from server)
  */
 export type NativePaymentMethodTypes = typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY | typeof PaymentMethodType.ADYEN_BLIK;
-export type ManagerByType<T extends PaymentMethodType> = Extract<InitializedManager, {
-	type: T;
-}>;
-export interface InitializedManagersMap extends Map<PaymentMethodType, InitializedManager> {
-	get<T extends PaymentMethodType>(key: T): ManagerByType<T> | undefined;
-}
 /**
  * Payment methods that use the REDIRECT manager type.
  *
@@ -1897,13 +1907,13 @@ export interface InitializedManagersMap extends Map<PaymentMethodType, Initializ
  * - STRIPE_ACH: Uses ACH manager
  * - PAYMENT_CARD: Uses CARD manager
  * - KLARNA: Uses KLARNA manager
+ * - ADYEN_KLARNA: Uses ADYEN_KLARNA manager
  * - PAYPAL, GOOGLE_PAY, APPLE_PAY: Use NATIVE manager
  * - ADYEN_BLIK: Uses BLIK manager
  *
  * All other payment methods use the REDIRECT manager by default.
  */
-export type RedirectPaymentMethodTypes = Exclude<PaymentMethodType, typeof PaymentMethodType.STRIPE_ACH | typeof PaymentMethodType.PAYMENT_CARD | typeof PaymentMethodType.KLARNA | typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY | typeof PaymentMethodType.ADYEN_BLIK>;
-export type DynamicPaymentMethodTypes = typeof PaymentMethodType.STRIPE_ACH;
+export type RedirectPaymentMethodTypes = Exclude<PaymentMethodType, typeof PaymentMethodType.STRIPE_ACH | typeof PaymentMethodType.PAYMENT_CARD | typeof PaymentMethodType.KLARNA | typeof PaymentMethodType.ADYEN_KLARNA | typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY | typeof PaymentMethodType.ADYEN_BLIK>;
 /**
  * Represents a payment method that uses the REDIRECT manager.
  *
@@ -1912,51 +1922,43 @@ export type DynamicPaymentMethodTypes = typeof PaymentMethodType.STRIPE_ACH;
  * use custom inline UI components while still being classified as REDIRECT type
  * due to their flow characteristics (status polling, external authorization).
  */
-export type RedirectPaymentMethod = {
+export interface RedirectPaymentMethod {
 	type: RedirectPaymentMethodTypes;
 	managerType: HeadlessManagerType.REDIRECT;
-};
+	manager: IRedirectPaymentMethodManager;
+}
+export interface NativePaymentMethod {
+	type: typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY;
+	managerType: HeadlessManagerType.NATIVE;
+	manager: INativePaymentMethodManager;
+}
+export interface BlikPaymentMethod {
+	type: typeof PaymentMethodType.ADYEN_BLIK;
+	managerType: HeadlessManagerType.BLIK;
+	manager: IBlikPaymentMethodManager;
+}
 export type InitializedPaymentMethod = {
 	type: typeof PaymentMethodType.STRIPE_ACH;
 	managerType: HeadlessManagerType.ACH;
+	manager: IAchPaymentMethodManager;
 } | {
 	type: typeof PaymentMethodType.PAYMENT_CARD;
 	managerType: HeadlessManagerType.CARD;
+	manager: ICardPaymentMethodManager;
 } | {
 	type: typeof PaymentMethodType.KLARNA;
 	managerType: HeadlessManagerType.KLARNA;
+	manager: IKlarnaPaymentMethodManager;
 } | {
-	type: typeof PaymentMethodType.PAYPAL;
-	managerType: HeadlessManagerType.NATIVE;
-} | {
-	type: typeof PaymentMethodType.GOOGLE_PAY;
-	managerType: HeadlessManagerType.NATIVE;
-} | {
-	type: typeof PaymentMethodType.APPLE_PAY;
-	managerType: HeadlessManagerType.NATIVE;
-} | {
-	type: typeof PaymentMethodType.ADYEN_BLIK;
-	managerType: HeadlessManagerType.BLIK;
-} | RedirectPaymentMethod;
-export type PaymentMethodByType<T extends PaymentMethodType> = Extract<InitializedPaymentMethod, {
-	type: T;
-}>;
-export interface InitializedPaymentMethodMap extends Map<PaymentMethodType, InitializedPaymentMethod> {
-	get<T extends PaymentMethodType>(key: T): PaymentMethodByType<T> | undefined;
-}
+	type: typeof PaymentMethodType.ADYEN_KLARNA;
+	managerType: HeadlessManagerType.ADYEN_KLARNA;
+	manager: IAdyenKlarnaPaymentMethodManager;
+} | BlikPaymentMethod | RedirectPaymentMethod | NativePaymentMethod;
 export interface AssetsConfig {
 	backgroundColor: string;
 	name: string;
 	iconUrl: string;
 }
-export type AnalyticsContextType = AnalyticsUtils | null;
-export type EventsContextType = PrimerEventsController | null;
-export type HeadlessUtilsContextType = HeadlessSDKUtilities | null;
-export type ConfigurationContextType = ClientConfiguration | null;
-export type KlarnaCategoriesContextType = {
-	categories: KlarnaPaymentMethodCategory[];
-	isLoading: boolean;
-};
 /**
  * Options for initializing the Vault Manager
  */
@@ -1995,142 +1997,88 @@ export interface VaultManagerItemState {
 	selectedVaultedPaymentMethod: VaultedPaymentMethod | null;
 	setSelectedVaultedPaymentMethod: (paymentMethod: VaultedPaymentMethod | null) => void;
 }
+export type KlarnaCategoriesContextType = {
+	categories: KlarnaPaymentMethodCategory[];
+	isLoading: boolean;
+};
+export type AdyenKlarnaOptionsContextType = {
+	options: AdyenKlarnaPaymentOption[];
+	isLoading: boolean;
+};
+export type CardNetwork = {
+	displayName: string;
+	network: string;
+};
+export type CardNetworksContextType = {
+	detectedCardNetwork: CardNetwork | null;
+	selectableCardNetworks: CardNetwork[];
+	isLoading: boolean;
+} | null;
 /**
- * Context for core vault manager functionality
- * Contains properties that don't change frequently and relate to vault functionality
- */
-export type VaultManagerContextType = VaultManagerState | null;
-/**
- * Context for vault manager CVV-specific state
- * Contains properties specifically related to CVV input functionality
- * Further separated to minimize re-renders related to frequently changing CVV input state
+ * SDK state representation
  */
-export type VaultItemContextType = VaultManagerItemState | null;
-declare class SDKContextController implements ReactiveController {
-	host: PrimerCheckoutType;
-	private sdkStateProvider;
-	private paymentMethodsProvider;
-	private paymentManagerProvider;
-	private cardNetworksContext;
-	private vaultManagerProvider;
-	private vaultManagerCvvProvider;
-	private clientOptionsContext;
-	private headlessUtilsProvider;
-	private configurationProvider;
-	private klarnaCategoriesProvider;
-	private computedStylesProvider;
-	private analyticsProvider;
-	private eventsProvider;
-	constructor(host: PrimerCheckoutType);
-	hostConnected(): void;
+export type SdkState = {
+	isSuccessful: boolean;
+	isProcessing: boolean;
 	/**
-	 * Updates the SDK state context.
-	 * @param value The new SDK state.
+	 * SDK/component initialization errors.
+	 * This represents errors from the Primer JS layer itself (e.g., configuration errors,
+	 * component initialization failures), not payment processing errors.
 	 */
-	setSdkState(value: SdkStateContextType): void;
+	primerJsError: Error | null;
+	isLoading: boolean;
 	/**
-	 * Updates the payment methods context.
-	 * @param value The new payment methods data.
+	 * Payment processing failure information.
+	 * Contains structured error details from failed payment attempts.
+	 * Includes error code, message, diagnostics ID, and additional metadata.
 	 */
-	setPaymentMethods(value: InitializedPaymentMethod[]): void;
+	paymentFailure: {
+		code: string;
+		message: string;
+		diagnosticsId?: string | null;
+		data?: Record<string, unknown>;
+	} | null;
+};
+export type ContextType = {
+	analytics?: AnalyticsUtils;
+	configuration?: ClientConfiguration;
+	computedStyles?: CSSStyleDeclaration | null;
+	klarnaCategories: KlarnaCategoriesContextType;
+	adyenKlarnaOptions?: AdyenKlarnaOptionsContextType;
+	cardNetworks?: CardNetworksContextType;
+	events?: PrimerEventsController;
+	clientOptions?: PrimerCheckoutOptions;
+	paymentMethods: InitializedPaymentMethod[];
+	headlessUtils?: HeadlessSDKUtilities;
+	sdkState: SdkState;
+	vaultManager?: VaultManagerState;
+	vaultItem?: VaultManagerItemState;
+};
+declare class SDKContextController implements ReactiveController {
+	host: PrimerCheckoutType;
+	contextProvider: ContextProvider<{
+		__context__: ContextType;
+	}>;
+	constructor(host: PrimerCheckoutType);
+	hostConnected(): void;
 	/**
-	 * Updates the payment manager context.
-	 * @param value The new payment manager mapping.
+	 * Updates the main SDK context by merging new values into the existing context.
 	 */
-	setPaymentManagers(value: InitializedManagersMap): void;
+	setContext(value: Partial<NonNullable<ContextType>>): void;
+	setSdkState(stateUpdate: Partial<SdkState>): void;
+	resetSdkState(): void;
 	setCardNetworks(value: CardNetworksContextType): void;
 	setCardNetworksLoadingFalse(): void;
-	setVaultManager(value: VaultManagerContextType): void;
+	setVaultManager(vaultManager: VaultManagerState): void;
 	setKlarnaCategories(value: KlarnaCategoriesContextType): void;
-	setClientOptions(value: PrimerCheckoutOptions | null): void;
-	setHeadlessUtils(value: HeadlessUtilsContextType): void;
-	setConfiguration(value: ConfigurationContextType): void;
-	setAnalyticsUtils(value: AnalyticsContextType): void;
-	getAnalyticsUtils(): AnalyticsContextType | undefined;
+	setAdyenKlarnaOptions(value: AdyenKlarnaOptionsContextType): void;
 	setComputedStyles(value: CSSStyleDeclaration): void;
-	setVaultManagerCvv(value: VaultItemContextType): void;
+	setVaultManagerCvv(vaultItem: VaultManagerItemState): void;
 	/**
 	 * Updates the events context.
 	 * @param value The new events controller.
 	 */
-	setEventsController(value: EventsContextType): void;
-}
-export type ReducerCallbacks<State, _Action extends {
-	type: string;
-}> = {
-	[K in keyof State]?: State[K] extends (...args: unknown[]) => unknown ? State[K] : never;
-};
-export type TypedReducer<State, Action extends {
-	type: string;
-}, Callbacks> = (state: State, action: Action, callbacks: Callbacks) => State;
-declare abstract class ReactiveStateController<Host extends ReactiveControllerHost, State, Action extends {
-	type: string;
-}, Callbacks = ReducerCallbacks<State, Action> | null> implements ReactiveController {
-	protected host: Host;
-	protected stateHandler: (state: State) => void;
-	private _dispatcher;
-	constructor(host: Host, initialState: State, reducer: TypedReducer<State, Action, Callbacks>, initialCallbacks: Callbacks, stateHandler?: (state: State) => void);
-	get currentState(): Readonly<State>;
-	protected dispatch(action: Action): void;
-	protected setCallbacks(callbacks: Partial<Callbacks>): void;
-	hostConnected(): void;
-	hostDisconnected(): void;
-}
-declare class CompositeStateController<Host extends ReactiveControllerHost> implements ReactiveController {
-	protected host: Host;
-	private _controllers;
-	constructor(host: Host);
-	addController<State, Action extends {
-		type: string;
-	}, Callbacks = ReducerCallbacks<State, Action> | null>(controller: ReactiveStateController<Host, State, Action, Callbacks>): void;
-	hostConnected(): void;
-	hostDisconnected(): void;
-}
-export type SdkStateAction = {
-	type: "SET_LOADING";
-	payload: boolean;
-} | {
-	type: "SET_PROCESSING";
-	payload: boolean;
-} | {
-	type: "SET_SUCCESS";
-	payload: boolean;
-} | {
-	type: "SET_PRIMER_JS_ERROR";
-	payload: Error | null;
-} | {
-	type: "SET_PAYMENT_FAILURE";
-	payload: {
-		code: string;
-		message: string;
-		diagnosticsId?: string | null;
-		data?: Record<string, unknown>;
-	} | null;
-} | {
-	type: "COMPLETE_PROCESSING";
-} | {
-	type: "RESET";
-};
-declare class SdkStateController extends ReactiveStateController<PrimerCheckoutType, SdkState, SdkStateAction, null> {
-	constructor(host: PrimerCheckoutType);
-	setLoading(loading: boolean): void;
-	setProcessing(processing: boolean): void;
-	setSuccess(success: boolean): void;
-	setPrimerJsError(error: Error | null): void;
-	setPaymentFailure(failure: {
-		code: string;
-		message: string;
-		diagnosticsId?: string | null;
-		data?: Record<string, unknown>;
-	} | null): void;
-	completeProcessing(): void;
-	reset(): void;
-	startLoading(): void;
-	completeLoading(): void;
-	startProcessing(): void;
-	stopProcessing(): void;
-	resetError(): void;
-	forceCompleteLoading(): void;
+	setEventsController(events?: PrimerEventsController): void;
 }
 /**
  * PrimerCheckoutType defines the interface for the primer-checkout component implementation.
@@ -2142,18 +2090,28 @@ export interface PrimerCheckoutType extends ReactiveControllerHost, LitElement {
 	clientToken: string;
 	options: PrimerCheckoutOptions;
 	sdkContextController: SDKContextController;
-	sdkStateController: SdkStateController;
 	primerEventsController: PrimerEventsController;
 	vaultManagerController: VaultManagerController;
 	primerJS?: PrimerJS;
 }
-declare class VaultManagerController extends CompositeStateController<PrimerCheckoutType> {
-	private coreController;
-	private itemController;
+declare class VaultManagerController implements ReactiveController {
+	private host;
+	private _coreState;
+	private _itemState;
 	private _vaultManager;
 	private _options;
 	private createVaultManagerFn;
 	constructor(host: PrimerCheckoutType);
+	/**
+	 * Update core state with deep-equality guard.
+	 * Only pushes to context if state actually changed.
+	 */
+	private updateCoreState;
+	/**
+	 * Update item state with deep-equality guard.
+	 * Only pushes to context if state actually changed.
+	 */
+	private updateItemState;
 	/**
 	 * Initialize the vault manager with a factory function and options
 	 * @param createVaultManagerFn - Bound function to create vault manager when needed
@@ -2166,9 +2124,7 @@ declare class VaultManagerController extends CompositeStateController<PrimerChec
 	set options(options: VaultManagerInitOptions | null);
 	get vaultManagerState(): Readonly<VaultManagerState>;
 	get vaultItemState(): Readonly<VaultManagerItemState>;
-	/**
-	 * Lifecycle method called when the host disconnects
-	 */
+	hostConnected(): void;
 	hostDisconnected(): void;
 	/**
 	 * Transform raw vault data into filtered, event-ready format.
@@ -2317,7 +2273,6 @@ export interface VaultAPI {
 export declare class PrimerJS {
 	private headlessInstance;
 	private paymentMethods;
-	private paymentManagers;
 	private vaultController;
 	/**
 	 * Vault namespace providing programmatic access to vaulted payment method operations.
@@ -2433,11 +2388,6 @@ export declare class PrimerJS {
 	 * @internal - This is only used internally by the SDK
 	 */
 	setPaymentMethods(methods: InitializedPaymentMethod[]): void;
-	/**
-	 * Set the initialized payment managers
-	 * @internal - This is only used internally by the SDK
-	 */
-	setPaymentManagers(managers: InitializedManagersMap): void;
 	/**
 	 * Internal method to set the vault controller reference.
 	 * Called during vault initialization.
@@ -2536,9 +2486,6 @@ export interface CardSubmitErrorsPayload {
 export interface CardSubmitPayload {
 	source?: string;
 }
-export interface PrimeAchErrorPayload {
-	error: Error;
-}
 export interface VaultSubmitPayload {
 	source?: string;
 }
@@ -2550,7 +2497,7 @@ export interface ShowOtherPaymentsToggledPayload {
 	expanded: boolean;
 }
 export interface PrimerEvents {
-	"primer:state-change": CustomEvent<SdkStateContextType>;
+	"primer:state-change": CustomEvent<SdkState>;
 	"primer:methods-update": CustomEvent<InitializedPaymentMethod[]>;
 	"primer:ready": CustomEvent<PrimerJS>;
 	"primer:card-network-change": CustomEvent<CardNetworksContextType>;
@@ -2563,10 +2510,6 @@ export interface PrimerEvents {
 	"primer:card-error": CustomEvent<CardSubmitErrorsPayload>;
 	"primer:dialog-open": CustomEvent;
 	"primer:dialog-close": CustomEvent;
-	"primer-ach-error": CustomEvent<PrimeAchErrorPayload>;
-	"primer-ach-bank-details-collected": CustomEvent;
-	"primer-ach-mandate-confirmed": CustomEvent;
-	"primer-ach-mandate-declined": CustomEvent;
 	"primer:payment-start": CustomEvent<{
 		paymentMethodType: PaymentMethodType;
 		abortPaymentCreation: () => void;
@@ -2609,10 +2552,9 @@ export interface PrimerEvents {
 	"primer:show-other-payments-toggle": CustomEvent<ShowOtherPaymentsTogglePayload>;
 	"primer:show-other-payments-toggled": CustomEvent<ShowOtherPaymentsToggledPayload>;
 }
-declare class PrimerEventsController implements ReactiveController {
-	host: ReactiveControllerHost & LitElement;
-	constructor(host: ReactiveControllerHost & LitElement);
-	hostConnected(): void;
+declare class PrimerEventsController {
+	host: LitElement;
+	constructor(host: LitElement);
 	/**
 	 * Dispatch a custom event using the unified naming pattern.
 	 * Ensures that every event bubbles and crosses shadow DOM boundaries.
@@ -2621,7 +2563,7 @@ declare class PrimerEventsController implements ReactiveController {
 	 * @param detail - The payload for the event.
 	 */
 	dispatchEvent<K extends keyof PrimerEvents>(type: K, detail: PrimerEvents[K]["detail"]): void;
-	dispatchSdkState(sdkState: SdkStateContextType): void;
+	dispatchSdkState(sdkState: SdkState): void;
 	dispatchPaymentMethods(paymentMethods: InitializedPaymentMethod[]): void;
 	dispatchCheckoutInitialized(checkoutInstance: PrimerJS): void;
 	dispatchCardNetworkChange(network: CardNetworksContextType): void;
@@ -2824,16 +2766,11 @@ declare const targetLocales = [
 export type LocaleCode = typeof sourceLocale | (typeof targetLocales)[number];
 declare class HeadlessSdkController implements ReactiveController {
 	host: PrimerCheckoutType;
-	private sdkInstanceTask;
-	private createPaymentMethodManager;
-	private _paymentsList;
 	private currentSdkInstance;
 	private primerJS;
 	private loadingTimeout;
 	private isDisconnected;
 	constructor(host: PrimerCheckoutType);
-	set paymentsList(value: PaymentMethodInfo[]);
-	get paymentsList(): PaymentMethodInfo[];
 	get primerJSInstance(): PrimerJS | null;
 	hostConnected(): void;
 	hostDisconnected(): void;
@@ -2851,20 +2788,7 @@ declare class HeadlessSdkController implements ReactiveController {
 		string | null,
 		PrimerCheckoutOptions | null
 	]) => Promise<PrimerHeadlessCheckout | typeof initialState>;
-	initializeLitContext(): ([sdkInstance, paymentsList]: readonly [
-		PrimerHeadlessCheckout | null | undefined,
-		PaymentMethodInfo[]
-	]) => Promise<InitializedPaymentMethodMap | typeof initialState | null>;
-	initializePaymentMethodManager(paymentMethod: PaymentMethodInfo): () => Promise<{
-		type: PaymentMethodType;
-		manager: IKlarnaPaymentMethodManager;
-	} | {
-		type: PaymentMethodType;
-		manager: ICardPaymentMethodManager;
-	} | {
-		type: PaymentMethodType;
-		manager: IRedirectPaymentMethodManager;
-	} | null>;
+	private createManager;
 	/**
 	 * Updates card networks state and dispatches events
 	 *
@@ -2872,25 +2796,6 @@ declare class HeadlessSdkController implements ReactiveController {
 	 */
 	private updateCardNetworksState;
 }
-declare global {
-	interface HTMLElementTagNameMap {
-		"primer-checkout": PrimerCheckoutComponent;
-	}
-	type PublicPrimerEvents = Omit<PrimerEvents, "primer-ach-error" | "primer-ach-bank-details-collected" | "primer-ach-mandate-confirmed" | "primer-ach-mandate-declined">;
-	interface DocumentEventMap extends PublicPrimerEvents {
-	}
-	interface HTMLElementEventMap extends PublicPrimerEvents {
-	}
-}
-declare class AchPaymentEventsController implements ReactiveController {
-	host: PrimerCheckoutComponent;
-	constructor(host: PrimerCheckoutComponent);
-	private _error;
-	private _mandateConfirmed;
-	private _mandateDeclined;
-	hostConnected(): void;
-	hostDisconnected(): void;
-}
 /**
  * PrimerCheckoutComponent implements the main checkout experience.
  * This component includes a CSS-only loader that displays before the JavaScript
@@ -2924,11 +2829,9 @@ export declare class PrimerCheckoutComponent extends LitElement implements Prime
 	locale: LocaleCode;
 	private onSlotChange;
 	sdkContextController: SDKContextController;
-	sdkStateController: SdkStateController;
 	primerEventsController: PrimerEventsController;
 	styleProcessingController: StyleProcessingController;
 	vaultManagerController: VaultManagerController;
-	achPaymentEventsController: AchPaymentEventsController;
 	headlessSdkController: HeadlessSdkController;
 	constructor();
 	connectedCallback(): void;
@@ -3480,28 +3383,6 @@ declare global {
 		"primer-error-message": ErrorMessageComponent;
 	}
 }
-declare class PortalComponent extends LitElement {
-	static styles: import("lit").CSSResult[];
-	private _id;
-	get id(): string;
-	getContainer(): HTMLDivElement;
-	/**
-	 * Proxies the events sent from the portalled content and
-	 * re-dispatches them.
-	 *
-	 * TODO: find a better way to scale to new events instead
-	 * of hardcoding them one by one here.
-	 */
-	private _setupEventListeners;
-	disconnectedCallback(): void;
-	private _handleSlotChange;
-	render(): import("lit-html").TemplateResult<1>;
-}
-declare global {
-	interface HTMLElementTagNameMap {
-		"primer-portal": PortalComponent;
-	}
-}
 declare class DialogComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	size: "flex" | "large";
@@ -3536,22 +3417,20 @@ declare global {
  */
 declare class PrimerKlarnaComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentManagers: InitializedManagersMap;
-	sdkState: SdkStateContextType;
-	headlessUtils: HeadlessUtilsContextType;
-	klarnaCategories: KlarnaCategoriesContextType | null;
+	primerContext?: ContextType;
 	disabled: boolean;
 	private selectedCategory;
 	private isExpanded;
-	private headerAriaLabel;
+	private categoryLoading;
 	private klarnaContainer;
-	private _paymentMethodManagerTask;
-	toggleExpand: () => void;
+	private _setupTask;
+	private handleExpandedChange;
+	private klarnaPaymentInProgress;
 	startKlarnaPayment(): Promise<void>;
 	renderSelectedCategory(): Promise<void>;
 	selectCategory(category: string): void;
 	updated(changedProperties: Map<string, unknown>): void;
-	renderCategorySelection(): import("lit-html").TemplateResult<1>;
+	renderCategorySelection(): import("lit-html").TemplateResult<1> | typeof nothing;
 	renderExpandedContent(): import("lit-html").TemplateResult<1>;
 	render(): import("lit-html").TemplateResult<1> | typeof nothing | undefined;
 }
@@ -3560,7 +3439,6 @@ declare global {
 		"primer-klarna": PrimerKlarnaComponent;
 	}
 }
-export type PaymentMethodsContextType = InitializedPaymentMethod[] | null;
 /**
  * Google Pay component with shadow root rendering for full-width button support.
  *
@@ -3572,10 +3450,9 @@ export type PaymentMethodsContextType = InitializedPaymentMethod[] | null;
  */
 declare class GooglePayComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: InitializedPaymentMethod | undefined;
-	paymentManagers: InitializedManagersMap;
+	paymentMethod: NativePaymentMethod | undefined;
+	primerContext?: ContextType;
 	disabled: boolean;
-	private loadManagerTask;
 	private renderButtonTask;
 	constructor();
 	attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
@@ -3598,11 +3475,10 @@ declare global {
  */
 declare class ApplePayComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: InitializedPaymentMethod | undefined;
-	paymentManagers: InitializedManagersMap;
+	paymentMethod: NativePaymentMethod | undefined;
+	primerContext?: ContextType;
 	disabled: boolean;
 	private buttonContainerRef;
-	private loadManagerTask;
 	private renderButtonTask;
 	constructor();
 	attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
@@ -3625,11 +3501,10 @@ declare global {
  */
 declare class PayPalComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: InitializedPaymentMethod | undefined;
-	paymentManagers: InitializedManagersMap;
+	paymentMethod: NativePaymentMethod | undefined;
+	primerContext?: ContextType;
 	disabled: boolean;
 	private buttonContainerRef;
-	private loadManagerTask;
 	private renderButtonTask;
 	constructor();
 	attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
@@ -3663,32 +3538,15 @@ declare global {
  */
 declare class BlikComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: InitializedPaymentMethod | undefined;
+	paymentMethod: BlikPaymentMethod | undefined;
 	disabled: boolean;
-	paymentManagers: InitializedManagersMap;
 	private currentState;
 	private blikCode;
 	private errorMessage;
 	private pollingDuration;
 	private pollingTimer;
-	/**
-	 * Manager loading task
-	 * Validates BLIK manager exists before allowing payment flow
-	 *
-	 * This Task provides reactive validation of manager availability:
-	 * - Automatically re-runs when paymentMethod or paymentManagers change
-	 * - Provides type-safe access to the BLIK manager
-	 * - Enables early error detection before user interaction
-	 *
-	 * Unlike native payment methods (Apple Pay, Google Pay, PayPal) which use a
-	 * two-task pattern (manager loading + button rendering), BLIK only needs the
-	 * manager loading task because it renders its own UI via Lit templates.
-	 */
-	private loadManagerTask;
-	/**
-	 * Handles button click to toggle between collapsed and expanded states
-	 */
-	private handleButtonClick;
+	private get isExpanded();
+	private handleExpandedChange;
 	/**
 	 * Handles collapsing the form back to button-only view
 	 * Resets form state when user clicks button to collapse
@@ -3714,10 +3572,6 @@ declare class BlikComponent extends LitElement {
 	 * Validates and submits the BLIK code
 	 */
 	private submitBlikCode;
-	/**
-	 * Renders the collapsed button state
-	 */
-	private renderCollapsed;
 	/**
 	 * Renders the expanded input state
 	 */
@@ -3745,15 +3599,50 @@ declare global {
 		"primer-blik": BlikComponent;
 	}
 }
-declare class PaymentMethodComponent extends LitElement {
+declare class AdyenKlarnaComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	type: PaymentMethodType | undefined;
+	primerContext?: ContextType;
+	/**
+	 * The payment method from context
+	 */
+	paymentMethod?: InitializedPaymentMethod;
+	/**
+	 * Whether the component is disabled
+	 */
 	disabled: boolean;
-	paymentMethods: PaymentMethodsContextType;
 	/**
-	 * Analytics utils for sending analytics events
+	 * Whether the accordion is expanded
 	 */
-	analyticsUtils: AnalyticsContextType;
+	private expanded;
+	/**
+	 * Currently selected option ID
+	 */
+	private selectedOptionId;
+	/**
+	 * Whether the payment is currently being processed
+	 */
+	private loading;
+	private paymentInProgress;
+	private get manager();
+	/**
+	 * Get the Klarna logo URL from the payment method configuration
+	 */
+	private get klarnaLogoUrl();
+	private handleOptionSelect;
+	private handleConfirm;
+	private renderPaymentOptions;
+	render(): import("lit-html").TemplateResult<1> | typeof nothing;
+}
+declare global {
+	interface HTMLElementTagNameMap {
+		"primer-adyen-klarna": AdyenKlarnaComponent;
+	}
+}
+declare class PaymentMethodComponent extends LitElement {
+	static styles: import("lit").CSSResult[];
+	type: PaymentMethodType | undefined;
+	disabled: boolean;
+	primerContext?: ContextType;
 	/**
 	 * Sends PAYMENT_METHOD_SELECTION analytics event when user clicks on payment method
 	 * @private
@@ -3771,14 +3660,12 @@ declare global {
 		"primer-payment-method": PaymentMethodComponent;
 	}
 }
-export type ClientOptionsContextType = PrimerCheckoutOptions | null;
 declare class PaymentMethodContainerComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	include?: string;
 	exclude?: string;
 	disabled: boolean;
-	paymentMethods: PaymentMethodsContextType;
-	clientOptions: ClientOptionsContextType;
+	primerContext?: ContextType;
 	private getFilteredMethods;
 	render(): import("lit-html").TemplateResult<1> | typeof nothing;
 }
@@ -3787,105 +3674,31 @@ declare global {
 		"primer-payment-method-container": PaymentMethodContainerComponent;
 	}
 }
-export type AchField = "firstName" | "lastName" | "emailAddress";
-export interface AchFormState {
-	value: string;
-	error: string;
-	pristine: boolean;
-	touched: boolean;
-	dirty: boolean;
-	valid: boolean;
-}
-export type AchFormStateMap = Record<AchField, AchFormState>;
-export type ValidationFunction = (data: StripeAchCustomerDetails) => Promise<Validation>;
-declare class AchPaymentFormControler implements ReactiveController {
-	host: AchPaymentComponent;
-	validate: ValidationFunction;
-	formState: AchFormStateMap;
-	get hasError(): {
-		firstName: boolean;
-		lastName: boolean;
-		emailAddress: boolean;
-	};
-	get formData(): StripeAchCustomerDetails;
-	constructor(host: AchPaymentComponent, validate: ValidationFunction);
-	setFieldValue(field: AchField, value: string): Promise<void>;
-	setValidation(validation: Validation, submit?: boolean): void;
-	setFieldTouched(field: AchField): void;
-	resetForm(): void;
-	private isValidFieldName;
-	hostConnected(): void;
-	hostDisconnected(): void;
-}
-declare class AchPaymentComponent extends LitElement {
-	static styles: import("lit").CSSResult[];
-	protected readonly formController: AchPaymentFormControler;
-	paymentMethod: InitializedPaymentMethod | undefined;
-	paymentManagers: InitializedManagersMap;
-	sdkState: SdkStateContextType | undefined;
-	clientOptions: ClientOptionsContextType | undefined;
-	screen: "form" | "mandate";
-	private isSubmitting;
-	private _paymentMethodManagerTask;
-	private _handleInput;
-	private _handleBlur;
-	private _handleError;
-	private _handleSubmitButtonClick;
-	private _handleCollectBankAccountDetails;
-	private _handleConfirmMandate;
-	private _handleDeclineMandate;
-	private renderForm;
-	private renderMandate;
-	render(): typeof nothing | TemplateResult | undefined;
-}
-declare global {
-	interface HTMLElementTagNameMap {
-		"primer-ach-payment": AchPaymentComponent;
-	}
-}
-declare class DynamicPaymentComponent extends LitElement {
+declare class PaymentMethodButtonComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: InitializedPaymentMethod | undefined;
-	paymentManagers: InitializedManagersMap;
-	sdkState: SdkStateContextType;
-	headlessUtils: HeadlessUtilsContextType;
-	open: boolean;
-	private _paymentMethodManagerTask;
-	private _getAssetsTask;
+	type: PaymentMethodType | undefined;
+	disabled: boolean;
+	primerContext?: ContextType;
 	/**
 	 * Based on packages/primer-sdk-web/src/payment-methods/Button.tsx
 	 * Should be replaced once we align on a better solution across all platforms.
-	 * TODO: get label from payment config
 	 */
 	private _legacyGetButtonLabel;
-	private _setupTasks;
-	start(): void;
-	renderDialog(): import("lit-html").TemplateResult<1> | typeof nothing;
+	private _setupTask;
+	private _handleClick;
 	render(): symbol | import("lit-html").TemplateResult<1> | undefined;
 }
 declare global {
 	interface HTMLElementTagNameMap {
-		"primer-dynamic-payment": DynamicPaymentComponent;
+		"primer-payment-method-button": PaymentMethodButtonComponent;
 	}
 }
 declare class RedirectPaymentComponent extends LitElement {
-	static styles: import("lit").CSSResult[];
-	paymentMethod: InitializedPaymentMethod | undefined;
+	static styles: import("lit").CSSResult;
+	paymentMethod: RedirectPaymentMethod | undefined;
 	disabled: boolean;
-	paymentManagers: InitializedManagersMap;
-	sdkState: SdkStateContextType;
-	headlessUtils: HeadlessUtilsContextType;
-	clientOptions: ClientOptionsContextType | undefined;
-	private _paymentMethodManagerTask;
-	/**
-	 * Based on packages/primer-sdk-web/src/payment-methods/Button.tsx
-	 * Should be replaced once we align on a better solution across all platforms.
-	 */
-	private _legacyGetButtonLabel;
-	private _getAssetsTask;
-	private _setupTasks;
-	startRedirectPayment(): void;
-	render(): symbol | import("lit-html").TemplateResult<1> | undefined;
+	private _handleClick;
+	render(): import("lit-html").TemplateResult<1>;
 }
 declare global {
 	interface HTMLElementTagNameMap {
@@ -3905,14 +3718,7 @@ declare global {
  */
 declare class BillingAddressComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	/**
-	 * Configuration from SDK Core containing checkoutModules configuration
-	 */
-	configuration: ConfigurationContextType;
-	/**
-	 * Headless SDK utilities for API methods like setBillingAddress
-	 */
-	headlessUtils: HeadlessUtilsContextType;
+	primerContext?: ContextType;
 	/**
 	 * Form data state
 	 */
@@ -3950,7 +3756,7 @@ declare class BillingAddressComponent extends LitElement {
 	 *          attempting field configuration extraction and country initialization
 	 *
 	 * Lifecycle:
-	 * - Task runs when this.configuration or this.headlessUtils changes
+	 * - Task runs when this.primerContext?.configuration or this.primerContext?.headlessUtils changes
 	 * - Stays pending (returns initialState) until both contexts are available
 	 * - Completes when field config is extracted and countries initialized
 	 *
@@ -4115,10 +3921,7 @@ declare class VaultManagerComponent extends LitElement {
 	constructor();
 	addEventListener: <K extends keyof VaultManagerEventMap>(type: K, listener: (ev: VaultManagerEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => void;
 	removeEventListener: <K extends keyof VaultManagerEventMap>(type: K, listener: (ev: VaultManagerEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => void;
-	vaultManagerContext: VaultManagerContextType;
-	vaultItemContext: VaultItemContextType;
-	headlessUtils: HeadlessUtilsContextType;
-	contextEventsController: EventsContextType;
+	primerContext?: ContextType;
 	/**
 	 * State to track if slot has content (triggers re-render)
 	 */
@@ -4263,16 +4066,11 @@ declare class VaultPaymentMethodItemComponent extends LitElement {
 	 */
 	addEventListener: <K extends keyof VaultManagerEventMap>(type: K, listener: (ev: VaultManagerEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => void;
 	removeEventListener: <K extends keyof VaultManagerEventMap>(type: K, listener: (ev: VaultManagerEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => void;
-	/**
-	 * Consume the vault manager context
-	 */
-	vaultManagerContext: VaultManagerContextType;
-	vaultItemContext: VaultItemContextType;
-	headlessUtils: HeadlessUtilsContextType;
+	primerContext?: ContextType;
 	/**
 	 * The payment method to display
 	 */
-	paymentMethod: VaultedPaymentMethod | null;
+	paymentMethod: VaultedPaymentMethod | undefined;
 	/**
 	 * Whether the component is in edit mode
 	 */
@@ -4355,10 +4153,6 @@ declare class VaultDeleteConfirmationComponent extends LitElement {
 	 * Payment method name to display in confirmation
 	 */
 	paymentMethodName: string;
-	/**
-	 * Consume the vault manager context to access payment method info
-	 */
-	vaultManager: VaultManagerContextType;
 	/**
 	 * Handle confirm click
 	 */
@@ -4435,11 +4229,7 @@ declare class VaultPaymentSubmitComponent extends LitElement {
 	 */
 	get buttonText(): string;
 	set buttonText(value: string);
-	headlessInstance: HeadlessUtilsContextType;
-	sdkState: SdkStateContextType;
-	vaultItemContext: VaultItemContextType;
-	vaultManager: VaultManagerContextType;
-	clientOptions: PrimerCheckoutOptions | null;
+	primerContext?: ContextType;
 	/**
 	 * The button variant to use.
 	 * @default "primary"
@@ -4475,16 +4265,7 @@ declare global {
  */
 declare class VaultCvvInputComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	/**
-	 * Form context for checking form dirty state
-	 */
-	vaultManagerFormContext: VaultManagerContextType;
-	/**
-	 * CVV-specific context for dedicated CVV handling
-	 * Separated to minimize re-renders on frequent CVV input changes
-	 */
-	vaultManagerCvvContext: VaultItemContextType;
-	computedStyles: CSSStyleDeclaration | null;
+	primerContext?: ContextType;
 	paymentMethod: PaymentCardVaultedMethod | null;
 	private cvvError;
 	private cvvInputIsDirty;
@@ -4610,26 +4391,7 @@ declare class CardFormComponent extends LitElement {
 	 * @private
 	 */
 	private paymentMethodSelectionSent;
-	/**
-	 * Payment managers injected from context
-	 */
-	paymentManagers: InitializedManagersMap;
-	/**
-	 * Client options for configuration
-	 */
-	clientOptions: ClientOptionsContextType;
-	/**
-	 * Headless utils for accessing server configuration
-	 */
-	headlessUtils: HeadlessUtilsContextType;
-	/**
-	 * Analytics utils for sending analytics events
-	 */
-	analyticsUtils: AnalyticsContextType;
-	/**
-	 * Events controller from context for receiving forwarded events
-	 */
-	contextEventsController: EventsContextType;
+	primerContext?: ContextType;
 	/**
 	 * Context provider for card form data
 	 */
@@ -4731,7 +4493,7 @@ declare class CardFormComponent extends LitElement {
  */
 export interface HostedInputHost extends ReactiveControllerHost, LitElement {
 	cardFormContext: CardFormContext | null;
-	computedStyles: CSSStyleDeclaration | null;
+	primerContext?: ContextType;
 	/** A string for the input placeholder. */
 	placeholder: string;
 	/** An accessible label for the input. */
@@ -4907,7 +4669,7 @@ declare abstract class AbstractCardInputComponent extends LitElement implements
 	private _cardFormContext;
 	get cardFormContext(): CardFormContext | null;
 	set cardFormContext(value: CardFormContext | null);
-	computedStyles: CSSStyleDeclaration | null;
+	primerContext?: ContextType;
 	/** Tracks which properties were explicitly set by the user */
 	protected readonly _userAssignedProps: Set<string>;
 	/** Internal storage for property values */
@@ -5060,12 +4822,8 @@ declare class CardFormSubmitComponent extends LitElement {
 	 */
 	get buttonText(): string;
 	set buttonText(value: string);
-	headlessUtils: HeadlessUtilsContextType;
-	clientOptions: ClientOptionsContextType;
-	sdkState: SdkStateContextType;
 	cardFormContext: CardFormContext | null;
-	analyticsUtils: AnalyticsContextType;
-	contextEventsController: EventsContextType;
+	primerContext?: ContextType;
 	/**
 	 * The button variant to use.
 	 * @default "primary"
@@ -5103,11 +4861,7 @@ declare global {
  */
 declare class CardNetworkSelectorComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	/**
-	 * Card networks context from provider
-	 */
-	cardNetworks: CardNetworksContextType;
-	headlessUtils: HeadlessUtilsContextType;
+	primerContext?: ContextType;
 	private selectedCardNetwork;
 	/**
 	 * Internal state to track if dropdown is open
@@ -5208,14 +4962,7 @@ declare global {
  */
 declare class ShowOtherPaymentsComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	/**
-	 * Consume the vault manager context to interact with vault state
-	 */
-	vaultManager: VaultManagerContextType;
-	/**
-	 * Consume the events context for external control
-	 */
-	contextEventsController: EventsContextType;
+	primerContext?: ContextType;
 	/**
 	 * Reference to the collapsable component
 	 */
@@ -5297,6 +5044,40 @@ declare global {
 		"primer-show-other-payments": ShowOtherPaymentsComponent;
 	}
 }
+declare class PaymentMethodAccordionComponent extends LitElement {
+	static styles: import("lit").CSSResult[];
+	type: PaymentMethodType | undefined;
+	disabled: boolean;
+	expanded: boolean;
+	/**
+	 * When true, suppresses auto-collapse on window blur.
+	 * Used when payment flows open external popups (e.g. Klarna).
+	 */
+	suppressBlurCollapse: boolean;
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	private _handleDocumentClick;
+	private _handleWindowBlur;
+	private _collapseFromOutsideInteraction;
+	private _handleButtonClick;
+	render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+	interface HTMLElementTagNameMap {
+		"primer-payment-method-accordion": PaymentMethodAccordionComponent;
+	}
+}
+declare class PaymentMethodAccordionConfirmButtonComponent extends LitElement {
+	static styles: import("lit").CSSResult[];
+	disabled: boolean;
+	loading: boolean;
+	render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+	interface HTMLElementTagNameMap {
+		"primer-payment-method-accordion-confirm-button": PaymentMethodAccordionConfirmButtonComponent;
+	}
+}
 declare class PrimerCheckoutCompleteComponent extends LitElement {
 	render(): import("lit-html").TemplateResult<1>;
 }
@@ -5306,7 +5087,7 @@ declare global {
 	}
 }
 declare class PrimerCheckoutErrorComponent extends LitElement {
-	sdkState: SdkStateContextType;
+	primerContext?: ContextType;
 	render(): import("lit-html").TemplateResult<1>;
 }
 declare global {
@@ -5325,10 +5106,10 @@ declare global {
 declare class ErrorMessageContainerComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	/**
-	 * Consume the SDK state context
+	 * Consume the unified context
 	 * This automatically subscribes to changes in the SDK state
 	 */
-	protected sdkState?: SdkStateContextType;
+	primerContext?: ContextType;
 	showProcessingErrors: boolean;
 	/**
 	 * Determine if an error should be shown
@@ -5352,9 +5133,7 @@ declare class PrimerMainComponent extends LitElement {
 	 * Uses assignedNodes with flatten to detect if the slot has any nodes.
 	 */
 	private onSlotChange;
-	paymentMethods: PaymentMethodsContextType;
-	sdkState: SdkStateContextType;
-	clientOptions: ClientOptionsContextType;
+	primerContext?: ContextType;
 	render(): import("lit-html").TemplateResult<1>;
 }
 declare global {
@@ -5368,7 +5147,6 @@ declare global {
 export declare function loadPrimer(): void;
 
 export {
-	AchPaymentComponent as AchPayment,
 	ApplePayComponent as ApplePay,
 	BillingAddressComponent as BillingAddress,
 	BlikComponent as Blik,
@@ -5378,7 +5156,6 @@ export {
 	CardNetworkSelectorComponent as CardFormCardNetworkSelector,
 	CollapsableComponent as Collapsable,
 	DialogComponent as Dialog,
-	DynamicPaymentComponent as DynamicPayment,
 	ErrorMessageComponent as ErrorMessage,
 	ErrorMessageContainerComponent as ErrorMessageContainer,
 	GooglePayComponent as GooglePay,
@@ -5391,9 +5168,11 @@ export {
 	InputLabelComponent as InputLabel,
 	InputWrapperComponent as InputWrapper,
 	PayPalComponent as PayPal,
+	PaymentMethodAccordionComponent as PaymentMethodAccordion,
+	PaymentMethodAccordionConfirmButtonComponent as PaymentMethodAccordionConfirmButton,
+	PaymentMethodButtonComponent as PaymentMethodButton,
 	PaymentMethodComponent as PaymentMethod,
 	PaymentMethodContainerComponent as PaymentMethodContainer,
-	PortalComponent as Portal,
 	PortalDialogComponent as PortalDialog,
 	PrimerCheckoutCompleteComponent as PrimerCheckoutComplete,
 	PrimerCheckoutErrorComponent as PrimerCheckoutFailure,