@solana/kit-plugin-wallet 0.12.0 → 0.13.1

package/dist/types/types.d.ts

@@ -1,4 +1,4 @@
-import type { MessageSigner, SignatureBytes, TransactionSigner } from '@solana/kit';
+import type { MessageSigner, ReadonlyUint8Array, SignatureBytes, TransactionSigner } from '@solana/kit';
 import type { SolanaChain } from '@solana/wallet-standard-chains';
 import type { SolanaSignInInput, SolanaSignInOutput } from '@solana/wallet-standard-features';
 import type { IdentifierString } from '@wallet-standard/base';
@@ -228,13 +228,19 @@ export type WalletNamespace = {
      */
     connect: (wallet: UiWallet, options?: WalletActionOptions) => Promise<readonly UiWalletAccount[]>;
     /**
-     * Disconnect the active wallet. Calls `standard:disconnect` if supported.
+     * Disconnect a wallet. Calls `standard:disconnect` if supported.
+     *
+     * `wallet` defaults to the active wallet. Passing a non-active, currently
+     * authorized wallet deauthorizes it (calling `standard:disconnect` if
+     * supported) while leaving the active connection untouched. A `wallet`
+     * that doesn't support `standard:disconnect`, or one that is already
+     * unauthorized/unregistered, is a forgiving no-op.
      *
      * @throws `options.abortSignal.reason` if the signal is already aborted
      *   when the action is called. Aborts after the wallet call has been
      *   dispatched do not take effect.
      */
-    disconnect: (options?: WalletActionOptions) => Promise<void>;
+    disconnect: (wallet?: UiWallet, options?: WalletActionOptions) => Promise<void>;
     /**
      * Get the current wallet state. Referentially stable — a new object is
      * only created when a field actually changes, so React's
@@ -244,13 +250,19 @@ export type WalletNamespace = {
      */
     getState: () => WalletState;
     /**
-     * Switch to a different account within the connected wallet. Creates and
-     * caches a new signer for the selected account.
+     * Select an account, creating and caching a new signer for it.
+     *
+     * The account may belong to any currently authorized wallet, not only the
+     * active one. When it belongs to a different authorized wallet, the active
+     * connection switches to that wallet synchronously (no prompt), leaving the
+     * previously active wallet authorized. If the store is currently 'disconnected',
+     * this allows transitioning to 'connected' synchronously.
      *
-     * @throws `SolanaError(SOLANA_ERROR__WALLET__NOT_CONNECTED)` if no wallet is
-     *   connected, or the connected wallet is currently disconnecting.
      * @throws `SolanaError(SOLANA_ERROR__WALLET__ACCOUNT_NOT_AVAILABLE)` if the
-     *   specified account is not among the connected wallet's accounts.
+     *   account's handle cannot be resolved to a currently authorized wallet, or
+     *   the account is not among that wallet's accounts.
+     * @throws `SolanaError(SOLANA_ERROR__WALLET__NOT_CONNECTED)` if the account's
+     *   wallet is currently disconnecting.
      */
     selectAccount: (account: UiWalletAccount) => void;
     /**
@@ -300,7 +312,7 @@ export type WalletNamespace = {
      *   when the action is called. Aborts after the wallet call has been
      *   dispatched do not take effect.
      */
-    signMessage: (message: Uint8Array, options?: WalletActionOptions) => Promise<SignatureBytes>;
+    signMessage: (message: ReadonlyUint8Array, options?: WalletActionOptions) => Promise<SignatureBytes>;
     /**
      * Subscribe to any wallet state change. Compatible with React's
      * `useSyncExternalStore` and similar framework primitives.
@@ -313,6 +325,42 @@ export type WalletNamespace = {
      * ```
      */
     subscribe: (listener: () => void) => () => void;
+    /**
+     * **Advanced.** Resolves once the initial connection attempt has settled —
+     * i.e. {@link getState}'s `status` is no longer `'pending'` or
+     * `'reconnecting'`.
+     *
+     * You only need this if your app **rebuilds the client at runtime** (for
+     * example, to change chain). Each freshly built client runs a silent
+     * auto-reconnect that briefly passes through `'pending'`/`'reconnecting'`;
+     * awaiting this lets you hold the previous UI until the new client is ready
+     * instead of flashing a "reconnecting" state on every swap. Most apps never
+     * call it — subscribe to `status` with {@link subscribe} instead.
+     *
+     * Does **not** wait for user-initiated `connect`/`disconnect`/`signIn`
+     * (those pass through `'connecting'`/`'disconnecting'`, which count as
+     * ready), so a normal connect never makes this block. While transient it
+     * returns the **same** promise reference on every call, so successive
+     * awaits during one warm-up share a single settlement.
+     *
+     * Disposing the client mid-warm-up settles the status to `'disconnected'`,
+     * so a pending `whenReady()` resolves rather than hanging. Check
+     * {@link getState} after awaiting if you need to distinguish a ready
+     * connection from a disposed (or never-connected) client.
+     *
+     * @returns A promise that resolves with no value once the wallet is past its
+     *   initial `'pending'`/`'reconnecting'` warm-up. Already resolved when the
+     *   status is not transient.
+     *
+     * @example
+     * ```ts
+     * // On a chain switch, hold the old UI until the rebuilt client is ready:
+     * const next = createClient().use(walletSigner({ chain }));
+     * await next.wallet.whenReady();
+     * setClient(next);
+     * ```
+     */
+    whenReady: () => Promise<void>;
 };
 /**
  * Properties added to the client by the wallet plugins.

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/wallet.d.ts

@@ -32,7 +32,7 @@ import type { ClientWithWallet, WalletPluginConfig } from './types';
  */
 export declare function walletSigner(config: WalletPluginConfig): <T extends object & {
     wallet?: never;
-}>(client: T) => Disposable & Omit<T, "wallet" | "payer" | "identity" | "subscribeToIdentity" | "subscribeToPayer"> & ClientWithIdentity & ClientWithPayer & ClientWithSubscribeToIdentity & ClientWithSubscribeToPayer & ClientWithWallet;
+}>(client: T) => Disposable & Omit<T, "identity" | "payer" | "subscribeToIdentity" | "subscribeToPayer" | "wallet"> & ClientWithIdentity & ClientWithPayer & ClientWithSubscribeToIdentity & ClientWithSubscribeToPayer & ClientWithWallet;
 /**
  * A framework-agnostic Kit plugin that manages wallet discovery, connection
  * lifecycle, and signer creation using wallet-standard — and syncs the
@@ -64,7 +64,7 @@ export declare function walletSigner(config: WalletPluginConfig): <T extends obj
  */
 export declare function walletIdentity(config: WalletPluginConfig): <T extends object & {
     wallet?: never;
-}>(client: T) => Disposable & Omit<T, "wallet" | "identity" | "subscribeToIdentity"> & ClientWithIdentity & ClientWithSubscribeToIdentity & ClientWithWallet;
+}>(client: T) => Disposable & Omit<T, "identity" | "subscribeToIdentity" | "wallet"> & ClientWithIdentity & ClientWithSubscribeToIdentity & ClientWithWallet;
 /**
  * A framework-agnostic Kit plugin that manages wallet discovery, connection
  * lifecycle, and signer creation using wallet-standard — and syncs the
@@ -96,7 +96,7 @@ export declare function walletIdentity(config: WalletPluginConfig): <T extends o
  */
 export declare function walletPayer(config: WalletPluginConfig): <T extends object & {
     wallet?: never;
-}>(client: T) => Disposable & Omit<T, "wallet" | "payer" | "subscribeToPayer"> & ClientWithPayer & ClientWithSubscribeToPayer & ClientWithWallet;
+}>(client: T) => Disposable & Omit<T, "payer" | "subscribeToPayer" | "wallet"> & ClientWithPayer & ClientWithSubscribeToPayer & ClientWithWallet;
 /**
  * A framework-agnostic Kit plugin that manages wallet discovery, connection
  * lifecycle, and signer creation using wallet-standard.

package/dist/types/wallet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAMlC,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAgEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,IAtD3C,CAAC;aAA6B,KAAK;2OA8D9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,IA7F7C,CAAC;aAA6B,KAAK;6JA+F9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,IA9H1C,CAAC;aAA6B,KAAK;iJAgI9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,IAhKlD,CAAC;aAA6B,KAAK;mEAkK9C"}
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAMlC,MAAM,aAAa,CAAC;AAGrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAkEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,IAtD3C,CAAC,SAAS,MAAM,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,0OA8DhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,IA7F7C,CAAC,SAAS,MAAM,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,4JA+FhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,IA9H1C,CAAC,SAAS,MAAM,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,gJAgIhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,IAhKlD,CAAC,SAAS,MAAM,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,kEAkKhD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana/kit-plugin-wallet",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "Wallet connection plugin for Kit clients",
   "keywords": [
     "kit",
@@ -22,6 +22,7 @@
   "files": [
     "./dist/types",
     "./dist/index.*",
+    "./dist/react/index.*",
     "./src/"
   ],
   "type": "commonjs",
@@ -35,19 +36,33 @@
   "types": "./dist/types/index.d.ts",
   "react-native": "./dist/index.react-native.mjs",
   "exports": {
-    "types": "./dist/types/index.d.ts",
-    "react-native": "./dist/index.react-native.mjs",
-    "browser": {
-      "import": "./dist/index.browser.mjs",
-      "require": "./dist/index.browser.cjs"
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "react-native": "./dist/index.react-native.mjs",
+      "browser": {
+        "import": "./dist/index.browser.mjs",
+        "require": "./dist/index.browser.cjs"
+      },
+      "node": {
+        "import": "./dist/index.node.mjs",
+        "require": "./dist/index.node.cjs"
+      }
     },
-    "node": {
-      "import": "./dist/index.node.mjs",
-      "require": "./dist/index.node.cjs"
+    "./react": {
+      "types": "./dist/types/react/index.d.ts",
+      "react-native": "./dist/react/index.react-native.mjs",
+      "browser": {
+        "import": "./dist/react/index.browser.mjs",
+        "require": "./dist/react/index.browser.cjs"
+      },
+      "node": {
+        "import": "./dist/react/index.node.mjs",
+        "require": "./dist/react/index.node.cjs"
+      }
     }
   },
   "dependencies": {
-    "@solana/wallet-account-signer": "^6.10.0",
+    "@solana/wallet-account-signer": "^7.0.0",
     "@solana/wallet-standard-chains": "^1.1.2",
     "@solana/wallet-standard-features": "^1.4.0",
     "@wallet-standard/app": "^1.1.1",
@@ -58,10 +73,25 @@
     "@wallet-standard/ui-registry": "^1.1.1"
   },
   "devDependencies": {
-    "@wallet-standard/errors": "^0.1.2"
+    "@solana/react": "^7.0.0",
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^18.0.0 || ^19.0.0",
+    "@wallet-standard/errors": "^0.1.2",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
   },
   "peerDependencies": {
-    "@solana/kit": "^6.10.0"
+    "@solana/kit": "^7.0.0",
+    "@solana/react": "^7.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@solana/react": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
   },
   "browserslist": [
     "supports bigint and not dead",
@@ -70,8 +100,9 @@
   "scripts": {
     "build": "rimraf dist && tsup && tsc -p ./tsconfig.declarations.json",
     "dev": "vitest --project node",
-    "test": "pnpm test:types && pnpm test:treeshakability && pnpm test:unit",
-    "test:treeshakability": "for file in dist/index.*.mjs; do agadoo $file; done",
+    "test": "pnpm test:types && pnpm test:treeshakability && pnpm test:packaging && pnpm test:unit",
+    "test:packaging": "node ../../scripts/assert-publishable-dist.mjs",
+    "test:treeshakability": "for file in dist/index.*.mjs dist/react/index.*.mjs; do agadoo $file; done",
     "test:types": "tsc --noEmit",
     "test:unit": "vitest run"
   }

package/src/__typetests__/wallet-typetest.ts

@@ -7,6 +7,7 @@ import {
     TransactionSigner,
 } from '@solana/kit';
 
+import { isWalletWarmingUp, type WalletStatus } from '../index';
 import { ClientWithWallet } from '../types';
 import { walletIdentity, walletPayer, walletSigner, walletWithoutSigner } from '../wallet';
 
@@ -97,6 +98,20 @@ const signer = null as unknown as TransactionSigner;
     }
 }
 
+// [DESCRIBE] isWalletWarmingUp
+{
+    // It is exported from the root entry and narrows a status to a boolean.
+    {
+        const status = null as unknown as WalletStatus;
+        isWalletWarmingUp(status) satisfies boolean;
+    }
+    // It requires a WalletStatus argument.
+    {
+        // @ts-expect-error isWalletWarmingUp requires a status argument.
+        isWalletWarmingUp();
+    }
+}
+
 // [DESCRIBE] Only one wallet plugin allowed
 {
     // It fails to typecheck when a wallet plugin is used on a client that already has wallet.

package/src/index.ts

@@ -1,2 +1,3 @@
+export * from './status';
 export * from './types';
 export * from './wallet';

package/src/react/__typetests__/index.ts

@@ -0,0 +1,108 @@
+import type { ReadonlyUint8Array, SignatureBytes } from '@solana/kit';
+import type { SolanaSignInInput, SolanaSignInOutput } from '@solana/wallet-standard-features';
+import type { UiWallet, UiWalletAccount } from '@wallet-standard/ui';
+import type { ReactNode } from 'react';
+
+import type { WalletState, WalletStatus } from '../../types';
+import {
+    useConnect,
+    useConnectedWallet,
+    useDisconnect,
+    useIsWalletReady,
+    useSelectAccount,
+    useSignIn,
+    useSignMessage,
+    useWallets,
+    WalletReadyGate,
+    type WalletReadyGateProps,
+    useWalletStatus,
+} from '../index';
+
+// NB: hooks are only type-checked here, never executed.
+
+// [DESCRIBE] useWalletStatus
+{
+    const status = useWalletStatus();
+    status satisfies WalletStatus;
+}
+
+// [DESCRIBE] useIsWalletReady
+{
+    const isReady = useIsWalletReady();
+    isReady satisfies boolean;
+}
+
+// [DESCRIBE] WalletReadyGate
+{
+    // Both `children` and `fallback` are required `ReactNode` props.
+    ({ children: 'ready', fallback: 'loading' }) satisfies WalletReadyGateProps;
+    // The gate is callable and its return type is assignable to `ReactNode`.
+    const rendered: ReactNode = WalletReadyGate({ children: null, fallback: null });
+    void rendered;
+}
+{
+    // @ts-expect-error `fallback` is required.
+    ({ children: null }) satisfies WalletReadyGateProps;
+}
+
+// [DESCRIBE] useConnectedWallet
+{
+    const connected = useConnectedWallet();
+    connected satisfies WalletState['connected'];
+    // The connection is nullable when disconnected.
+    connected satisfies { account: UiWalletAccount } | null;
+}
+
+// [DESCRIBE] useWallets
+{
+    const wallets = useWallets();
+    wallets satisfies readonly UiWallet[];
+}
+
+// [DESCRIBE] useConnect
+{
+    const action = useConnect();
+    action.dispatch(null as unknown as UiWallet);
+    action.data satisfies readonly UiWalletAccount[] | undefined;
+    // @ts-expect-error dispatch requires the wallet argument.
+    action.dispatch();
+}
+
+// [DESCRIBE] useDisconnect
+{
+    const action = useDisconnect();
+    // The wallet argument is optional — omit it to disconnect the active wallet.
+    action.dispatch();
+    // Or pass a specific wallet to deauthorize.
+    action.dispatch(null as unknown as UiWallet);
+    action.data satisfies void | undefined;
+}
+
+// [DESCRIBE] useSignIn
+{
+    const action = useSignIn();
+    action.dispatch(null as unknown as UiWallet, null as unknown as SolanaSignInInput);
+    action.data satisfies SolanaSignInOutput | undefined;
+    // @ts-expect-error dispatch requires both the wallet and the sign-in input.
+    action.dispatch(null as unknown as UiWallet);
+}
+
+// [DESCRIBE] useSignMessage
+{
+    const action = useSignMessage();
+    action.dispatch(new Uint8Array());
+    action.data satisfies SignatureBytes | undefined;
+}
+{
+    // dispatch accepts a ReadonlyUint8Array (e.g. codec output) without a cast.
+    const action = useSignMessage();
+    action.dispatch(null as unknown as ReadonlyUint8Array);
+}
+
+// [DESCRIBE] useSelectAccount
+{
+    const selectAccount = useSelectAccount();
+    selectAccount(null as unknown as UiWalletAccount) satisfies void;
+    // @ts-expect-error selectAccount requires the account argument.
+    selectAccount();
+}