@tuwaio/nova-connect 0.3.2 → 0.4.1

package/dist/{useWalletNativeBalance-C3-mg2mY.d.cts → useWalletNativeBalance-DYd-fWtH.d.cts}

@@ -1,7 +1,9 @@
 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 { Variants, Easing } from 'framer-motion';
 
 /**
  * @description
@@ -42,6 +44,333 @@ interface AllChainConfigs {
  */
 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>>;
+
 type ButtonTxStatus = 'idle' | 'loading' | 'succeed' | 'failed' | 'replaced';
 type ConnectContentType = 'network' | 'connectors' | 'about' | 'getWallet' | 'connecting' | 'impersonate';
 type ConnectedContentType = 'main' | 'transactions' | 'chains' | 'connections';
@@ -67,6 +396,11 @@ interface NovaConnectProviderProps extends InitialChains {
     customConnectorGroups?: Record<string, string[]>;
     /** Legal configuration for Terms of Service and Privacy Policy links */
     legal?: LegalConfig;
+    /**
+     * 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>;
 }
@@ -371,4 +705,4 @@ interface NativeBalanceData {
  */
 declare function useWalletNativeBalance(): NativeBalanceData;
 
-export { type AllChainConfigs as A, type ButtonTxStatus as B, type ConnectContentType as C, type InitialChains as I, type LegalConfig as L, type NovaConnectProviderType as N, type WalletBalance as W, type ConnectedContentType as a, type NovaConnectProviderProps as b, NovaConnectProviderError as c, NovaConnectProviderContext as d, useHasNovaConnectContext as e, useNovaConnectOptional as f, NovaConnectLabelsContext as g, useNovaConnectLabels as h, useNovaConnectLabel as i, useNovaConnectLabelsSubset as j, hasLabel as k, type LabelCategory as l, useLabelsByCategory as m, isDefaultLabels as n, getLabelWithFallback as o, createLabelsSubset as p, type NativeBalanceResult as q, useWalletNativeBalance as r, useNovaConnect as u };
+export { type AllChainConfigs as A, type ButtonTxStatus as B, type ConnectContentType as C, type InitialChains as I, type LegalConfig as L, type NovaConnectProviderType as N, type WalletBalance as W, type ConnectedContentType as a, type NovaConnectProviderProps as b, NovaConnectProviderError as c, NovaConnectProviderContext as d, useHasNovaConnectContext as e, useNovaConnectOptional as f, NovaConnectLabelsContext as g, useNovaConnectLabels as h, useNovaConnectLabel as i, useNovaConnectLabelsSubset as j, hasLabel as k, type LabelCategory as l, useLabelsByCategory as m, isDefaultLabels as n, getLabelWithFallback as o, createLabelsSubset as p, type NativeBalanceResult as q, useWalletNativeBalance as r, type ConnectedModalTxHistoryProps as s, type ConnectedModalTxHistoryCustomization as t, useNovaConnect as u, type LocalTxPagination as v, type LocalTransactionsHistoryCustomization as w, ConnectedModalTxHistory as x };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/nova-connect",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",
@@ -88,14 +88,14 @@
     "@heroicons/react": "2.x.x",
     "@radix-ui/react-dialog": "1.x.x",
     "@radix-ui/react-select": "2.x.x",
-    "@tuwaio/orbit-core": ">=0.2.7",
-    "@tuwaio/orbit-evm": ">=0.2.9",
-    "@tuwaio/orbit-solana": ">=0.2.3",
-    "@tuwaio/satellite-core": ">=0.3",
-    "@tuwaio/satellite-evm": ">=0.3",
-    "@tuwaio/satellite-solana": ">=0.3",
-    "@tuwaio/satellite-react": ">=0.3",
-    "@tuwaio/pulsar-core": ">=0.5",
+    "@tuwaio/orbit-core": ">=0.2.8",
+    "@tuwaio/orbit-evm": ">=0.2.11",
+    "@tuwaio/orbit-solana": ">=0.2.4",
+    "@tuwaio/satellite-core": ">=0.3.2",
+    "@tuwaio/satellite-evm": ">=0.3.2",
+    "@tuwaio/satellite-solana": ">=0.3.2",
+    "@tuwaio/satellite-react": ">=0.3.2",
+    "@tuwaio/pulsar-core": ">=0.6",
     "@tuwaio/nova-core": ">=0.3",
     "@tuwaio/nova-transactions": ">=0.3",
     "@wallet-standard/react": "1.x.x",
@@ -200,42 +200,42 @@
     "@heroicons/react": "^2.2.0",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-select": "^2.2.6",
-    "@tuwaio/orbit-core": "^0.2.7",
-    "@tuwaio/orbit-evm": "^0.2.10",
-    "@tuwaio/orbit-solana": "^0.2.3",
-    "@tuwaio/satellite-react": "^0.3.1",
-    "@tuwaio/satellite-core": "^0.3.1",
-    "@tuwaio/satellite-evm": "^0.3.1",
-    "@tuwaio/satellite-solana": "^0.3.1",
-    "@tuwaio/pulsar-core": "^0.5.1",
+    "@tuwaio/orbit-core": "^0.2.8",
+    "@tuwaio/orbit-evm": "^0.2.11",
+    "@tuwaio/orbit-solana": "^0.2.4",
+    "@tuwaio/satellite-react": "^0.3.2",
+    "@tuwaio/satellite-core": "^0.3.2",
+    "@tuwaio/satellite-evm": "^0.3.2",
+    "@tuwaio/satellite-solana": "^0.3.2",
+    "@tuwaio/pulsar-core": "^0.6.0",
     "@wallet-standard/react": "^1.0.1",
-    "@wagmi/core": "^3.4.0",
+    "@wagmi/core": "^3.4.6",
     "@web3icons/react": "^4.1.17",
     "@web3icons/common": "^0.11.46",
     "gill": "^0.14.0",
     "clsx": "^2.1.1",
-    "dayjs": "^1.11.19",
+    "dayjs": "^1.11.20",
     "immer": "^11.1.4",
     "ethereum-blockies-base64": "^1.0.2",
-    "framer-motion": "^12.34.5",
-    "react": "^19.2.4",
-    "react-toastify": "^11.0.5",
+    "framer-motion": "^12.38.0",
+    "react": "^19.2.5",
+    "react-toastify": "^11.1.0",
     "tailwind-merge": "^3.5.0",
-    "viem": "^2.46.3",
-    "zustand": "^5.0.11",
-    "@tailwindcss/postcss": "^4.2.1",
-    "@tailwindcss/vite": "^4.2.1",
+    "viem": "^2.48.4",
+    "zustand": "^5.0.12",
+    "@tailwindcss/postcss": "^4.2.4",
+    "@tailwindcss/vite": "^4.2.4",
     "@types/react": "^19.2.14",
-    "autoprefixer": "^10.4.27",
-    "postcss": "^8.5.8",
+    "autoprefixer": "^10.5.0",
+    "postcss": "^8.5.12",
     "postcss-cli": "^11.0.1",
-    "tailwindcss": "^4.2.1",
+    "tailwindcss": "^4.2.4",
     "@emotion/is-prop-valid": "^1.4.0",
     "tw-animate-css": "^1.4.0",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.3",
     "tsup": "^8.5.1",
-    "@tuwaio/nova-core": "^0.3.3",
-    "@tuwaio/nova-transactions": "^0.3.1"
+    "@tuwaio/nova-core": "^0.4.1",
+    "@tuwaio/nova-transactions": "^0.4.1"
   },
   "scripts": {
     "start": "tsup src/index.ts --watch",

package/dist/chunk-2SFIZVDC.cjs

@@ -1 +0,0 @@
-'use strict';var satelliteReact=require('@tuwaio/satellite-react');Object.defineProperty(exports,"a",{enumerable:true,get:function(){return satelliteReact.AllConnectors}});Object.defineProperty(exports,"b",{enumerable:true,get:function(){return satelliteReact.Connection}});Object.defineProperty(exports,"c",{enumerable:true,get:function(){return satelliteReact.Connector}});Object.defineProperty(exports,"d",{enumerable:true,get:function(){return satelliteReact.SatelliteConnectProvider}});Object.defineProperty(exports,"e",{enumerable:true,get:function(){return satelliteReact.SatelliteConnectProviderProps}});Object.defineProperty(exports,"f",{enumerable:true,get:function(){return satelliteReact.SatelliteStoreContext}});Object.defineProperty(exports,"g",{enumerable:true,get:function(){return satelliteReact.useInitializeAutoConnect}});Object.defineProperty(exports,"h",{enumerable:true,get:function(){return satelliteReact.useSatelliteConnectStore}});