@whop/elements 0.0.0 → 1.0.0-beta.0

package/wallet.d.ts

@@ -0,0 +1,1441 @@
+/**
+ * Options for `whop.wallet.create()`: the controller's props plus its `on<Event>` callbacks. In React, these are the `<Wallet>` component's props.
+ * @example
+ * ```ts
+ * import { loadWhop } from "@whop/elements";
+ * 
+ * const whop = (await loadWhop())({ locale: "en" });
+ * const wallet = whop.wallet.create({}); // options: props + on<Event> callbacks
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface WalletOptions {
+	/**
+	 * Three-letter ISO 4217 currency code for amount fields. An unknown code falls back to `usd`.
+	 * @default "usd"
+	 */
+	currency?: string;
+	/**
+	 * Account or user ID whose money these surfaces read. Account IDs are prefixed `biz_`; user IDs are prefixed `user_` and can read only the viewer's own balance.
+	 */
+	accountId: string;
+	/**
+	 * Runs when the grouped loading state changes. The value is `true` while any mounted element is still loading.
+	 */
+	onLoadingChange?: ((loading: boolean) => void);
+	/**
+	 * Visual customization for this group's elements. Overrides the global `WhopElements({ appearance })`. Change it live with `update({ appearance })`.
+	 */
+	appearance?: import("./_framework.js").Appearance;
+	/**
+	 * Locale for this group's element UI text. Set it to one of the app's built locales to override the global configuration. Any other value falls back to the default locale.
+	 */
+	locale?: import("./_framework.js").WhopElementsLocale;
+}
+
+/**
+ * Consumer props for the "activity" element. Set at create (or as `<ActivityElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/activity
+ */
+export interface ActivityElementProps {
+	/**
+	 * Only show activity for this currency. Without it, activity from every currency is shown.
+	 */
+	currency?: string;
+	/**
+	 * A scoped token for the read. An account needs `company:balance:read`, and a user needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * When off, card transaction rows render inert (no click, no hover) instead of firing `activitySelected`. Use it when you know the viewer isn't allowed to see those details.
+	 * @default true
+	 */
+	canOpenCardTransactionDetails?: boolean;
+}
+
+/**
+ * The live handle for a mounted "activity" element. Returned by `create("activity")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/activity
+ */
+export interface ActivityElementHandle {
+	/**
+	 * Re-fetch the account's activity from the first page. Call it after a mutation made elsewhere (a deposit, a send) so the list reflects it without waiting for the cache to expire.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * Set the date filter from outside the element, for example wiring a chart brush selection into the list. Pass `null` to clear it.
+	 */
+	setDateRange: (input: ActivityDateRangeOverride | null) => Promise<void>;
+	/**
+	 * 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<ActivityElementProps>) => void;
+}
+
+/**
+ * Options for `create("activity")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const activity = wallet.create("activity", {}); // this interface: props + on<Event> callbacks
+ * activity.mount("#wallet-activity");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/activity
+ */
+export interface ActivityElementCreateOptions {
+	/**
+	 * Only show activity for this currency. Without it, activity from every currency is shown.
+	 */
+	currency?: string;
+	/**
+	 * A scoped token for the read. An account needs `company:balance:read`, and a user needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * When off, card transaction rows render inert (no click, no hover) instead of firing `activitySelected`. Use it when you know the viewer isn't allowed to see those details.
+	 * @default true
+	 */
+	canOpenCardTransactionDetails?: boolean;
+	/**
+	 * A row was clicked. Open your own detail view or route for it; the element never navigates.
+	 */
+	onActivitySelected?: ((payload: { activity: LedgerActivity; }) => void);
+	/**
+	 * The pointer entered a row, or left one (`null`). Point something of your own at the same moment, like marking the row on a balance chart.
+	 */
+	onActivityHovered?: ((payload: { activity: LedgerActivity; } | null) => void);
+	/**
+	 * The viewer changed the date filter through the filter row rather than through `setDateRange`. Clear any range selection of your own, like a chart brush, that no longer matches.
+	 */
+	onDateRangeChanged?: ((payload: { dateRange: { start: string; end: string; } | null; }) => 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.
+	 * @default ""
+	 */
+	amount?: string;
+	/**
+	 * Offer the crypto rail when the account has a deposit address.
+	 * @default true
+	 */
+	showCrypto?: boolean;
+	/**
+	 * Offer the bank-transfer rail when the account has wire instructions.
+	 * @default true
+	 */
+	showBank?: boolean;
+	/**
+	 * Cards you already hold for this payer, rendered as funding rows. Choosing one emits `cardDepositRequested` with the amount — the element never collects a card payment.
+	 * @default []
+	 */
+	savedCards?: DepositSavedCard[];
+	/**
+	 * Add an "Add card" row that emits `addCardRequested` so you can open your own card-collection flow.
+	 * @default false
+	 */
+	allowNewCard?: boolean;
+	/**
+	 * Offer a "Platform balance" row that emits `platformBalanceSelected` immediately, with no amount step.
+	 * @default false
+	 */
+	showPlatformBalance?: boolean;
+	/**
+	 * Processing fees to preview under the amount when a card row is selected. `percentageFee` is in percentage POINTS (`2.9` is 2.9%); `fixedFee` and `radarFee` are major units (`0.3` is $0.30).
+	 * @default null
+	 */
+	cardFee?: DepositCardFee | null;
+	/**
+	 * Preselect a rail by id (`bank`, `crypto`, `platform_balance`, or a saved card id). Continue stays disabled while that rail is not yet offered, rather than funding through another one.
+	 * @default ""
+	 */
+	preferredMethodId?: string;
+	/**
+	 * Emit `bankSelected` and stay on the amount screen instead of showing the wire fields — for hosts that run their own step (a verification, an onboarding) first. Because that host owns the rail, the row is then offered even before the account has instructions to show.
+	 * @default false
+	 */
+	deferBankToHost?: boolean;
+	/**
+	 * Show an "I have deposited my funds" button on the crypto screen that emits `depositConfirmed`, so you can start watching for the transfer.
+	 * @default false
+	 */
+	confirmCryptoDeposit?: boolean;
+	/**
+	 * Open straight onto a rail instead of the picker. `crypto` and `bank` need no amount; their back button emits `dismissed` because there is no picker behind them.
+	 * @default "amount"
+	 */
+	initialStep?: "amount" | "bank" | "crypto";
+}
+
+/**
+ * The live handle for a mounted "deposit" element. Returned by `create("deposit")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/deposit
+ */
+export interface DepositElementHandle {
+	/**
+	 * Move the element to a screen. `{ step: "amount" }` is how you hand control back after settling a card or platform-balance deposit on your side.
+	 */
+	showStep: (input: { step: "amount" | "bank" | "crypto"; }) => Promise<void>;
+	/**
+	 * Re-resolve the account's funding rails. Call it after anything on your side changes what the account can offer — finishing bank onboarding, for instance — so the new rail appears without waiting for the cache to expire.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * 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<DepositElementProps>) => void;
+}
+
+/**
+ * Options for `create("deposit")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const deposit = wallet.create("deposit", {}); // this interface: props + on<Event> callbacks
+ * deposit.mount("#wallet-deposit");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/deposit
+ */
+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.
+	 * @default ""
+	 */
+	amount?: string;
+	/**
+	 * Offer the crypto rail when the account has a deposit address.
+	 * @default true
+	 */
+	showCrypto?: boolean;
+	/**
+	 * Offer the bank-transfer rail when the account has wire instructions.
+	 * @default true
+	 */
+	showBank?: boolean;
+	/**
+	 * Cards you already hold for this payer, rendered as funding rows. Choosing one emits `cardDepositRequested` with the amount — the element never collects a card payment.
+	 * @default []
+	 */
+	savedCards?: DepositSavedCard[];
+	/**
+	 * Add an "Add card" row that emits `addCardRequested` so you can open your own card-collection flow.
+	 * @default false
+	 */
+	allowNewCard?: boolean;
+	/**
+	 * Offer a "Platform balance" row that emits `platformBalanceSelected` immediately, with no amount step.
+	 * @default false
+	 */
+	showPlatformBalance?: boolean;
+	/**
+	 * Processing fees to preview under the amount when a card row is selected. `percentageFee` is in percentage POINTS (`2.9` is 2.9%); `fixedFee` and `radarFee` are major units (`0.3` is $0.30).
+	 * @default null
+	 */
+	cardFee?: DepositCardFee | null;
+	/**
+	 * Preselect a rail by id (`bank`, `crypto`, `platform_balance`, or a saved card id). Continue stays disabled while that rail is not yet offered, rather than funding through another one.
+	 * @default ""
+	 */
+	preferredMethodId?: string;
+	/**
+	 * Emit `bankSelected` and stay on the amount screen instead of showing the wire fields — for hosts that run their own step (a verification, an onboarding) first. Because that host owns the rail, the row is then offered even before the account has instructions to show.
+	 * @default false
+	 */
+	deferBankToHost?: boolean;
+	/**
+	 * Show an "I have deposited my funds" button on the crypto screen that emits `depositConfirmed`, so you can start watching for the transfer.
+	 * @default false
+	 */
+	confirmCryptoDeposit?: boolean;
+	/**
+	 * Open straight onto a rail instead of the picker. `crypto` and `bank` need no amount; their back button emits `dismissed` because there is no picker behind them.
+	 * @default "amount"
+	 */
+	initialStep?: "amount" | "bank" | "crypto";
+	/**
+	 * The payer confirmed an amount and a rail. Fires for every rail, before any instructions render — the analytics/funnel hook.
+	 */
+	onDepositInitiated?: ((payload: { method: "card" | "bank" | "crypto" | "platform_balance"; amount: number; currency: string; paymentMethodId?: string | undefined; }) => void);
+	/**
+	 * A saved card was chosen. Collect the payment on your side, then call `showStep({ step: "amount" })` to return the element to the picker.
+	 */
+	onCardDepositRequested?: ((payload: { amount: number; currency: string; paymentMethodId: string; }) => void);
+	/**
+	 * The "Add card" row was picked — open your card-collection flow.
+	 */
+	onAddCardRequested?: ((payload: Record<string, never>) => void);
+	/**
+	 * The bank rail was chosen while `deferBankToHost` is set — run your step, then show the fields yourself or call `showStep({ step: "bank" })`.
+	 */
+	onBankSelected?: ((payload: Record<string, never>) => void);
+	/**
+	 * The platform-balance row was picked. It carries no amount — your own screen collects that.
+	 */
+	onPlatformBalanceSelected?: ((payload: Record<string, never>) => void);
+	/**
+	 * The payer said they sent the crypto. `since` is a unix-seconds floor to start matching incoming transfers from (it looks slightly back in time, so a transfer sent moments before the click still matches).
+	 */
+	onDepositConfirmed?: ((payload: { network: string; token: string; networkLabel: string; since: number; }) => void);
+	/**
+	 * The visible screen changed.
+	 */
+	onStepChanged?: ((payload: { step: "amount" | "bank" | "crypto"; }) => void);
+	/**
+	 * The payer backed out of a rail the element was opened directly onto — close the surface holding it.
+	 */
+	onDismissed?: ((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);
+}
+
+/**
+ * The overlay handle for "deposit". Returned by `createOverlay("deposit")`; drives the modal presentation imperatively.
+ * @see https://docs.whop.com/elements/latest/wallet/deposit
+ */
+export interface DepositElementOverlayHandle {
+	/**
+	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 */
+	open(): void;
+	/**
+	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 */
+	close(): 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<DepositElementProps>): void;
+}
+
+/**
+ * Consumer props for the "withdraw" element. Set at create (or as `<WithdrawElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ */
+export interface WithdrawElementProps {
+	/**
+	 * Saved payout methods with quotes for the current amount.
+	 * @default []
+	 */
+	methods?: WithdrawalMethod[];
+	/**
+	 * Settled balance available to standard payout methods.
+	 * @default 0
+	 */
+	availableBalance?: number;
+	/**
+	 * Pending balance that may be available to instant payout methods.
+	 * @default 0
+	 */
+	pendingBalance?: number;
+	/**
+	 * The payout account's ISO 3166-1 alpha-2 country.
+	 * @default "US"
+	 */
+	payoutCountry?: string;
+	/**
+	 * Payout methods available to add in the selected country, including required fields.
+	 * @default []
+	 */
+	supportedMethods?: WithdrawalSupportedMethod[];
+	/**
+	 * Whether supported payout methods are loading for the selected country.
+	 * @default false
+	 */
+	supportedMethodsLoading?: boolean;
+	/**
+	 * Live standard and instant payout limits.
+	 * @default {"standard":{"maxAmount":0},"instant":{"maxAmount":0}}
+	 */
+	limits?: WithdrawalLimits;
+	/**
+	 * Whether payout methods and limits are loading.
+	 * @default false
+	 */
+	loading?: boolean;
+	/**
+	 * Whether the current amount is being repriced.
+	 * @default false
+	 */
+	quoteLoading?: boolean;
+	/**
+	 * Whether a new payout method is being saved.
+	 * @default false
+	 */
+	savingMethod?: boolean;
+	/**
+	 * Whether the confirmed payout is being created.
+	 * @default false
+	 */
+	submitting?: boolean;
+	/**
+	 * A host-side error to show inside the current screen.
+	 * @default ""
+	 */
+	error?: string;
+	/**
+	 * True when the last payout was refused because the bank could not confirm the account holder name. Shows a fix-or-confirm choice; confirming re-emits withdrawalRequested with acknowledgeBankWarning set. Set this back to false when handling each withdrawalRequested — the choice appears on the change to true, so a flag left true hides every later refusal.
+	 * @default false
+	 */
+	bankWarning?: boolean;
+	/**
+	 * The most recently created method, selected when it appears in methods.
+	 * @default ""
+	 */
+	createdMethodId?: string;
+	/**
+	 * Set when the payer backed out of Plaid Link or it failed to open. Unlocks manual entry on a rail that otherwise requires linking.
+	 * @default false
+	 */
+	plaidUnavailable?: boolean;
+	/**
+	 * Whether a bank link is in progress — the Plaid session is open, or the linked method is being saved.
+	 * @default false
+	 */
+	linkingBank?: boolean;
+}
+
+/**
+ * The live handle for a mounted "withdraw" element. Returned by `create("withdraw")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ */
+export interface WithdrawElementHandle {
+	/**
+	 * 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<WithdrawElementProps>) => void;
+}
+
+/**
+ * Options for `create("withdraw")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const withdraw = wallet.create("withdraw", {}); // this interface: props + on<Event> callbacks
+ * withdraw.mount("#wallet-withdraw");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ */
+export interface WithdrawElementCreateOptions {
+	/**
+	 * Saved payout methods with quotes for the current amount.
+	 * @default []
+	 */
+	methods?: WithdrawalMethod[];
+	/**
+	 * Settled balance available to standard payout methods.
+	 * @default 0
+	 */
+	availableBalance?: number;
+	/**
+	 * Pending balance that may be available to instant payout methods.
+	 * @default 0
+	 */
+	pendingBalance?: number;
+	/**
+	 * The payout account's ISO 3166-1 alpha-2 country.
+	 * @default "US"
+	 */
+	payoutCountry?: string;
+	/**
+	 * Payout methods available to add in the selected country, including required fields.
+	 * @default []
+	 */
+	supportedMethods?: WithdrawalSupportedMethod[];
+	/**
+	 * Whether supported payout methods are loading for the selected country.
+	 * @default false
+	 */
+	supportedMethodsLoading?: boolean;
+	/**
+	 * Live standard and instant payout limits.
+	 * @default {"standard":{"maxAmount":0},"instant":{"maxAmount":0}}
+	 */
+	limits?: WithdrawalLimits;
+	/**
+	 * Whether payout methods and limits are loading.
+	 * @default false
+	 */
+	loading?: boolean;
+	/**
+	 * Whether the current amount is being repriced.
+	 * @default false
+	 */
+	quoteLoading?: boolean;
+	/**
+	 * Whether a new payout method is being saved.
+	 * @default false
+	 */
+	savingMethod?: boolean;
+	/**
+	 * Whether the confirmed payout is being created.
+	 * @default false
+	 */
+	submitting?: boolean;
+	/**
+	 * A host-side error to show inside the current screen.
+	 * @default ""
+	 */
+	error?: string;
+	/**
+	 * True when the last payout was refused because the bank could not confirm the account holder name. Shows a fix-or-confirm choice; confirming re-emits withdrawalRequested with acknowledgeBankWarning set. Set this back to false when handling each withdrawalRequested — the choice appears on the change to true, so a flag left true hides every later refusal.
+	 * @default false
+	 */
+	bankWarning?: boolean;
+	/**
+	 * The most recently created method, selected when it appears in methods.
+	 * @default ""
+	 */
+	createdMethodId?: string;
+	/**
+	 * Set when the payer backed out of Plaid Link or it failed to open. Unlocks manual entry on a rail that otherwise requires linking.
+	 * @default false
+	 */
+	plaidUnavailable?: boolean;
+	/**
+	 * Whether a bank link is in progress — the Plaid session is open, or the linked method is being saved.
+	 * @default false
+	 */
+	linkingBank?: boolean;
+	/**
+	 * The amount changed and should be repriced.
+	 */
+	onAmountChanged?: ((payload: { amount: number; }) => void);
+	/**
+	 * The add-method country changed and supported methods should be refreshed.
+	 */
+	onCountryChanged?: ((payload: { country: string; }) => void);
+	/**
+	 * A supported payout method was selected and its exact required fields should be loaded.
+	 */
+	onSupportedMethodChanged?: ((payload: { country: string; supportedPayoutMethodId: string; destinationCurrency: string; }) => void);
+	/**
+	 * The payer submitted the dynamic add-payout-method form.
+	 */
+	onAddMethodRequested?: ((payload: WithdrawalCreateMethodInput) => void);
+	/**
+	 * The payer chose to link their bank through Plaid instead of typing details. Open Plaid Link on receipt.
+	 */
+	onPlaidLinkRequested?: ((payload: { country: string; supportedPayoutMethodId: string; destinationCurrency: string; }) => void);
+	/**
+	 * The newly added payout method finished its verification step.
+	 */
+	onMethodVerificationCompleted?: ((payload: Record<string, never>) => void);
+	/**
+	 * The payer requested to rename a saved payout method.
+	 */
+	onRenameMethodRequested?: ((payload: { methodId: string; }) => void);
+	/**
+	 * The payer requested to remove a saved payout method.
+	 */
+	onRemoveMethodRequested?: ((payload: { methodId: string; }) => void);
+	/**
+	 * The payer confirmed the final payout details. Create the payout on receipt.
+	 */
+	onWithdrawalRequested?: ((payload: WithdrawalRequest) => 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);
+}
+
+/**
+ * The overlay handle for "withdraw". Returned by `createOverlay("withdraw")`; drives the modal presentation imperatively.
+ * @see https://docs.whop.com/elements/latest/wallet/withdraw
+ */
+export interface WithdrawElementOverlayHandle {
+	/**
+	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 */
+	open(): void;
+	/**
+	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 */
+	close(): 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<WithdrawElementProps>): void;
+}
+
+/**
+ * Consumer props for the "send" element. Set at create (or as `<SendElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/send
+ */
+export interface SendElementProps {
+	/**
+	 * A scoped token for the privileged read/write — needs `payout:withdraw_funds` (plus `company:authorized_user:read` and `member:basic:read` for recipient search, `airdrop_link:manage` for claim links). Omitted, the read carries the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Off, only the team/other-account list shows — no search box. For a host that knows the viewer lacks `member:basic:read`.
+	 * @default true
+	 */
+	canSearchRecipients?: boolean;
+	/**
+	 * Off, the "Send via link" row is hidden. For a host that knows the viewer lacks `airdrop_link:manage`.
+	 * @default true
+	 */
+	canCreateLink?: boolean;
+	/**
+	 * Skip the picker and open straight onto this recipient's amount screen — for a "pay this person" action row. No back button is shown in that case, matching there being no picker behind it.
+	 * @default null
+	 */
+	initialRecipient?: SendRecipient | null;
+	/**
+	 * Preselect a currency in the amount screen's picker. Falls back to `currency`, then USD.
+	 * @default ""
+	 */
+	initialCurrency?: string;
+}
+
+/**
+ * The live handle for a mounted "send" element. Returned by `create("send")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/send
+ */
+export interface SendElementHandle {
+	/**
+	 * Re-fetch the account's balances and recipient list. Call it after anything on your side changes what it can offer.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * 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<SendElementProps>) => void;
+}
+
+/**
+ * Options for `create("send")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const send = wallet.create("send", {}); // this interface: props + on<Event> callbacks
+ * send.mount("#wallet-send");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/send
+ */
+export interface SendElementCreateOptions {
+	/**
+	 * A scoped token for the privileged read/write — needs `payout:withdraw_funds` (plus `company:authorized_user:read` and `member:basic:read` for recipient search, `airdrop_link:manage` for claim links). Omitted, the read carries the viewer's own session, which only answers same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * Off, only the team/other-account list shows — no search box. For a host that knows the viewer lacks `member:basic:read`.
+	 * @default true
+	 */
+	canSearchRecipients?: boolean;
+	/**
+	 * Off, the "Send via link" row is hidden. For a host that knows the viewer lacks `airdrop_link:manage`.
+	 * @default true
+	 */
+	canCreateLink?: boolean;
+	/**
+	 * Skip the picker and open straight onto this recipient's amount screen — for a "pay this person" action row. No back button is shown in that case, matching there being no picker behind it.
+	 * @default null
+	 */
+	initialRecipient?: SendRecipient | null;
+	/**
+	 * Preselect a currency in the amount screen's picker. Falls back to `currency`, then USD.
+	 * @default ""
+	 */
+	initialCurrency?: string;
+	/**
+	 * The visible screen changed.
+	 */
+	onStepChanged?: ((payload: { step: "enter_amount" | "select_recipient" | "create_link" | "link_success" | "success"; }) => void);
+	/**
+	 * A transfer succeeded. Refresh anything on your side reading the account's balance or activity.
+	 */
+	onSendCompleted?: ((payload: { recipient: SendRecipient; amount: number; currency: string; }) => void);
+	/**
+	 * A claim link was created. Refresh anything on your side reading the account's balance.
+	 */
+	onLinkCreated?: ((payload: { claimUrl: string; amount: number; redeemableCount: number; }) => void);
+	/**
+	 * The viewer clicked "Done" on a success screen — close the surface holding it.
+	 */
+	onDone?: ((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);
+}
+
+/**
+ * The overlay handle for "send". Returned by `createOverlay("send")`; drives the modal presentation imperatively.
+ * @see https://docs.whop.com/elements/latest/wallet/send
+ */
+export interface SendElementOverlayHandle {
+	/**
+	 * Open the overlay. The first call mounts the element. Later calls reuse it.
+	 */
+	open(): void;
+	/**
+	 * Close the overlay without destroying it. Keep the handle and `open()` again.
+	 */
+	close(): 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<SendElementProps>): void;
+}
+
+/**
+ * Consumer props for the "cards" element. Set at create (or as `<CardsElement />` JSX props), and updatable live via `update()`.
+ * @see https://docs.whop.com/elements/latest/wallet/cards
+ */
+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.
+	 */
+	accessToken?: string;
+	/**
+	 * Off, the element fetches nothing and keeps the title and "+" button visible with an empty body — for a host that only wants to fetch once some precondition (card issuing being active for this account, say) is true.
+	 * @default true
+	 */
+	enabled?: boolean;
+	/**
+	 * Cap the rows shown, most recently issued first. `null` shows every active card.
+	 * @default null
+	 */
+	limit?: number | null;
+	/**
+	 * Render the title as plain, unclickable text instead of a click target. Off by default, in which case clicking the title emits `viewAllSelected` for you to route to the full cards list — the element never navigates.
+	 * @default false
+	 */
+	disableRedirect?: boolean;
+	/**
+	 * Hide the "+" button. Off by default, in which case clicking it emits `addCardRequested`.
+	 * @default false
+	 */
+	hideAddButton?: boolean;
+}
+
+/**
+ * The live handle for a mounted "cards" element. Returned by `create("cards")`; in React, the component's `ref`.
+ * @see https://docs.whop.com/elements/latest/wallet/cards
+ */
+export interface CardsElementHandle {
+	/**
+	 * Re-fetch the account's cards. Call it after a mutation made elsewhere (rename, freeze, cancel, a new card) so the list reflects it without waiting for the cache to expire.
+	 */
+	refresh: () => Promise<void>;
+	/**
+	 * 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<CardsElementProps>) => void;
+}
+
+/**
+ * Options for `create("cards")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @example
+ * ```ts
+ * const cards = wallet.create("cards", {}); // this interface: props + on<Event> callbacks
+ * cards.mount("#wallet-cards");
+ * ```
+ * @see https://docs.whop.com/elements/latest/wallet/cards
+ */
+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.
+	 */
+	accessToken?: string;
+	/**
+	 * Off, the element fetches nothing and keeps the title and "+" button visible with an empty body — for a host that only wants to fetch once some precondition (card issuing being active for this account, say) is true.
+	 * @default true
+	 */
+	enabled?: boolean;
+	/**
+	 * Cap the rows shown, most recently issued first. `null` shows every active card.
+	 * @default null
+	 */
+	limit?: number | null;
+	/**
+	 * Render the title as plain, unclickable text instead of a click target. Off by default, in which case clicking the title emits `viewAllSelected` for you to route to the full cards list — the element never navigates.
+	 * @default false
+	 */
+	disableRedirect?: boolean;
+	/**
+	 * Hide the "+" button. Off by default, in which case clicking it emits `addCardRequested`.
+	 * @default false
+	 */
+	hideAddButton?: boolean;
+	/**
+	 * A card row was clicked. Open your own card details for it — the element never navigates.
+	 */
+	onCardSelected?: ((payload: { cardId: string; }) => void);
+	/**
+	 * The title was clicked. Only fires when `disableRedirect` is false.
+	 */
+	onViewAllSelected?: ((payload: Record<string, never>) => void);
+	/**
+	 * The "+" button was clicked. Only fires when `hideAddButton` is false.
+	 */
+	onAddCardRequested?: ((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 "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);
+}
+
+/**
+ * Consumer props for the "balances" sub-controller's "balance" element.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BalanceElementProps {
+	/**
+	 * A scoped token for the reads. An account needs `company:balance:read` for the total and `stats:read` for the chart; a user's own balance needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`, and set a fresh one before it expires. Without it the reads use the viewer's own session, which only works same-origin.
+	 * @default ""
+	 */
+	accessToken?: string;
+	/**
+	 * The time range to open on. The buttons change it from there, or set this prop again to control it yourself.
+	 * @default "1M"
+	 */
+	range?: "1D" | "1W" | "1M" | "1Y" | "ALL";
+	/**
+	 * When the account was opened, as an ISO 8601 timestamp. `ALL` starts here instead of at its five-year default, so an account older than that keeps its full history.
+	 * @default ""
+	 */
+	openedAt?: string;
+	/**
+	 * Adds the account name to the label: `Total balance · Acme` normally, and `Acme balance on Jul 9` while the viewer reads a point. Without it the label is just `Total balance`.
+	 * @default ""
+	 */
+	accountName?: string;
+	/**
+	 * The selected range on the chart, as ISO 8601 timestamps. Set it to control the selection yourself, or `null` to clear the one the viewer made. Echo back what `rangeBrushed` reports, and clearing a filter elsewhere on your page clears the selection here too.
+	 * @default null
+	 */
+	brush?: { from: string; to: string; } | null;
+	/**
+	 * A moment to mark on the chart, as an ISO 8601 timestamp — the point something else on your page is pointing at, like the row under the pointer in an activity list. It reads like the viewer hovering that point themselves, and is ignored when it falls outside the window on screen or when they are reading the chart.
+	 * @default ""
+	 */
+	markedAt?: string;
+	/**
+	 * For a user, total their own money plus every account they own instead of their own money alone. Ignored for an account, which is a single account already.
+	 * @default false
+	 */
+	includeOwnedAccounts?: boolean;
+	/**
+	 * Hide the total and its change, leaving the chart and the range buttons.
+	 * @default false
+	 */
+	hideTotal?: boolean;
+	/**
+	 * Hide the chart, leaving the total and the range buttons.
+	 * @default false
+	 */
+	hideChart?: boolean;
+	/**
+	 * How tall the chart is drawn, in pixels.
+	 * @default 210
+	 */
+	height?: number;
+}
+
+/**
+ * The live handle for a mounted "balance" element. Returned by the "balances" sub handle's `create("balance")`.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BalanceElementHandle {
+	/**
+	 * 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<BalanceElementProps>) => void;
+}
+
+/**
+ * Options for the "balances" sub handle's `create("balance")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BalanceElementCreateOptions {
+	/**
+	 * A scoped token for the reads. An account needs `company:balance:read` for the total and `stats:read` for the chart; a user's own balance needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`, and set a fresh one before it expires. Without it the reads use the viewer's own session, which only works same-origin.
+	 * @default ""
+	 */
+	accessToken?: string;
+	/**
+	 * The time range to open on. The buttons change it from there, or set this prop again to control it yourself.
+	 * @default "1M"
+	 */
+	range?: "1D" | "1W" | "1M" | "1Y" | "ALL";
+	/**
+	 * When the account was opened, as an ISO 8601 timestamp. `ALL` starts here instead of at its five-year default, so an account older than that keeps its full history.
+	 * @default ""
+	 */
+	openedAt?: string;
+	/**
+	 * Adds the account name to the label: `Total balance · Acme` normally, and `Acme balance on Jul 9` while the viewer reads a point. Without it the label is just `Total balance`.
+	 * @default ""
+	 */
+	accountName?: string;
+	/**
+	 * The selected range on the chart, as ISO 8601 timestamps. Set it to control the selection yourself, or `null` to clear the one the viewer made. Echo back what `rangeBrushed` reports, and clearing a filter elsewhere on your page clears the selection here too.
+	 * @default null
+	 */
+	brush?: { from: string; to: string; } | null;
+	/**
+	 * A moment to mark on the chart, as an ISO 8601 timestamp — the point something else on your page is pointing at, like the row under the pointer in an activity list. It reads like the viewer hovering that point themselves, and is ignored when it falls outside the window on screen or when they are reading the chart.
+	 * @default ""
+	 */
+	markedAt?: string;
+	/**
+	 * For a user, total their own money plus every account they own instead of their own money alone. Ignored for an account, which is a single account already.
+	 * @default false
+	 */
+	includeOwnedAccounts?: boolean;
+	/**
+	 * Hide the total and its change, leaving the chart and the range buttons.
+	 * @default false
+	 */
+	hideTotal?: boolean;
+	/**
+	 * Hide the chart, leaving the total and the range buttons.
+	 * @default false
+	 */
+	hideChart?: boolean;
+	/**
+	 * How tall the chart is drawn, in pixels.
+	 * @default 210
+	 */
+	height?: number;
+	/**
+	 * The visible time range changed. Mirror it if something else on your page reads the same period.
+	 */
+	onRangeChanged?: ((payload: { range: "1D" | "1W" | "1M" | "1Y" | "ALL"; }) => void);
+	/**
+	 * The viewer dragged across the chart to select a range, or cleared the selection (`null`). Gives ISO 8601 timestamps plus the range they were read in, so you can filter your own views, like an activity list or a table, to the same period.
+	 */
+	onRangeBrushed?: ((payload: { from: string; to: string; range: "1D" | "1W" | "1M" | "1Y" | "ALL"; } | null) => 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 "balances" sub-controller's "list" element.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface ListElementProps {
+	/**
+	 * A scoped token for the read. An account needs `company:balance:read`; a user's holdings or owned-account list needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * For a user's `user_…` account, list their personal balance followed by every owned account the backend returns instead of listing the holdings inside their personal account. Ignored for an account.
+	 * @default false
+	 */
+	includeOwnedAccounts?: boolean;
+	/**
+	 * Show each row in the currency it is held in (€4.20, 0.00000009 cbBTC) and put the dollar value underneath. Off by default, so every row is in dollars.
+	 * @default false
+	 */
+	showSourceCurrency?: boolean;
+	/**
+	 * Keep the dollar value under a holding shown in its own currency. Only applies when `showSourceCurrency` is on.
+	 * @default true
+	 */
+	showUsdEquivalent?: boolean;
+	/**
+	 * Keep the personal row when `includeOwnedAccounts` is on. Turn it off if your app has no personal account to open.
+	 * @default true
+	 */
+	showPersonalAccount?: boolean;
+}
+
+/**
+ * The live handle for a mounted "list" element. Returned by the "balances" sub handle's `create("list")`.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface ListElementHandle {
+	/**
+	 * 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<ListElementProps>) => void;
+}
+
+/**
+ * Options for the "balances" sub handle's `create("list")`: the consumer props plus event callbacks and lifecycle hooks.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface ListElementCreateOptions {
+	/**
+	 * A scoped token for the read. An account needs `company:balance:read`; a user's holdings or owned-account list needs `user:balance:read`. Mint it on your server with `POST /api/v1/access_tokens`. Without it the read uses the viewer's own session, which only works same-origin.
+	 */
+	accessToken?: string;
+	/**
+	 * For a user's `user_…` account, list their personal balance followed by every owned account the backend returns instead of listing the holdings inside their personal account. Ignored for an account.
+	 * @default false
+	 */
+	includeOwnedAccounts?: boolean;
+	/**
+	 * Show each row in the currency it is held in (€4.20, 0.00000009 cbBTC) and put the dollar value underneath. Off by default, so every row is in dollars.
+	 * @default false
+	 */
+	showSourceCurrency?: boolean;
+	/**
+	 * Keep the dollar value under a holding shown in its own currency. Only applies when `showSourceCurrency` is on.
+	 * @default true
+	 */
+	showUsdEquivalent?: boolean;
+	/**
+	 * Keep the personal row when `includeOwnedAccounts` is on. Turn it off if your app has no personal account to open.
+	 * @default true
+	 */
+	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.
+	 */
+	onBalanceSelected?: ((payload: { key: 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.
+	 */
+	onAccountSelected?: ((payload: { accountId: string; kind: "personal" | "business"; }) => 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);
+}
+
+/**
+ * The "balances" sub-handle, minted by `handle.create("balances", …)`. Mounts the sub-controller's elements and carries its actions.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface BalancesSubHandle {
+	/**
+	 * An account's balance and a chart of how it changed. The total and its change sit at the top, the chart below that, and the time range buttons at the bottom. The viewer can read individual points on the chart and switch the time range themselves.
+	 */
+	create(name: "balance", options?: BalanceElementCreateOptions): BalanceElementHandle;
+	/**
+	 * The holdings behind an account's balance. Every currency and token gets its own row, showing its name and its value in dollars, largest first. Rows can report which one the viewer tapped, so you can open your own screen for it.
+	 */
+	create(name: "list", options?: ListElementCreateOptions): ListElementHandle;
+	/**
+	 * Merges new props and callbacks into the sub-controller.
+	 */
+	update(options: Partial<BalancesSubOptions>): void;
+	/**
+	 * Destroys the sub-controller and its elements, then frees its exclusive slot. A later `create("balances")` starts fresh.
+	 */
+	destroy(): void;
+}
+
+/**
+ * The Wallet handle, returned by `whop.wallet.create()` (React: `useWallet()`). Mounts the elements and carries the controller's actions.
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+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;
+	/**
+	 * 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.
+	 */
+	create(name: "deposit", options?: DepositElementCreateOptions): DepositElementHandle;
+	/**
+	 * 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.
+	 */
+	createOverlay(name: "deposit", options?: DepositElementCreateOptions): DepositElementOverlayHandle;
+	/**
+	 * Collects a payout amount and saved payout method, groups standard and instant delivery choices with live fees and arrival estimates, collects a new payout method when needed, and presents a confirmation screen before emitting the final payout request.
+	 */
+	create(name: "withdraw", options?: WithdrawElementCreateOptions): WithdrawElementHandle;
+	/**
+	 * Collects a payout amount and saved payout method, groups standard and instant delivery choices with live fees and arrival estimates, collects a new payout method when needed, and presents a confirmation screen before emitting the final payout request.
+	 */
+	createOverlay(name: "withdraw", options?: WithdrawElementCreateOptions): WithdrawElementOverlayHandle;
+	/**
+	 * Sends money from an account to a recipient — a user, another account, or a public claim link anyone can redeem. Renders its own recipient search resolved from the account ID with no credentials beyond the account's own token. Needs an `accessToken` scoped to `payout:withdraw_funds`; account recipient search additionally needs `company:authorized_user:read` and `member:basic:read`, and account claim links need `airdrop_link:manage` — a host without one of those scopes should turn off the matching prop rather than leave a row that will 403.
+	 */
+	create(name: "send", options?: SendElementCreateOptions): SendElementHandle;
+	/**
+	 * Sends money from an account to a recipient — a user, another account, or a public claim link anyone can redeem. Renders its own recipient search resolved from the account ID with no credentials beyond the account's own token. Needs an `accessToken` scoped to `payout:withdraw_funds`; account recipient search additionally needs `company:authorized_user:read` and `member:basic:read`, and account claim links need `airdrop_link:manage` — a host without one of those scopes should turn off the matching prop rather than leave a row that will 403.
+	 */
+	createOverlay(name: "send", options?: SendElementCreateOptions): SendElementOverlayHandle;
+	/**
+	 * Lists the account's active issued cards, most recently issued first. Needs an `accessToken`. The title and rows are click targets that emit events instead of navigating — a host wires up its own routing and card-detail UI.
+	 */
+	create(name: "cards", options?: CardsElementCreateOptions): CardsElementHandle;
+	/**
+	 * Two views of an account's money. The balance view shows the total, a chart of how it changed, and a picker for the time range. The list view shows the holdings that make up that total, valued in dollars.
+	 */
+	create(name: "balances", options?: BalancesSubOptions): BalancesSubHandle;
+	/**
+	 * Merges new handle options into every mounted element. In React, change the namespace props instead.
+	 */
+	update(options: Partial<WalletOptions>): void;
+}
+
+/**
+ * Wallet's static actions, callable with nothing mounted: `whop.wallet.<method>()` (React: `useWhop().wallet.<method>()`).
+ * @see https://docs.whop.com/elements/latest/wallet/overview
+ */
+export interface WalletStatics {}
+
+/**
+ * Declared from the app's `ActivityDateRangeOverride`, referenced by a host-capability surface.
+ */
+export interface ActivityDateRangeOverride {
+	start: string;
+	end: string;
+	includeTime?: boolean | undefined;
+	postedAfter?: string | undefined;
+	postedBefore?: string | undefined;
+	displayPostedAfter?: string | undefined;
+	displayPostedBefore?: string | undefined;
+}
+
+/**
+ * Declared from the app's `LedgerActivity`, referenced by a host-capability surface.
+ */
+export interface LedgerActivity {
+	object: "ledger_activity";
+	/**
+	 * Ledger activity ID.
+	 */
+	id: string;
+	/**
+	 * 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";
+	/**
+	 * Signed amount in the currency's smallest precision units.
+	 */
+	amount: string;
+	/**
+	 * Currency for this ledger activity.
+	 */
+	currency: { code: string; precision: string; };
+	/**
+	 * When the activity posted to the ledger.
+	 */
+	posted_at: string;
+	/**
+	 * ISO 8601 timestamp these funds became (or are scheduled to become) withdrawable: the posted time for already-settled funds, or 00:00:00 UTC on the scheduled release date for pending funds. Present only on inflows entering the balance (payments, top-ups, incoming transfers/affiliate); null on withdrawals, refunds, disputes and on-chain rows. The available_after/before filters window on its UTC settlement date.
+	 */
+	available_at: string | null;
+	/**
+	 * When the activity record was created.
+	 */
+	created_at: string | null;
+	/**
+	 * Resource associated with this ledger activity.
+	 */
+	resource: { object: "account"; id: string; title: string | null; route: string | null; logo_url: string | null; } | { object: "user"; id: string; name: string | null; username: string | null; profile_picture_url: string | null; } | { object: "bounty"; id: string; title: string; status: string; } | { object: "ledger_account"; id: string; owner: { object: "account"; id: string; title: string | null; route: string | null; logo_url: string | null; } | { object: "user"; id: string; name: string | null; username: string | null; profile_picture_url: string | null; } | null; } | { object: "payment_method"; id: string; payment_method_type: string | null; gateway_type: string | null; card: { brand: string | null; last4: string | null; exp_month: number | null; exp_year: number | null; } | null; bank: { bank_name: string | null; account_name: string | null; last4: string | null; account_type: string | null; } | null; email_identifier: string | null; } | { object: "payout_method"; id: string; nickname: string | null; institution_name: string | null; account_reference: string | null; provider: string | null; destination_currency_code: string | null; } | { object: "card_transaction"; id: string; card_id: string | null; merchant_name: string | null; merchant_icon_url: string | null; merchant_category: string | null; status: string | null; usd_amount: string | null; local_amount: string | null; local_currency: string | null; cashback_usd: string | null; authorized_at: string | null; posted_at: string | null; declined_reason: string | null; } | null;
+	/**
+	 * 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;
+	/**
+	 * The viewer account that owns this row's ledger. Present only when the response aggregates owned accounts (include_owned_accounts=true); omitted otherwise.
+	 */
+	account?: { object: "account"; id: string; title: string | null; route: string | null; logo_url: string | null; } | { object: "user"; id: string; name: string | null; username: string | null; profile_picture_url: string | null; } | undefined;
+	/**
+	 * The ledger account (a ldgr_ identifier) this row belongs to. Present only when the response aggregates owned accounts (include_owned_accounts=true); omitted otherwise. Pair it with `account` to scope drawers and dashboard links to the owning business.
+	 */
+	ledger_account_id?: string | null | undefined;
+}
+
+/**
+ * A card the consumer already holds for this account — the element renders it as a funding row and hands the choice back through `cardDepositRequested`; it never collects a card payment itself.
+ * Declared from the app's `DepositSavedCard`, referenced by a host-capability surface.
+ */
+export interface DepositSavedCard {
+	/**
+	 * Payment-method ID echoed back in `cardDepositRequested`.
+	 */
+	id: string;
+	/**
+	 * Row label, for example, `Visa •••• 4242`.
+	 */
+	label: string;
+	/**
+	 * Brand key used to pick the row icon — `visa`, `mastercard`, `amex`, `discover`, `jcb`.
+	 */
+	cardBrand?: string | null | undefined;
+}
+
+/**
+ * Declared from the app's `DepositCardFee`, referenced by a host-capability surface.
+ */
+export interface DepositCardFee {
+	/**
+	 * Percentage POINTS, not a fraction: `2.9` means 2.9%.
+	 */
+	percentageFee: number;
+	/**
+	 * Flat fee in major units: `0.3` means $0.30.
+	 */
+	fixedFee: number;
+	/**
+	 * Fraud-screening fee in major units.
+	 */
+	radarFee: number;
+}
+
+/**
+ * Declared from the app's `WithdrawalQuoteSpeed`, referenced by a host-capability surface.
+ */
+export interface WithdrawalQuoteSpeed {
+	estimatedArrival?: string | null | undefined;
+	fee: number;
+	totalReceived: number;
+	currency?: string | undefined;
+	destinationCurrency?: string | undefined;
+	exchangeRate?: number | undefined;
+	minLimit?: number | undefined;
+	maxLimit?: number | null | undefined;
+}
+
+/**
+ * Declared from the app's `WithdrawalQuote`, referenced by a host-capability surface.
+ */
+export interface WithdrawalQuote {
+	amount: number;
+	currency: string;
+	destinationCurrency: string;
+	exchangeRate: number;
+	minLimit: number;
+	maxLimit?: number | null | undefined;
+	standard?: WithdrawalQuoteSpeed | null | undefined;
+	instant?: WithdrawalQuoteSpeed | null | undefined;
+}
+
+/**
+ * Declared from the app's `WithdrawalMethod`, referenced by a host-capability surface.
+ */
+export interface WithdrawalMethod {
+	id: string;
+	nickname?: string | null | undefined;
+	accountReference?: string | null | undefined;
+	payerName?: string | null | undefined;
+	destinationCurrency: string;
+	isDefault: boolean;
+	iconUrl?: string | null | undefined;
+	deliveryType: string;
+	supportsStandard: boolean;
+	supportsInstant: boolean;
+	bankVerificationState?: string | null | undefined;
+	unavailableReason?: string | null | undefined;
+	feeStructure?: { percentage: number; fixedAmount: number; currency: string; } | null | undefined;
+	standardEstimatedArrival?: string | null | undefined;
+	instantEstimatedArrival?: string | null | undefined;
+	quote?: WithdrawalQuote | null | undefined;
+}
+
+/**
+ * Declared from the app's `WithdrawalRequiredField`, referenced by a host-capability surface.
+ */
+export interface WithdrawalRequiredField {
+	id: string;
+	label: string;
+	inputType: string;
+	required: boolean;
+	sensitive: boolean;
+	placeholder?: string | null | undefined;
+	validation?: string | null | undefined;
+	options?: string[] | null | undefined;
+}
+
+/**
+ * Declared from the app's `WithdrawalSupportedMethod`, referenced by a host-capability surface.
+ */
+export interface WithdrawalSupportedMethod {
+	id: string;
+	name?: string | null | undefined;
+	iconUrl?: string | null | undefined;
+	deliveryType: string;
+	supportsStandard: boolean;
+	supportsInstant: boolean;
+	supportsPlaid?: boolean | undefined;
+	quotes: WithdrawalQuote[];
+	requiredFields: WithdrawalRequiredField[];
+}
+
+/**
+ * Declared from the app's `WithdrawalLimits`, referenced by a host-capability surface.
+ */
+export interface WithdrawalLimits {
+	standard: { maxAmount: number; errorMessage?: string | null | undefined; };
+	instant: { maxAmount: number; dailyAmountRemaining?: number | null | undefined; errorMessage?: string | null | undefined; };
+}
+
+/**
+ * Declared from the app's `WithdrawalCreateMethodInput`, referenced by a host-capability surface.
+ */
+export interface WithdrawalCreateMethodInput {
+	country: string;
+	supportedPayoutMethodId: string;
+	destinationCurrency: string;
+	nickname: string;
+	fields: Record<string, string>;
+}
+
+/**
+ * Declared from the app's `WithdrawalRequest`, referenced by a host-capability surface.
+ */
+export interface WithdrawalRequest {
+	amount: number;
+	currency: string;
+	payoutMethodId: string;
+	presentedFee: number;
+	speed: "standard" | "instant";
+	notes?: string | undefined;
+	acknowledgeBankWarning?: boolean | undefined;
+}
+
+/**
+ * Declared from the app's `SendRecipient`, referenced by a host-capability surface.
+ */
+export interface SendRecipient {
+	id: string;
+	name: string | null;
+	username: string | null;
+	profilePicUrl: string | null;
+	kind: "business" | "user" | "email";
+}