@tuwaio/nova-connect 0.6.0 → 0.7.0

package/dist/useWalletNativeBalance-BuiJip3d.d.cts

@@ -1,743 +0,0 @@
-import * as React$1 from 'react';
-import React__default, { ComponentPropsWithoutRef, ComponentType, ReactNode } from 'react';
-import { OrbitAdapter } from '@tuwaio/orbit-core';
-import { TransactionPool, Transaction, TxAdapter } from '@tuwaio/pulsar-core';
-import { N as NovaConnectLabels } from './types-DxUn8qmU.cjs';
-import { SatelliteSiwxFieldOptions, UseSiwxSignInOptions } from '@tuwaio/siwx-react';
-import { Variants, Easing } from 'framer-motion';
-
-/**
- * @description
- * This interface provides default fallback types for chain configurations.
- * Chain-specific packages will use module augmentation to override these
- * with more specific types while maintaining backward compatibility.
- *
- * Default values are `any` to ensure the system works without specific
- * chain packages, but gets enhanced type safety when they are installed.
- */
-interface AllChainConfigs {
-    /**
-     * App chains configuration - defaults to any, gets enhanced by chain-specific packages
-     * @default any - Will be typed as `readonly [Chain, ...Chain[]]` when viem is available
-     */
-    appChains?: any;
-    /**
-     * Solana RPC URLs configuration - defaults to any, gets enhanced by Solana packages
-     * @default any - Will be typed as `Partial<Record<SolanaClusterMoniker, string>>` when @tuwaio/orbit-solana is available
-     */
-    solanaRPCUrls?: any;
-}
-/**
- * Union type for all supported chain configurations.
- * Gets automatically extended when packages augment AllChainConfigs.
- *
- * @example
- * ```typescript
- * // Without specific packages - uses any types
- * const config: InitialChains = {
- *   appChains: [], // any
- *   solanaRPCUrls: {} // any
- * }
- *
- * // With viem package installed - gets proper Chain[] typing
- * // With @tuwaio/orbit-solana package installed - gets proper SolanaClusterMoniker typing
- * ```
- */
-type InitialChains = AllChainConfigs;
-
-/**
- * @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. */
-    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;
-    };
-};
-type CustomLoadingContainerProps = {
-    labels: Record<string, string>;
-    className?: string;
-    /** Granular classNames for sub-elements */
-    classNames?: {
-        spinner?: string;
-        text?: string;
-    };
-};
-type CustomErrorContainerProps = {
-    className?: string;
-    /** Granular classNames for sub-elements */
-    classNames?: {
-        iconContainer?: string;
-        icon?: string;
-        content?: string;
-        title?: string;
-        description?: string;
-    };
-};
-type CustomNoWalletContainerProps = {
-    className?: string;
-    /** Granular classNames for sub-elements */
-    classNames?: {
-        text?: string;
-    };
-};
-type CustomTransactionsHistoryWrapperProps = {
-    children: ReactNode;
-    activeConnectionAddress: string;
-    transactionPool: NonNullable<NovaConnectProviderProps['transactionPool']>;
-    pulsarAdapter: NonNullable<NovaConnectProviderProps['pulsarAdapter']>;
-    labels: Record<string, string>;
-    className?: string;
-};
-/**
- * Customization options for ConnectedModalTxHistory component
- */
-type ConnectedModalTxHistoryCustomization = {
-    /** Override root container props */
-    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<CustomLoadingContainerProps>;
-        /** Custom error container component */
-        ErrorContainer?: ComponentType<CustomErrorContainerProps>;
-        /** Custom no wallet container component */
-        NoWalletContainer?: ComponentType<CustomNoWalletContainerProps>;
-        /** Custom transactions history wrapper component */
-        TransactionsHistoryWrapper?: ComponentType<CustomTransactionsHistoryWrapperProps>;
-    };
-    /** Custom class name generators */
-    classNames?: {
-        /** Function to generate container classes */
-        container?: (params: {
-            hasActiveWallet: boolean;
-            hasValidAdapter: boolean;
-        }) => string;
-        /** Function to generate loading container classes */
-        loadingContainer?: () => string;
-        /** Function to generate loading spinner classes */
-        loadingSpinner?: () => string;
-        /** Function to generate loading text classes */
-        loadingText?: () => string;
-        /** Function to generate error container classes */
-        errorContainer?: () => string;
-        /** Function to generate error icon container classes */
-        errorIconContainer?: () => string;
-        /** Function to generate error icon classes */
-        errorIcon?: () => string;
-        /** Function to generate error content classes */
-        errorContent?: () => string;
-        /** Function to generate error title classes */
-        errorTitle?: () => string;
-        /** Function to generate error description classes */
-        errorDescription?: () => string;
-        /** Function to generate no wallet container classes */
-        noWalletContainer?: () => string;
-        /** Function to generate no wallet text classes */
-        noWalletText?: () => string;
-        /** Function to generate pulsar required container classes */
-        pulsarRequiredContainer?: () => string;
-        /** Function to generate pulsar required icon container classes */
-        pulsarRequiredIconContainer?: () => string;
-        /** Function to generate pulsar required icon classes */
-        pulsarRequiredIcon?: () => string;
-        /** Function to generate pulsar required content classes */
-        pulsarRequiredContent?: () => string;
-        /** Function to generate pulsar required title classes */
-        pulsarRequiredTitle?: () => string;
-        /** Function to generate pulsar required description classes */
-        pulsarRequiredDescription?: () => string;
-        /** Function to generate transactions history wrapper classes */
-        transactionsHistoryWrapper?: () => string;
-    };
-    /** Custom animation variants */
-    variants?: {
-        /** Container animation variants */
-        container?: Variants;
-        /** Error animation variants */
-        error?: Variants;
-        /** Loading animation variants */
-        loading?: 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;
-        };
-        /** Error animation configuration */
-        error?: {
-            /** Animation duration in seconds */
-            duration?: number;
-            /** Animation easing curve */
-            ease?: Easing | Easing[];
-            /** Animation delay in seconds */
-            delay?: number;
-        };
-        /** Loading animation configuration */
-        loading?: {
-            /** Animation duration in seconds */
-            duration?: number;
-            /** Animation easing curve */
-            ease?: Easing | Easing[];
-            /** Animation delay in seconds */
-            delay?: number;
-        };
-    };
-    /** Custom event handlers */
-    handlers?: {
-        /** Custom handler for error retry actions */
-        onErrorRetry?: (error: Error, event: React__default.MouseEvent<HTMLButtonElement>) => void;
-        /** Custom handler for package loading failure */
-        onPackageLoadingFailure?: (packageName: string, error: Error) => void;
-    };
-    /** Configuration options */
-    config?: {
-        /** Whether to disable animations */
-        disableAnimation?: boolean;
-        /** Whether to reduce motion for accessibility */
-        reduceMotion?: boolean;
-        /** Custom package name for error messages */
-        packageName?: string;
-        /** Custom aria labels for different states */
-        ariaLabels?: {
-            loading?: string;
-            error?: string;
-            noWallet?: string;
-            pulsarRequired?: string;
-            transactionsHistory?: string;
-        };
-    };
-    /**
-     * Customization for the TransactionsHistory component (from @tuwaio/nova-transactions).
-     * Passed through to the dynamically loaded component.
-     */
-    transactionsHistory?: LocalTransactionsHistoryCustomization;
-};
-/**
- * Props for the ConnectedModalTxHistory component
- */
-interface ConnectedModalTxHistoryProps extends Pick<NovaConnectProviderProps, 'transactionPool' | 'pulsarAdapter'> {
-    /** Additional CSS classes for the container */
-    className?: string;
-    /** Custom aria-label for the container */
-    'aria-label'?: string;
-    /** Customization options */
-    customization?: ConnectedModalTxHistoryCustomization;
-    /** Pagination state for infinite scroll, forwarded to TransactionsHistory. */
-    pagination?: LocalTxPagination;
-}
-/**
- * Component for displaying transaction history with comprehensive customization options.
- *
- * This component provides comprehensive transaction history functionality:
- * - Conditional loading of the @tuwaio/nova-transactions package
- * - Graceful fallback when the package is not available
- * - Loading states with proper accessibility support
- * - Error handling for missing configuration
- * - Full WCAG compliance with ARIA labels
- * - Comprehensive customization for all UI elements and behaviors
- * - Animation support with reduced motion options
- * - Custom event handlers for enhanced interactivity
- * - Performance-optimized with memoized calculations
- *
- * The component automatically detects if the required dependencies are available
- * and provides appropriate fallbacks for different scenarios.
- *
- * @example Basic usage
- * ```tsx
- * <ConnectedModalTxHistory
- *   transactionPool={txPool}
- *   pulsarAdapter={adapter}
- *   className="custom-styling"
- * />
- * ```
- *
- * @example With full customization
- * ```tsx
- * <ConnectedModalTxHistory
- *   transactionPool={txPool}
- *   pulsarAdapter={adapter}
- *   customization={{
- *     classNames: {
- *       container: ({ hasActiveWallet }) =>
- *         `custom-container ${hasActiveWallet ? 'has-wallet' : 'no-wallet'}`,
- *       loadingContainer: () => "custom-loading bg-blue-100",
- *       errorContainer: () => "custom-error bg-red-100",
- *     },
- *     components: {
- *       LoadingContainer: ({ className }) =>
- *         <div className={cn("custom-spinner", className)} />,
- *     },
- *     handlers: {
- *       onPackageLoadingFailure: (packageName, error) =>
- *         console.error(`Failed to load ${packageName}:`, error),
- *     },
- *     config: {
- *       packageName: '@custom/transactions',
- *       ariaLabels: {
- *         loading: 'Loading transaction history...',
- *         error: 'Error loading transactions',
- *       },
- *     },
- *     animation: {
- *       container: { duration: 0.3, ease: 'easeOut' },
- *       error: { duration: 0.2, ease: 'easeIn' },
- *     },
- *   }}
- * />
- * ```
- */
-declare const ConnectedModalTxHistory: React__default.ForwardRefExoticComponent<ConnectedModalTxHistoryProps & React__default.RefAttributes<HTMLDivElement>>;
-
-/**
- * @fileoverview Headless SIWX auto-authentication watcher for NovaConnect.
- * Monitors active wallet connections and automatically triggers SIWX signing prompts.
- */
-
-/**
- * Props for NovaSiwxWatcher component.
- */
-interface NovaSiwxWatcherProps extends SatelliteSiwxFieldOptions {
-    /** Enables or disables automatic SIWX authentication prompt (defaults to true) */
-    enabled?: boolean;
-    /** Optional function to fetch challenge nonce from backend */
-    getNonce?: () => Promise<string>;
-    /** Optional backend verification callback function */
-    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'];
-}
-/**
- * Headless React component rendered inside `NovaConnectProvider`.
- * Automatically prompts the user for SIWX authentication whenever a new wallet connects.
- * Uses a `lastPromptedAddress` ref lock to prevent infinite retry loops on prompt rejection.
- */
-declare function NovaSiwxWatcher(props: NovaSiwxWatcherProps): null;
-
-type ButtonTxStatus = 'idle' | 'loading' | 'succeed' | 'failed' | 'replaced';
-type ConnectContentType = 'network' | 'connectors' | 'about' | 'getWallet' | 'connecting' | 'impersonate';
-type ConnectedContentType = 'main' | 'transactions' | 'chains' | 'connections';
-/** Legal configuration for Terms of Service and Privacy Policy links */
-interface LegalConfig {
-    termsUrl?: string;
-    privacyUrl?: string;
-}
-interface NovaConnectProviderProps extends InitialChains {
-    /** Transaction pool for pending transactions display */
-    transactionPool?: TransactionPool<Transaction>;
-    /** Pulsar adapter(s) for transaction handling */
-    pulsarAdapter?: TxAdapter<Transaction> | TxAdapter<Transaction>[];
-    /** Whether balance should be shown */
-    withBalance?: boolean;
-    /** Whether chain selector should be shown */
-    withChain?: boolean;
-    /** Whether impersonated wallets are enabled */
-    withImpersonated?: boolean;
-    /** Custom list of popular connector names to show in the popular section */
-    popularConnectors?: string[];
-    /** Custom connector groups to show in the modal */
-    customConnectorGroups?: Record<string, string[]>;
-    /** Legal configuration for Terms of Service and Privacy Policy links */
-    legal?: LegalConfig;
-    /** SIWX auto-authentication watcher configuration */
-    siwx?: NovaSiwxWatcherProps;
-    /**
-     * Pagination state for infinite scroll, forwarded to ConnectedModalTxHistory and TransactionsHistory.
-     * Mirrors TxInMemoryPagination from @tuwaio/pulsar-core (optional peer dependency).
-     */
-    pagination?: LocalTxPagination;
-    children: React.ReactNode;
-    labels?: Partial<NovaConnectLabels>;
-}
-interface WalletBalance {
-    value: string;
-    symbol: string;
-}
-interface NovaConnectProviderType extends Omit<NovaConnectProviderProps, 'pulsarAdapter' | 'children' | 'labels' | 'transactionPool'> {
-    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;
-    legal?: LegalConfig;
-}
-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;
-
-/**
- * React Context for storing and providing the UI labels.
- * It is initialized with the default English labels, ensuring that components
- * work even without an explicit provider.
- */
-declare const NovaConnectLabelsContext: React$1.Context<NovaConnectLabels>;
-/**
- * A custom hook to easily access the i18n labels from any component
- * within the `NovaConnectLabelsProvider` tree.
- *
- * This hook provides type-safe access to all UI labels and automatically
- * falls back to default English labels if no provider is found.
- *
- * @returns {NovaConnectLabels} The complete object of UI labels for the current locale.
- *
- * @example
- * ```typescript
- * import { useNovaConnectLabels } from './hooks/useNovaConnectLabels';
- *
- * function MyComponent() {
- *   const labels = useNovaConnectLabels();
- *
- *   return (
- *     <div>
- *       <h1>{labels.connectWallet}</h1>
- *       <button>{labels.connect}</button>
- *       <p aria-label={labels.walletBalance}>{formattedBalance}</p>
- *     </div>
- *   );
- * }
- * ```
- *
- * @example
- * ```typescript
- * // Destructuring specific labels for better performance
- * function ConnectButton() {
- *   const { connectWallet, connecting, connected } = useNovaConnectLabels();
- *
- *   return (
- *     <button>
- *       {isConnecting ? connecting : isConnected ? connected : connectWallet}
- *     </button>
- *   );
- * }
- * ```
- */
-declare const useNovaConnectLabels: () => NovaConnectLabels;
-/**
- * Hook to get a specific label by key path with type safety
- *
- * @param key The label key to retrieve
- * @returns The specific label value
- *
- * @example
- * ```typescript
- * function MyComponent() {
- *   const connectLabel = useNovaConnectLabel('connectWallet');
- *   const errorLabel = useNovaConnectLabel('connectionError');
- *
- *   return <button>{connectLabel}</button>;
- * }
- * ```
- */
-declare const useNovaConnectLabel: <K extends keyof NovaConnectLabels>(key: K) => NovaConnectLabels[K];
-/**
- * Hook to get multiple specific labels for better performance
- *
- * @param keys Array of label keys to retrieve
- * @returns Object with only the requested labels
- *
- * @example
- * ```typescript
- * function ConnectModal() {
- *   const { connectWallet, connecting, disconnect } = useNovaConnectLabelsSubset(['connectWallet', 'connecting', 'disconnect']);
- *
- *   return (
- *     <div>
- *       <h2>{connectWallet}</h2>
- *       <span>{connecting}</span>
- *       <button>{disconnect}</button>
- *     </div>
- *   );
- * }
- * ```
- */
-declare const useNovaConnectLabelsSubset: <K extends keyof NovaConnectLabels>(keys: K[]) => Pick<NovaConnectLabels, K>;
-/**
- * Type-safe helper to check if a label exists
- *
- * @param labels The labels object
- * @param key The key to check
- * @returns Whether the key exists and has a non-empty value
- */
-declare const hasLabel: (labels: NovaConnectLabels, key: keyof NovaConnectLabels) => boolean;
-/**
- * Utility type for extracting label keys by category
- */
-type LabelCategory = {
-    actions: Extract<keyof NovaConnectLabels, 'connectWallet' | 'disconnect' | 'connecting' | 'connected' | 'tryAgain' | 'back' | 'connect' | 'close'>;
-    states: Extract<keyof NovaConnectLabels, 'success' | 'error' | 'replaced' | 'loading' | 'idle'>;
-    accessibility: Extract<keyof NovaConnectLabels, 'chainSelector' | 'closeModal' | 'selectChain' | 'walletControls' | 'openWalletModal'>;
-    transactions: Extract<keyof NovaConnectLabels, 'transactionLoading' | 'transactionSuccess' | 'transactionError' | 'transactionReplaced' | 'recent'>;
-};
-/**
- * Hook to get labels by category for better organization
- *
- * @param category The category of labels to retrieve
- * @returns Object with labels from the specified category
- */
-declare const useLabelsByCategory: <T extends keyof LabelCategory>(category: T) => Pick<NovaConnectLabels, LabelCategory[T]>;
-/**
- * Utility function to check if labels are default ones (for external use)
- * This is a regular function, not a hook, so it can be used anywhere
- *
- * @param labels The labels to check
- * @returns Whether the labels are the default English labels
- *
- * @example
- * ```typescript
- * function SomeUtilityFunction(labels: NovaConnectLabels) {
- *   if (isDefaultLabels(labels)) {
- *     console.log('Using default English labels');
- *   }
- * }
- * ```
- */
-declare const isDefaultLabels: (labels: NovaConnectLabels) => boolean;
-/**
- * Utility function to get a formatted label with fallback
- *
- * @param labels The labels object
- * @param key The label key
- * @param fallback Optional fallback text
- * @returns The label value or fallback
- *
- * @example
- * ```typescript
- * const buttonText = getLabelWithFallback(labels, 'connectWallet', 'Connect');
- * ```
- */
-declare const getLabelWithFallback: (labels: NovaConnectLabels, key: keyof NovaConnectLabels, fallback?: string) => string;
-/**
- * Utility function to create a labels subset (for use outside of React components)
- *
- * @param labels The source labels object
- * @param keys Array of keys to extract
- * @returns Object with only the requested labels
- *
- * @example
- * ```typescript
- * const actionLabels = createLabelsSubset(labels, ['connect', 'disconnect', 'tryAgain']);
- * ```
- */
-declare const createLabelsSubset: <K extends keyof NovaConnectLabels>(labels: NovaConnectLabels, keys: K[]) => Pick<NovaConnectLabels, K>;
-
-/**
- * @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(): NativeBalanceData;
-
-export { type AllChainConfigs as A, type ButtonTxStatus as B, type ConnectContentType as C, type InitialChains as I, type LabelCategory as L, type NovaConnectProviderProps as N, type WalletBalance as W, type ConnectedContentType as a, type NovaConnectProviderType as b, type LegalConfig as c, type NativeBalanceResult as d, NovaConnectLabelsContext as e, NovaConnectProviderContext as f, NovaConnectProviderError as g, NovaSiwxWatcher as h, type NovaSiwxWatcherProps as i, createLabelsSubset as j, getLabelWithFallback as k, hasLabel as l, isDefaultLabels as m, useLabelsByCategory as n, useNovaConnect as o, useNovaConnectLabel as p, useNovaConnectLabels as q, useNovaConnectLabelsSubset as r, useNovaConnectOptional as s, useWalletNativeBalance as t, useHasNovaConnectContext as u, type ConnectedModalTxHistoryProps as v, type ConnectedModalTxHistoryCustomization as w, ConnectedModalTxHistory as x, type LocalTransactionsHistoryCustomization as y, type LocalTxPagination as z };