@tuwaio/nova-transactions 0.0.14 → 1.0.0-alpha.1.72f68be

package/dist/{types-bqi7UbSO.d.cts → TransactionsHistory-Bz0XaDda.d.cts}

@@ -1,12 +1,9 @@
-import { TransactionStatus, Transaction, TransactionPool, ITxTrackingStore } from '@tuwaio/pulsar-core';
-import { Config } from '@wagmi/core';
+import { TransactionStatus, Transaction, TxAdapter, TransactionAdapter, TxActions, TransactionPool, IInitializeTxTrackingStore, ITxTrackingStore } from '@tuwaio/pulsar-core';
 import { ReactNode, JSX, ComponentType, ComponentPropsWithoutRef } from 'react';
-import { ToastContentProps, ToastContainerProps } from 'react-toastify';
-import { Chain, Address } from 'viem';
+import { ToastContainerProps, ToastContentProps } from 'react-toastify';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as Dialog from '@radix-ui/react-dialog';
-import { ActionTxKey } from '@tuwaio/pulsar-evm';
 import { MotionProps } from 'framer-motion';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
  * @file This file contains the `HashLink` component, a UI element for displaying hashes with copy and explorer link functionality.
@@ -63,186 +60,171 @@ type StatusAwareTextProps = {
 declare function StatusAwareText({ txStatus, source, fallback, variant, className, applyColor, }: StatusAwareTextProps): ReactNode;
 
 /**
- * @file This file contains the `TransactionStatusBadge` component for visually displaying a transaction's status.
- */
-
-type TransactionStatusBadgeProps<TR, T extends Transaction<TR>> = {
-    /** The transaction object whose status will be displayed. */
-    tx: T;
-    /** Optional additional CSS classes to apply to the badge container. */
-    className?: string;
-};
-/**
- * A component that displays a transaction's status as a styled badge
- * with a corresponding icon, color, and label.
- *
- * @param {TransactionStatusBadgeProps<TR, T>} props - The component props.
- * @returns {JSX.Element} The rendered status badge.
- */
-declare function TransactionStatusBadge<TR, T extends Transaction<TR>>({ tx, className, }: TransactionStatusBadgeProps<TR, T>): JSX.Element;
-
-/**
- * @file This file contains the `TransactionHistoryItem` component, which renders a single transaction
- * in a list format for the transaction history view.
+ * @file This file defines the TypeScript type for the library's internationalization (i18n) labels.
+ * It provides a strict structure for all text used in the UI components, ensuring type safety for different languages.
  */
-
-type CustomIconProps = {
-    chainId: number;
-};
-type CustomStatusAwareTextProps$1 = Parameters<typeof StatusAwareText>[0];
-type CustomTimestampProps = {
-    timestamp?: number;
-};
-type CustomStatusBadgeProps$1<TR, T extends Transaction<TR>> = Parameters<typeof TransactionStatusBadge<TR, T>>[0];
-type CustomTransactionKeyProps$1<TR, T extends Transaction<TR>> = Parameters<typeof TransactionKey<TR, T>>[0];
 /**
- * Defines the structure for the `customization` prop, allowing users to override
- * default sub-components with their own implementations for a history item.
+ * Defines the complete structure for all customizable text labels used throughout the transaction tracking UI components.
  */
-type TransactionHistoryItemCustomization<TR, T extends Transaction<TR>> = {
-    components?: {
-        /** Override the default chain icon. */
-        icon?: (props: CustomIconProps) => ReactNode;
-        /** Override the default title component. */
-        title?: (props: CustomStatusAwareTextProps$1) => ReactNode;
-        /** Override the default description component. */
-        description?: (props: CustomStatusAwareTextProps$1) => ReactNode;
-        /** Override the default timestamp component. */
-        timestamp?: (props: CustomTimestampProps) => ReactNode;
-        /** Override the default status badge component. */
-        statusBadge?: (props: CustomStatusBadgeProps$1<TR, T>) => ReactNode;
-        /** Override the default component for displaying transaction keys/hashes. */
-        transactionKey?: (props: CustomTransactionKeyProps$1<TR, T>) => ReactNode;
+type TuwaLabels = {
+    /** Labels for the main wallet information modal. */
+    walletModal: {
+        /** The title displayed at the top of the wallet modal. */
+        title: string;
+        header: {
+            /** Text displayed when no wallet is connected. */
+            notConnected: string;
+            /** Alt text for the wallet's avatar image. */
+            avatarAlt: string;
+        };
+        history: {
+            /** The title for the transaction history section. */
+            title: string;
+            /** The title displayed when the user needs to connect a wallet to see history. */
+            connectWalletTitle: string;
+            /** The message displayed when the user needs to connect a wallet. */
+            connectWalletMessage: string;
+            /** The title displayed when the connected wallet has no transaction history. */
+            noTransactionsTitle: string;
+            /** The message displayed when there are no transactions to show. */
+            noTransactionsMessage: string;
+        };
     };
-};
-type TransactionHistoryItemProps<TR, T extends Transaction<TR>> = {
-    /** The transaction object to display. */
-    tx: T;
-    /** An array of supported chain objects. */
-    appChains: Chain[];
-    /** The entire pool of transactions. */
-    transactionsPool: TransactionPool<TR, T>;
-    /** Optional additional CSS classes for the container. */
-    className?: string;
-    /** An object to customize and override the default internal components. */
-    customization?: TransactionHistoryItemCustomization<TR, T>;
-};
-/**
- * A component that renders a single row in the transaction history list.
- * It is highly customizable via the `customization` prop.
- *
- * @param {TransactionHistoryItemProps<TR, T>} props - The component props.
- * @returns {JSX.Element} The rendered history item.
- */
-declare function TransactionHistoryItem<TR, T extends Transaction<TR>>({ tx, appChains, transactionsPool, className, customization, }: TransactionHistoryItemProps<TR, T>): JSX.Element;
-
-/**
- * @file This file contains the `TransactionsHistory` component, which displays a list of past and pending transactions.
- */
-
-type CustomPlaceholderProps = {
-    title: string;
-    message: string;
-};
-/**
- * Defines the customization options for the TransactionsHistory component.
- */
-type TransactionsHistoryCustomization<TR, T extends Transaction<TR>> = {
-    classNames?: {
-        /** CSS classes for the list's wrapper `div`. */
-        listWrapper?: string;
+    /** Labels related to toast notifications. */
+    toast: {
+        /** Text for the button/link within a toast to open the wallet modal. */
+        openWalletInfo: string;
     };
-    components?: {
-        /**
-         * A render prop to replace the default placeholder component
-         * (e.g., for "Connect Wallet" or "No Transactions").
-         */
-        placeholder?: (props: CustomPlaceholderProps) => ReactNode;
-        /**
-         * A custom component to use instead of the default `TransactionHistoryItem`.
-         * This should be a component type, not a render function.
-         */
-        HistoryItem?: ComponentType<TransactionHistoryItemProps<TR, T>>;
+    /** Standard labels for transaction statuses. */
+    statuses: {
+        /** Text for a pending transaction. */
+        pending: string;
+        /** Text for a successful transaction. */
+        success: string;
+        /** Text for a failed transaction. */
+        failed: string;
+        /** Text for a reverted transaction. */
+        reverted: string;
+        /** Text for a replaced transaction (e.g., sped up). */
+        replaced: string;
+        /** Text for an unknown or indeterminate status. */
+        unknown: string;
+    };
+    /** Labels for different types of transaction hashes/keys. */
+    hashLabels: {
+        /** Label for a Gelato Task ID. */
+        gelato: string;
+        /** Label for a Safe Transaction Hash. */
+        safe: string;
+        /** Label for the original transaction hash (before replacement). */
+        original: string;
+        /** Label for the new transaction hash that replaced the original. */
+        replaced: string;
+        /** Default label for a standard transaction hash. */
+        default: string;
+    };
+    /** Labels for the transaction information block. */
+    txInfo: {
+        /** Label indicating when the transaction was started. */
+        started: string;
+        /** Label for the network name. */
+        network: string;
+    };
+    /** Labels for the transaction error block. */
+    txError: {
+        /** The title for the error details section. */
+        title: string;
+        /** Confirmation text shown after copying an error message. */
+        copied: string;
+    };
+    /** Labels for the detailed transaction tracking modal. */
+    trackingModal: {
+        /** The main title of the tracking modal. */
+        title: string;
+        /** Text indicating that the transaction is being processed. */
+        processing: string;
+        /** Label for the close button. */
+        close: string;
+        /** Label for the button to open the main wallet info modal. */
+        walletInfo: string;
+        /** Label for a button to retry a transaction. */
+        retry: string;
+        /** Labels for the step-by-step progress indicator. */
+        progressIndicator: {
+            /** Label for the "transaction created" step. */
+            created: string;
+            /** Label for the "processing" step. */
+            processing: string;
+            /** Label for the "succeed" or final step. */
+            succeed: string;
+        };
+    };
+    /** Labels for the main transaction action button. */
+    trackedTxButton: {
+        /** Text shown on the button while the transaction is initializing. */
+        loading: string;
+        /** Text shown on the button after the transaction succeeds. */
+        succeed: string;
+        /** Text shown on the button if the transaction fails to initialize. */
+        failed: string;
+        /** Text shown on the button if the transaction replaced to initialize. */
+        replaced: string;
+    };
+    /** Labels for common action buttons/links. */
+    actions: {
+        /** Text for a "Copy" action (e.g., copy address or hash). */
+        copy: string;
+        /** Text for a link to view the transaction on a block explorer. */
+        viewOnExplorer: string;
+        /** Text for a generic "Close" action. */
+        close: string;
+        /** Text for a generic "Cancel" action. */
+        cancel: string;
+        /** Text for a generic "Speed up" action. */
+        speedUp: string;
     };
 };
-/**
- * A component that displays a scrollable list of transactions for the connected wallet.
- * It handles states for when a wallet is not connected or when there is no history.
- *
- * @param {WalletInfoModalProps<TR, T> & { customization?: TransactionsHistoryCustomization<TR, T> }} props
- * @returns {JSX.Element} The rendered transaction history section.
- */
-declare function TransactionsHistory<TR, T extends Transaction<TR>>({ walletAddress, transactionsPool, appChains, className, customization, }: WalletInfoModalProps<TR, T> & {
-    className?: string;
-    customization?: TransactionsHistoryCustomization<TR, T>;
-}): JSX.Element;
 
 /**
- * @file This file contains the main `WalletInfoModal` component, which serves as the primary UI for viewing wallet details and transaction history.
+ * @file This file contains the main `NovaProvider` component, the primary entry point for the UI library.
  */
 
-type CustomHeaderProps$1 = {
-    closeModal: () => void;
-};
-type CustomWalletInfoProps<TR, T extends Transaction<TR>> = WalletInfoModalProps<TR, T>;
-type CustomHistoryProps<TR, T extends Transaction<TR>> = WalletInfoModalProps<TR, T> & {
-    customization?: TransactionsHistoryCustomization<TR, T>;
-};
-/**
- * Defines the customization options for the WalletInfoModal.
- * Allows customization of modal behavior, animations, and individual UI components.
- */
-type WalletInfoModalCustomization<TR, T extends Transaction<TR>> = {
-    /** Custom props to pass to the underlying Radix UI Dialog.Content component */
-    modalProps?: Partial<ComponentPropsWithoutRef<typeof Dialog.Content>>;
-    /** Custom Framer Motion animation properties */
-    motionProps?: MotionProps;
-    classNames?: {
-        /** CSS classes for the main content wrapper div. */
-        contentWrapper?: string;
+type NovaProviderProps<TR, T extends Transaction<TR>, A> = {
+    adapters: TxAdapter<TR, T, A>[];
+    connectedWalletAddress?: string;
+    connectedAdapterType?: TransactionAdapter;
+    /** A partial object of labels to override the default English text. */
+    labels?: Partial<TuwaLabels>;
+    /** An object to enable or disable major UI features. All are enabled by default. */
+    features?: {
+        toasts?: boolean;
+        walletInfoModal?: boolean;
+        trackingTxModal?: boolean;
     };
-    /** Custom component overrides for different parts of the modal */
-    components?: {
-        /** A render prop to replace the entire modal header. */
-        header?: (props: CustomHeaderProps$1) => ReactNode;
-        /** A render prop to replace the `WalletHeader` component. */
-        walletInfo?: (props: CustomWalletInfoProps<TR, T>) => ReactNode;
-        /** A render prop to replace the `TransactionsHistory` component. */
-        history?: (props: CustomHistoryProps<TR, T>) => ReactNode;
+    /** A single object to pass down deep customization options to all child components. */
+    customization?: {
+        toast?: ToastTransactionCustomization<TR, T, A>;
+        walletInfoModal?: WalletInfoModalCustomization<TR, T, A>;
+        trackingTxModal?: TrackingTxModalCustomization<TR, T, A>;
     };
-};
-/**
- * Defines the core props for the WalletInfoModal and its children.
- */
-interface WalletInfoModalProps<TR, T extends Transaction<TR>> {
-    /** The connected wallet's address. */
-    walletAddress?: Address;
-    /** The viem `Chain` object for the currently connected network. */
-    chain?: Chain;
-    /** The entire pool of transactions from the store. */
+    /** A registry of retryable actions, keyed by `actionKey`. */
+    actions?: TxActions;
+    /** The global transaction pool from the tracking store. */
     transactionsPool: TransactionPool<TR, T>;
-    /** An array of all chains supported by the application. */
-    appChains: Chain[];
-}
+} & Pick<IInitializeTxTrackingStore<TR, T>, 'closeTxTrackedModal'> & Partial<Pick<ITxTrackingStore<TR, T, A>, 'handleTransaction' | 'initialTx'>> & ToastContainerProps;
 /**
- * The main modal component for displaying wallet information and transaction history.
- * It is highly customizable through the `customization` prop and supports full Radix UI Dialog customization.
+ * The main provider for the Nova UI ecosystem.
+ * It orchestrates toasts, modals, and the i18n context for the entire application.
  *
- * @param {WalletInfoModalProps<TR, T> & { ... }} props - The component props.
- * @returns {JSX.Element | null} The rendered modal or null if not open.
+ * @param {NovaProviderProps<TR, T>} props - The component props.
+ * @returns {JSX.Element} The rendered provider.
  */
-declare function WalletInfoModal<TR, T extends Transaction<TR>>({ isOpen, setIsOpen, customization, ...props }: WalletInfoModalProps<TR, T> & {
-    isOpen: boolean;
-    setIsOpen: (value: boolean) => void;
-    customization?: WalletInfoModalCustomization<TR, T>;
-}): JSX.Element | null;
+declare function NovaProvider<TR, T extends Transaction<TR>, A>({ adapters, connectedWalletAddress, connectedAdapterType, labels, features, customization, closeTxTrackedModal, actions, handleTransaction, initialTx, transactionsPool, ...toastProps }: NovaProviderProps<TR, T, A>): JSX.Element;
 
 type CustomHashLinkProps = Parameters<typeof HashLink>[0];
-interface ToastTransactionKeyProps<TR, T extends Transaction<TR>> extends Pick<WalletInfoModalProps<TR, T>, 'transactionsPool'> {
+interface ToastTransactionKeyProps<TR, T extends Transaction<TR>, A> extends Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'transactionsPool'> {
     /** The transaction object to display identifiers for. */
     tx: T;
-    /** An array of supported chain objects, used for generating explorer links. */
-    appChains: Chain[];
     /** The visual variant, which applies different container styles. */
     variant?: 'toast' | 'history';
     /** Optional additional CSS classes for the container. */
@@ -260,15 +242,34 @@ interface ToastTransactionKeyProps<TR, T extends Transaction<TR>> extends Pick<W
  * @param {ToastTransactionKeyProps<TR, T>} props - The component props.
  * @returns {JSX.Element} The rendered component.
  */
-declare function TransactionKey<TR, T extends Transaction<TR>>({ tx, appChains, transactionsPool, variant, className, renderHashLink, }: ToastTransactionKeyProps<TR, T>): react_jsx_runtime.JSX.Element | null;
+declare function TransactionKey<TR, T extends Transaction<TR>, A>({ tx, adapters, transactionsPool, variant, className, renderHashLink, }: ToastTransactionKeyProps<TR, T, A>): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * @file This file contains the `TransactionStatusBadge` component for visually displaying a transaction's status.
+ */
+
+type TransactionStatusBadgeProps<TR, T extends Transaction<TR>> = {
+    /** The transaction object whose status will be displayed. */
+    tx: T;
+    /** Optional additional CSS classes to apply to the badge container. */
+    className?: string;
+};
+/**
+ * A component that displays a transaction's status as a styled badge
+ * with a corresponding icon, color, and label.
+ *
+ * @param {TransactionStatusBadgeProps<TR, T>} props - The component props.
+ * @returns {JSX.Element} The rendered status badge.
+ */
+declare function TransactionStatusBadge<TR, T extends Transaction<TR>>({ tx, className, }: TransactionStatusBadgeProps<TR, T>): JSX.Element;
 
 /**
  * @file This file contains the `ToastTransaction` component, which serves as the main body for a transaction notification toast.
  */
 
-type CustomStatusAwareTextProps = Parameters<typeof StatusAwareText>[0];
-type CustomTransactionKeyProps<TR, T extends Transaction<TR>> = Parameters<typeof TransactionKey<TR, T>>[0];
-type CustomStatusBadgeProps<TR, T extends Transaction<TR>> = Parameters<typeof TransactionStatusBadge<TR, T>>[0];
+type CustomStatusAwareTextProps$1 = Parameters<typeof StatusAwareText>[0];
+type CustomTransactionKeyProps$1<TR, T extends Transaction<TR>, A> = Parameters<typeof TransactionKey<TR, T, A>>[0];
+type CustomStatusBadgeProps$1<TR, T extends Transaction<TR>> = Parameters<typeof TransactionStatusBadge<TR, T>>[0];
 /** Props provided to custom action buttons like 'Wallet Info', 'Speed Up', or 'Cancel'. */
 type CustomActionButtonProps = {
     onClick: () => void;
@@ -278,14 +279,14 @@ type CustomActionButtonProps = {
  * Defines the structure for the `customization` prop, allowing users to override
  * default sub-components with their own implementations.
  */
-type ToastTransactionCustomization<TR, T extends Transaction<TR>> = {
+type ToastTransactionCustomization<TR, T extends Transaction<TR>, A> = {
     components?: {
         /** Override the default title/description component. */
-        statusAwareText?: (props: CustomStatusAwareTextProps) => ReactNode;
+        statusAwareText?: (props: CustomStatusAwareTextProps$1) => ReactNode;
         /** Override the default component for displaying transaction keys/hashes. */
-        transactionKey?: (props: CustomTransactionKeyProps<TR, T>) => ReactNode;
+        transactionKey?: (props: CustomTransactionKeyProps$1<TR, T, A>) => ReactNode;
         /** Override the default status badge component. */
-        statusBadge?: (props: CustomStatusBadgeProps<TR, T>) => ReactNode;
+        statusBadge?: (props: CustomStatusBadgeProps$1<TR, T>) => ReactNode;
         /** Override the default "Open wallet info" button. */
         walletInfoButton?: (props: CustomActionButtonProps) => ReactNode;
         /** Override the default "Speed Up" button. */
@@ -294,25 +295,21 @@ type ToastTransactionCustomization<TR, T extends Transaction<TR>> = {
         cancelButton?: (props: CustomActionButtonProps) => ReactNode;
     };
 };
-type ToastTransactionProps<TR, T extends Transaction<TR>> = {
+type ToastTransactionProps<TR, T extends Transaction<TR>, A> = {
     /** The transaction object to display in the toast. */
     tx: T;
     /** A function to open the main wallet info modal. If not provided, the button will not be rendered. */
     openWalletInfoModal?: (value: boolean) => void;
-    /** An array of supported chain objects, used for displaying network information. */
-    appChains: Chain[];
     /** An optional custom icon to display instead of the default chain icon. */
     icon?: ReactNode;
     /** Optional additional CSS classes for the toast container. */
     className?: string;
     /** An object to customize and override the default internal components. */
-    customization?: ToastTransactionCustomization<TR, T>;
-    /** The wagmi config object, required for Speed Up and Cancel functionality. */
-    config?: Config;
+    customization?: ToastTransactionCustomization<TR, T, A>;
     /** Props from `react-toastify` to control the toast itself. */
     closeToast?: ToastContentProps['closeToast'];
     toastProps?: ToastContainerProps;
-} & Pick<WalletInfoModalProps<TR, T>, 'transactionsPool'>;
+} & Pick<NovaProviderProps<TR, T, A>, 'transactionsPool' | 'adapters' | 'connectedWalletAddress'>;
 /**
  * A composite component that renders the content for a transaction toast notification.
  * It is highly customizable and includes actions for speeding up or canceling transactions
@@ -323,7 +320,7 @@ type ToastTransactionProps<TR, T extends Transaction<TR>> = {
  * @param {ToastTransactionProps<TR, T>} props The component props.
  * @returns {JSX.Element} The rendered toast body.
  */
-declare function ToastTransaction<TR, T extends Transaction<TR>>({ openWalletInfoModal, tx, transactionsPool, appChains, icon, className, customization, config, }: ToastTransactionProps<TR, T>): JSX.Element;
+declare function ToastTransaction<TR, T extends Transaction<TR>, A>({ openWalletInfoModal, tx, transactionsPool, icon, className, customization, connectedWalletAddress, adapters, }: ToastTransactionProps<TR, T, A>): JSX.Element;
 
 type TxErrorBlockProps = {
     /** The error message string to display. If undefined, the component renders nothing. */
@@ -352,7 +349,7 @@ type CustomInfoRowProps = {
 /**
  * Defines the customization options for the `TxInfoBlock` component.
  */
-type TxInfoBlockCustomization<TR, T extends Transaction<TR>> = {
+type TxInfoBlockCustomization<TR, T extends Transaction<TR>, A> = {
     components?: {
         /** A render prop to replace the default label-value row component. */
         infoRow?: (props: CustomInfoRowProps) => ReactNode;
@@ -360,18 +357,16 @@ type TxInfoBlockCustomization<TR, T extends Transaction<TR>> = {
          * A render prop to customize the rendering of the transaction keys/hashes.
          * This is passed down to the underlying `TransactionKey` component.
          */
-        transactionKey?: ToastTransactionKeyProps<TR, T>['renderHashLink'];
+        transactionKey?: ToastTransactionKeyProps<TR, T, A>['renderHashLink'];
     };
 };
-type TxInfoBlockProps<TR, T extends Transaction<TR>> = {
+type TxInfoBlockProps<TR, T extends Transaction<TR>, A> = {
     tx: T & {
         desiredChainID?: number;
     };
-    appChains: Chain[];
-    transactionsPool: TransactionPool<TR, T>;
     className?: string;
-    customization?: TxInfoBlockCustomization<TR, T>;
-};
+    customization?: TxInfoBlockCustomization<TR, T, A>;
+} & Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'transactionsPool'>;
 /**
  * A component that displays a block of essential transaction details,
  * such as network, start time, and relevant hashes/keys.
@@ -379,7 +374,7 @@ type TxInfoBlockProps<TR, T extends Transaction<TR>> = {
  * @param {object} props - The component props.
  * @returns {JSX.Element} The rendered info block.
  */
-declare function TxInfoBlock<TR, T extends Transaction<TR>>({ tx, appChains, transactionsPool, className, customization, }: TxInfoBlockProps<TR, T>): JSX.Element;
+declare function TxInfoBlock<TR, T extends Transaction<TR>, A>({ tx, adapters, transactionsPool, className, customization, }: TxInfoBlockProps<TR, T, A>): JSX.Element;
 
 /**
  * @file This file contains the `TxProgressIndicator` component, a visual step-by-step progress bar for transactions.
@@ -434,7 +429,7 @@ type TxStatusVisualProps = {
 declare function TxStatusVisual({ isProcessing, isSucceed, isFailed, isReplaced }: TxStatusVisualProps): JSX.Element;
 
 /** Props provided to a custom header component. */
-type CustomHeaderProps = {
+type CustomHeaderProps$1 = {
     onClose: (txKey?: string) => void;
 };
 /** Props provided to a custom footer component. */
@@ -446,28 +441,26 @@ type CustomFooterProps = {
     onCancel?: () => void;
     isProcessing?: boolean;
 };
-/** A registry of functions that can be re-executed via the 'Retry' button. The key should match `actionKey` on a transaction. */
-type TxActions = Record<string, (...args: any[]) => Promise<unknown>>;
 /**
  * Defines the customization options for the TrackingTxModal.
  * Allows overriding modal behavior, animations, and individual UI components.
  */
-type TrackingTxModalCustomization<TR, T extends Transaction<TR>> = {
+type TrackingTxModalCustomization<TR, T extends Transaction<TR>, A> = {
     /** Custom props to pass to the underlying Radix UI `Dialog.Content` component. */
     modalProps?: Partial<ComponentPropsWithoutRef<typeof Dialog.Content>>;
     /** Custom Framer Motion animation properties for the modal's entrance and exit. */
     motionProps?: MotionProps;
     /** A record of custom components to override parts of the modal's UI. */
     components?: {
-        header?: (props: CustomHeaderProps) => ReactNode;
+        header?: (props: CustomHeaderProps$1) => ReactNode;
         footer?: (props: CustomFooterProps) => ReactNode;
         statusVisual?: (props: TxStatusVisualProps) => ReactNode;
         progressIndicator?: (props: TxProgressIndicatorProps) => ReactNode;
-        infoBlock?: (props: TxInfoBlockProps<TR, T>) => ReactNode;
+        infoBlock?: (props: TxInfoBlockProps<TR, T, A>) => ReactNode;
         errorBlock?: (props: TxErrorBlockProps) => ReactNode;
     };
 };
-interface TrackingTxModalProps<TR, T extends Transaction<TR>> extends Partial<Pick<ITxTrackingStore<TR, T, ActionTxKey>, 'handleTransaction' | 'initialTx'>> {
+interface TrackingTxModalProps<TR, T extends Transaction<TR>, A> extends Pick<NovaProviderProps<TR, T, A>, 'handleTransaction' | 'initialTx' | 'actions' | 'transactionsPool' | 'adapters' | 'connectedAdapterType'> {
     /** A function to close the modal. */
     onClose: (txKey?: string) => void;
     /** A function to open the main wallet info modal. */
@@ -475,15 +468,7 @@ interface TrackingTxModalProps<TR, T extends Transaction<TR>> extends Partial<Pi
     /** Optional additional CSS classes for the modal's container. */
     className?: string;
     /** An object containing all customization options for the modal. */
-    customization?: TrackingTxModalCustomization<TR, T>;
-    /** An array of `viem` chain objects supported by the application. */
-    appChains: Chain[];
-    /** The global transaction pool from the tracking store. */
-    transactionsPool: TransactionPool<TR, T>;
-    /** A registry of retryable actions, keyed by `actionKey`. */
-    actions?: TxActions;
-    /** The wagmi config object, required for retry, cancel, and speed up functionality. */
-    config?: Config;
+    customization?: TrackingTxModalCustomization<TR, T, A>;
 }
 /**
  * A detailed modal that displays the real-time status and lifecycle of a transaction.
@@ -494,132 +479,151 @@ interface TrackingTxModalProps<TR, T extends Transaction<TR>> extends Partial<Pi
  * @param {TrackingTxModalProps<TR, T>} props - The component props.
  * @returns {JSX.Element} The rendered tracking modal.
  */
-declare function TrackingTxModal<TR, T extends Transaction<TR>>({ onClose, onOpenWalletInfo, className, customization, appChains, transactionsPool, actions, handleTransaction, config, initialTx, }: TrackingTxModalProps<TR, T>): JSX.Element;
+declare function TrackingTxModal<TR, T extends Transaction<TR>, A>({ adapters, onClose, onOpenWalletInfo, className, customization, transactionsPool, actions, handleTransaction, initialTx, connectedAdapterType, }: TrackingTxModalProps<TR, T, A>): JSX.Element;
 
 /**
- * @file This file defines the TypeScript type for the library's internationalization (i18n) labels.
- * It provides a strict structure for all text used in the UI components, ensuring type safety for different languages.
+ * @file This file contains the `TransactionHistoryItem` component, which renders a single transaction
+ * in a list format for the transaction history view.
  */
+
+type CustomIconProps = {
+    chainId: number;
+};
+type CustomStatusAwareTextProps = Parameters<typeof StatusAwareText>[0];
+type CustomTimestampProps = {
+    timestamp?: number;
+};
+type CustomStatusBadgeProps<TR, T extends Transaction<TR>> = Parameters<typeof TransactionStatusBadge<TR, T>>[0];
+type CustomTransactionKeyProps<TR, T extends Transaction<TR>, A> = Parameters<typeof TransactionKey<TR, T, A>>[0];
 /**
- * Defines the complete structure for all customizable text labels used throughout the transaction tracking UI components.
+ * Defines the structure for the `customization` prop, allowing users to override
+ * default sub-components with their own implementations for a history item.
  */
-type TuwaLabels = {
-    /** Labels for the main wallet information modal. */
-    walletModal: {
-        /** The title displayed at the top of the wallet modal. */
-        title: string;
-        header: {
-            /** Text displayed when no wallet is connected. */
-            notConnected: string;
-            /** Alt text for the wallet's avatar image. */
-            avatarAlt: string;
-        };
-        history: {
-            /** The title for the transaction history section. */
-            title: string;
-            /** The title displayed when the user needs to connect a wallet to see history. */
-            connectWalletTitle: string;
-            /** The message displayed when the user needs to connect a wallet. */
-            connectWalletMessage: string;
-            /** The title displayed when the connected wallet has no transaction history. */
-            noTransactionsTitle: string;
-            /** The message displayed when there are no transactions to show. */
-            noTransactionsMessage: string;
-        };
-    };
-    /** Labels related to toast notifications. */
-    toast: {
-        /** Text for the button/link within a toast to open the wallet modal. */
-        openWalletInfo: string;
-    };
-    /** Standard labels for transaction statuses. */
-    statuses: {
-        /** Text for a pending transaction. */
-        pending: string;
-        /** Text for a successful transaction. */
-        success: string;
-        /** Text for a failed transaction. */
-        failed: string;
-        /** Text for a reverted transaction. */
-        reverted: string;
-        /** Text for a replaced transaction (e.g., sped up). */
-        replaced: string;
-        /** Text for an unknown or indeterminate status. */
-        unknown: string;
-    };
-    /** Labels for different types of transaction hashes/keys. */
-    hashLabels: {
-        /** Label for a Gelato Task ID. */
-        gelato: string;
-        /** Label for a Safe Transaction Hash. */
-        safe: string;
-        /** Label for the original transaction hash (before replacement). */
-        original: string;
-        /** Label for the new transaction hash that replaced the original. */
-        replaced: string;
-        /** Default label for a standard transaction hash. */
-        default: string;
-    };
-    /** Labels for the transaction information block. */
-    txInfo: {
-        /** Label indicating when the transaction was started. */
-        started: string;
-        /** Label for the network name. */
-        network: string;
+type TransactionHistoryItemCustomization<TR, T extends Transaction<TR>, A> = {
+    components?: {
+        /** Override the default chain icon. */
+        icon?: (props: CustomIconProps) => ReactNode;
+        /** Override the default title component. */
+        title?: (props: CustomStatusAwareTextProps) => ReactNode;
+        /** Override the default description component. */
+        description?: (props: CustomStatusAwareTextProps) => ReactNode;
+        /** Override the default timestamp component. */
+        timestamp?: (props: CustomTimestampProps) => ReactNode;
+        /** Override the default status badge component. */
+        statusBadge?: (props: CustomStatusBadgeProps<TR, T>) => ReactNode;
+        /** Override the default component for displaying transaction keys/hashes. */
+        transactionKey?: (props: CustomTransactionKeyProps<TR, T, A>) => ReactNode;
     };
-    /** Labels for the transaction error block. */
-    txError: {
-        /** The title for the error details section. */
-        title: string;
-        /** Confirmation text shown after copying an error message. */
-        copied: string;
+};
+type TransactionHistoryItemProps<TR, T extends Transaction<TR>, A> = {
+    /** The transaction object to display. */
+    tx: T;
+    /** The entire pool of transactions. */
+    transactionsPool: TransactionPool<TR, T>;
+    /** Optional additional CSS classes for the container. */
+    className?: string;
+    /** An object to customize and override the default internal components. */
+    customization?: TransactionHistoryItemCustomization<TR, T, A>;
+} & Pick<NovaProviderProps<TR, T, A>, 'adapters'>;
+/**
+ * A component that renders a single row in the transaction history list.
+ * It is highly customizable via the `customization` prop.
+ *
+ * @param {TransactionHistoryItemProps<TR, T>} props - The component props.
+ * @returns {JSX.Element} The rendered history item.
+ */
+declare function TransactionHistoryItem<TR, T extends Transaction<TR>, A>({ tx, adapters, transactionsPool, className, customization, }: TransactionHistoryItemProps<TR, T, A>): JSX.Element;
+
+/**
+ * @file This file contains the main `WalletInfoModal` component, which serves as the primary UI for viewing wallet details and transaction history.
+ */
+
+type CustomHeaderProps = {
+    closeModal: () => void;
+};
+type CustomWalletInfoProps<TR, T extends Transaction<TR>, A> = WalletInfoModalProps<TR, T, A>;
+type CustomHistoryProps<TR, T extends Transaction<TR>, A> = WalletInfoModalProps<TR, T, A> & {
+    customization?: TransactionsHistoryCustomization<TR, T, A>;
+};
+/**
+ * Defines the customization options for the WalletInfoModal.
+ * Allows customization of modal behavior, animations, and individual UI components.
+ */
+type WalletInfoModalCustomization<TR, T extends Transaction<TR>, A> = {
+    /** Custom props to pass to the underlying Radix UI Dialog.Content component */
+    modalProps?: Partial<ComponentPropsWithoutRef<typeof Dialog.Content>>;
+    /** Custom Framer Motion animation properties */
+    motionProps?: MotionProps;
+    classNames?: {
+        /** CSS classes for the main content wrapper div. */
+        contentWrapper?: string;
     };
-    /** Labels for the detailed transaction tracking modal. */
-    trackingModal: {
-        /** The main title of the tracking modal. */
-        title: string;
-        /** Text indicating that the transaction is being processed. */
-        processing: string;
-        /** Label for the close button. */
-        close: string;
-        /** Label for the button to open the main wallet info modal. */
-        walletInfo: string;
-        /** Label for a button to retry a transaction. */
-        retry: string;
-        /** Labels for the step-by-step progress indicator. */
-        progressIndicator: {
-            /** Label for the "transaction created" step. */
-            created: string;
-            /** Label for the "processing" step. */
-            processing: string;
-            /** Label for the "succeed" or final step. */
-            succeed: string;
-        };
+    /** Custom component overrides for different parts of the modal */
+    components?: {
+        /** A render prop to replace the entire modal header. */
+        header?: (props: CustomHeaderProps) => ReactNode;
+        /** A render prop to replace the `WalletHeader` component. */
+        walletInfo?: (props: CustomWalletInfoProps<TR, T, A>) => ReactNode;
+        /** A render prop to replace the `TransactionsHistory` component. */
+        history?: (props: CustomHistoryProps<TR, T, A>) => ReactNode;
     };
-    /** Labels for the main transaction action button. */
-    trackedTxButton: {
-        /** Text shown on the button while the transaction is initializing. */
-        loading: string;
-        /** Text shown on the button after the transaction succeeds. */
-        succeed: string;
-        /** Text shown on the button if the transaction fails to initialize. */
-        failed: string;
-        /** Text shown on the button if the transaction replaced to initialize. */
-        replaced: string;
+};
+/**
+ * Defines the core props for the WalletInfoModal and its children.
+ */
+interface WalletInfoModalProps<TR, T extends Transaction<TR>, A> extends Pick<NovaProviderProps<TR, T, A>, 'adapters' | 'connectedAdapterType' | 'connectedWalletAddress' | 'transactionsPool'> {
+    isOpen?: boolean;
+    setIsOpen?: (value: boolean) => void;
+    customization?: WalletInfoModalCustomization<TR, T, A>;
+}
+/**
+ * The main modal component for displaying wallet information and transaction history.
+ * It is highly customizable through the `customization` prop and supports full Radix UI Dialog customization.
+ *
+ * @param {WalletInfoModalProps<TR, T> & { ... }} props - The component props.
+ * @returns {JSX.Element | null} The rendered modal or null if not open.
+ */
+declare function WalletInfoModal<TR, T extends Transaction<TR>, A>({ isOpen, setIsOpen, customization, ...props }: WalletInfoModalProps<TR, T, A>): JSX.Element | null;
+
+/**
+ * @file This file contains the `TransactionsHistory` component, which displays a list of past and pending transactions.
+ */
+
+type CustomPlaceholderProps = {
+    title: string;
+    message: string;
+};
+/**
+ * Defines the customization options for the TransactionsHistory component.
+ */
+type TransactionsHistoryCustomization<TR, T extends Transaction<TR>, A> = {
+    classNames?: {
+        /** CSS classes for the list's wrapper `div`. */
+        listWrapper?: string;
     };
-    /** Labels for common action buttons/links. */
-    actions: {
-        /** Text for a "Copy" action (e.g., copy address or hash). */
-        copy: string;
-        /** Text for a link to view the transaction on a block explorer. */
-        viewOnExplorer: string;
-        /** Text for a generic "Close" action. */
-        close: string;
-        /** Text for a generic "Cancel" action. */
-        cancel: string;
-        /** Text for a generic "Speed up" action. */
-        speedUp: string;
+    components?: {
+        /**
+         * A render prop to replace the default placeholder component
+         * (e.g., for "Connect Wallet" or "No Transactions").
+         */
+        placeholder?: (props: CustomPlaceholderProps) => ReactNode;
+        /**
+         * A custom component to use instead of the default `TransactionHistoryItem`.
+         * This should be a component type, not a render function.
+         */
+        HistoryItem?: ComponentType<TransactionHistoryItemProps<TR, T, A>>;
     };
 };
+/**
+ * A component that displays a scrollable list of transactions for the connected wallet.
+ * It handles states for when a wallet is not connected or when there is no history.
+ *
+ * @param {WalletInfoModalProps<TR, T> & { customization?: TransactionsHistoryCustomization<TR, T> }} props
+ * @returns {JSX.Element} The rendered transaction history section.
+ */
+declare function TransactionsHistory<TR, T extends Transaction<TR>, A>({ adapters, connectedWalletAddress, transactionsPool, className, customization, }: WalletInfoModalProps<TR, T, A> & Pick<NovaProviderProps<TR, T, A>, 'adapters'> & {
+    className?: string;
+    customization?: TransactionsHistoryCustomization<TR, T, A>;
+}): JSX.Element;
 
-export { type WalletInfoModalProps as A, WalletInfoModal as B, HashLink as H, StatusAwareText as S, type TuwaLabels as T, type WalletInfoModalCustomization as W, type ToastTransactionCustomization as a, type ToastTransactionProps as b, ToastTransaction as c, type TxActions as d, type TrackingTxModalCustomization as e, type TrackingTxModalProps as f, TrackingTxModal as g, type TxErrorBlockProps as h, TxErrorBlock as i, type TxInfoBlockCustomization as j, type TxInfoBlockProps as k, TxInfoBlock as l, type StepStatus as m, type StepProps as n, type TxProgressIndicatorProps as o, TxProgressIndicator as p, type TxStatusVisualProps as q, TxStatusVisual as r, type TransactionHistoryItemCustomization as s, type TransactionHistoryItemProps as t, TransactionHistoryItem as u, type ToastTransactionKeyProps as v, TransactionKey as w, type TransactionsHistoryCustomization as x, TransactionsHistory as y, TransactionStatusBadge as z };
+export { WalletInfoModal as A, NovaProvider as B, HashLink as H, type NovaProviderProps as N, StatusAwareText as S, type TuwaLabels as T, type WalletInfoModalCustomization as W, type ToastTransactionCustomization as a, type ToastTransactionProps as b, ToastTransaction as c, type TrackingTxModalCustomization as d, type TrackingTxModalProps as e, TrackingTxModal as f, type TxErrorBlockProps as g, TxErrorBlock as h, type TxInfoBlockCustomization as i, type TxInfoBlockProps as j, TxInfoBlock as k, type StepStatus as l, type StepProps as m, type TxProgressIndicatorProps as n, TxProgressIndicator as o, type TxStatusVisualProps as p, TxStatusVisual as q, type TransactionHistoryItemCustomization as r, type TransactionHistoryItemProps as s, TransactionHistoryItem as t, type ToastTransactionKeyProps as u, TransactionKey as v, type TransactionsHistoryCustomization as w, TransactionsHistory as x, TransactionStatusBadge as y, type WalletInfoModalProps as z };