@tuwaio/nova-connect 0.8.0 → 0.8.2

package/dist/{useWalletNativeBalance-DMPPRldX.d.cts → ConnectedModalTxHistory-CNOrs8nI.d.cts}

@@ -1,10 +1,10 @@
 import * as React$1 from 'react';
 import React__default, { ComponentPropsWithoutRef, ComponentType, ReactNode } from 'react';
+import { N as NovaConnectLabels } from './types-CnOiSyvZ.cjs';
+import { Variants, Easing } from 'framer-motion';
 import { OrbitAdapter } from '@tuwaio/orbit-core';
 import { TransactionPool, Transaction, TxAdapter } from '@tuwaio/pulsar-core';
-import { N as NovaConnectLabels } from './types-CnOiSyvZ.cjs';
 import { SatelliteSiwxFieldOptions, UseSiwxSignInOptions } from '@tuwaio/siwx-react';
-import { Variants, Easing } from 'framer-motion';
 
 /**
  * Chain configuration types of the networks the app imports. Importing `@tuwaio/nova-connect/evm` adds `appChains`
@@ -50,509 +50,108 @@ interface AllChainConfigs {
 type InitialChains = AllChainConfigs;
 
 /**
- * @file ConnectedModalTxHistory component with comprehensive customization options for transaction history display.
+ * @file Headless SIWX auto-authentication watcher for NovaConnect.
+ * Monitors active wallet connections and automatically triggers SIWX signing prompts.
  */
 
 /**
- * Local mirror of TxInMemoryPagination from @tuwaio/pulsar-core.
- * Defined inline because pulsar-core is an optional peer dependency in nova-connect.
+ * Props of {@link NovaSiwxWatcher} (the `siwx` prop of `NovaConnectProvider`): the sign-in callbacks and the SIWX
+ * message fields of `getSatelliteSiwxFields` from `@tuwaio/siwx-react` (`domain`, `uri`, `statement`, and so on).
  */
-type LocalTxPagination = {
-    /** Indicates whether the store is currently loading transaction history. */
-    isLoading: boolean;
-    /** Indicates whether the last loading request ended with an error. */
-    isError: boolean;
-    /** Indicates whether more history pages are available. */
-    hasMore: boolean;
-    /** The current page number in the paginated history. */
-    currentPage: number;
+interface NovaSiwxWatcherProps extends SatelliteSiwxFieldOptions {
+    /** Whether to ask connected wallets to sign in (default: `true`) */
+    enabled?: boolean;
+    /** Fetches the nonce of the SIWX message from your backend */
+    getNonce?: () => Promise<string>;
+    /** Verifies the signed message on your backend (required for the sign-in) */
+    verifier?: UseSiwxSignInOptions['verifier'];
     /**
-     * Loads the next page of transaction history and appends it to the pool.
-     *
-     * @param walletAddress - The address whose history is loaded.
-     * @returns Resolves when the page is loaded.
+     * Optional callback triggered when the wallet disconnects or when `signOut` is called.
+     * Useful for hitting a `/logout` endpoint to clear the backend cookie.
      */
-    fetchNextPage: (walletAddress: string) => Promise<void>;
-};
+    destroyer?: () => Promise<void>;
+    /** Optional callback triggered immediately after successful SIWX authentication */
+    onSuccess?: UseSiwxSignInOptions['onSuccess'];
+    /** Optional callback triggered if SIWX signing or verification fails */
+    onError?: UseSiwxSignInOptions['onError'];
+}
 /**
- * Local customization options for TransactionsHistory component.
- * This is a copy of the type from @tuwaio/nova-transactions to avoid
- * breaking dynamic import logic.
+ * Signs the connected wallet in with SIWX. `NovaConnectProvider` renders it with its `siwx` prop, so apps do not
+ * render it themselves. It renders nothing.
+ *
+ * - When a wallet connects (or the account changes), it asks the wallet to sign a SIWX message once per address
+ *   (`signIn` of `useSiwx` from `@tuwaio/siwx-react`: a wallet prompt, then `getNonce` and `verifier` requests to your
+ *   backend). A rejected or failed sign-in disconnects that wallet (if it is still the active one) and calls
+ *   `onError`. Without `verifier` it logs a warning and does not sign in.
+ * - When no wallet is connected, it clears the SIWX session and calls `destroyer`. After a page load it waits until
+ *   Satellite Connect has finished reconnecting (`isAutoConnectFinished`), so the session restored by
+ *   `@tuwaio/siwx-react` is kept.
+ *
+ * @param props - See {@link NovaSiwxWatcherProps}.
+ * @returns `null`.
  */
