@whop/elements 1.0.0-beta.0 → 1.0.0-beta.2

package/payments.d.ts

@@ -43,6 +43,10 @@ export type PaymentsOptions = (
 		 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
 		 */
 		onLoadingChange?: ((loading: boolean) => void);
+		/**
+		 * Set `false` to turn off Whop's built-in usage analytics for this handle and its elements. The analytics identity is never threaded to its frames. A reserved option, not element data.
+		 */
+		analytics?: false;
 	}
 	| {
 		/**
@@ -85,6 +89,10 @@ export type PaymentsOptions = (
 		 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
 		 */
 		onLoadingChange?: ((loading: boolean) => void);
+		/**
+		 * Set `false` to turn off Whop's built-in usage analytics for this handle and its elements. The analytics identity is never threaded to its frames. A reserved option, not element data.
+		 */
+		analytics?: false;
 	}
 	| {
 		/**
@@ -131,6 +139,10 @@ export type PaymentsOptions = (
 		 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
 		 */
 		onLoadingChange?: ((loading: boolean) => void);
+		/**
+		 * Set `false` to turn off Whop's built-in usage analytics for this handle and its elements. The analytics identity is never threaded to its frames. A reserved option, not element data.
+		 */
+		analytics?: false;
 	}
 ) & {
 	/**
@@ -148,6 +160,11 @@ export type PaymentsOptions = (
  * @see https://docs.whop.com/elements/latest/payments/payment
  */
 export interface PaymentElementProps {
+	/**
+	 * Controls display order in either layout. Listed types appear first in order. Unlisted types retain their relative order. Does not affect availability.
+	 * @default []
+	 */
+	order?: string[];
 	/**
 	 * Controls billing-details collection. `billingDetails: 'minimal'` (default) follows each method's matrix. Methods collect name and the complete country format by default. An override may collect only the declared minimum or nothing. For cards, the minimum is name on card, country, and postal code. `'full'` requires name and the complete country format for every fresh method. `'never'` hides the block. Pass the address to `createConfirmationToken` instead. The country selector includes only countries supported by the method and payment currency. It locks when only one is available.
 	 * @default {"billingDetails":"minimal"}
@@ -163,11 +180,6 @@ export interface PaymentElementProps {
 	 * @default false
 	 */
 	separated?: boolean;
-	/**
-	 * Controls display order in either layout. Listed types appear first in order. Unlisted types retain their relative order. Does not affect availability.
-	 * @default []
-	 */
-	order?: string[];
 	/**
 	 * Whether to select the first offered method after resolution. The default `true` respects `order` and emits `selected` and `change` like a buyer interaction. It runs once before buyer interaction and does nothing when no method is offered. Set `false` to mount unselected. Independently, if an update removes the selected method, selection falls back to the first offered method. An already unselected element stays unselected.
 	 * @default true
@@ -208,6 +220,11 @@ export interface PaymentElementHandle {
  * @see https://docs.whop.com/elements/latest/payments/payment
  */
 export interface PaymentElementCreateOptions {
+	/**
+	 * Controls display order in either layout. Listed types appear first in order. Unlisted types retain their relative order. Does not affect availability.
+	 * @default []
+	 */
+	order?: string[];
 	/**
 	 * Controls billing-details collection. `billingDetails: 'minimal'` (default) follows each method's matrix. Methods collect name and the complete country format by default. An override may collect only the declared minimum or nothing. For cards, the minimum is name on card, country, and postal code. `'full'` requires name and the complete country format for every fresh method. `'never'` hides the block. Pass the address to `createConfirmationToken` instead. The country selector includes only countries supported by the method and payment currency. It locks when only one is available.
 	 * @default {"billingDetails":"minimal"}
@@ -223,18 +240,13 @@ export interface PaymentElementCreateOptions {
 	 * @default false
 	 */
 	separated?: boolean;
-	/**
-	 * Controls display order in either layout. Listed types appear first in order. Unlisted types retain their relative order. Does not affect availability.
-	 * @default []
-	 */
-	order?: string[];
 	/**
 	 * Whether to select the first offered method after resolution. The default `true` respects `order` and emits `selected` and `change` like a buyer interaction. It runs once before buyer interaction and does nothing when no method is offered. Set `false` to mount unselected. Independently, if an update removes the selected method, selection falls back to the first offered method. An already unselected element stays unselected.
 	 * @default true
 	 */
 	autoSelect?: boolean;
 	/**
-	 * Fires when selection changes. `complete: true` means the buyer selected a method and completed its card fields or required inputs. Use it to enable confirmation. `method` provides category, per-currency countries, and amount bounds for dependent UI such as country fields. `supportsBuyerFee` indicates whether to include Whop's buyer service fee in the displayed total.
+	 * Fires when selection changes. `complete: true` means the buyer selected a method and completed its card fields or required inputs. Use it to enable confirmation. `method` provides category, per-currency countries, and amount bounds for dependent UI such as country fields; when the buyer picks a card installment plan, `countries` narrows to the countries that plan serves for the payment currency. `supportsBuyerFee` indicates whether to include Whop's buyer service fee in the displayed total.
 	 */
 	onChange?: ((payload: { complete: boolean; type?: string | undefined; supportsBuyerFee?: boolean | undefined; method?: { type: string; category: string; template: string; display_name: string; countries: ({ country: string; min_amount: number | null; max_amount: number | null; })[]; min_amount: number | null; max_amount: number | null; } | undefined; }) => void);
 	/**
@@ -478,9 +490,9 @@ export interface CardElementCreateOptions {
 	 */
 	layout?: "compact" | "stacked";
 	/**
-	 * Fires when card fields change. `complete` becomes true after the buyer fills all three. Use it to enable confirmation. `brand` is the detected card network.
+	 * Fires when card fields change. `complete` becomes true after the buyer fills all three. Use it to enable confirmation. `brand` is the detected card network. `funding` is the detected funding type (`credit`, `debit`, or `prepaid`), `null` until the number identifies one.
 	 */
-	onChange?: ((payload: { complete: boolean; brand: string; }) => void);
+	onChange?: ((payload: { complete: boolean; brand: string; funding: string | null; }) => void);
 	/**
 	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
@@ -671,6 +683,55 @@ export interface TaxIdElementCreateOptions {
 	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
 }
 
+/**
+ * Consumer props for the "branding" element. Set at create (or as `<BrandingElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/payments/branding
+ */
+export interface BrandingElementProps {}
+
+/**
+ * The live handle for a mounted "branding" element. Returned by `create("branding")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/payments/branding
+ */
+export interface BrandingElementHandle {
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<BrandingElementProps>) => void;
+}
+
+/**
+ * Options for `create("branding")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const branding = payments.create("branding", {}); // this interface: props + on<Event> callbacks
+ * branding.mount("#payments-branding");
+ * ```
+ * @see https://docs.whop.com/elements/latest/payments/branding
+ */
+export interface BrandingElementCreateOptions {
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
 /**
  * Consumer props for the "cardFields" sub-controller: the `create("cardFields")` options and the minted sub handle's `update()` payload (React: `<CardFields>` props). Parent-injected props never appear here.
  * @see https://docs.whop.com/elements/latest/payments/overview
@@ -690,13 +751,9 @@ export interface CardFieldsSubOptions {
 	 */
 	networks?: CardNetworkArt[];
 	/**
-	 * Fires when completeness changes. `complete` becomes true after the buyer fills all three fields. Use it to enable confirmation. `brand` is the detected card network.
+	 * Fires when completeness changes. `complete` becomes true after the buyer fills all three fields. Use it to enable confirmation. `brand` is the detected card network. `funding` is the detected funding type (`credit`, `debit`, or `prepaid`), `null` until the number identifies one.
 	 */
-	onChange?: ((payload: { complete: boolean; brand: string; }) => void);
-	/**
-	 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
-	 */
-	onLoadingChange?: ((loading: boolean) => void);
+	onChange?: ((payload: { complete: boolean; brand: string; funding: string | null; }) => void);
 }
 
 /**
@@ -918,11 +975,11 @@ export interface PaymentRequestResourceOptions {
  */
 export interface PaymentRequestResource {
 	/**
-	 * Returns availability for each wallet when the account offers it and the device supports it. Google Pay also requires origin approval. This primes `show()`. Always await it first.
+	 * Returns availability for each wallet when the account offers it, the device supports it, and this page's origin is approved for the account (first-party whop.com pages are pre-approved; a merchant page needs its domain registered as a payment method domain). Apple Pay on non-WebKit browsers is the desktop iPhone-handoff flow, so mobile devices there report it unavailable — native Apple Pay on iOS browsers is unaffected. `order` ranks the wallets by which sheet is native to the browser — Apple Pay first on Safari, Google Pay first elsewhere — so express buttons can stack best-first. This primes `show()`. Always await it first.
 	 */
 	canMakePayment: () => Promise<WalletAvailability>;
 	/**
-	 * Open the selected wallet sheet after awaiting `canMakePayment()`. Apple requires session creation within the gesture stack. If `requestPayerEmail` is `false`, pass `email` from your form. Otherwise, the sheet refuses to open because confirmation tokens require an email.
+	 * Open the selected wallet sheet after awaiting `canMakePayment()`. Apple requires session creation within the gesture stack. Pass `email` when your page already collected one — the sheet takes it and never asks for a second. With `requestPayerEmail: false`, passing one is required, and the sheet refuses to open without it because confirmation tokens require an email.
 	 * Call synchronously during user activation. Await prerequisites first because browsers revoke activation across asynchronous steps.
 	 */
 	show: (type: "apple_pay" | "google_pay", provided?: { email?: string | undefined; } | undefined) => Promise<PaymentRequestResult>;
@@ -983,6 +1040,10 @@ export interface PaymentsHandle {
 	 * Collects a business tax registration accepted by the API. Labels use buyer-facing names. The placeholder matches the selected format. `country` preselects a type. `onChange` emits committed pairs. The host supplies API validation errors.
 	 */
 	create(name: "taxId", options?: TaxIdElementCreateOptions): TaxIdElementHandle;
+	/**
+	 * Whop's merchant-of-record notice: the Whop wordmark with links to the buyer terms and privacy policy. Mount it alongside every payment collection surface.
+	 */
+	create(name: "branding", options?: BrandingElementCreateOptions): BrandingElementHandle;
 	/**
 	 * Creates a confirmation token for the selected method from your pay button. Pass the checkout's billing details. They must include `email`. Cards also need `name` and an address containing `line1` and `country`. Wallet selections open their sheet during the pay-button interaction. Confirm the returned `confirmationToken` server-side, then call `WhopElements.payments.handleNextAction(…)`.
 	 * Runs on your page (host-side), not in the controller iframe.
@@ -997,6 +1058,10 @@ export interface PaymentsHandle {
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
 	update(options: Partial<PaymentsOptions>): void;
+	/**
+	 * Destroys every element and sub-controller this handle created, removes the controller frame, and releases its subscriptions. You can call it more than once, but a destroyed handle refuses any other call — create a new handle to start over. React removes the group automatically when the provider unmounts.
+	 */
+	destroy(): void;
 }
 
 /**
@@ -1022,6 +1087,10 @@ export interface PaymentsStatics {
 export interface WalletAvailability {
 	applePay: boolean;
 	googlePay: boolean;
+	/**
+	 * The wallets ranked by which sheet is native to this browser — Apple Pay first on WebKit, Google Pay first everywhere else — so express buttons can stack best-first. Absent on consumer-stated availability (previews) and on wires that predate it. An inline union, not payment-request's WalletSheetType: that module already imports this one.
+	 */
+	order?: ("apple_pay" | "google_pay")[] | undefined;
 }
 
 /**

package/tracking.d.cts

@@ -48,6 +48,10 @@ export interface TrackingOptions {
 	 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
 	 */
 	onLoadingChange?: ((loading: boolean) => void);
+	/**
+	 * Set `false` to turn off Whop's built-in usage analytics for this handle and its elements. The analytics identity is never threaded to its frames. A reserved option, not element data.
+	 */
+	analytics?: false;
 	/**
 	 * Visual customization for this group's elements. Overrides the global `WhopElements({ appearance })`. Change it live with `update({ appearance })`.
 	 */
@@ -461,6 +465,10 @@ export interface TrackingHandle {
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
 	update(options: Partial<TrackingOptions>): void;
+	/**
+	 * Destroys every element and sub-controller this handle created, removes the controller frame, and releases its subscriptions. You can call it more than once, but a destroyed handle refuses any other call — create a new handle to start over. React removes the group automatically when the provider unmounts.
+	 */
+	destroy(): void;
 }
 
 /**

package/tracking.d.ts

@@ -48,6 +48,10 @@ export interface TrackingOptions {
 	 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
 	 */
 	onLoadingChange?: ((loading: boolean) => void);
+	/**
+	 * Set `false` to turn off Whop's built-in usage analytics for this handle and its elements. The analytics identity is never threaded to its frames. A reserved option, not element data.
+	 */
+	analytics?: false;
 	/**
 	 * Visual customization for this group's elements. Overrides the global `WhopElements({ appearance })`. Change it live with `update({ appearance })`.
 	 */
@@ -461,6 +465,10 @@ export interface TrackingHandle {
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
 	update(options: Partial<TrackingOptions>): void;
+	/**
+	 * Destroys every element and sub-controller this handle created, removes the controller frame, and releases its subscriptions. You can call it more than once, but a destroyed handle refuses any other call — create a new handle to start over. React removes the group automatically when the provider unmounts.
+	 */
+	destroy(): void;
 }
 
 /**

package/wallet.d.cts

@@ -23,6 +23,10 @@ export interface WalletOptions {
 	 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
 	 */
 	onLoadingChange?: ((loading: boolean) => void);
+	/**
+	 * Set `false` to turn off Whop's built-in usage analytics for this handle and its elements. The analytics identity is never threaded to its frames. A reserved option, not element data.
+	 */
+	analytics?: false;
 	/**
 	 * Visual customization for this group's elements. Overrides the global `WhopElements({ appearance })`. Change it live with `update({ appearance })`.
 	 */
@@ -129,13 +133,135 @@ export interface ActivityElementCreateOptions {
 	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
 }
 
+/**
+ * Consumer props for the "actions" element. Set at create (or as `<ActionsElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/actions
+ */
+export interface ActionsElementProps {
+	/**
+	 * Show the Deposit button.
+	 * @default true
+	 */
+	showDeposit?: boolean;
+	/**
+	 * Show the Accept button.
+	 * @default true
+	 */
+	showAccept?: boolean;
+	/**
+	 * Show the Send button.
+	 * @default true
+	 */
+	showSend?: boolean;
+	/**
+	 * Disable the Deposit button while keeping it visible.
+	 * @default false
+	 */
+	depositDisabled?: boolean;
+	/**
+	 * Disable the Accept button while keeping it visible.
+	 * @default false
+	 */
+	acceptDisabled?: boolean;
+	/**
+	 * Disable the Send button while keeping it visible.
+	 * @default false
+	 */
+	sendDisabled?: boolean;
+}
+
+/**
+ * The live handle for a mounted "actions" element. Returned by `create("actions")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/actions
+ */
+export interface ActionsElementHandle {
+	/**
+	 * Mounts the element in `target` and starts loading. React components mount themselves.
+	 */
+	mount: (target: string | HTMLElement) => void;
+	/**
+	 * Removes the element and releases its frame and subscriptions. You can call it more than once. React removes the element automatically.
+	 */
+	destroy: () => void;
+	/**
+	 * Merges new props into the mounted element. In React, change the component props instead.
+	 */
+	update: (options: Partial<ActionsElementProps>) => void;
+}
+
+/**
+ * Options for `create("actions")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const actions = wallet.create("actions", {}); // this interface: props + on<Event> callbacks
+ * actions.mount("#wallet-actions");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/actions
+ */
+export interface ActionsElementCreateOptions {
+	/**
+	 * Show the Deposit button.
+	 * @default true
+	 */
+	showDeposit?: boolean;
+	/**
+	 * Show the Accept button.
+	 * @default true
+	 */
+	showAccept?: boolean;
+	/**
+	 * Show the Send button.
+	 * @default true
+	 */
+	showSend?: boolean;
+	/**
+	 * Disable the Deposit button while keeping it visible.
+	 * @default false
+	 */
+	depositDisabled?: boolean;
+	/**
+	 * Disable the Accept button while keeping it visible.
+	 * @default false
+	 */
+	acceptDisabled?: boolean;
+	/**
+	 * Disable the Send button while keeping it visible.
+	 * @default false
+	 */
+	sendDisabled?: boolean;
+	/**
+	 * The Deposit button was pressed and the Wallet controller opened its deposit overlay.
+	 */
+	onDepositRequested?: ((payload: Record<string, never>) => void);
+	/**
+	 * The Accept button was pressed and the Wallet controller opened the corresponding Whop setup page.
+	 */
+	onAcceptRequested?: ((payload: Record<string, never>) => void);
+	/**
+	 * The Send button was pressed and the Wallet controller opened its send overlay.
+	 */
+	onSendRequested?: ((payload: Record<string, never>) => void);
+	/**
+	 * Runs after the loading skeleton first paints and before `onReady`.
+	 */
+	onLoaderStart?: (() => void);
+	/**
+	 * Runs after the element's first complete paint.
+	 */
+	onReady?: (() => void);
+	/**
+	 * Runs when the element fails to load or crashes. The fallback remains visible. Use `code` for programmatic handling. `sourceKey` identifies a failed host-state source.
+	 */
+	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
+}
+
 /**
  * Consumer props for the "deposit" element. Set at create (or as `<DepositElement />` JSX props), and updatable live via `update()`.
  * @see https://docs.whop.com/elements/latest/wallet/deposit
  */
 export interface DepositElementProps {
 	/**
-	 * Prefill the amount and make it read-only — for flows that already know what is owed. An amount at or below zero, or above 9,999,999, is ignored.
+	 * Prefill the amount and make it read-only — for flows that already know what is owed. An amount at or below zero is ignored, as is one longer than 12 whole digits; the rest is rounded to the currency’s decimal places.
 	 * @default ""
 	 */
 	amount?: string;
@@ -229,7 +355,7 @@ export interface DepositElementHandle {
  */
 export interface DepositElementCreateOptions {
 	/**
-	 * Prefill the amount and make it read-only — for flows that already know what is owed. An amount at or below zero, or above 9,999,999, is ignored.
+	 * Prefill the amount and make it read-only — for flows that already know what is owed. An amount at or below zero is ignored, as is one longer than 12 whole digits; the rest is rounded to the currency’s decimal places.
 	 * @default ""
 	 */
 	amount?: string;
@@ -357,6 +483,11 @@ export interface DepositElementOverlayHandle {
  * @see https://docs.whop.com/elements/latest/wallet/withdraw
  */
 export interface WithdrawElementProps {
+	/**
+	 * Whether the confirmed payout was created successfully.
+	 * @default false
+	 */
+	succeeded?: boolean;
 	/**
 	 * Saved payout methods with quotes for the current amount.
 	 * @default []
@@ -468,6 +599,11 @@ export interface WithdrawElementHandle {
  * @see https://docs.whop.com/elements/latest/wallet/withdraw
  */
 export interface WithdrawElementCreateOptions {
+	/**
+	 * Whether the confirmed payout was created successfully.
+	 * @default false
+	 */
+	succeeded?: boolean;
 	/**
 	 * Saved payout methods with quotes for the current amount.
 	 * @default []
@@ -584,6 +720,10 @@ export interface WithdrawElementCreateOptions {
 	 * The payer confirmed the final payout details. Create the payout on receipt.
 	 */
 	onWithdrawalRequested?: ((payload: WithdrawalRequest) => void);
+	/**
+	 * The payer finished reviewing a successful payout.
+	 */
+	onDone?: ((payload: Record<string, never>) => void);
 	/**
 	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
@@ -712,7 +852,7 @@ export interface SendElementCreateOptions {
 	/**
 	 * The visible screen changed.
 	 */
-	onStepChanged?: ((payload: { step: "enter_amount" | "select_recipient" | "create_link" | "link_success" | "success"; }) => void);
+	onStepChanged?: ((payload: { step: "success" | "enter_amount" | "select_recipient" | "create_link" | "link_success"; }) => void);
 	/**
 	 * A transfer succeeded. Refresh anything on your side reading the account's balance or activity.
 	 */
@@ -768,7 +908,7 @@ export interface SendElementOverlayHandle {
  */
 export interface CardsElementProps {
 	/**
-	 * A scoped token for the privileged read — needs `payout:account:read`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the read carries the viewer's own session, which only answers same-origin.
+	 * A scoped token for the privileged read and verification start — needs `payout:account:read` and `identity:write`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the calls carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
@@ -827,7 +967,7 @@ export interface CardsElementHandle {
  */
 export interface CardsElementCreateOptions {
 	/**
-	 * A scoped token for the privileged read — needs `payout:account:read`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the read carries the viewer's own session, which only answers same-origin.
+	 * A scoped token for the privileged read and verification start — needs `payout:account:read` and `identity:write`. Mint it on your server with `POST /api/v1/access_tokens`. Omitted, the calls carry the viewer's own session, which only answers same-origin.
 	 */
 	accessToken?: string;
 	/**
@@ -862,6 +1002,10 @@ export interface CardsElementCreateOptions {
 	 * The "+" button was clicked. Only fires when `hideAddButton` is false.
 	 */
 	onAddCardRequested?: ((payload: Record<string, never>) => void);
+	/**
+	 * The viewer pressed the verify button on an account with no card program. The element starts the hosted session and leaves for it itself — this fires alongside, so a host can record the trip or show its own state.
+	 */
+	onVerificationRequested?: ((payload: { accountId: string; }) => void);
 	/**
 	 * Runs after the loading skeleton first paints and before `onReady`.
 	 */
@@ -880,12 +1024,7 @@ export interface CardsElementCreateOptions {
  * Consumer props for the "balances" sub-controller: the `create("balances")` options and the minted sub handle's `update()` payload (React: `<Balances>` props). Parent-injected props never appear here.
  * @see https://docs.whop.com/elements/latest/wallet/overview
  */
-export interface BalancesSubOptions {
-	/**
-	 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
-	 */
-	onLoadingChange?: ((loading: boolean) => void);
-}
+export interface BalancesSubOptions {}
 
 /**
  * Consumer props for the "balances" sub-controller's "balance" element.
@@ -1120,9 +1259,9 @@ export interface ListElementCreateOptions {
 	 */
 	showPersonalAccount?: boolean;
 	/**
-	 * A holding row was clicked, with `includeOwnedAccounts` off. `key` is `usd` for the combined dollar row, otherwise the holding symbol (`cbBTC`, `EUR`), and `kind` tells you which of the three it is so you can route without classifying symbols yourself. The element never navigates.
+	 * A holding row was clicked, with `includeOwnedAccounts` off. `holding` is `usd` for the combined dollar row, otherwise the holding symbol (`cbBTC`, `EUR`), and `kind` tells you which of the three it is so you can route without classifying symbols yourself. The element never navigates.
 	 */
-	onBalanceSelected?: ((payload: { key: string; kind: "usd" | "cash" | "asset"; }) => void);
+	onBalanceSelected?: ((payload: { holding: string; kind: "usd" | "cash" | "asset"; }) => void);
 	/**
 	 * An account row was clicked, with `includeOwnedAccounts` on. `accountId` is the personal `user_…` tag or an owned `biz_…` tag, and `kind` lets you route without inspecting it. The element never navigates.
 	 */
@@ -1173,6 +1312,10 @@ export interface WalletHandle {
 	 * An account's ledger activity: every movement of money in or out, newest first. The list pages as the viewer scrolls, and rows report which one was tapped instead of navigating, so you can open your own detail screen.
 	 */
 	create(name: "activity", options?: ActivityElementCreateOptions): ActivityElementHandle;
+	/**
+	 * The account action row from Whop's balance dashboard. Deposit and Send open the Wallet controller's built-in overlays. Accept opens Whop's checkout-link creator for a business account or company creation for a personal account. Each button also emits its requested event so the embedding page can observe the action.
+	 */
+	create(name: "actions", options?: ActionsElementCreateOptions): ActionsElementHandle;
 	/**
 	 * Funds a Whop account. Renders an amount field and the account's live funding rails — crypto (a per-network deposit address with its QR) and bank transfer (the wire fields for each settlement currency) — resolved from the account ID with no credentials, so it works on any page. Cards and platform balance are opt-in: pass `savedCards`, `allowNewCard`, or `showPlatformBalance` and the element collects the amount and the choice, then emits `cardDepositRequested` / `addCardRequested` / `platformBalanceSelected` and waits for you to call `showStep({ step: 'amount' })` when your own screen is done.
 	 */
@@ -1209,6 +1352,10 @@ export interface WalletHandle {
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
 	update(options: Partial<WalletOptions>): void;
+	/**
+	 * Destroys every element and sub-controller this handle created, removes the controller frame, and releases its subscriptions. You can call it more than once, but a destroyed handle refuses any other call — create a new handle to start over. React removes the group automatically when the provider unmounts.
+	 */
+	destroy(): void;
 }
 
 /**
@@ -1230,6 +1377,28 @@ export interface ActivityDateRangeOverride {
 	displayPostedBefore?: string | undefined;
 }
 
+/**
+ * Declared from the app's `Money`, referenced by a host-capability surface.
+ */
+export interface Money {
+	/**
+	 * Three-letter ISO 4217 currency code, lowercase.
+	 */
+	currency: string;
+	/**
+	 * The amount in major units, as an exact decimal string — `"10.00"` is ten dollars. A string so no float rounds it in transit.
+	 */
+	amount: string;
+	/**
+	 * How many decimal places the amount CARRIES — the precision the charge itself runs at.
+	 */
+	decimals: number;
+	/**
+	 * How many decimal places to SHOW. Usually equal to `decimals`, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is `2` and `0`. Format the number in your own locale using this.
+	 */
+	display_decimals: number;
+}
+
 /**
  * Declared from the app's `LedgerActivity`, referenced by a host-capability surface.
  */
@@ -1242,7 +1411,7 @@ export interface LedgerActivity {
 	/**
 	 * The ledger line category this activity was posted under.
 	 */
-	line_type: "ad_budget_release" | "ad_campaign_budget" | "ad_publisher_payout" | "ad_publisher_payout_received" | "ad_spend_charge" | "affiliate_fee" | "airdrop" | "airdrop_link_created" | "airdrop_link_redeemed" | "airdrop_link_returned" | "airdrop_reversal" | "application_fee" | "application_fee_payout" | "bank_transfer" | "billing_percentage_fee" | "buyer_fee" | "card_spend_authorization" | "card_spend_authorization_void" | "card_spend_refund" | "company_referral" | "cross_border_percentage_fee" | "currency_conversion_incoming" | "currency_conversion_outgoing" | "dispute_alert_fee" | "dispute_hold_adjustment" | "dispute_representment_fee" | "fraud_prevention_fee" | "fx_percentage_fee" | "high_risk_merchant_fee" | "installment_default" | "internal_balance_transfer_incoming" | "internal_balance_transfer_outgoing" | "internal_withdrawal" | "internal_withdrawal_reversal" | "legacy_crypto_payment" | "legacy_payment" | "legacy_payment_refund" | "license_sale" | "license_sale_commission" | "license_sale_revenue" | "misc_purchase" | "misc_refund" | "misc_reversal" | "onchain_deposit" | "onchain_swap_target" | "onchain_wallet_transfer_incoming" | "onchain_wallet_transfer_outgoing" | "orchestration_percentage_fee" | "passthrough_gmv" | "payment_dispute" | "payment_dispute_adjustment" | "payment_dispute_fee" | "payment_dispute_reversal" | "payment_gross" | "payment_gross_reversal" | "payment_processing_fixed_fee" | "payment_processing_percentage_fee" | "payment_referral" | "payment_referral_reversal" | "payment_refund" | "payment_refund_reversal" | "payment_revshare" | "payment_revshare_payout" | "payment_revshare_refund" | "payment_revshare_reversal" | "payout_fee" | "platform_affiliate_payment" | "platform_affiliate_payment_reversal" | "platform_balance_payment" | "platform_balance_payment_refund" | "platform_balance_transfer_incoming" | "platform_balance_transfer_outgoing" | "platform_covered_dispute" | "promo_reversal" | "referral_bonus" | "resolution_center_refund" | "revshare_percentage_fee" | "sales_tax_fee" | "sales_tax_remittance" | "sales_tax_remittance_reversal" | "software_rental_revshare" | "software_rental_transaction" | "stripe_domestic_processing_fee" | "stripe_international_processing_fee" | "three_ds_fixed_fee" | "topup" | "topup_fee" | "topup_reversal" | "treasury_payin" | "whop_processing_fee" | "withdrawal" | "withdrawal_clawback" | "withdrawal_clawback_reversal" | "withdrawal_reclassification" | "withdrawal_reversal";
+	line_type: "ad_budget_release" | "ad_campaign_budget" | "ad_publisher_payout" | "ad_publisher_payout_received" | "ad_spend_charge" | "affiliate_fee" | "airdrop" | "airdrop_link_created" | "airdrop_link_redeemed" | "airdrop_link_returned" | "airdrop_reversal" | "application_fee" | "application_fee_payout" | "balance_reservation" | "balance_reservation_reversal" | "bank_transfer" | "billing_percentage_fee" | "buyer_fee" | "card_spend_authorization" | "card_spend_authorization_void" | "card_spend_refund" | "company_referral" | "cross_border_percentage_fee" | "currency_conversion_incoming" | "currency_conversion_outgoing" | "dispute_alert_fee" | "dispute_hold_adjustment" | "dispute_representment_fee" | "fraud_prevention_fee" | "fx_percentage_fee" | "high_risk_merchant_fee" | "installment_default" | "internal_balance_transfer_incoming" | "internal_balance_transfer_outgoing" | "internal_withdrawal" | "internal_withdrawal_reversal" | "legacy_crypto_payment" | "legacy_payment" | "legacy_payment_refund" | "license_sale" | "license_sale_commission" | "license_sale_revenue" | "misc_purchase" | "misc_refund" | "misc_reversal" | "onchain_deposit" | "onchain_swap_target" | "onchain_wallet_transfer_incoming" | "onchain_wallet_transfer_outgoing" | "orchestration_percentage_fee" | "passthrough_gmv" | "payment_dispute" | "payment_dispute_adjustment" | "payment_dispute_fee" | "payment_dispute_reversal" | "payment_gross" | "payment_gross_reversal" | "payment_processing_fixed_fee" | "payment_processing_percentage_fee" | "payment_referral" | "payment_referral_reversal" | "payment_refund" | "payment_refund_reversal" | "payment_revshare" | "payment_revshare_payout" | "payment_revshare_refund" | "payment_revshare_reversal" | "payout_fee" | "platform_affiliate_payment" | "platform_affiliate_payment_reversal" | "platform_balance_payment" | "platform_balance_payment_refund" | "platform_balance_transfer_incoming" | "platform_balance_transfer_outgoing" | "platform_covered_dispute" | "promo_reversal" | "referral_bonus" | "resolution_center_refund" | "revshare_percentage_fee" | "sales_tax_fee" | "sales_tax_remittance" | "sales_tax_remittance_reversal" | "software_rental_revshare" | "software_rental_transaction" | "stripe_domestic_processing_fee" | "stripe_international_processing_fee" | "three_ds_fixed_fee" | "topup" | "topup_fee" | "topup_reversal" | "treasury_payin" | "whop_processing_fee" | "withdrawal" | "withdrawal_clawback" | "withdrawal_clawback_reversal" | "withdrawal_reclassification" | "withdrawal_reversal";
 	/**
 	 * Signed amount in the currency's smallest precision units.
 	 */
@@ -1270,7 +1439,11 @@ export interface LedgerActivity {
 	/**
 	 * Source of this ledger activity.
 	 */
-	source: { object: string; id: string; status?: string | null | undefined; reason?: string | null | undefined; claim_url?: string | null | undefined; amount_float?: number | null | undefined; created_at?: string | null | undefined; estimated_arrival?: string | null | undefined; payer_name?: string | null | undefined; payout_token_nickname?: string | null | undefined; tx_hash?: string | null | undefined; sender_address?: string | null | undefined; chain?: string | null | undefined; from_amount?: string | null | undefined; from_currency?: string | null | undefined; to_amount?: string | null | undefined; to_currency?: string | null | undefined; payout_destination?: { payer_name?: string | null | undefined; icon_url?: string | null | undefined; } | null | undefined; [key: string]: unknown; } | null;
+	source: { object: string; id: string; status?: string | null | undefined; payment_amount?: Money | null | undefined; payment_method_type?: string | null | undefined; payment_processor?: string | null | undefined; card_brand?: string | null | undefined; reason?: string | null | undefined; claim_url?: string | null | undefined; amount_float?: number | null | undefined; created_at?: string | null | undefined; estimated_arrival?: string | null | undefined; payer_name?: string | null | undefined; payout_token_nickname?: string | null | undefined; tx_hash?: string | null | undefined; sender_address?: string | null | undefined; chain?: string | null | undefined; from_amount?: string | null | undefined; from_currency?: string | null | undefined; to_amount?: string | null | undefined; to_currency?: string | null | undefined; payout_destination?: { payer_name?: string | null | undefined; icon_url?: string | null | undefined; } | null | undefined; [key: string]: unknown; } | null;
+	/**
+	 * Payment related to this ledger activity. Included when rich resource hydration is enabled and the movement is tied to a payment.
+	 */
+	payment?: { object: "payment"; id: string; amount: Money | null; payment_method_type: string | null; payment_processor: string | null; card_brand: string | null; card_last4: string | null; created_at: string; } | null | undefined;
 	/**
 	 * The viewer account that owns this row's ledger. Present only when the response aggregates owned accounts (include_owned_accounts=true); omitted otherwise.
 	 */