@evervault/js 2.20.0 → 2.23.0

package/dist/evervault.d.ts

@@ -1,5 +1,18 @@
 import { nodeEvents } from 'node:events';
 
+declare interface AgentToolsConfig {
+    enabled: boolean;
+    namePrefix?: string;
+    productName?: string;
+    exposeTo?: string[];
+}
+
+declare interface AgentToolsFrameConfig {
+    namePrefix: string;
+    productName: string;
+    exposeTo: string[];
+}
+
 declare class ApplePayButton {
     #private;
     client: EvervaultClient;
@@ -146,6 +159,24 @@ declare interface ApplePayCardEnrichment {
 
 declare type ApplePayCardNetwork = "amex" | "bancomat" | "bancontact" | "cartesBancaires" | "chinaUnionPay" | "dankort" | "discover" | "eftpos" | "electron" | "elo" | "girocard" | "interac" | "jcb" | "mada" | "maestro" | "masterCard" | "mir" | "privateLabel" | "visa" | "vPay";
 
+/** Shape of Apple Pay's native billing/shipping contact, as passed through unmodified. */
+declare interface ApplePayContact {
+    givenName?: string;
+    familyName?: string;
+    phoneticGivenName?: string;
+    phoneticFamilyName?: string;
+    emailAddress?: string;
+    phoneNumber?: string;
+    addressLines?: string[];
+    subLocality?: string;
+    locality?: string;
+    postalCode?: string;
+    subAdministrativeArea?: string;
+    administrativeArea?: string;
+    country?: string;
+    countryCode?: string;
+}
+
 /** Maps to ApplePayErrorCode values for coupon validation on the sheet. */
 declare type ApplePayCouponCodeErrorCode = "couponCodeInvalid" | "couponCodeExpired";
 
@@ -224,43 +255,17 @@ declare interface CageKey {
 
 declare class Card {
     #private;
-    values: CardPayload;
     constructor(client: EvervaultClient, options?: CardOptions);
-    get config(): {
-        theme: ThemeDefinition | undefined;
-        config: {
-            icons: boolean | Partial< CardIcons> | undefined;
-            autoFocus: boolean | undefined;
-            translations: Partial< CardTranslations> | undefined;
-            hiddenFields: string;
-            fields: CardField[] | undefined;
-            acceptedBrands: CardBrandName[] | undefined;
-            customBrands: CustomBrand[] | undefined;
-            defaultValues: {
-                name?: string;
-            } | undefined;
-            autoComplete: {
-                name?: boolean;
-                number?: boolean;
-                expiry?: boolean;
-                cvc?: boolean;
-            } | undefined;
-            autoProgress: boolean | undefined;
-            redactCVC: boolean | undefined;
-            allow3DigitAmexCVC: boolean | undefined;
-            validation: {
-                name?: {
-                    regex?: RegExp;
-                };
-                cvc?: {
-                    optional?: boolean;
-                };
-            } | undefined;
-        };
+    get values(): CardPayload;
+    get config(): CardHostConfiguration & {
+        config: CardFrameConfig;
     };
     mount(selector: SelectorType): this;
+    preload(selector: SelectorType): this;
+    show(): this;
     update(options?: CardOptions): this;
     unmount(): this;
+    destroy(): this;
     on<T extends keyof CardEvents>(event: T, callback: CardEvents[T]): () => void;
     validate(): this;
 }
@@ -309,6 +314,43 @@ extends TranslationsObject {
     errors?: E;
 }
 
+declare interface CardFrameConfig {
+    icons?: boolean | Partial<CardIcons>;
+    autoFocus?: boolean;
+    hiddenFields?: string; // deprecated, sent comma-joined
+    // A field list from `ui.card()`, or the node tree a declared card renders.
+    fields?: CardField[] | CardSpecNode[];
+    acceptedBrands?: CardBrandName[];
+    customBrands?: CustomBrand[];
+    translations?: Partial<CardTranslations>;
+    autoProgress?: boolean;
+    redactCVC?: boolean;
+    allow3DigitAmexCVC?: boolean;
+    defaultValues?: {
+        name?: string;
+    };
+    autoComplete?: {
+        name?: boolean;
+        number?: boolean;
+        expiry?: boolean;
+        cvc?: boolean;
+    };
+    validation?: {
+        name?: {
+            regex?: RegExp;
+        };
+        cvc?: {
+            optional?: boolean;
+        };
+    };
+    agentTools?: AgentToolsFrameConfig;
+}
+
+declare interface CardHostConfiguration {
+    theme?: ThemeDefinition;
+    config?: CardFrameConfig;
+}
+
 declare type CardIcons = Record<CardBrandName | "default", string>;
 
 declare interface CardOptions {
@@ -341,6 +383,7 @@ declare interface CardOptions {
             optional?: boolean;
         };
     };
+    agentTools?: AgentToolsConfig;
 }
 
 declare interface CardPayload {
@@ -363,6 +406,15 @@ declare interface CardPayload {
     }>;
 }
 
+declare interface CardSpecNode {
+    type: CardSpecNodeType;
+    id: string;
+    props: Record<string, string>;
+    children?: CardSpecNode[];
+}
+
+declare type CardSpecNodeType = "row" | CardField;
+
 declare interface CardTranslations extends TranslationsObject {
     number: CardFieldTranslations<{
         invalid?: string;
@@ -372,112 +424,9 @@ declare interface CardTranslations extends TranslationsObject {
     cvc: CardFieldTranslations<{ invalid?: string }>;
 }
 
-declare function clean(extended?: ThemeDefinition): ThemeDefinition {
-    return (utils) => ({
-        styles: {
-            ":root": {
-                "--icon-offset": "1.9rem",
-            },
-            body: {
-                paddingBottom: 2,
-            },
-            label: {
-                fontSize: 14,
-                marginBottom: 4,
-                display: "block",
-                color: "#0a2540",
-            },
-            input: {
-                height: 40,
-                fontSize: 16,
-                borderRadius: 6,
-                color: "#0a2540",
-                padding: "0 12px",
-                backgroundColor: "#fff",
-                border: "1px solid #e6ebf1",
-                boxShadow:
-                "0px 1px 1px rgba(0, 0, 0, .03), 0px 3px 6px rgba(0, 0, 0, .02)",
-
-                "&::placeholder": {
-                    color: "#717f96",
-                },
-
-                "&:focus": {
-                    outline: "none",
-                    borderColor: "#63e",
-                },
-            },
-            textarea: {
-                height: 40,
-                fontSize: 16,
-                borderRadius: 6,
-                color: "#0a2540",
-                padding: "6px 12px",
-                backgroundColor: "#fff",
-                border: "1px solid #e6ebf1",
-
-                boxShadow:
-                "0px 1px 1px rgba(0, 0, 0, .03), 0px 3px 6px rgba(0, 0, 0, .02)",
-
-                "&::placeholder": {
-                    color: "#717f96",
-                },
-
-                "&:focus": {
-                    outline: "none",
-                    borderColor: "#63e",
-                },
-            },
-            select: {
-                height: 40,
-                fontSize: 16,
-                borderRadius: 6,
-                color: "#0a2540",
-                padding: "6px 12px",
-                backgroundColor: "#fff",
-                border: "1px solid #e6ebf1",
-            },
-            button: {
-                fontSize: 16,
-                height: 40,
-                border: "1px solid #e6ebf1",
-                padding: "0 12px",
-            },
-            ".field[ev-valid=false] input": {
-                color: "#df1c41",
-                borderColor: "#df1c41",
-            },
-            ".error": {
-                color: "#df1c41",
-                fontSize: "0.75rem",
-                padding: "0.25rem 0",
-            },
-            "[ev-component=card]": {
-                gap: 16,
-            },
-            "[ev-component=pin] input": {
-                height: 80,
-                fontSize: 20,
-                caretColor: "transparent",
-            },
-            "[ev-component=card]:has(.icon)": {
-                "& .field[ev-name=number]": {
-                    position: "relative",
-                },
-                "& .icon": {
-                    left: 10,
-                    height: 20,
-                    position: "absolute",
-                    top: "var(--icon-offset)",
-                },
-                "& .field[ev-name=number] input": {
-                    paddingLeft: 48,
-                },
-            },
-            ...(extended ? utils.extend(extended) : {}),
-        },
-    });
-}
+export declare function clean(config?: PresetConfig): ThemeDefinition;
+
+export declare function clean(extended?: ThemeDefinition, config?: PresetConfig): ThemeDefinition;
 
 declare type ColorScheme =
 | "normal"
@@ -538,6 +487,8 @@ PaymentTransactionDetails,
 "type"
 > & { type?: "payment" };
 
+export declare function cssVar(name: string): string;
+
 declare interface CustomBrand {
     name: string;
     isLocal: true;
@@ -1097,27 +1048,12 @@ EncryptedDPAN<"apple">,
 > & {
     networkToken: PaymentToken<"apple"> & { rawExpiry: string };
     card: EncryptedDPAN<"apple">["card"] & ApplePayCardEnrichment;
-    billingContact?: {
-        givenName?: string;
-        familyName?: string;
-        phoneticGivenName?: string;
-        phoneticFamilyName?: string;
-        emailAddress?: string;
-        phoneNumber?: string;
-        address?: unknown;
-    };
+    billingContact?: ApplePayContact;
     paymentDataType: string;
     transactionType: ApplePayTransactionType;
     transactionId: string;
     deviceManufacturerIdentifier: string;
-    shippingContact?: {
-        givenName?: string;
-        familyName?: string;
-        phoneticGivenName?: string;
-        phoneticFamilyName?: string;
-        emailAddress?: string;
-        phoneNumber?: string;
-    };
+    shippingContact?: ApplePayContact;
     /**
      * Set when `requestPayerDetails` is used. Apple Pay collects these on the
      * shipping contact, so they also appear on `shippingContact`.
@@ -1168,11 +1104,30 @@ declare interface EncryptedFPAN {
 }
 
 declare type EncryptedGooglePayData = (
-| EncryptedDPAN<"google">
-| EncryptedFPAN
+| EncryptedGooglePayDPAN
+| EncryptedGooglePayFPAN
 ) & {
     email?: string | null;
     billingAddress?: google.payments.api.Address | null;
+    /**
+     * The address the buyer chose in the sheet. Present when shipping-address
+     * collection was enabled directly or through `shippingOptions`.
+     */
+    shippingAddress?: google.payments.api.Address | null;
+    /**
+     * The shipping option the buyer chose in the sheet. Present only when
+     * `shippingOptions` were configured on the Google Pay button.
+     */
+    shippingOption?: GooglePayShippingOption | null;
+    assuranceDetails?: google.payments.api.AssuranceDetails | null;
+};
+
+declare type EncryptedGooglePayDPAN = Omit<EncryptedDPAN<"google">, "card"> & {
+    card: EncryptedDPAN<"google">["card"] & GooglePayCardEnrichment;
+};
+
+declare type EncryptedGooglePayFPAN = Omit<EncryptedFPAN, "card"> & {
+    card: EncryptedFPAN["card"] & GooglePayCardEnrichment;
 };
 
 declare const encryptionConstants: {
@@ -1351,7 +1306,18 @@ declare class GooglePay {
             allowedAuthMethods: google.payments.api.CardAuthMethod[] | undefined;
             allowedCardNetworks: google.payments.api.CardNetwork[] | undefined;
             billingAddress: GooglePayBillingAddressConfig | undefined;
+            shippingAddress: GooglePayShippingAddressConfig | undefined;
+            shippingOptions: GooglePayShippingOptionsConfig | undefined;
             emailRequired: boolean | undefined;
+            checkoutOption: google.payments.api.CheckoutOption | undefined;
+            transactionId: string | undefined;
+            totalPriceStatus: "ESTIMATED" | "FINAL" | undefined;
+            allowPrepaidCards: boolean | undefined;
+            allowCreditCards: boolean | undefined;
+            softwareInfo: google.payments.api.SoftwareInfo | undefined;
+            assuranceDetailsRequired: boolean | undefined;
+            existingPaymentMethodRequired: boolean | undefined;
+            prefetchPaymentData: boolean | undefined;
         };
     };
     mount(selector: SelectorType): this;
@@ -1412,6 +1378,37 @@ declare type GooglePayButtonType =
 | "plain"
 | "subscribe";
 
+declare interface GooglePayCardEnrichment {
+    funding?: string;
+    segment?: string;
+    country?: string;
+    currency?: string;
+    issuer?: string;
+}
+
+/** Rejects the buyer's current selection and shows an error in the sheet. */
+declare interface GooglePayDataChangeFailure {
+    error: GooglePayErrorMessage;
+    amount?: never;
+    lineItems?: never;
+    shippingOptions?: never;
+}
+
+/**
+ * A successful patch for the open sheet. Omitted fields retain their current
+ * values. Amounts use the currency's minor units, like `transaction.amount`.
+ */
+declare interface GooglePayDataChangeSuccess {
+    amount?: number;
+    lineItems?: TransactionLineItem[];
+    shippingOptions?: GooglePayShippingOptionsConfig;
+    error?: never;
+}
+
+declare type GooglePayDataChangeUpdate =
+| GooglePayDataChangeSuccess
+| GooglePayDataChangeFailure;
+
 declare interface GooglePayErrorMessage {
     message: string;
     reason?: google.payments.api.ErrorReason;
@@ -1442,7 +1439,119 @@ declare interface GooglePayOptions {
     allowedAuthMethods?: google.payments.api.CardAuthMethod[];
     allowedCardNetworks?: google.payments.api.CardNetwork[];
     billingAddress?: GooglePayBillingAddressConfig;
+    /**
+     * Collect a shipping address in the sheet. Pass `true` for any supported
+     * country, or parameters to restrict countries / request a phone number.
+     */
+    shippingAddress?: GooglePayShippingAddressConfig;
+    /**
+     * Offer shipping options in the sheet. This also enables shipping-address
+     * collection when `shippingAddress` is omitted.
+     */
+    shippingOptions?: GooglePayShippingOptionsConfig;
+    /**
+     * Called when the buyer picks or changes their shipping address, while the
+     * sheet is still open. Return updated totals, line items or options. The
+     * callback has 10 seconds to complete.
+     */
+    onShippingAddressChange?: (
+    address: google.payments.api.IntermediateAddress,
+    context: GooglePayShippingContext
+    ) =>
+    | GooglePayDataChangeUpdate
+    | void
+    | Promise<GooglePayDataChangeUpdate | void>;
+    /**
+     * Called when the buyer picks a different shipping option. The callback has
+     * 10 seconds to complete.
+     */
+    onShippingOptionChange?: (
+    option: GooglePayShippingOption,
+    context: GooglePayShippingContext
+    ) =>
+    | GooglePayDataChangeUpdate
+    | void
+    | Promise<GooglePayDataChangeUpdate | void>;
     theme?: ThemeDefinition;
+    /**
+     * Whether to show a 'Continue' or 'Pay Now' button on the Google Pay sheet.
+     * @default "DEFAULT"
+     */
+    checkoutOption?: google.payments.api.CheckoutOption;
+    /**
+     * A merchant-generated ID for this transaction, used for fraud correlation.
+     */
+    transactionId?: string;
+    /**
+     * Whether the total price is known and final, or still an estimate.
+     *
+     * `"NOT_CURRENTLY_KNOWN"` isn't supported — same as Android and our
+     * current shipping implementation.
+     * @default "FINAL"
+     */
+    totalPriceStatus?: Exclude<
+    google.payments.api.TotalPriceStatus,
+    "NOT_CURRENTLY_KNOWN"
+    >;
+    /** @default true */
+    allowPrepaidCards?: boolean;
+    /** @default true */
+    allowCreditCards?: boolean;
+    /**
+     * Identifies the software used to integrate with Google Pay, for Google's
+     * own metrics.
+     */
+    softwareInfo?: google.payments.api.SoftwareInfo;
+    /**
+     * When true, requests that Google Pay perform cardholder ID&V/possession
+     * checks and return the result as `assuranceDetails` on the payment method.
+     */
+    assuranceDetailsRequired?: boolean;
+    /**
+     * When true, requires the user to have an existing payment method
+     * associated with their Google account for the button to be shown as
+     * ready. Checked by `isReadyToPay`, not `loadPaymentData`.
+     * @default false
+     */
+    existingPaymentMethodRequired?: boolean;
+    /**
+     * When true, asks Google Pay to prefetch payment data as soon as the
+     * button is ready, so the sheet opens faster when the user clicks it.
+     * Fire-and-forget; has no effect on `process()`'s result.
+     */
+    prefetchPaymentData?: boolean;
+}
+
+declare type GooglePayShippingAddressConfig =
+| boolean
+| GooglePayShippingAddressParameters;
+
+declare type GooglePayShippingAddressParameters =
+google.payments.api.ShippingAddressParameters;
+
+/** The current shipping state when Google Pay asks for an update. */
+declare interface GooglePayShippingContext {
+    trigger: google.payments.api.CallbackTrigger;
+    shippingAddress?: google.payments.api.IntermediateAddress | null;
+    selectedShippingOption?: GooglePayShippingOption | null;
+    /** The current total in the currency's minor units. */
+    amount: number;
+    lineItems?: TransactionLineItem[];
+    shippingOptions?: GooglePayShippingOptionsConfig;
+}
+
+declare type GooglePayShippingOption = google.payments.api.SelectionOption & {
+    /**
+     * Optional shipping cost in minor units. Google Pay does not display this
+     * field automatically. Include it in `label` when buyers must see the price.
+     */
+    amount?: number;
+};
+
+declare interface GooglePayShippingOptionsConfig {
+    options: GooglePayShippingOption[];
+    /** Defaults to the first option when omitted, matching Google's own default. */
+    defaultSelectedOptionId?: string;
 }
 
 declare interface HttpConfig {
@@ -1511,313 +1620,13 @@ declare type JssValue =
 
 export declare function loadEvervault(team: string, app: string, config?: CustomConfig): Promise<EvervaultInstance>;
 
-declare function material(extended?: ThemeDefinition): ThemeDefinition {
-    return (utils) => ({
-        styles: {
-            body: {
-                paddingTop: 4,
-            },
-
-            ".field": {
-                position: "relative",
-            },
-
-            label: {
-                top: 10,
-                left: 8,
-                zIndex: 3,
-                fontSize: 14,
-                lineHeight: 1,
-                height: "20px",
-                display: "flex",
-                color: "#717f96",
-                padding: "0 4px",
-                alignItems: "center",
-                position: "absolute",
-                pointerEvents: "none",
-                transformOrigin: "center left",
-                transition: "transform 150ms, background 150ms",
-            },
-
-            input: {
-                height: 40,
-                fontSize: 16,
-                borderRadius: 6,
-                color: "#0a2540",
-                padding: "0 12px",
-                backgroundColor: "#fff",
-                border: "1px solid #e6ebf1",
-
-                "&::placeholder": {
-                    color: "transparent",
-                },
-
-                "&:focus": {
-                    outline: "none",
-                    borderColor: "#63e",
-                },
-            },
-
-            textarea: {
-                height: 40,
-                fontSize: 16,
-                borderRadius: 6,
-                color: "#0a2540",
-                padding: "6 12px",
-                backgroundColor: "#fff",
-                border: "1px solid #e6ebf1",
-
-                "&::placeholder": {
-                    color: "transparent",
-                },
-
-                "&:focus": {
-                    outline: "none",
-                    borderColor: "#63e",
-                },
-            },
-
-            ".field[ev-valid=false] input": {
-                color: "#df1c41",
-                borderColor: "#df1c41",
-            },
-
-            ".field:focus-within label, .field:not([ev-has-value=false]) label": {
-                background: "white",
-                transform: "translateY(-100%) scale(0.8)",
-            },
-
-            ".error": {
-                color: "#df1c41",
-                fontSize: "0.75rem",
-                padding: "0.25rem 0",
-            },
-
-            ".field:not([ev-valid=false]):focus-within label": {
-                color: "#63e",
-            },
-
-            ".field[ev-valid=false] label": {
-                color: "#df1c41",
-            },
-
-            ".field[ev-has-value=true][ev-valid=true]:not(:focus-within) label": {
-                color: "#0a2540",
-            },
-
-            "[ev-component=card]": {
-                gap: 16,
-            },
-
-            "[ev-component=card]:has(.icon)": {
-                "& .icon": {
-                    left: 10,
-                    height: 20,
-                    position: "absolute",
-                    top: 10,
-                    opacity: 0,
-                },
-
-                "& .field[ev-name=number]:focus-within, & .field[ev-name=number]:not([ev-has-value=false])":
-                    {
-                    "& .icon": {
-                        opacity: 1,
-                    },
-                    "& input": {
-                        paddingLeft: 45,
-                    },
-                },
-            },
-            ...(extended ? utils.extend(extended) : {}),
-        },
-    });
-}
+export declare function material(config?: PresetConfig): ThemeDefinition;
 
-declare function minimal(extended?: ThemeDefinition): ThemeDefinition {
-    return (utils) => ({
-        styles: {
-            ":root": {
-                "--icon-offset": "34px",
-            },
-
-            body: {
-                paddingBottom: 2,
-            },
-
-            label: {
-                fontSize: 14,
-                marginBottom: "0.5rem",
-                color: "#0a2540",
-                display: "none",
-            },
-
-            ".field:first-child label": {
-                display: "block",
-            },
-
-            "fieldset[ev-valid=false]": {
-                paddingBottom: "1.5rem",
-            },
-
-            input: {
-                height: 40,
-                fontSize: 16,
-                borderRadius: 0,
-                color: "#0a2540",
-                padding: "0 12px",
-                backgroundColor: "#fff",
-                border: "1px solid #e6ebf1",
-
-                boxShadow:
-                "0px 1px 1px rgba(0, 0, 0, .03), 0px 3px 6px rgba(0, 0, 0, .02)",
-
-                "&::placeholder": {
-                    color: "#717f96",
-                },
-
-                "&:focus": {
-                    outline: "none",
-                    borderColor: "#63e",
-                },
-            },
-
-            textarea: {
-                height: 40,
-                fontSize: 16,
-                borderRadius: 0,
-                color: "#0a2540",
-                padding: "6 12px",
-                backgroundColor: "#fff",
-                border: "1px solid #e6ebf1",
-
-                boxShadow:
-                "0px 1px 1px rgba(0, 0, 0, .03), 0px 3px 6px rgba(0, 0, 0, .02)",
-
-                "&::placeholder": {
-                    color: "#717f96",
-                },
-
-                "&:focus": {
-                    outline: "none",
-                    borderColor: "#63e",
-                },
-            },
-
-            ".field[ev-valid=false] input": {
-                color: "#df1c41",
-                borderColor: "#df1c41",
-            },
-
-            ".error": {
-                color: "#df1c41",
-                fontSize: "0.75rem",
-                padding: "0.25rem 0",
-                position: "absolute",
-                left: 0,
-                bottom: 0,
-                display: "none",
-            },
-
-            ".field[ev-valid=false]": {
-                zIndex: 4,
-            },
-
-            ".field:focus-within": {
-                zIndex: 5,
-            },
-
-            "[ev-component=card]": {
-                gap: 0,
-
-                "& .field[ev-valid=false]:nth-child(1) .error": {
-                    display: "block",
-                },
-
-                "& [ev-valid=true]:nth-child(1) + [ev-valid=false] .error": {
-                    display: "block",
-                },
-
-                "& [ev-valid=true]:nth-child(1) + [ev-valid=true]:nth-child(2) + [ev-valid=false] .error":
-                    {
-                    display: "block",
-                },
-
-                "& [ev-valid=true]:nth-child(1) + [ev-valid=true]:nth-child(2) + [ev-valid=true]:nth-child(3) + [ev-valid=false] .error":
-                    {
-                    display: "block",
-                },
-
-                "& .field:not(:last-child)": {
-                    marginBottom: "-1px",
-                },
-
-                "& .field:first-child": {
-                    "& input": {
-                        borderTopLeftRadius: 6,
-                        borderTopRightRadius: 6,
-                    },
-                },
-
-                "& .field:last-child": {
-                    "& input": {
-                        borderBottomRightRadius: 6,
-                        borderBottomLeftRadius: 6,
-                    },
-                },
-            },
-
-            "[ev-component=card][ev-fields*=cvc][ev-fields*=expiry]": {
-                "& .field[ev-name=expiry]": {
-                    "& input": {
-                        borderBottomLeftRadius: 6,
-                    },
-                },
-
-                "& .field[ev-name=cvc]": {
-                    marginLeft: "-1px",
-
-                    "& input": {
-                        borderBottomLeftRadius: 0,
-                    },
-                },
-            },
-
-            "[ev-component=pin]": {
-                gap: 0,
-
-                "& input": {
-                    height: 60,
-                },
-
-                "& .field:not(:first-child)": {
-                    marginLeft: "-1px",
-                },
-
-                "& .field:first-child input": {
-                    borderTopLeftRadius: 6,
-                    borderBottomLeftRadius: 6,
-                },
-
-                "& .field:last-child input": {
-                    borderTopRightRadius: 6,
-                    borderBottomRightRadius: 6,
-                },
-            },
-            "[ev-component=card]:has(.icon)": {
-                "& .icon": {
-                    left: 10,
-                    height: 20,
-                    position: "absolute",
-                    top: "var(--icon-offset)",
-                },
-                "& .field[ev-name=number] input": {
-                    paddingLeft: 48,
-                },
-            },
-            ...(extended ? utils.extend(extended) : {}),
-        },
-    });
-}
+export declare function material(extended?: ThemeDefinition, config?: PresetConfig): ThemeDefinition;
+
+export declare function minimal(config?: PresetConfig): ThemeDefinition;
+
+export declare function minimal(extended?: ThemeDefinition, config?: PresetConfig): ThemeDefinition;
 
 declare interface MinimalObservable<T> {
     subscribe(nextOrObserver: ((value: T) => void) | {next: (value: T) => void}): {
@@ -2952,6 +2761,14 @@ declare interface PinPayload {
     value: string | null;
 }
 
+export declare interface PresetConfig {
+    primary?: string;
+    greyTone?: string;
+    roundness?: string;
+    font?: string;
+    selectors?: ThemeStyles;
+}
+
 declare interface Properties<TLength = (string & {}) | 0, TTime = string & {}>
 extends StandardProperties<TLength, TTime>,
 VendorProperties<TLength, TTime>,
@@ -4756,6 +4573,7 @@ declare class RevealCopyButton {
 
 declare interface RevealCopyButtonEvents {
     copy: () => void;
+    error: () => void;
 }
 
 declare interface RevealCopyButtonOptions {
@@ -4800,6 +4618,11 @@ declare class RevealText {
     constructor(reveal: Reveal, client: EvervaultClient, path: string, options?: RevealTextOptions);
     mount(selector: SelectorType): this;
     unmount(): this;
+    on<T extends keyof RevealTextEvents>(event: T, callback: RevealTextEvents[T]): () => void;
+}
+
+declare interface RevealTextEvents {
+    error: () => void;
 }
 
 declare interface RevealTextOptions {
@@ -11753,12 +11576,21 @@ declare interface SwipedCard {
     bin: string | null;
 }
 
-declare type ThemeDefinition = ThemeObject | ThemeFunction;
+export declare type ThemeDefinition = ThemeObject | ThemeFunction;
+
+declare interface ThemeFontFace {
+    fontFamily: string;
+    src: string;
+    fontWeight?: string | number;
+    fontStyle?: string;
+    fontDisplay?: string;
+}
 
 declare type ThemeFunction = (utilities: ThemeUtilities) => ThemeObject;
 
 declare interface ThemeObject {
     fonts?: string[];
+    fontFaces?: ThemeFontFace[];
     styles?: ThemeStyles;
 }
 
@@ -11766,7 +11598,9 @@ declare namespace themes {
     export {
         clean,
         material,
-        minimal
+        minimal,
+        PresetConfig,
+        cssVar
     }
 }
 
@@ -11835,6 +11669,12 @@ declare interface TransactionLineItem {
      * Defaults to `"final"` when omitted.
      */
     type?: TransactionLineItemType;
+    /**
+     * The kind of line item, for platforms that distinguish it (currently Google
+     * Pay only, where it maps to `displayItems[].type`). Has no effect on Apple
+     * Pay or disbursements. Defaults to `"line_item"` when omitted.
+     */
+    category?: "line_item" | "subtotal" | "tax" | "discount" | "shipping_option";
 }
 
 declare type TransactionLineItemType = "final" | "pending";
@@ -11858,6 +11698,7 @@ declare class UIComponents {
      * @deprecated Use `applePay` instead.
      */
     applePayButton(tx: Transaction, opts: ApplePayButtonOptions): ApplePayButton;
+    mountElements(): void;
 }
 
 declare interface VendorLonghandProperties<TLength = (string & {}) | 0, TTime = string & {}> {
@@ -41933,6 +41774,99 @@ declare global {
 
 
 
+declare module "@vitest/expect" {
+	interface MatcherState {
+		environment: string;
+		snapshotState: SnapshotState;
+		task?: Readonly<Test>;
+	}
+	interface ExpectPollOptions {
+		interval?: number;
+		timeout?: number;
+		message?: string;
+	}
+	interface ExpectStatic {
+		assert: Chai.AssertStatic;
+		unreachable: (message?: string) => never;
+		soft: <T>(actual: T, message?: string) => Assertion<T>;
+		poll: <T>(actual: () => T, options?: ExpectPollOptions) => PromisifyAssertion<Awaited<T>>;
+		addEqualityTesters: (testers: Array<Tester>) => void;
+		assertions: (expected: number) => void;
+		hasAssertions: () => void;
+		addSnapshotSerializer: (plugin: Plugin) => void;
+	}
+	interface Assertion<T> {
+		matchSnapshot: SnapshotMatcher<T>;
+		toMatchSnapshot: SnapshotMatcher<T>;
+		toMatchInlineSnapshot: InlineSnapshotMatcher<T>;
+		/**
+		* Checks that an error thrown by a function matches a previously recorded snapshot.
+		*
+		* @param hint - Optional custom error message.
+		*
+		* @example
+		* expect(functionWithError).toThrowErrorMatchingSnapshot();
+		*/
+		toThrowErrorMatchingSnapshot: (hint?: string) => void;
+		/**
+		* Checks that an error thrown by a function matches an inline snapshot within the test file.
+		* Useful for keeping snapshots close to the test code.
+		*
+		* @param snapshot - Optional inline snapshot string to match.
+		* @param hint - Optional custom error message.
+		*
+		* @example
+		* const throwError = () => { throw new Error('Error occurred') };
+		* expect(throwError).toThrowErrorMatchingInlineSnapshot(`"Error occurred"`);
+		*/
+		toThrowErrorMatchingInlineSnapshot: (snapshot?: string, hint?: string) => void;
+		/**
+		* Compares the received value to a snapshot saved in a specified file.
+		* Useful for cases where snapshot content is large or needs to be shared across tests.
+		*
+		* @param filepath - Path to the snapshot file.
+		* @param hint - Optional custom error message.
+		*
+		* @example
+		* await expect(largeData).toMatchFileSnapshot('path/to/snapshot.json');
+		*/
+		toMatchFileSnapshot: (filepath: string, hint?: string) => Promise<void>;
+	}
+}
+
+
+
+
+declare module "@vitest/runner" {
+	interface TestContext {
+		/**
+		* `expect` instance bound to the current test.
+		*
+		* This API is useful for running snapshot tests concurrently because global expect cannot track them.
+		*/
+		readonly expect: ExpectStatic;
+		/** @internal */
+		_local: boolean;
+	}
+	interface TaskMeta {
+		typecheck?: boolean;
+		benchmark?: boolean;
+	}
+	interface File {
+		prepareDuration?: number;
+		environmentLoad?: number;
+	}
+	interface TaskBase {
+		logs?: UserConsoleLog[];
+	}
+	interface TaskResult {
+		benchmark?: BenchmarkResult;
+	}
+}
+
+
+
+
 declare namespace Emitter {
   /**
    * Returns a union of all event types, both public and reserved, for the given emitter.
@@ -42062,99 +41996,6 @@ declare namespace EventMap {
 
 
 
-declare module "@vitest/expect" {
-	interface MatcherState {
-		environment: string;
-		snapshotState: SnapshotState;
-		task?: Readonly<Test>;
-	}
-	interface ExpectPollOptions {
-		interval?: number;
-		timeout?: number;
-		message?: string;
-	}
-	interface ExpectStatic {
-		assert: Chai.AssertStatic;
-		unreachable: (message?: string) => never;
-		soft: <T>(actual: T, message?: string) => Assertion<T>;
-		poll: <T>(actual: () => T, options?: ExpectPollOptions) => PromisifyAssertion<Awaited<T>>;
-		addEqualityTesters: (testers: Array<Tester>) => void;
-		assertions: (expected: number) => void;
-		hasAssertions: () => void;
-		addSnapshotSerializer: (plugin: Plugin) => void;
-	}
-	interface Assertion<T> {
-		matchSnapshot: SnapshotMatcher<T>;
-		toMatchSnapshot: SnapshotMatcher<T>;
-		toMatchInlineSnapshot: InlineSnapshotMatcher<T>;
-		/**
-		* Checks that an error thrown by a function matches a previously recorded snapshot.
-		*
-		* @param hint - Optional custom error message.
-		*
-		* @example
-		* expect(functionWithError).toThrowErrorMatchingSnapshot();
-		*/
-		toThrowErrorMatchingSnapshot: (hint?: string) => void;
-		/**
-		* Checks that an error thrown by a function matches an inline snapshot within the test file.
-		* Useful for keeping snapshots close to the test code.
-		*
-		* @param snapshot - Optional inline snapshot string to match.
-		* @param hint - Optional custom error message.
-		*
-		* @example
-		* const throwError = () => { throw new Error('Error occurred') };
-		* expect(throwError).toThrowErrorMatchingInlineSnapshot(`"Error occurred"`);
-		*/
-		toThrowErrorMatchingInlineSnapshot: (snapshot?: string, hint?: string) => void;
-		/**
-		* Compares the received value to a snapshot saved in a specified file.
-		* Useful for cases where snapshot content is large or needs to be shared across tests.
-		*
-		* @param filepath - Path to the snapshot file.
-		* @param hint - Optional custom error message.
-		*
-		* @example
-		* await expect(largeData).toMatchFileSnapshot('path/to/snapshot.json');
-		*/
-		toMatchFileSnapshot: (filepath: string, hint?: string) => Promise<void>;
-	}
-}
-
-
-
-
-declare module "@vitest/runner" {
-	interface TestContext {
-		/**
-		* `expect` instance bound to the current test.
-		*
-		* This API is useful for running snapshot tests concurrently because global expect cannot track them.
-		*/
-		readonly expect: ExpectStatic;
-		/** @internal */
-		_local: boolean;
-	}
-	interface TaskMeta {
-		typecheck?: boolean;
-		benchmark?: boolean;
-	}
-	interface File {
-		prepareDuration?: number;
-		environmentLoad?: number;
-	}
-	interface TaskBase {
-		logs?: UserConsoleLog[];
-	}
-	interface TaskResult {
-		benchmark?: BenchmarkResult;
-	}
-}
-
-
-
-
 
 declare namespace buildConnector {
   export type BuildOptions = (ConnectionOptions | TcpNetConnectOpts | IpcNetConnectOpts) & {