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

package/ads.d.cts

@@ -32,6 +32,10 @@ export interface AdsOptions {
 	 * 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 })`.
 	 */
@@ -271,10 +275,6 @@ export interface ReportingSubOptions {
 	 * The viewer asked to edit something — a row menu, a draft row, or Edit ad in the details overlay. `campaignId` is always there; `adGroupId` and `adId` narrow it to what they clicked. Only raised when `useCampaignCreator` is off; on, the builder opens over the page instead and this stays quiet.
 	 */
 	onEditRequested?: ((payload: AdsEditTarget) => void);
-	/**
-	 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
-	 */
-	onLoadingChange?: ((loading: boolean) => void);
 }
 
 /**
@@ -541,6 +541,10 @@ export interface AdsHandle {
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
 	update(options: Partial<AdsOptions>): 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/ads.d.ts

@@ -32,6 +32,10 @@ export interface AdsOptions {
 	 * 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 })`.
 	 */
@@ -271,10 +275,6 @@ export interface ReportingSubOptions {
 	 * The viewer asked to edit something — a row menu, a draft row, or Edit ad in the details overlay. `campaignId` is always there; `adGroupId` and `adId` narrow it to what they clicked. Only raised when `useCampaignCreator` is off; on, the builder opens over the page instead and this stays quiet.
 	 */
 	onEditRequested?: ((payload: AdsEditTarget) => void);
-	/**
-	 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
-	 */
-	onLoadingChange?: ((loading: boolean) => void);
 }
 
 /**
@@ -541,6 +541,10 @@ export interface AdsHandle {
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
 	update(options: Partial<AdsOptions>): 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/checkout.d.cts

@@ -11,9 +11,13 @@
  */
 export interface CheckoutOptions {
 	/**
-	 * Existing plan ID, prefixed `plan_`. The element creates a checkout session for it, and the plan defines the price; nothing about amounts can be asserted client-side. Every checkout names one — omitting it refuses loudly at mount. Set at create only: the session is minted from it, and changing it later refuses.
+	 * Existing plan ID, prefixed `plan_`. The element creates a checkout session for it, and the plan defines the price; nothing about amounts can be asserted client-side. Every checkout is created from this or a `checkoutConfiguration` — omitting both refuses loudly at mount. Set at create only: the session is minted from it, and changing it later refuses.
 	 */
 	plan?: string;
+	/**
+	 * Existing checkout configuration ID, prefixed `ch_`. The element creates the checkout session from it: the configuration names the plan being sold and seeds its own affiliate code, metadata, redirect and payment-method presets — an option passed here beside it wins over the configuration’s copy, field by field. Pass `plan` alongside only to set `quantity`; it must be the configuration’s own plan, which can never be swapped out from under its presets. Set at create only.
+	 */
+	checkoutConfiguration?: string;
 	/**
 	 * How many units to purchase. Plans that disallow multiples refuse values above 1. Set at create only: the session is minted with it, and changing it later refuses. @default 1
 	 */
@@ -42,6 +46,10 @@ export interface CheckoutOptions {
 	 * 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 })`.
 	 */
@@ -101,20 +109,99 @@ export interface CheckoutElementCreateOptions {
 	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
 }
 
+/**
+ * Consumer props for the "expressCheckout" element. Set at create (or as `<ExpressCheckoutElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/checkout/expressCheckout
+ */
+export interface ExpressCheckoutElementProps {
+	/**
+	 * Which wallets may render — a filter over what the buyer’s device actually offers. The element never shows a wallet the device or the served matrix cannot back, and the render order stays best-native-first whatever order this lists. An empty list renders nothing (warned in dev builds).
+	 * @default ["apple_pay","google_pay"]
+	 */
+	wallets?: ("apple_pay" | "google_pay")[];
+	/**
+	 * How the buttons stack. `auto` follows the element’s own container — stacked in narrow containers, side by side in wide ones; `horizontal` and `vertical` force one arrangement.
+	 * @default "auto"
+	 */
+	layout?: "auto" | "horizontal" | "vertical";
+}
+
+/**
+ * The live handle for a mounted "expressCheckout" element. Returned by `create("expressCheckout")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/checkout/expressCheckout
+ */
+export interface ExpressCheckoutElementHandle {
+	/**
+	 * 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<ExpressCheckoutElementProps>) => void;
+}
+
+/**
+ * Options for `create("expressCheckout")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const expressCheckout = checkout.create("expressCheckout", {}); // this interface: props + on<Event> callbacks
+ * expressCheckout.mount("#checkout-expressCheckout");
+ * ```
+ * @see https://docs.whop.com/elements/latest/checkout/expressCheckout
+ */
+export interface ExpressCheckoutElementCreateOptions {
+	/**
+	 * Which wallets may render — a filter over what the buyer’s device actually offers. The element never shows a wallet the device or the served matrix cannot back, and the render order stays best-native-first whatever order this lists. An empty list renders nothing (warned in dev builds).
+	 * @default ["apple_pay","google_pay"]
+	 */
+	wallets?: ("apple_pay" | "google_pay")[];
+	/**
+	 * How the buttons stack. `auto` follows the element’s own container — stacked in narrow containers, side by side in wide ones; `horizontal` and `vertical` force one arrangement.
+	 * @default "auto"
+	 */
+	layout?: "auto" | "horizontal" | "vertical";
+	/**
+	 * 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);
+}
+
 /**
  * The Checkout handle, returned by `whop.checkout.create()` (React: `useCheckout()`). Mounts the elements and carries the controller's actions.
  * @see https://docs.whop.com/elements/latest/checkout/overview
  */
 export interface CheckoutHandle {
 	/**
-	 * The full checkout surface — order summary with the live quote, promo code entry, the currency the buyer pays in, everything this checkout has to collect from the buyer, the composed payment methods surface, and the pay flow. What it collects is whatever the account owner set up (email, their own questions, a phone number, a shipping address for physical goods, an explicit agreement to their terms), rendered together on one screen in the order they chose — so an account owner who starts asking for something new needs no change here. Renders the whole purchase; the checkout controller owns the session and the credential. After a payment that needs an off-site step, this same surface renders the outcome the server reports when the buyer comes back.
-	 * Exclusive slot `entry`. Mount exactly one of: checkout.
+	 * The full checkout surface — order summary with the live quote, promo code entry, the currency the buyer pays in, everything this checkout has to collect from the buyer, the composed payment methods surface, and the pay flow. What it collects is whatever the seller set up (email, their own questions, a phone number, a shipping address for physical goods, an explicit agreement to their terms), rendered together on one screen in the order they chose — so a seller who starts asking for something new needs no change here. Renders the whole purchase; the checkout controller owns the session and the credential. After a payment that needs an off-site step, this same surface renders the outcome the server reports when the buyer comes back.
+	 * Exclusive slot `entry`. Mount exactly one of: checkout | expressCheckout.
 	 */
 	create(name: "checkout", options?: CheckoutElementCreateOptions): CheckoutElementHandle;
+	/**
+	 * One-press Apple Pay and Google Pay buttons for a checkout — the OS payment sheet collects whatever the session still needs (the buyer's email, a shipping address for physical goods, a promo code where the seller offers entry) and one press finishes the purchase. It shares the checkout's entry slot with the full checkout element, so a handle mounts exactly one of the two: this button alone where the purchase is simple enough for a sheet to finish, or the full checkout surface for everything else. Renders only the wallets the buyer's device can actually pay with, using the served button art, and renders nothing where no wallet is available. A checkout the sheet cannot honestly finish — a waitlist join, a transfer, a form question only a page can ask — refuses loudly instead of rendering a doomed button.
+	 * Exclusive slot `entry`. Mount exactly one of: checkout | expressCheckout.
+	 */
+	create(name: "expressCheckout", options?: ExpressCheckoutElementCreateOptions): ExpressCheckoutElementHandle;
 	/**
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
 	update(options: Partial<CheckoutOptions>): 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/checkout.d.ts

@@ -11,9 +11,13 @@
  */
 export interface CheckoutOptions {
 	/**
-	 * Existing plan ID, prefixed `plan_`. The element creates a checkout session for it, and the plan defines the price; nothing about amounts can be asserted client-side. Every checkout names one — omitting it refuses loudly at mount. Set at create only: the session is minted from it, and changing it later refuses.
+	 * Existing plan ID, prefixed `plan_`. The element creates a checkout session for it, and the plan defines the price; nothing about amounts can be asserted client-side. Every checkout is created from this or a `checkoutConfiguration` — omitting both refuses loudly at mount. Set at create only: the session is minted from it, and changing it later refuses.
 	 */
 	plan?: string;
+	/**
+	 * Existing checkout configuration ID, prefixed `ch_`. The element creates the checkout session from it: the configuration names the plan being sold and seeds its own affiliate code, metadata, redirect and payment-method presets — an option passed here beside it wins over the configuration’s copy, field by field. Pass `plan` alongside only to set `quantity`; it must be the configuration’s own plan, which can never be swapped out from under its presets. Set at create only.
+	 */
+	checkoutConfiguration?: string;
 	/**
 	 * How many units to purchase. Plans that disallow multiples refuse values above 1. Set at create only: the session is minted with it, and changing it later refuses. @default 1
 	 */
@@ -42,6 +46,10 @@ export interface CheckoutOptions {
 	 * 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 })`.
 	 */
@@ -101,20 +109,99 @@ export interface CheckoutElementCreateOptions {
 	onError?: ((e: { message: string; code?: string | undefined; sourceKey?: string | undefined; }) => void);
 }
 
+/**
+ * Consumer props for the "expressCheckout" element. Set at create (or as `<ExpressCheckoutElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/checkout/expressCheckout
+ */
+export interface ExpressCheckoutElementProps {
+	/**
+	 * Which wallets may render — a filter over what the buyer’s device actually offers. The element never shows a wallet the device or the served matrix cannot back, and the render order stays best-native-first whatever order this lists. An empty list renders nothing (warned in dev builds).
+	 * @default ["apple_pay","google_pay"]
+	 */
+	wallets?: ("apple_pay" | "google_pay")[];
+	/**
+	 * How the buttons stack. `auto` follows the element’s own container — stacked in narrow containers, side by side in wide ones; `horizontal` and `vertical` force one arrangement.
+	 * @default "auto"
+	 */
+	layout?: "auto" | "horizontal" | "vertical";
+}
+
+/**
+ * The live handle for a mounted "expressCheckout" element. Returned by `create("expressCheckout")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/checkout/expressCheckout
+ */
+export interface ExpressCheckoutElementHandle {
+	/**
+	 * 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<ExpressCheckoutElementProps>) => void;
+}
+
+/**
+ * Options for `create("expressCheckout")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const expressCheckout = checkout.create("expressCheckout", {}); // this interface: props + on<Event> callbacks
+ * expressCheckout.mount("#checkout-expressCheckout");
+ * ```
+ * @see https://docs.whop.com/elements/latest/checkout/expressCheckout
+ */
+export interface ExpressCheckoutElementCreateOptions {
+	/**
+	 * Which wallets may render — a filter over what the buyer’s device actually offers. The element never shows a wallet the device or the served matrix cannot back, and the render order stays best-native-first whatever order this lists. An empty list renders nothing (warned in dev builds).
+	 * @default ["apple_pay","google_pay"]
+	 */
+	wallets?: ("apple_pay" | "google_pay")[];
+	/**
+	 * How the buttons stack. `auto` follows the element’s own container — stacked in narrow containers, side by side in wide ones; `horizontal` and `vertical` force one arrangement.
+	 * @default "auto"
+	 */
+	layout?: "auto" | "horizontal" | "vertical";
+	/**
+	 * 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);
+}
+
 /**
  * The Checkout handle, returned by `whop.checkout.create()` (React: `useCheckout()`). Mounts the elements and carries the controller's actions.
  * @see https://docs.whop.com/elements/latest/checkout/overview
  */
 export interface CheckoutHandle {
 	/**
-	 * The full checkout surface — order summary with the live quote, promo code entry, the currency the buyer pays in, everything this checkout has to collect from the buyer, the composed payment methods surface, and the pay flow. What it collects is whatever the account owner set up (email, their own questions, a phone number, a shipping address for physical goods, an explicit agreement to their terms), rendered together on one screen in the order they chose — so an account owner who starts asking for something new needs no change here. Renders the whole purchase; the checkout controller owns the session and the credential. After a payment that needs an off-site step, this same surface renders the outcome the server reports when the buyer comes back.
-	 * Exclusive slot `entry`. Mount exactly one of: checkout.
+	 * The full checkout surface — order summary with the live quote, promo code entry, the currency the buyer pays in, everything this checkout has to collect from the buyer, the composed payment methods surface, and the pay flow. What it collects is whatever the seller set up (email, their own questions, a phone number, a shipping address for physical goods, an explicit agreement to their terms), rendered together on one screen in the order they chose — so a seller who starts asking for something new needs no change here. Renders the whole purchase; the checkout controller owns the session and the credential. After a payment that needs an off-site step, this same surface renders the outcome the server reports when the buyer comes back.
+	 * Exclusive slot `entry`. Mount exactly one of: checkout | expressCheckout.
 	 */
 	create(name: "checkout", options?: CheckoutElementCreateOptions): CheckoutElementHandle;
+	/**
+	 * One-press Apple Pay and Google Pay buttons for a checkout — the OS payment sheet collects whatever the session still needs (the buyer's email, a shipping address for physical goods, a promo code where the seller offers entry) and one press finishes the purchase. It shares the checkout's entry slot with the full checkout element, so a handle mounts exactly one of the two: this button alone where the purchase is simple enough for a sheet to finish, or the full checkout surface for everything else. Renders only the wallets the buyer's device can actually pay with, using the served button art, and renders nothing where no wallet is available. A checkout the sheet cannot honestly finish — a waitlist join, a transfer, a form question only a page can ask — refuses loudly instead of rendering a doomed button.
+	 * Exclusive slot `entry`. Mount exactly one of: checkout | expressCheckout.
+	 */
+	create(name: "expressCheckout", options?: ExpressCheckoutElementCreateOptions): ExpressCheckoutElementHandle;
 	/**
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
 	update(options: Partial<CheckoutOptions>): 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/index.d.cts

@@ -16,7 +16,7 @@ export interface Whop {
 	 */
 	payments: { create(options: PaymentsOptions): PaymentsHandle } & PaymentsStatics;
 	/**
-	 * Drives a full hosted checkout for one plan — price summary, promo codes, the currency the buyer pays in, and the whole payment collection surface (the payments elements, composed inside) — against the Whop checkout sessions API. Mount it with a `plan` and the element opens the checkout session itself; the session credential never leaves the element. The buyer pays inside the element, and a finished checkout redirects the current tab to `returnUrl`, including the page that contains the element. Fulfill from webhooks rather than a browser callback. Without a `returnUrl`, the buyer rests on the element’s own success face. The element automatically drives an off-site payment step, such as 3DS or a bank page. On whop.com, it brings the buyer back into the restored checkout; in an embed, the buyer returns to the same `returnUrl`. A failed payment reopens the same checkout with the reason shown, so the buyer can pay again. Every option is set at creation: the element mints a checkout session from these values when it mounts. Changing one later with `update()` or new React props fails instead of changing the existing order. Mount a new checkout to change the purchase.
+	 * Drives a full hosted checkout for one plan — price summary, promo codes, the currency the buyer pays in, and the whole payment collection surface (the payments elements, composed inside) — against the Whop checkout sessions API. Mount it with a `plan` (or a `checkoutConfiguration` you authored) and the element opens the checkout session itself; the session credential never leaves the element. The buyer pays inside the element, and a finished checkout redirects the current tab to `returnUrl`, including the page that contains the element. Fulfill from webhooks rather than a browser callback. Without a `returnUrl`, the buyer rests on the element’s own success face. The element automatically drives an off-site payment step, such as 3DS or a bank page. On whop.com, it brings the buyer back into the restored checkout; in an embed, the buyer returns to the same `returnUrl`. A failed payment reopens the same checkout with the reason shown, so the buyer can pay again. Every option is set at creation: the element mints a checkout session from these values when it mounts. Changing one later with `update()` or new React props fails instead of changing the existing order. Mount a new checkout to change the purchase.
 	 */
 	checkout: { create(options: CheckoutOptions): CheckoutHandle } & CheckoutStatics;
 	/**

package/index.d.ts

@@ -16,7 +16,7 @@ export interface Whop {
 	 */
 	payments: { create(options: PaymentsOptions): PaymentsHandle } & PaymentsStatics;
 	/**
-	 * Drives a full hosted checkout for one plan — price summary, promo codes, the currency the buyer pays in, and the whole payment collection surface (the payments elements, composed inside) — against the Whop checkout sessions API. Mount it with a `plan` and the element opens the checkout session itself; the session credential never leaves the element. The buyer pays inside the element, and a finished checkout redirects the current tab to `returnUrl`, including the page that contains the element. Fulfill from webhooks rather than a browser callback. Without a `returnUrl`, the buyer rests on the element’s own success face. The element automatically drives an off-site payment step, such as 3DS or a bank page. On whop.com, it brings the buyer back into the restored checkout; in an embed, the buyer returns to the same `returnUrl`. A failed payment reopens the same checkout with the reason shown, so the buyer can pay again. Every option is set at creation: the element mints a checkout session from these values when it mounts. Changing one later with `update()` or new React props fails instead of changing the existing order. Mount a new checkout to change the purchase.
+	 * Drives a full hosted checkout for one plan — price summary, promo codes, the currency the buyer pays in, and the whole payment collection surface (the payments elements, composed inside) — against the Whop checkout sessions API. Mount it with a `plan` (or a `checkoutConfiguration` you authored) and the element opens the checkout session itself; the session credential never leaves the element. The buyer pays inside the element, and a finished checkout redirects the current tab to `returnUrl`, including the page that contains the element. Fulfill from webhooks rather than a browser callback. Without a `returnUrl`, the buyer rests on the element’s own success face. The element automatically drives an off-site payment step, such as 3DS or a bank page. On whop.com, it brings the buyer back into the restored checkout; in an embed, the buyer returns to the same `returnUrl`. A failed payment reopens the same checkout with the reason shown, so the buyer can pay again. Every option is set at creation: the element mints a checkout session from these values when it mounts. Changing one later with `update()` or new React props fails instead of changing the existing order. Mount a new checkout to change the purchase.
 	 */
 	checkout: { create(options: CheckoutOptions): CheckoutHandle } & CheckoutStatics;
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@whop/elements",
-	"version": "1.0.0-beta.0",
+	"version": "1.0.0-beta.1",
 	"description": "Whop Elements — vanilla-js loader + types. Loads the hosted SDK and exposes the typed WhopElements factory.",
 	"keywords": [
 		"checkout",
@@ -81,5 +81,5 @@
 			}
 		}
 	},
-	"whopElementsApiHash": "6f00c3f1ef717575e3e56a392ace6dafc99c13d33b1dea86f12206ccdd4496a6"
+	"whopElementsApiHash": "31ffc5bac2c4d883453f2e655b2c659c727d500b41c4cfae65e66e08988a9424"
 }

package/payments.d.cts

@@ -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,11 +240,6 @@ 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
@@ -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
@@ -693,10 +754,6 @@ export interface CardFieldsSubOptions {
 	 * 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.
 	 */
 	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);
 }
 
 /**
@@ -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. Required — the other payments elements stay in their loading state until it is mounted, and payments cannot be confirmed without it.
+	 */
+	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/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,11 +240,6 @@ 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
@@ -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
@@ -693,10 +754,6 @@ export interface CardFieldsSubOptions {
 	 * 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.
 	 */
 	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);
 }
 
 /**
@@ -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. Required — the other payments elements stay in their loading state until it is mounted, and payments cannot be confirmed without it.
+	 */
+	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 })`.
 	 */
@@ -357,6 +361,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 +477,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 +598,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 +730,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 +786,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 +845,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 +880,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 +902,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 +1137,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.
 	 */
@@ -1209,6 +1226,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;
 }
 
 /**

package/wallet.d.ts

@@ -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 })`.
 	 */
@@ -357,6 +361,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 +477,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 +598,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 +730,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 +786,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 +845,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 +880,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 +902,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 +1137,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.
 	 */
@@ -1209,6 +1226,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;
 }
 
 /**

package/websites.d.cts

@@ -62,6 +62,10 @@ export interface WebsitesOptions {
 	 * 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 })`.
 	 */
@@ -339,6 +343,10 @@ export interface WebsitesHandle {
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
 	update(options: Partial<WebsitesOptions>): 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/websites.d.ts

@@ -62,6 +62,10 @@ export interface WebsitesOptions {
 	 * 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 })`.
 	 */
@@ -339,6 +343,10 @@ export interface WebsitesHandle {
 	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
 	 */
 	update(options: Partial<WebsitesOptions>): 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;
 }
 
 /**