-type LocalTransactionsHistoryCustomization = {
-    /** Custom title for the transactions history section */
-    title?: string;
-    /** Custom class name generators */
-    classNames?: {
-        /** Classes for the outer container */
-        container?: string;
-        /** Classes for the title element */
-        titleText?: string;
-        /** Classes for the list wrapper container */
-        listWrapper?: string;
-        /** Classes for the placeholder container */
-        placeholderContainer?: string;
-        /** Classes for the placeholder title */
-        placeholderTitle?: string;
-        /** Classes for the placeholder message */
-        placeholderMessage?: string;
-        /** Classes for the infinite scroll loader container */
-        loaderContainer?: string;
-        /** Classes for the infinite scroll loader icon (spinner) */
-        loaderIcon?: string;
-        /** Classes for the error indicator container */
-        errorContainer?: string;
-        /** Classes for the error indicator icon */
-        errorIcon?: string;
-        /** Classes for individual transaction item container */
-        itemContainer?: string;
-        /** Classes for the icon wrapper */
-        itemIconWrapper?: string;
-        /** Classes for the icon itself */
-        itemIcon?: string;
-        /** Classes for the content wrapper */
-        itemContentWrapper?: string;
-        /** Classes for the title text */
-        itemTitle?: string;
-        /** Classes for the timestamp text */
-        itemTimestamp?: string;
-        /** Classes for the description text */
-        itemDescription?: string;
-        /** Classes for the status badge container */
-        itemStatusBadge?: string;
-        /** Classes for the status badge icon */
-        itemStatusBadgeIcon?: string;
-        /** Classes for the status badge label */
-        itemStatusBadgeLabel?: string;
-        /** Classes for the transaction key container */
-        itemTxKeyContainer?: string;
-        /** Classes for the default hash link label */
-        itemHashLabel?: string;
-        /** Classes for the default hash link */
-        itemHashLink?: string;
-        /** Classes for the default hash copy button */
-        itemHashCopyButton?: string;
-        /** Classes for the original hash link label (replaced transactions) */
-        itemOriginalHashLabel?: string;
-        /** Classes for the original hash link (replaced transactions) */
-        itemOriginalHashLink?: string;
-        /** Classes for the original hash copy button (replaced transactions) */
-        itemOriginalHashCopyButton?: string;
-    };
-};
+declare function NovaSiwxWatcher(props: NovaSiwxWatcherProps): null;
+
 /**
- * Props for a custom loading state (shown while `@tuwaio/nova-transactions` loads).
+ * Status of the latest transaction of the active wallet, shown by the connect button: `loading` while it is pending,
+ * then `succeed`, `failed` or `replaced`, and `idle` otherwise.
  */
-type ConnectedModalTxHistoryLoadingContainerProps = {
-    /** The Nova Connect labels */
-    labels: Record<string, string>;
-    /** Classes from `classNames.loadingContainer` */
-    className?: string;
-    /** Granular classNames for sub-elements */
-    classNames?: {
-        /** From `classNames.loadingSpinner` */
-        spinner?: string;
-        /** From `classNames.loadingText` */
-        text?: string;
-    };
-};
+type ButtonTxStatus = 'idle' | 'loading' | 'succeed' | 'failed' | 'replaced';
 /**
- * Props for a custom error state (shown when `@tuwaio/nova-transactions` cannot be loaded or its component throws).
+ * Screen of the connect modal: `connectors` (wallet list), `network` (network choice of a multi-network wallet),
+ * `connecting`, `about` ("About wallets"), `getWallet` ("Get a wallet") or `impersonate` (impersonation form).
  */
-type ConnectedModalTxHistoryErrorContainerProps = {
-    /** Classes from `classNames.errorContainer` */
-    className?: string;
-    /** Granular classNames for sub-elements */
-    classNames?: {
-        /** From `classNames.errorIconContainer` */
-        iconContainer?: string;
-        /** From `classNames.errorIcon` */
-        icon?: string;
-        /** From `classNames.errorContent` */
-        content?: string;
-        /** From `classNames.errorTitle` */
-        title?: string;
-        /** From `classNames.errorDescription` */
-        description?: string;
-    };
-};
+type ConnectContentType = 'network' | 'connectors' | 'about' | 'getWallet' | 'connecting' | 'impersonate';
 /**
- * Props for a custom state without a connected wallet.
+ * Screen of the connected modal: `main`, `transactions` (history), `chains` (network switch) or `connections`
+ * (connected and recent wallets).
  */
-type ConnectedModalTxHistoryNoWalletContainerProps = {
-    /** Classes from `classNames.noWalletContainer` */
-    className?: string;
-    /** Granular classNames for sub-elements */
-    classNames?: {
-        /** From `classNames.noWalletText` */
-        text?: string;
-    };
-};
+type ConnectedContentType = 'main' | 'transactions' | 'chains' | 'connections';
+/** Legal configuration for Terms of Service and Privacy Policy links */
+interface LegalConfig {
+    /** URL of the terms of service */
+    termsUrl?: string;
+    /** URL of the privacy policy */
+    privacyUrl?: string;
+}
 /**
- * Props for a custom wrapper of the `TransactionsHistory` of `@tuwaio/nova-transactions`.
+ * Props of `NovaConnectProvider`. `appChains` and `solanaRPCUrls` give the chains of the app; without both, the
+ * modals are not rendered.
  */
