@movebridge/react 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,446 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { NetworkType, MovementError, Movement, WalletType, ContractInterface, BuildOptions, TransactionResponse } from '@movebridge/core';
+export { ContractEvent, MovementError, NetworkType, TransactionResponse, WalletType } from '@movebridge/core';
+
+/**
+ * Movement context value
+ */
+interface MovementContextValue {
+    /** Movement SDK instance */
+    movement: Movement | null;
+    /** Current network */
+    network: NetworkType;
+    /** Wallet state */
+    address: string | null;
+    connected: boolean;
+    connecting: boolean;
+    /** Available wallets */
+    wallets: WalletType[];
+    /** Currently connected wallet */
+    wallet: WalletType | null;
+    /** Connect to a wallet */
+    connect: (wallet: WalletType) => Promise<void>;
+    /** Disconnect from wallet */
+    disconnect: () => Promise<void>;
+    /** Error handler */
+    onError?: (error: MovementError) => void;
+}
+/**
+ * Movement context
+ */
+declare const MovementContext: react.Context<MovementContextValue | null>;
+/**
+ * Provider props
+ */
+interface MovementProviderProps {
+    /** Network to connect to */
+    network: NetworkType;
+    /** Auto-connect to previously connected wallet */
+    autoConnect?: boolean;
+    /** Error callback */
+    onError?: (error: MovementError) => void;
+    /** Children */
+    children: ReactNode;
+}
+/**
+ * Movement Provider
+ * Provides Movement SDK context to child components
+ *
+ * @example
+ * ```tsx
+ * import { MovementProvider } from '@movebridge/react';
+ *
+ * function App() {
+ *   return (
+ *     <MovementProvider network="testnet" autoConnect>
+ *       <YourApp />
+ *     </MovementProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function MovementProvider({ network, autoConnect, onError, children, }: MovementProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access Movement context
+ * @throws Error if used outside MovementProvider
+ */
+declare function useMovementContext(): MovementContextValue;
+
+/**
+ * @movebridge/react - useMovement hook
+ * Hook for wallet connection state
+ */
+
+/**
+ * Return type for useMovement hook
+ */
+interface UseMovementReturn {
+    /** Movement SDK instance */
+    movement: Movement | null;
+    /** Current network */
+    network: NetworkType;
+    /** Connected wallet address */
+    address: string | null;
+    /** Whether a wallet is connected */
+    connected: boolean;
+    /** Whether a connection is in progress */
+    connecting: boolean;
+    /** Connect to a wallet */
+    connect: (wallet: WalletType) => Promise<void>;
+    /** Disconnect from wallet */
+    disconnect: () => Promise<void>;
+    /** Available wallets */
+    wallets: WalletType[];
+    /** Currently connected wallet */
+    wallet: WalletType | null;
+}
+/**
+ * Hook for wallet connection state
+ *
+ * @example
+ * ```tsx
+ * function WalletButton() {
+ *   const { address, connected, connect, disconnect, wallets } = useMovement();
+ *
+ *   if (connected) {
+ *     return (
+ *       <button onClick={disconnect}>
+ *         {address?.slice(0, 6)}...{address?.slice(-4)}
+ *       </button>
+ *     );
+ *   }
+ *
+ *   return (
+ *     <button onClick={() => connect(wallets[0])}>
+ *       Connect Wallet
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare function useMovement(): UseMovementReturn;
+
+/**
+ * @movebridge/react - useBalance hook
+ * Hook for fetching account balance
+ */
+
+/**
+ * Return type for useBalance hook
+ */
+interface UseBalanceReturn {
+    /** Account balance in smallest unit */
+    balance: string | null;
+    /** Whether balance is loading */
+    loading: boolean;
+    /** Error if fetch failed */
+    error: MovementError | null;
+    /** Refetch balance */
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook for fetching account balance
+ *
+ * @param address - Account address to fetch balance for (defaults to connected address)
+ *
+ * @example
+ * ```tsx
+ * function BalanceDisplay() {
+ *   const { address } = useMovement();
+ *   const { balance, loading, error, refetch } = useBalance(address);
+ *
+ *   if (loading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return (
+ *     <div>
+ *       Balance: {balance} octas
+ *       <button onClick={refetch}>Refresh</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useBalance(address?: string | null): UseBalanceReturn;
+
+/**
+ * @movebridge/react - useContract hook
+ * Hook for contract interactions
+ */
+
+/**
+ * Return type for useContract hook
+ */
+interface UseContractReturn<T = unknown> {
+    /** Last operation result */
+    data: T | null;
+    /** Whether an operation is in progress */
+    loading: boolean;
+    /** Error if operation failed */
+    error: MovementError | null;
+    /** Call a view function */
+    read: <R = unknown>(functionName: string, args: unknown[], typeArgs?: string[]) => Promise<R>;
+    /** Call an entry function */
+    write: (functionName: string, args: unknown[], typeArgs?: string[]) => Promise<string>;
+    /** Contract interface instance */
+    contract: ContractInterface | null;
+}
+/**
+ * Options for useContract hook
+ */
+interface UseContractOptions {
+    /** Contract address */
+    address: string;
+    /** Module name */
+    module: string;
+}
+/**
+ * Hook for contract interactions
+ *
+ * @param options - Contract options
+ *
+ * @example
+ * ```tsx
+ * function Counter() {
+ *   const { data, loading, error, read, write } = useContract({
+ *     address: '0x123',
+ *     module: 'counter',
+ *   });
+ *
+ *   const fetchCount = async () => {
+ *     const count = await read('get_count', []);
+ *     console.log('Count:', count);
+ *   };
+ *
+ *   const increment = async () => {
+ *     const txHash = await write('increment', []);
+ *     console.log('Transaction:', txHash);
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <p>Count: {data}</p>
+ *       <button onClick={fetchCount}>Fetch</button>
+ *       <button onClick={increment}>Increment</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useContract<T = unknown>(options: UseContractOptions): UseContractReturn<T>;
+
+/**
+ * @movebridge/react - useTransaction hook
+ * Hook for transaction submission
+ */
+
+/**
+ * Return type for useTransaction hook
+ */
+interface UseTransactionReturn {
+    /** Send a transaction */
+    send: (options: BuildOptions) => Promise<string>;
+    /** Last transaction hash */
+    data: string | null;
+    /** Whether transaction is in progress */
+    loading: boolean;
+    /** Error if transaction failed */
+    error: MovementError | null;
+    /** Reset state */
+    reset: () => void;
+}
+/**
+ * Hook for transaction submission
+ *
+ * @example
+ * ```tsx
+ * function TransferForm() {
+ *   const { send, data, loading, error, reset } = useTransaction();
+ *
+ *   const handleTransfer = async () => {
+ *     try {
+ *       const hash = await send({
+ *         function: '0x1::coin::transfer',
+ *         typeArguments: ['0x1::aptos_coin::AptosCoin'],
+ *         arguments: ['0x123...', '1000000'],
+ *       });
+ *       console.log('Transaction hash:', hash);
+ *     } catch (err) {
+ *       console.error('Transaction failed:', err);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={handleTransfer} disabled={loading}>
+ *         {loading ? 'Sending...' : 'Send'}
+ *       </button>
+ *       {data && <p>Transaction: {data}</p>}
+ *       {error && <p>Error: {error.message}</p>}
+ *       <button onClick={reset}>Reset</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useTransaction(): UseTransactionReturn;
+
+/**
+ * @movebridge/react - useWaitForTransaction hook
+ * Hook for waiting for transaction confirmation
+ */
+
+/**
+ * Return type for useWaitForTransaction hook
+ */
+interface UseWaitForTransactionReturn {
+    /** Transaction response */
+    data: TransactionResponse | null;
+    /** Whether waiting for confirmation */
+    loading: boolean;
+    /** Error if confirmation failed */
+    error: MovementError | null;
+}
+/**
+ * Options for useWaitForTransaction hook
+ */
+interface UseWaitForTransactionOptions {
+    /** Timeout in milliseconds */
+    timeoutMs?: number;
+    /** Check interval in milliseconds */
+    checkIntervalMs?: number;
+}
+/**
+ * Hook for waiting for transaction confirmation
+ *
+ * @param hash - Transaction hash to wait for
+ * @param options - Wait options
+ *
+ * @example
+ * ```tsx
+ * function TransactionStatus({ hash }: { hash: string }) {
+ *   const { data, loading, error } = useWaitForTransaction(hash);
+ *
+ *   if (loading) return <div>Waiting for confirmation...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *   if (!data) return null;
+ *
+ *   return (
+ *     <div>
+ *       <p>Status: {data.success ? 'Success' : 'Failed'}</p>
+ *       <p>Gas used: {data.gasUsed}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useWaitForTransaction(hash: string | null | undefined, options?: UseWaitForTransactionOptions): UseWaitForTransactionReturn;
+
+/**
+ * @movebridge/react - WalletButton component
+ * Drop-in wallet connect button
+ */
+/**
+ * Props for WalletButton component
+ */
+interface WalletButtonProps {
+    /** Additional CSS class */
+    className?: string;
+    /** Text to show when disconnected */
+    connectText?: string;
+}
+/**
+ * WalletButton component
+ * Shows connect button when disconnected, address when connected
+ *
+ * @example
+ * ```tsx
+ * <WalletButton />
+ * <WalletButton connectText="Connect" className="my-button" />
+ * ```
+ */
+declare function WalletButton({ className, connectText }: WalletButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @movebridge/react - WalletModal component
+ * Modal for wallet selection
+ */
+/**
+ * Props for WalletModal component
+ */
+interface WalletModalProps {
+    /** Whether modal is open */
+    open: boolean;
+    /** Callback when modal should close */
+    onClose: () => void;
+}
+/**
+ * WalletModal component
+ * Displays available wallets for selection
+ *
+ * @example
+ * ```tsx
+ * const [open, setOpen] = useState(false);
+ *
+ * <button onClick={() => setOpen(true)}>Connect</button>
+ * <WalletModal open={open} onClose={() => setOpen(false)} />
+ * ```
+ */
+declare function WalletModal({ open, onClose }: WalletModalProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * @movebridge/react - AddressDisplay component
+ * Displays an address with truncation and copy functionality
+ */
+/**
+ * Props for AddressDisplay component
+ */
+interface AddressDisplayProps {
+    /** Address to display */
+    address: string;
+    /** Whether to truncate the address */
+    truncate?: boolean;
+    /** Whether to show copy button */
+    copyable?: boolean;
+    /** Additional CSS class */
+    className?: string;
+}
+/**
+ * AddressDisplay component
+ * Shows an address with optional truncation and copy-to-clipboard
+ *
+ * @example
+ * ```tsx
+ * <AddressDisplay address="0x123..." />
+ * <AddressDisplay address="0x123..." truncate copyable />
+ * ```
+ */
+declare function AddressDisplay({ address, truncate, copyable, className, }: AddressDisplayProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Props for NetworkSwitcher component
+ */
+interface NetworkSwitcherProps {
+    /** Additional CSS class */
+    className?: string;
+    /** Callback when network change is requested */
+    onNetworkChange?: (network: NetworkType) => void;
+}
+/**
+ * NetworkSwitcher component
+ * Displays current network with option to switch
+ *
+ * Note: Switching networks requires re-initializing the provider.
+ * This component shows the current network and can trigger a callback
+ * for the parent to handle network switching.
+ *
+ * @example
+ * ```tsx
+ * <NetworkSwitcher onNetworkChange={(network) => setNetwork(network)} />
+ * ```
+ */
+declare function NetworkSwitcher({ className, onNetworkChange }: NetworkSwitcherProps): react_jsx_runtime.JSX.Element;
+
+export { AddressDisplay, type AddressDisplayProps, MovementContext, type MovementContextValue, MovementProvider, type MovementProviderProps, NetworkSwitcher, type NetworkSwitcherProps, type UseBalanceReturn, type UseContractOptions, type UseContractReturn, type UseMovementReturn, type UseTransactionReturn, type UseWaitForTransactionOptions, type UseWaitForTransactionReturn, WalletButton, type WalletButtonProps, WalletModal, type WalletModalProps, useBalance, useContract, useMovement, useMovementContext, useTransaction, useWaitForTransaction };