@tuwaio/nova-connect 1.0.0-fix-test-alpha.1.1de2063 → 1.0.0-fix-test-alpha.2.3c61c83

package/dist/ToastError-D24J0PWb.d.cts

@@ -0,0 +1,586 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { BaseWallet, ISatelliteConnectStore } from '@tuwaio/satellite-core';
+import * as React$1 from 'react';
+import { ComponentPropsWithoutRef, ComponentType, ReactNode } from 'react';
+import { OrbitAdapter } from '@tuwaio/orbit-core';
+import { StoreApi } from 'zustand/index';
+import { a as Connector, W as Wallet } from './types-yzbOGSEA.cjs';
+import { ToastPosition, ToastContainer, toast } from 'react-toastify';
+
+/**
+ * Type definitions for NovaConnect component translations
+ * Contains all text strings for multi-language support
+ */
+type NovaConnectLabels = {
+    connectWallet: string;
+    disconnect: string;
+    connecting: string;
+    connected: string;
+    tryAgain: string;
+    back: string;
+    connect: string;
+    close: string;
+    all: string;
+    connectionError: string;
+    connectedSuccessfully: string;
+    connectingTo: string;
+    walletConnectionError: string;
+    errorWhenChainSwitching: string;
+    cannotConnectWallet: string;
+    success: string;
+    error: string;
+    replaced: string;
+    recent: string;
+    transactionLoading: string;
+    transactionSuccess: string;
+    transactionError: string;
+    transactionReplaced: string;
+    aboutWallets: string;
+    getWallet: string;
+    connectImpersonatedWallet: string;
+    transactionsInApp: string;
+    switchNetwork: string;
+    switchNetworks: string;
+    connectingEllipsis: string;
+    installed: string;
+    popular: string;
+    impersonate: string;
+    readOnlyMode: string;
+    whatIsWallet: string;
+    walletDescription: string;
+    whatIsNetwork: string;
+    networkDescription: string;
+    learnMore: string;
+    listOfNetworks: string;
+    viewOnExplorer: string;
+    viewTransactions: string;
+    enterWalletAddress: string;
+    walletAddressPlaceholder: string;
+    noConnectorsFound: string;
+    noConnectorsDescription: string;
+    somethingWentWrong: string;
+    networkPickingError: string;
+    pulsarAdapterRequired: string;
+    pulsarAdapterDescription: string;
+    selectAvailableNetwork: string;
+    startExploringWeb3: string;
+    walletKeyToDigitalWorld: string;
+    iDontHaveWallet: string;
+    choseWallet: string;
+    keyToNewInternet: string;
+    keyToNewInternetDescription: string;
+    logInWithoutHassle: string;
+    logInWithoutHassleDescription: string;
+    copyRawError: string;
+    copied: string;
+    chainSelector: string;
+    closeModal: string;
+    selectChain: string;
+    chainOption: string;
+    openChainSelector: string;
+    currentChain: string;
+    scrollToTop: string;
+    scrollToBottom: string;
+    chainListContainer: string;
+    walletControls: string;
+    openWalletModal: string;
+    walletConnected: string;
+    walletNotConnected: string;
+    walletBalance: string;
+    walletAddress: string;
+    transactionStatus: string;
+    successIcon: string;
+    errorIcon: string;
+    replacedIcon: string;
+    statusIcon: string;
+    loading: string;
+    idle: string;
+    unknownWallet: string;
+    walletAvatar: string;
+    ensAvatar: string;
+    walletIcon: string;
+    impersonateAddressEmpty: string;
+    impersonateAddressNotCorrect: string;
+    impersonateAddressConnected: string;
+};
+
+type ButtonTxStatus = 'idle' | 'loading' | 'succeed' | 'failed' | 'replaced';
+type ConnectContentType = 'network' | 'connectors' | 'about' | 'getWallet' | 'connecting' | 'impersonate';
+type ConnectedContentType = 'main' | 'transactions' | 'chains';
+interface NovaConnectProviderProps {
+    store: StoreApi<ISatelliteConnectStore<Connector, Wallet>>;
+    children: React.ReactNode;
+    labels?: Partial<NovaConnectLabels>;
+}
+interface WalletBalance {
+    value: string;
+    symbol: string;
+}
+interface NovaConnectProviderType {
+    activeWallet: BaseWallet | undefined;
+    walletConnectionError: string | undefined;
+    isConnectModalOpen: boolean;
+    setIsConnectModalOpen: (value: boolean) => void;
+    isConnectedModalOpen: boolean;
+    setIsConnectedModalOpen: (value: boolean) => void;
+    isChainsListOpen: boolean;
+    setIsChainsListOpen: (value: boolean) => void;
+    isChainsListOpenMobile: boolean;
+    setIsChainsListOpenMobile: (value: boolean) => void;
+    connectedButtonStatus: ButtonTxStatus;
+    setConnectedButtonStatus: (value: ButtonTxStatus) => void;
+    isConnected: boolean;
+    setIsConnected: (value: boolean) => void;
+    connectedModalContentType: ConnectedContentType;
+    setConnectedModalContentType: (value: ConnectedContentType) => void;
+    connectModalContentType: ConnectContentType;
+    setConnectModalContentType: (value: ConnectContentType) => void;
+    selectedAdapter: OrbitAdapter | undefined;
+    setSelectedAdapter: (value: OrbitAdapter | undefined) => void;
+    activeConnector: string | undefined;
+    setActiveConnector: (value: string | undefined) => void;
+    impersonatedAddress: string;
+    setImpersonatedAddress: (value: string) => void;
+}
+declare class NovaConnectProviderError extends Error {
+    constructor(message?: string);
+}
+declare const NovaConnectProviderContext: React$1.Context<NovaConnectProviderType | undefined>;
+/**
+ * Hook to access NovaConnect context
+ *
+ * @throws {NovaConnectProviderError} When used outside of NovaConnectProvider
+ * @returns {NovaConnectProviderType} The NovaConnect context value
+ *
+ * @example
+ * ```typescript
+ * function MyComponent() {
+ *   const { isConnected, handleConnectButtonClick } = useNovaConnect();
+ *
+ *   return (
+ *     <button onClick={handleConnectButtonClick}>
+ *       {isConnected ? 'Connected' : 'Connect Wallet'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare const useNovaConnect: () => NovaConnectProviderType;
+/**
+ * Hook to check if NovaConnect context is available
+ *
+ * @returns {boolean} True if context is available, false otherwise
+ *
+ * @example
+ * ```typescript
+ * function ConditionalComponent() {
+ *   const hasContext = useHasNovaConnectContext();
+ *
+ *   if (!hasContext) {
+ *     return <div>NovaConnect provider not found</div>;
+ *   }
+ *
+ *   return <ConnectedComponent />;
+ * }
+ * ```
+ */
+declare const useHasNovaConnectContext: () => boolean;
+/**
+ * Optional hook that returns null if provider is not available
+ *
+ * @returns {NovaConnectProviderType | null} Context value or null if not available
+ *
+ * @example
+ * ```typescript
+ * function OptionalComponent() {
+ *   const context = useNovaConnectOptional();
+ *
+ *   if (!context) {
+ *     return <div>No wallet provider available</div>;
+ *   }
+ *
+ *   return <div>Connected: {context.isConnected}</div>;
+ * }
+ * ```
+ */
+declare const useNovaConnectOptional: () => NovaConnectProviderType | null;
+
+/**
+ * @interface NativeBalanceResult
+ * Represents the native token balance returned by the adapter.
+ * The value is already formatted for human readability.
+ * @property {string} value The native token balance formatted to standard decimals (e.g., "1.5").
+ * @property {string} symbol The symbol of the native token (e.g., "ETH").
+ */
+interface NativeBalanceResult {
+    value: string;
+    symbol: string;
+}
+type NativeBalanceState = NativeBalanceResult | null;
+/**
+ * @interface NativeBalanceData
+ * The object returned by the useWalletNativeBalance hook.
+ * @property {NativeBalanceState} balance The native token balance and symbol, or null.
+ * @property {boolean} isLoading True while the balance is being fetched for the current wallet/chain combination.
+ * @property {() => void} refetch Function to manually trigger a balance refresh.
+ */
+interface NativeBalanceData {
+    balance: NativeBalanceState;
+    isLoading: boolean;
+    refetch: () => void;
+}
+/**
+ * Custom hook to fetch the native token balance for the currently connected wallet
+ * on the active chain. It includes a local cache layer to prevent redundant network calls
+ * when switching between components or on re-renders for the same wallet/chain.
+ *
+ * @returns {NativeBalanceData} An object containing the balance data and loading state.
+ *
+ * @example
+ * ```typescript
+ * import { useWalletNativeBalance } from './useWalletNativeBalance';
+ *
+ * function NativeTokenDisplay() {
+ *   const { balance, isLoading, refetch } = useWalletNativeBalance();
+ *
+ *   if (isLoading) {
+ *     return <p>Loading balance...</p>;
+ *   }
+ *
+ *   // Display the formatted balance and symbol
+ *   return (
+ *     <div>
+ *       <p>Balance: {balance ? `${balance.value} ${balance.symbol}` : '0.00'}</p>
+ *       <button onClick={refetch}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useWalletNativeBalance({ store, activeWallet, }: Pick<NovaConnectProviderProps, 'store'> & Pick<NovaConnectProviderType, 'activeWallet'>): NativeBalanceData;
+
+type CustomToastErrorProps = {
+    title: string;
+    rawError: string;
+    onCopyComplete?: (success: boolean) => void;
+    errorType: 'wallet' | 'switch' | null;
+    isConnected: boolean;
+};
+type CustomContainerProps = ComponentPropsWithoutRef<typeof ToastContainer>;
+/**
+ * Customization options for ErrorsProvider component
+ */
+type ErrorsProviderCustomization = {
+    /** Override ToastContainer element props */
+    containerProps?: Partial<ComponentPropsWithoutRef<typeof ToastContainer>>;
+    /** Custom components */
+    components?: {
+        /** Custom ToastError component */
+        ToastError?: ComponentType<CustomToastErrorProps>;
+        /** Custom ToastContainer component */
+        Container?: ComponentType<CustomContainerProps>;
+    };
+    /** Default ToastError customization (only used with default ToastError component) */
+    toastErrorCustomization?: ToastErrorCustomization;
+    /** Custom class name generators */
+    classNames?: {
+        /** Function to generate container classes */
+        container?: (params: {
+            hasErrors: boolean;
+            errorType: 'wallet' | 'switch' | null;
+        }) => string;
+    };
+    /** Custom toast options generators */
+    toastOptions?: {
+        /** Function to generate toast options */
+        error?: (params: {
+            title: string;
+            rawError: string;
+            errorType: 'wallet' | 'switch' | null;
+            isConnected: boolean;
+        }) => Partial<Parameters<typeof toast.error>[1]>;
+    };
+    /** Custom logic handlers */
+    handlers?: {
+        /** Custom error display logic */
+        showError?: (originalHandler: (title: string, rawError: string, errorKey: string) => void, params: {
+            title: string;
+            rawError: string;
+            errorKey: string;
+            errorType: 'wallet' | 'switch' | null;
+        }) => void;
+        /** Custom error dismissal logic */
+        dismissError?: (originalHandler: () => void) => void;
+        /** Custom copy complete handler */
+        onCopyComplete?: (success: boolean, rawError: string, errorType: 'wallet' | 'switch' | null) => void;
+    };
+    /** Custom error title generator - does NOT customize labels, just allows title modification */
+    errorTitle?: (defaultTitle: string, params: {
+        errorType: 'wallet' | 'switch' | null;
+    }) => string;
+    /** Custom error hash generator for deduplication */
+    errorHash?: (defaultHash: string | null, params: {
+        primaryError: string | null;
+        errorType: 'wallet' | 'switch' | null;
+    }) => string | null;
+};
+interface ErrorsProviderProps extends Pick<NovaConnectProviderProps, 'store'> {
+    /** Custom container ID for toast notifications */
+    containerId?: string;
+    /** Custom position for toast notifications */
+    position?: ToastPosition;
+    /** Auto close delay in milliseconds */
+    autoClose?: number | false;
+    /** Whether to enable drag to dismiss */
+    draggable?: boolean;
+    /** Customization options */
+    customization?: ErrorsProviderCustomization;
+}
+/**
+ * A highly customizable error toast provider with extensive styling options and component replacement capabilities.
+ * Provides comprehensive customization for appearance, behavior, and error handling logic while maintaining accessibility.
+ */
+declare function ErrorsProvider({ store, containerId, position, autoClose, draggable, customization, }: ErrorsProviderProps): react_jsx_runtime.JSX.Element;
+declare namespace ErrorsProvider {
+    var displayName: string;
+}
+
+/**
+ * Props for custom NovaConnectLabelsProvider component
+ */
+type CustomLabelsProviderProps = {
+    labels?: Partial<NovaConnectLabels>;
+    children: ReactNode;
+};
+/**
+ * Props for custom ErrorsProvider component
+ */
+type CustomErrorsProviderProps = Pick<ErrorsProviderProps, 'store'> & {
+    customization?: ErrorsProviderCustomization;
+};
+/**
+ * Context data passed to custom provider components
+ */
+type ProviderContext = {
+    /** Current wallet connection state */
+    isConnected: boolean;
+    /** Active wallet instance */
+    activeWallet: BaseWallet | undefined;
+    /** Current wallet connection error */
+    walletConnectionError: string | undefined;
+    /** All modal and UI states */
+    modalStates: {
+        isConnectModalOpen: boolean;
+        isConnectedModalOpen: boolean;
+        isChainsListOpen: boolean;
+        isChainsListOpenMobile: boolean;
+    };
+    /** Current content types for modals */
+    contentTypes: {
+        connectModal: ConnectContentType;
+        connectedModal: ConnectedContentType;
+    };
+    /** Button and transaction statuses */
+    statuses: {
+        connectedButton: ButtonTxStatus;
+    };
+};
+/**
+ * Comprehensive customization options for NovaConnectProvider
+ */
+type NovaConnectProviderCustomization = {
+    /** Custom components */
+    components?: {
+        /** Custom labels provider component */
+        LabelsProvider?: ComponentType<CustomLabelsProviderProps>;
+        /** Custom errors provider component */
+        ErrorsProvider?: ComponentType<CustomErrorsProviderProps>;
+    };
+    /** Labels customization and merging strategy */
+    labels?: {
+        /** Custom labels merging function */
+        merge?: (defaultLabels: NovaConnectLabels, userLabels: Partial<NovaConnectLabels>) => NovaConnectLabels;
+        /** Transform final merged labels before use */
+        transform?: (mergedLabels: NovaConnectLabels, context: ProviderContext) => NovaConnectLabels;
+    };
+    /** ErrorsProvider customization - passed through to ErrorsProvider */
+    errors?: ErrorsProviderCustomization;
+    /** Custom initialization logic */
+    initialization?: {
+        /** Custom logic after store subscription setup */
+        onStoreSubscribed?: (context: ProviderContext) => void;
+        /** Custom logic when connection state changes */
+        onConnectionStateChange?: (isConnected: boolean, activeWallet: BaseWallet | undefined, context: ProviderContext) => void;
+        /** Custom logic when error state changes */
+        onErrorStateChange?: (error: string | undefined, context: ProviderContext) => void;
+    };
+    /** Custom context value transformation */
+    contextValue?: {
+        /** Transform context value before providing to children */
+        transform?: (defaultValue: NovaConnectProviderType, context: ProviderContext) => NovaConnectProviderType;
+    };
+    /** Custom rendering logic */
+    rendering?: {
+        /** Custom provider tree structure */
+        providerTree?: (defaultTree: ReactNode, components: {
+            ErrorsProvider: ReactNode;
+            LabelsProvider: ReactNode;
+            MainContent: ReactNode;
+        }, context: ProviderContext) => ReactNode;
+    };
+};
+/**
+ * Extended props for NovaConnectProvider with full customization capabilities
+ */
+interface NovaConnectProviderPropsWithCustomization extends NovaConnectProviderProps {
+    /** Comprehensive customization options for the provider and its sub-components */
+    customization?: NovaConnectProviderCustomization;
+}
+/**
+ * Main NovaConnect provider component with comprehensive customization capabilities.
+ *
+ * This provider manages wallet connection state, error handling, internationalization,
+ * and modal states while offering extensive customization options for all sub-components
+ * and behaviors.
+ *
+ * Features:
+ * - Complete wallet connection state management
+ * - Customizable error handling through ErrorsProvider
+ * - Flexible internationalization system
+ * - Modal and UI state coordination
+ * - Extensive customization API for all aspects
+ * - Custom component replacement capabilities
+ * - Advanced initialization and lifecycle hooks
+ *
+ * @example Basic usage
+ * ```tsx
+ * <NovaConnectProvider store={store}>
+ *   <App />
+ * </NovaConnectProvider>
+ * ```
+ *
+ * @example With customization
+ * ```tsx
+ * <NovaConnectProvider
+ *   store={store}
+ *   labels={customLabels}
+ *   customization={{
+ *     errors: {
+ *       position: 'bottom-right',
+ *       autoClose: 5000,
+ *       components: {
+ *         ToastError: CustomToastError
+ *       }
+ *     },
+ *     initialization: {
+ *       onConnectionStateChange: (isConnected, wallet) => {
+ *         console.log('Connection state:', isConnected, wallet);
+ *       }
+ *     }
+ *   }}
+ * >
+ *   <App />
+ * </NovaConnectProvider>
+ * ```
+ *
+ * @param props - Provider configuration and customization options
+ */
+declare function NovaConnectProvider({ labels, store, children, customization, }: NovaConnectProviderPropsWithCustomization): react_jsx_runtime.JSX.Element;
+declare namespace NovaConnectProvider {
+    var displayName: string;
+}
+
+type CustomIconProps = {
+    isCopied: boolean;
+    className?: string;
+    'aria-hidden'?: boolean;
+};
+type CustomTitleProps = {
+    title: string;
+    titleId: string;
+    className?: string;
+};
+type CustomDescriptionProps = {
+    rawError: string;
+    descriptionId: string;
+    className?: string;
+};
+type CustomButtonContentProps = {
+    icon: ReactNode;
+    isCopied: boolean;
+    copyLabel: string;
+    copiedLabel: string;
+};
+/**
+ * Customization options for ToastError component
+ */
+type ToastErrorCustomization = {
+    /** Override container element props */
+    containerProps?: Partial<Omit<ComponentPropsWithoutRef<'div'>, 'style'>>;
+    /** Override button element props */
+    buttonProps?: Partial<Omit<ComponentPropsWithoutRef<'button'>, 'style'>>;
+    /** Custom components */
+    components?: {
+        /** Custom icon component */
+        Icon?: ComponentType<CustomIconProps>;
+        /** Custom title component */
+        Title?: ComponentType<CustomTitleProps>;
+        /** Custom description component */
+        Description?: ComponentType<CustomDescriptionProps>;
+        /** Custom button content component */
+        ButtonContent?: ComponentType<CustomButtonContentProps>;
+    };
+    /** Custom class name generators */
+    classNames?: {
+        /** Function to generate container classes */
+        container?: (params: {
+            hasTitle: boolean;
+            hasError: boolean;
+        }) => string;
+        /** Function to generate title classes */
+        title?: (params: {
+            title: string;
+        }) => string;
+        /** Function to generate description classes */
+        description?: (params: {
+            rawError: string;
+        }) => string;
+        /** Function to generate button classes */
+        button?: (params: {
+            isCopied: boolean;
+            disabled: boolean;
+        }) => string;
+        /** Function to generate icon classes */
+        icon?: (params: {
+            isCopied: boolean;
+        }) => string;
+    };
+    /** Custom event handlers */
+    handlers?: {
+        /** Custom click handler wrapper */
+        onClick?: (originalHandler: (event: React.MouseEvent<HTMLButtonElement>) => void, event: React.MouseEvent<HTMLButtonElement>) => void;
+        /** Custom keydown handler wrapper */
+        onKeyDown?: (originalHandler: (event: React.KeyboardEvent<HTMLButtonElement>) => void, event: React.KeyboardEvent<HTMLButtonElement>) => void;
+    };
+};
+interface ToastErrorProps extends Omit<ComponentPropsWithoutRef<'div'>, 'role' | 'aria-live' | 'style'> {
+    /** Error title to display */
+    title: string;
+    /** Raw error message to display and copy */
+    rawError: string;
+    /** Custom CSS classes for the container */
+    className?: string;
+    /** Custom ARIA label for the error container */
+    'aria-label'?: string;
+    /** Callback fired when copy operation completes */
+    onCopyComplete?: (success: boolean) => void;
+    /** Customization options */
+    customization?: ToastErrorCustomization;
+}
+/**
+ * A highly customizable error toast component with copy functionality and extensive styling options.
+ * Provides comprehensive customization for appearance, behavior, and event handling while maintaining accessibility.
+ */
+declare const ToastError: React$1.ForwardRefExoticComponent<ToastErrorProps & React$1.RefAttributes<HTMLDivElement>>;
+
+export { type ButtonTxStatus as B, type ConnectContentType as C, type ErrorsProviderCustomization as E, type NovaConnectLabels as N, type ToastErrorCustomization as T, type WalletBalance as W, type NativeBalanceResult as a, type NovaConnectProviderType as b, type NovaConnectProviderProps as c, NovaConnectProvider as d, type NovaConnectProviderCustomization as e, type ToastErrorProps as f, ToastError as g, type ConnectedContentType as h, NovaConnectProviderError as i, NovaConnectProviderContext as j, useHasNovaConnectContext as k, useNovaConnectOptional as l, useWalletNativeBalance as m, type ErrorsProviderProps as n, ErrorsProvider as o, type NovaConnectProviderPropsWithCustomization as p, useNovaConnect as u };