@tonconnect/ui 2.0.0-beta.9 → 2.0.1-beta.0

package/lib/index.d.ts

@@ -195,7 +195,7 @@ interface TonConnectUiCreateOptionsBase extends TonConnectUiOptions {
     widgetRootId?: string;
 }
 
-declare type WalletOpenMethod = 'qrcode' | 'universal-link';
+declare type WalletOpenMethod = 'qrcode' | 'universal-link' | 'custom-deeplink';
 declare type WalletInfoWithOpenMethod = WalletInfoInjectable | WalletInfoRemoteWithOpenMethod | (WalletInfoInjectable & WalletInfoRemoteWithOpenMethod);
 declare type WalletInfoRemoteWithOpenMethod = WalletInfoRemote & {
     openMethod?: WalletOpenMethod;
@@ -264,6 +264,45 @@ declare type WalletsModalState = WalletModalOpened | WalletModalClosed;
  */
 declare type WalletsModalCloseReason = 'action-cancelled' | 'wallet-selected';
 
+/**
+ * Opened modal window state.
+ */
+declare type SingleWalletModalOpened = {
+    /**
+     * Modal window status.
+     */
+    status: 'opened';
+    /**
+     * Wallet info.
+     */
+    walletInfo: WalletInfoRemote;
+    /**
+     * Always `null` for opened modal window.
+     */
+    closeReason: null;
+};
+/**
+ * Closed modal window state.
+ */
+declare type SingleWalletModalClosed = {
+    /**
+     * Modal window status.
+     */
+    status: 'closed';
+    /**
+     * Close reason, if the modal window was closed.
+     */
+    closeReason: SingleWalletModalCloseReason | null;
+};
+/**
+ * Modal window state.
+ */
+declare type SingleWalletModalState = SingleWalletModalOpened | SingleWalletModalClosed;
+/**
+ * Modal window close reason.
+ */
+declare type SingleWalletModalCloseReason = 'action-cancelled' | 'wallet-selected';
+
 declare class TonConnectUI {
     static getWallets(): Promise<WalletInfo[]>;
     private readonly walletInfoStorage;
@@ -281,6 +320,11 @@ declare class TonConnectUI {
      * Manages the modal window state.
      */
     readonly modal: WalletsModal;
+    /**
+     * Manages the single wallet modal window state.
+     * TODO: make it public when interface will be ready for external usage.
+     */
+    private readonly singleWalletModal;
     /**
      * Manages the transaction modal window state.
      * TODO: make it public when interface will be ready for external usage.
@@ -341,6 +385,26 @@ declare class TonConnectUI {
      * Returns current modal window state.
      */
     get modalState(): WalletsModalState;
+    /**
+     * Opens the single wallet modal window, returns a promise that resolves after the modal window is opened.
+     * @experimental
+     */
+    openSingleWalletModal(wallet: string): Promise<void>;
+    /**
+     * Close the single wallet modal window.
+     * @experimental
+     */
+    closeSingleWalletModal(): void;
+    /**
+     * Subscribe to the single wallet modal window state changes, returns a function which has to be called to unsubscribe.
+     * @experimental
+     */
+    onSingleWalletModalStateChange(onChange: (state: SingleWalletModalState) => void): () => void;
+    /**
+     * Returns current single wallet modal window state.
+     * @experimental
+     */
+    get singleWalletModalState(): SingleWalletModalState;
     /**
      * @deprecated Use `tonConnectUI.openModal()` instead. Will be removed in the next major version.
      * Opens the modal window and handles a wallet connection.