-type ConnectedModalTxHistoryTransactionsHistoryWrapperProps = {
-    /** The transaction history */
-    children: ReactNode;
-    /** The active address */
-    activeConnectionAddress: string;
-    /** The `transactionPool` prop */
-    transactionPool: NonNullable<NovaConnectProviderProps['transactionPool']>;
-    /** The `pulsarAdapter` prop */
-    pulsarAdapter: NonNullable<NovaConnectProviderProps['pulsarAdapter']>;
-    /** The Nova Connect labels */
-    labels: Record<string, string>;
-    /** Classes from `classNames.transactionsHistoryWrapper` */
-    className?: string;
-};
+interface NovaConnectProviderProps extends InitialChains {
+    /** Transaction pool of Pulsar: the connect button shows the status of the latest transaction of the wallet */
+    transactionPool?: TransactionPool<Transaction>;
+    /** Pulsar adapter(s); with `transactionPool`, the connected modal shows the transaction history */
+    pulsarAdapter?: TxAdapter<Transaction> | TxAdapter<Transaction>[];
+    /** Whether the connect button shows the native balance */
+    withBalance?: boolean;
+    /** Whether the connect button shows a chain selector */
+    withChain?: boolean;
+    /** Whether the wallet list offers the impersonated wallet (a read-only address, for development) */
+    withImpersonated?: boolean;
+    /** Wallet names of the "Popular" group, in order (default: WalletConnect, Porto, Coinbase, Gemini) */
+    popularConnectors?: string[];
+    /** Extra wallet groups of the wallet list: group title → wallet names, in order */
+    customConnectorGroups?: Record<string, string[]>;
+    /** Legal configuration for Terms of Service and Privacy Policy links */
+    legal?: LegalConfig;
+    /**
+     * SIWX sign-in of the connected wallet (see `NovaSiwxWatcher`). Without it, Nova Connect does not sign in and does
+     * not touch the SIWX session.
+     */
+    siwx?: NovaSiwxWatcherProps;
+    /**
+     * Pagination state for infinite scroll, forwarded to ConnectedModalTxHistory and TransactionsHistory.
+     * Mirrors TxInMemoryPagination from @tuwaio/pulsar-core (optional peer dependency).
+     */
+    pagination?: LocalTxPagination;
+    /** The app */
+    children: React.ReactNode;
+    /** Texts to override, merged over the English defaults */
+    labels?: Partial<NovaConnectLabels>;
+}
 /**
- * Customization options of {@link ConnectedModalTxHistory}.
- */
-type ConnectedModalTxHistoryCustomization = {
-    /** Props of the container (the component props, `className` and `aria-label` take precedence) */
-    containerProps?: Partial<Omit<ComponentPropsWithoutRef<'div'>, 'popover' | 'onDrag' | 'onDragEnd' | 'onDragExit' | 'onDragStart' | 'onDragStartCapture' | 'onAnimationStart' | 'onAnimationEnd' | 'onAnimationStartCapture' | 'onAnimationEndCapture' | 'onAnimationIteration' | 'onAnimationIterationCapture'>>;
-    /** Custom components */
-    components?: {
-        /** Custom loading container component */
-        LoadingContainer?: ComponentType<ConnectedModalTxHistoryLoadingContainerProps>;
-        /** Custom error container component */
-        ErrorContainer?: ComponentType<ConnectedModalTxHistoryErrorContainerProps>;
-        /** Custom no wallet container component */
-        NoWalletContainer?: ComponentType<ConnectedModalTxHistoryNoWalletContainerProps>;
-        /** Custom transactions history wrapper component */
-        TransactionsHistoryWrapper?: ComponentType<ConnectedModalTxHistoryTransactionsHistoryWrapperProps>;
-    };
-    /** Custom class name generators */
-    classNames?: {
-        /**
-         * Returns the classes of the container, instead of the default ones and the `className` prop.
-         *
-         * @param params - The state.
-         * @param params.hasActiveWallet - Whether a wallet is connected.
-         * @param params.hasValidAdapter - Whether `transactionPool` and `pulsarAdapter` are set.
-         * @returns The classes.
-         */
-        container?: (params: {
-            hasActiveWallet: boolean;
-            hasValidAdapter: boolean;
-        }) => string;
-        /**
-         * Returns classes of the loading state, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        loadingContainer?: () => string;
-        /**
-         * Returns classes of the loading spinner, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        loadingSpinner?: () => string;
-        /**
-         * Returns classes of the loading text, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        loadingText?: () => string;
-        /**
-         * Returns classes of the error state, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        errorContainer?: () => string;
-        /**
-         * Returns classes of the error icon container, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        errorIconContainer?: () => string;
-        /**
-         * Returns classes of the error icon, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        errorIcon?: () => string;
-        /**
-         * Returns classes of the error texts, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        errorContent?: () => string;
-        /**
-         * Returns classes of the error title, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        errorTitle?: () => string;
-        /**
-         * Returns classes of the error description, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        errorDescription?: () => string;
-        /**
-         * Returns classes of the state without a wallet, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        noWalletContainer?: () => string;
-        /**
-         * Returns classes of the text without a wallet, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        noWalletText?: () => string;
-        /**
-         * Returns classes of the "Pulsar adapter required" state, instead of the default ones.
-         *
-         * @returns The classes.
-         */
-        pulsarRequiredContainer?: () => string;
-        /**
-         * Returns classes of its icon container, instead of the default ones.
-         *
-         * @returns The classes.
-         */
-        pulsarRequiredIconContainer?: () => string;
-        /**
-         * Returns classes of its icon, instead of the default ones.
-         *
-         * @returns The classes.
-         */
-        pulsarRequiredIcon?: () => string;
-        /**
-         * Returns classes of its texts, instead of the default ones.
-         *
-         * @returns The classes.
-         */
-        pulsarRequiredContent?: () => string;
-        /**
-         * Returns classes of its title, instead of the default ones.
-         *
-         * @returns The classes.
-         */
-        pulsarRequiredTitle?: () => string;
-        /**
-         * Returns classes of its description, instead of the default ones.
-         *
-         * @returns The classes.
-         */
-        pulsarRequiredDescription?: () => string;
-        /**
-         * Returns classes of the transaction history wrapper, added to the default ones.
-         *
-         * @returns The classes.
-         */
-        transactionsHistoryWrapper?: () => string;
-    };
-    /** Custom animation variants */
-    variants?: {
-        /** Container animation variants (`initial`, `animate`, `exit`) */
-        container?: Variants;
-        /** Variants of the "Pulsar adapter required" state */
-        error?: Variants;
-    };
-    /** Custom animation configuration */
-    animation?: {
-        /** Container animation configuration */
-        container?: {
-            /** Animation duration in seconds */
-            duration?: number;
-            /** Animation easing curve */
-            ease?: Easing | Easing[];
-            /** Animation delay in seconds */
-            delay?: number;
-        };
-        /** Animation of the "Pulsar adapter required" state */
-        error?: {
-            /** Animation duration in seconds */
-            duration?: number;
-            /** Animation easing curve */
-            ease?: Easing | Easing[];
-            /** Animation delay in seconds */
-            delay?: number;
-        };
-    };
-    /** Custom event handlers */
-    handlers?: {
-        /**
-         * Called when `@tuwaio/nova-transactions` fails to load or its `TransactionsHistory` throws.
-         *
-         * @param packageName - `config.packageName`.
-         * @param error - The error.
-         */
-        onPackageLoadingFailure?: (packageName: string, error: Error) => void;
-    };
-    /** Configuration options */
-    config?: {
-        /** Renders without Framer Motion (default: `false`) */
-        disableAnimation?: boolean;
-        /** Same as `disableAnimation` (default: `false`) */
-        reduceMotion?: boolean;
-        /** Name passed to `handlers.onPackageLoadingFailure` (default: `@tuwaio/nova-transactions`) */
-        packageName?: string;
-        /** Custom aria labels for different states */
-        ariaLabels?: {
-            /** ARIA label of the container, after the `aria-label` prop (default: the `transactionsInApp` label) */
-            transactionsHistory?: string;
-        };
-    };
-    /**
-     * Customization for the TransactionsHistory component (from @tuwaio/nova-transactions).
-     * Passed through to the dynamically loaded component.
-     */
-    transactionsHistory?: LocalTransactionsHistoryCustomization;
-};
-/**
- * Props for the {@link ConnectedModalTxHistory} component. Without `transactionPool` and `pulsarAdapter` (Pulsar)
- * the "Pulsar adapter required" state is shown. Other props are passed to the container.
- */
-interface ConnectedModalTxHistoryProps extends Pick<NovaConnectProviderProps, 'transactionPool' | 'pulsarAdapter'> {
-    /** Classes added to the default container classes (ignored when `classNames.container` is set) */
-    className?: string;
-    /** ARIA label of the container (default: the `transactionsInApp` label) */
-    'aria-label'?: string;
-    /** Customization options */
-    customization?: ConnectedModalTxHistoryCustomization;
-    /** Pagination state for infinite scroll, forwarded to TransactionsHistory. */
-    pagination?: LocalTxPagination;
-}
-/**
- * The transaction history screen of the connected modal: the `TransactionsHistory` of `@tuwaio/nova-transactions`
- * for the active address (loaded with a dynamic import, without the details view). Shows a loading state while the
- * package loads, an error state when it cannot be loaded, a "Pulsar adapter required" state without
- * `transactionPool` and `pulsarAdapter`, and a message without a connected wallet.
- *
- * Props: {@link ConnectedModalTxHistoryProps}; the ref is forwarded to the container.
- *
- * @example
- * ```tsx
- * import { ConnectedModalTxHistory } from '@tuwaio/nova-connect/components';
- * import type { NovaConnectProviderProps } from '@tuwaio/nova-connect/hooks';
- *
- * type HistoryProps = Pick<NovaConnectProviderProps, 'transactionPool' | 'pulsarAdapter'>;
- *
- * export function History({ transactionPool, pulsarAdapter }: HistoryProps) {
- *   return (
- *     <ConnectedModalTxHistory
- *       transactionPool={transactionPool}
- *       pulsarAdapter={pulsarAdapter}
- *       customization={{
- *         classNames: { loadingContainer: () => 'bg-blue-100' },
- *         handlers: {
- *           onPackageLoadingFailure: (packageName, error) => console.error(packageName, error),
- *         },
- *       }}
- *     />
- *   );
- * }
- * ```
- */
-declare const ConnectedModalTxHistory: React__default.ForwardRefExoticComponent<ConnectedModalTxHistoryProps & React__default.RefAttributes<HTMLDivElement>>;
-
-/**
- * @file Headless SIWX auto-authentication watcher for NovaConnect.
- * Monitors active wallet connections and automatically triggers SIWX signing prompts.
- */
-
-/**
- * Props of {@link NovaSiwxWatcher} (the `siwx` prop of `NovaConnectProvider`): the sign-in callbacks and the SIWX
- * message fields of `getSatelliteSiwxFields` from `@tuwaio/siwx-react` (`domain`, `uri`, `statement`, and so on).
- */
-interface NovaSiwxWatcherProps extends SatelliteSiwxFieldOptions {
-    /** Whether to ask connected wallets to sign in (default: `true`) */
-    enabled?: boolean;
-    /** Fetches the nonce of the SIWX message from your backend */
-    getNonce?: () => Promise<string>;
-    /** Verifies the signed message on your backend (required for the sign-in) */
-    verifier?: UseSiwxSignInOptions['verifier'];
-    /**
-     * Optional callback triggered when the wallet disconnects or when `signOut` is called.
-     * Useful for hitting a `/logout` endpoint to clear the backend cookie.
-     */
-    destroyer?: () => Promise<void>;
-    /** Optional callback triggered immediately after successful SIWX authentication */
-    onSuccess?: UseSiwxSignInOptions['onSuccess'];
-    /** Optional callback triggered if SIWX signing or verification fails */
-    onError?: UseSiwxSignInOptions['onError'];
-}
-/**
- * Signs the connected wallet in with SIWX. `NovaConnectProvider` renders it with its `siwx` prop, so apps do not
- * render it themselves. It renders nothing.
- *
- * - When a wallet connects (or the account changes), it asks the wallet to sign a SIWX message once per address
- *   (`signIn` of `useSiwx` from `@tuwaio/siwx-react`: a wallet prompt, then `getNonce` and `verifier` requests to your
- *   backend). A rejected or failed sign-in disconnects that wallet (if it is still the active one) and calls
- *   `onError`. Without `verifier` it logs a warning and does not sign in.
- * - When no wallet is connected, it clears the SIWX session and calls `destroyer`. After a page load it waits until
- *   Satellite Connect has finished reconnecting (`isAutoConnectFinished`), so the session restored by
- *   `@tuwaio/siwx-react` is kept.
- *
- * @param props - See {@link NovaSiwxWatcherProps}.
- * @returns `null`.
- */
-declare function NovaSiwxWatcher(props: NovaSiwxWatcherProps): null;
-
-/**
- * Status of the latest transaction of the active wallet, shown by the connect button: `loading` while it is pending,
- * then `succeed`, `failed` or `replaced`, and `idle` otherwise.
- */
-type ButtonTxStatus = 'idle' | 'loading' | 'succeed' | 'failed' | 'replaced';
-/**
- * Screen of the connect modal: `connectors` (wallet list), `network` (network choice of a multi-network wallet),
- * `connecting`, `about` ("About wallets"), `getWallet` ("Get a wallet") or `impersonate` (impersonation form).
- */
-type ConnectContentType = 'network' | 'connectors' | 'about' | 'getWallet' | 'connecting' | 'impersonate';
-/**
- * Screen of the connected modal: `main`, `transactions` (history), `chains` (network switch) or `connections`
- * (connected and recent wallets).
- */
-type ConnectedContentType = 'main' | 'transactions' | 'chains' | 'connections';
-/** Legal configuration for Terms of Service and Privacy Policy links */
-interface LegalConfig {
-    /** URL of the terms of service */
-    termsUrl?: string;
-    /** URL of the privacy policy */
-    privacyUrl?: string;
-}
-/**
- * Props of `NovaConnectProvider`. `appChains` and `solanaRPCUrls` give the chains of the app; without both, the
- * modals are not rendered.
- */
-interface NovaConnectProviderProps extends InitialChains {
-    /** Transaction pool of Pulsar: the connect button shows the status of the latest transaction of the wallet */
-    transactionPool?: TransactionPool<Transaction>;
-    /** Pulsar adapter(s); with `transactionPool`, the connected modal shows the transaction history */
-    pulsarAdapter?: TxAdapter<Transaction> | TxAdapter<Transaction>[];
-    /** Whether the connect button shows the native balance */
-    withBalance?: boolean;
-    /** Whether the connect button shows a chain selector */
-    withChain?: boolean;
-    /** Whether the wallet list offers the impersonated wallet (a read-only address, for development) */
-    withImpersonated?: boolean;
-    /** Wallet names of the "Popular" group, in order (default: WalletConnect, Porto, Coinbase, Gemini) */
-    popularConnectors?: string[];
-    /** Extra wallet groups of the wallet list: group title → wallet names, in order */
-    customConnectorGroups?: Record<string, string[]>;
-    /** Legal configuration for Terms of Service and Privacy Policy links */
-    legal?: LegalConfig;
-    /**
-     * SIWX sign-in of the connected wallet (see `NovaSiwxWatcher`). Without it, Nova Connect does not sign in and does
-     * not touch the SIWX session.
-     */
-    siwx?: NovaSiwxWatcherProps;
-    /**
-     * Pagination state for infinite scroll, forwarded to ConnectedModalTxHistory and TransactionsHistory.
-     * Mirrors TxInMemoryPagination from @tuwaio/pulsar-core (optional peer dependency).
-     */
-    pagination?: LocalTxPagination;
-    /** The app */
-    children: React.ReactNode;
-    /** Texts to override, merged over the English defaults */
-    labels?: Partial<NovaConnectLabels>;
-}
-/**
- * A native balance.
+ * A native balance.
  */
 interface WalletBalance {
     /** Formatted amount */
@@ -875,44 +474,445 @@ interface NativeBalanceResult {
     symbol: string;
 }
 /**
- * The balance of {@link useWalletNativeBalance}, or `null` when it is not known.
+ * The balance of {@link useWalletNativeBalance}, or `null` when it is not known.
+ */
+type UseWalletNativeBalanceState = NativeBalanceResult | null;
+/**
+ * Result of {@link useWalletNativeBalance}.
+ */
+interface UseWalletNativeBalanceData {
+    /** The balance, or `null` without a wallet, without `getBalance` or before it resolves */
+    balance: UseWalletNativeBalanceState;
+    /** Whether the balance is being requested */
+    isLoading: boolean;
+    /** Requests the balance again (a failed refresh clears the kept balance) */
+    refetch: () => void;
+}
+/**
+ * Returns the native balance of the active wallet on its chain, from `getBalance` of its Satellite adapter (an RPC
+ * request). Each balance is kept in memory for the address and chain while the component is mounted, so switching
+ * back does not request it again; `refetch` requests it again.
+ *
+ * @returns See {@link UseWalletNativeBalanceData}.
+ *
+ * @example
+ * ```tsx
+ * import { useWalletNativeBalance } from '@tuwaio/nova-connect/hooks';
+ *
+ * export function NativeBalance() {
+ *   const { balance, isLoading, refetch } = useWalletNativeBalance();
+ *
+ *   if (isLoading) return <p>Loading balance...</p>;
+ *
+ *   return (
+ *     <p>
+ *       {balance ? `${balance.value} ${balance.symbol}` : 'n/a'} <button onClick={refetch}>Refresh</button>
+ *     </p>
+ *   );
+ * }
+ * ```
+ */
+declare function useWalletNativeBalance(): UseWalletNativeBalanceData;
+
+/**
+ * @file ConnectedModalTxHistory component with comprehensive customization options for transaction history display.
+ */
+
+/**
+ * Local mirror of TxInMemoryPagination from @tuwaio/pulsar-core.
+ * Defined inline because pulsar-core is an optional peer dependency in nova-connect.
+ */
+type LocalTxPagination = {
+    /** Indicates whether the store is currently loading transaction history. */
+    isLoading: boolean;
+    /** Indicates whether the last loading request ended with an error. */
+    isError: boolean;
+    /** Indicates whether more history pages are available. */
+    hasMore: boolean;
+    /** The current page number in the paginated history. */
+    currentPage: number;
+    /**
+     * Loads the next page of transaction history and appends it to the pool.
+     *
+     * @param walletAddress - The address whose history is loaded.
+     * @returns Resolves when the page is loaded.
+     */
+    fetchNextPage: (walletAddress: string) => Promise<void>;
+};
+/**
+ * Local customization options for TransactionsHistory component.
+ * This is a copy of the type from @tuwaio/nova-transactions to avoid
+ * breaking dynamic import logic.
+ */
+type LocalTransactionsHistoryCustomization = {
+    /** Custom title for the transactions history section */
+    title?: string;
+    /** Custom class name generators */
+    classNames?: {
+        /** Classes for the outer container */
+        container?: string;
+        /** Classes for the title element */
+        titleText?: string;
+        /** Classes for the list wrapper container */
+        listWrapper?: string;
+        /** Classes for the placeholder container */
+        placeholderContainer?: string;
+        /** Classes for the placeholder title */
+        placeholderTitle?: string;
+        /** Classes for the placeholder message */
+        placeholderMessage?: string;
+        /** Classes for the infinite scroll loader container */
+        loaderContainer?: string;
+        /** Classes for the infinite scroll loader icon (spinner) */
+        loaderIcon?: string;
+        /** Classes for the error indicator container */
+        errorContainer?: string;
+        /** Classes for the error indicator icon */
+        errorIcon?: string;
+        /** Classes for individual transaction item container */
+        itemContainer?: string;
+        /** Classes for the icon wrapper */
+        itemIconWrapper?: string;
+        /** Classes for the icon itself */
+        itemIcon?: string;
+        /** Classes for the content wrapper */
+        itemContentWrapper?: string;
+        /** Classes for the title text */
+        itemTitle?: string;
+        /** Classes for the timestamp text */
+        itemTimestamp?: string;
+        /** Classes for the description text */
+        itemDescription?: string;
+        /** Classes for the status badge container */
+        itemStatusBadge?: string;
+        /** Classes for the status badge icon */
+        itemStatusBadgeIcon?: string;
+        /** Classes for the status badge label */
+        itemStatusBadgeLabel?: string;
+        /** Classes for the transaction key container */
+        itemTxKeyContainer?: string;
+        /** Classes for the default hash link label */
+        itemHashLabel?: string;
+        /** Classes for the default hash link */
+        itemHashLink?: string;
+        /** Classes for the default hash copy button */
+        itemHashCopyButton?: string;
+        /** Classes for the original hash link label (replaced transactions) */
+        itemOriginalHashLabel?: string;
+        /** Classes for the original hash link (replaced transactions) */
+        itemOriginalHashLink?: string;
+        /** Classes for the original hash copy button (replaced transactions) */
+        itemOriginalHashCopyButton?: string;
+    };
+};
+/**
+ * Props for a custom loading state (shown while `@tuwaio/nova-transactions` loads).
+ */
+type ConnectedModalTxHistoryLoadingContainerProps = {
+    /** The Nova Connect labels */
+    labels: Record<string, string>;
+    /** Classes from `classNames.loadingContainer` */
+    className?: string;
+    /** Granular classNames for sub-elements */
+    classNames?: {
+        /** From `classNames.loadingSpinner` */
+        spinner?: string;
+        /** From `classNames.loadingText` */
+        text?: string;
+    };
+};
+/**
+ * Props for a custom error state (shown when `@tuwaio/nova-transactions` cannot be loaded or its component throws).
+ */
+type ConnectedModalTxHistoryErrorContainerProps = {
+    /** Classes from `classNames.errorContainer` */
+    className?: string;
+    /** Granular classNames for sub-elements */
+    classNames?: {
+        /** From `classNames.errorIconContainer` */
+        iconContainer?: string;
+        /** From `classNames.errorIcon` */
+        icon?: string;
+        /** From `classNames.errorContent` */
+        content?: string;
+        /** From `classNames.errorTitle` */
+        title?: string;
+        /** From `classNames.errorDescription` */
+        description?: string;
+    };
+};
+/**
+ * Props for a custom state without a connected wallet.
+ */
+type ConnectedModalTxHistoryNoWalletContainerProps = {
+    /** Classes from `classNames.noWalletContainer` */
+    className?: string;
+    /** Granular classNames for sub-elements */
+    classNames?: {
+        /** From `classNames.noWalletText` */
+        text?: string;
+    };
+};
+/**
+ * Props for a custom wrapper of the `TransactionsHistory` of `@tuwaio/nova-transactions`.
+ */
+type ConnectedModalTxHistoryTransactionsHistoryWrapperProps = {
+    /** The transaction history */
+    children: ReactNode;
+    /** The active address */
+    activeConnectionAddress: string;
+    /** The `transactionPool` prop */
+    transactionPool: NonNullable<NovaConnectProviderProps['transactionPool']>;
+    /** The `pulsarAdapter` prop */
+    pulsarAdapter: NonNullable<NovaConnectProviderProps['pulsarAdapter']>;
+    /** The Nova Connect labels */
+    labels: Record<string, string>;
+    /** Classes from `classNames.transactionsHistoryWrapper` */
+    className?: string;
+};
+/**
+ * Customization options of {@link ConnectedModalTxHistory}.
  */
-type UseWalletNativeBalanceState = NativeBalanceResult | null;
+type ConnectedModalTxHistoryCustomization = {
+    /** Props of the container (the component props, `className` and `aria-label` take precedence) */
+    containerProps?: Partial<Omit<ComponentPropsWithoutRef<'div'>, 'popover' | 'onDrag' | 'onDragEnd' | 'onDragExit' | 'onDragStart' | 'onDragStartCapture' | 'onAnimationStart' | 'onAnimationEnd' | 'onAnimationStartCapture' | 'onAnimationEndCapture' | 'onAnimationIteration' | 'onAnimationIterationCapture'>>;
+    /** Custom components */
+    components?: {
+        /** Custom loading container component */
+        LoadingContainer?: ComponentType<ConnectedModalTxHistoryLoadingContainerProps>;
+        /** Custom error container component */
+        ErrorContainer?: ComponentType<ConnectedModalTxHistoryErrorContainerProps>;
+        /** Custom no wallet container component */
+        NoWalletContainer?: ComponentType<ConnectedModalTxHistoryNoWalletContainerProps>;
+        /** Custom transactions history wrapper component */
+        TransactionsHistoryWrapper?: ComponentType<ConnectedModalTxHistoryTransactionsHistoryWrapperProps>;
+    };
+    /** Custom class name generators */
+    classNames?: {
+        /**
+         * Returns the classes of the container, instead of the default ones and the `className` prop.
+         *
+         * @param params - The state.
+         * @param params.hasActiveWallet - Whether a wallet is connected.
+         * @param params.hasValidAdapter - Whether `transactionPool` and `pulsarAdapter` are set.
+         * @returns The classes.
+         */
+        container?: (params: {
+            hasActiveWallet: boolean;
+            hasValidAdapter: boolean;
+        }) => string;
+        /**
+         * Returns classes of the loading state, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        loadingContainer?: () => string;
+        /**
+         * Returns classes of the loading spinner, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        loadingSpinner?: () => string;
+        /**
+         * Returns classes of the loading text, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        loadingText?: () => string;
+        /**
+         * Returns classes of the error state, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorContainer?: () => string;
+        /**
+         * Returns classes of the error icon container, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorIconContainer?: () => string;
+        /**
+         * Returns classes of the error icon, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorIcon?: () => string;
+        /**
+         * Returns classes of the error texts, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorContent?: () => string;
+        /**
+         * Returns classes of the error title, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorTitle?: () => string;
+        /**
+         * Returns classes of the error description, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorDescription?: () => string;
+        /**
+         * Returns classes of the state without a wallet, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        noWalletContainer?: () => string;
+        /**
+         * Returns classes of the text without a wallet, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        noWalletText?: () => string;
+        /**
+         * Returns classes of the "Pulsar adapter required" state, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredContainer?: () => string;
+        /**
+         * Returns classes of its icon container, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredIconContainer?: () => string;
+        /**
+         * Returns classes of its icon, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredIcon?: () => string;
+        /**
+         * Returns classes of its texts, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredContent?: () => string;
+        /**
+         * Returns classes of its title, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredTitle?: () => string;
+        /**
+         * Returns classes of its description, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredDescription?: () => string;
+        /**
+         * Returns classes of the transaction history wrapper, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        transactionsHistoryWrapper?: () => string;
+    };
+    /** Custom animation variants */
+    variants?: {
+        /** Container animation variants (`initial`, `animate`, `exit`) */
+        container?: Variants;
+        /** Variants of the "Pulsar adapter required" state */
+        error?: Variants;
+    };
+    /** Custom animation configuration */
+    animation?: {
+        /** Container animation configuration */
+        container?: {
+            /** Animation duration in seconds */
+            duration?: number;
+            /** Animation easing curve */
+            ease?: Easing | Easing[];
+            /** Animation delay in seconds */
+            delay?: number;
+        };
+        /** Animation of the "Pulsar adapter required" state */
+        error?: {
+            /** Animation duration in seconds */
+            duration?: number;
+            /** Animation easing curve */
+            ease?: Easing | Easing[];
+            /** Animation delay in seconds */
+            delay?: number;
+        };
+    };
+    /** Custom event handlers */
+    handlers?: {
+        /**
+         * Called when `@tuwaio/nova-transactions` fails to load or its `TransactionsHistory` throws.
+         *
+         * @param packageName - `config.packageName`.
+         * @param error - The error.
+         */
+        onPackageLoadingFailure?: (packageName: string, error: Error) => void;
+    };
+    /** Configuration options */
+    config?: {
+        /** Renders without Framer Motion (default: `false`) */
+        disableAnimation?: boolean;
+        /** Same as `disableAnimation` (default: `false`) */
+        reduceMotion?: boolean;
+        /** Name passed to `handlers.onPackageLoadingFailure` (default: `@tuwaio/nova-transactions`) */
+        packageName?: string;
+        /** Custom aria labels for different states */
+        ariaLabels?: {
+            /** ARIA label of the container, after the `aria-label` prop (default: the `transactionsInApp` label) */
+            transactionsHistory?: string;
+        };
+    };
+    /**
+     * Customization for the TransactionsHistory component (from @tuwaio/nova-transactions).
+     * Passed through to the dynamically loaded component.
+     */
+    transactionsHistory?: LocalTransactionsHistoryCustomization;
+};
 /**
- * Result of {@link useWalletNativeBalance}.
+ * Props for the {@link ConnectedModalTxHistory} component. Without `transactionPool` and `pulsarAdapter` (Pulsar)
+ * the "Pulsar adapter required" state is shown. Other props are passed to the container.
  */
-interface UseWalletNativeBalanceData {
-    /** The balance, or `null` without a wallet, without `getBalance` or before it resolves */
-    balance: UseWalletNativeBalanceState;
-    /** Whether the balance is being requested */
-    isLoading: boolean;
-    /** Requests the balance again (a failed refresh clears the kept balance) */
-    refetch: () => void;
+interface ConnectedModalTxHistoryProps extends Pick<NovaConnectProviderProps, 'transactionPool' | 'pulsarAdapter'> {
+    /** Classes added to the default container classes (ignored when `classNames.container` is set) */
+    className?: string;
+    /** ARIA label of the container (default: the `transactionsInApp` label) */
+    'aria-label'?: string;
+    /** Customization options */
+    customization?: ConnectedModalTxHistoryCustomization;
+    /** Pagination state for infinite scroll, forwarded to TransactionsHistory. */
+    pagination?: LocalTxPagination;
 }
 /**
- * Returns the native balance of the active wallet on its chain, from `getBalance` of its Satellite adapter (an RPC
- * request). Each balance is kept in memory for the address and chain while the component is mounted, so switching
- * back does not request it again; `refetch` requests it again.
+ * The transaction history screen of the connected modal: the `TransactionsHistory` of `@tuwaio/nova-transactions`
+ * for the active address (loaded with a dynamic import, without the details view). Shows a loading state while the
+ * package loads, an error state when it cannot be loaded, a "Pulsar adapter required" state without
+ * `transactionPool` and `pulsarAdapter`, and a message without a connected wallet.
  *
- * @returns See {@link UseWalletNativeBalanceData}.
+ * Props: {@link ConnectedModalTxHistoryProps}; the ref is forwarded to the container.
  *
  * @example
  * ```tsx
- * import { useWalletNativeBalance } from '@tuwaio/nova-connect/hooks';
- *
- * export function NativeBalance() {
- *   const { balance, isLoading, refetch } = useWalletNativeBalance();
+ * import { ConnectedModalTxHistory } from '@tuwaio/nova-connect/components';
+ * import type { NovaConnectProviderProps } from '@tuwaio/nova-connect/hooks';
  *
- *   if (isLoading) return <p>Loading balance...</p>;
+ * type HistoryProps = Pick<NovaConnectProviderProps, 'transactionPool' | 'pulsarAdapter'>;
  *
+ * export function History({ transactionPool, pulsarAdapter }: HistoryProps) {
  *   return (
- *     <p>
- *       {balance ? `${balance.value} ${balance.symbol}` : 'n/a'} <button onClick={refetch}>Refresh</button>
- *     </p>
+ *     <ConnectedModalTxHistory
+ *       transactionPool={transactionPool}
+ *       pulsarAdapter={pulsarAdapter}
+ *       customization={{
+ *         classNames: { loadingContainer: () => 'bg-blue-100' },
+ *         handlers: {
+ *           onPackageLoadingFailure: (packageName, error) => console.error(packageName, error),
+ *         },
+ *       }}
+ *     />
  *   );
  * }
  * ```
  */
-declare function useWalletNativeBalance(): UseWalletNativeBalanceData;
+declare const ConnectedModalTxHistory: React__default.ForwardRefExoticComponent<ConnectedModalTxHistoryProps & React__default.RefAttributes<HTMLDivElement>>;
 
 export { type AllChainConfigs as A, type ButtonTxStatus as B, type ConnectContentType as C, ConnectedModalTxHistory as D, type ConnectedModalTxHistoryErrorContainerProps as E, type ConnectedModalTxHistoryLoadingContainerProps as F, type ConnectedModalTxHistoryNoWalletContainerProps as G, type ConnectedModalTxHistoryProps as H, type InitialChains as I, type ConnectedModalTxHistoryTransactionsHistoryWrapperProps as J, type LocalTransactionsHistoryCustomization as K, type LabelCategory as L, type LocalTxPagination as M, type NovaConnectProviderProps as N, type UseWalletNativeBalanceData as U, type WalletBalance as W, type ConnectedContentType as a, type NovaConnectProviderType as b, type LegalConfig as c, type NativeBalanceResult as d, type NovaConnectAppChains as e, type NovaConnectChainConfigTypes as f, NovaConnectLabelsContext as g, NovaConnectProviderContext as h, NovaConnectProviderError as i, type NovaConnectSolanaRPCUrls as j, NovaSiwxWatcher as k, type NovaSiwxWatcherProps as l, type UseWalletNativeBalanceState as m, createLabelsSubset as n, getLabelWithFallback as o, hasLabel as p, isDefaultLabels as q, useLabelsByCategory as r, useNovaConnect as s, useNovaConnectLabel as t, useHasNovaConnectContext as u, useNovaConnectLabels as v, useNovaConnectLabelsSubset as w, useNovaConnectOptional as x, useWalletNativeBalance as y, type ConnectedModalTxHistoryCustomization as z };