refactor!: rename wallets "reconnect" to "initialize" (#165)

.changeset/clean-buttons-jump.md

@@ -0,0 +1,5 @@
+---
+"@reactive-dot/react": minor
+---
+
+BREAKING: renamed wallets "reconnect" to "initialize".

packages/react/src/contexts/index.tsx

@@ -1,4 +1,4 @@
-import { useWalletsReconnector } from "../hooks/use-wallets-reconnector.js";
+import { useWalletsInitializer } from "../hooks/use-wallets-initializer.js";
 import { configAtom } from "../stores/config.js";
 import { MutationEventSubjectContext } from "./mutation.js";
 import type { Config } from "@reactive-dot/core";
@@ -26,9 +26,9 @@ export type ReDotProviderProps = PropsWithChildren<{
   config: Config;
 
   /**
-   * Whether or not to reconnect previously connected wallets on mount.
+   * Whether or not to initialize wallets on mount.
    */
-  autoReconnectWallets?: boolean;
+  autoInitializeWallets?: boolean;
 }>;
 
 function ReDotHydrator(props: ReDotProviderProps) {
@@ -37,12 +37,12 @@ function ReDotHydrator(props: ReDotProviderProps) {
   return null;
 }
 
-function WalletsReconnector() {
-  const [_, reconnect] = useWalletsReconnector();
+function WalletsInitializer() {
+  const [_, initialize] = useWalletsInitializer();
 
   useEffect(() => {
-    reconnect();
-  }, [reconnect]);
+    initialize();
+  }, [initialize]);
 
   return null;
 }
@@ -54,15 +54,15 @@ function WalletsReconnector() {
  * @returns React element
  */
 export function ReDotProvider({
-  autoReconnectWallets = true,
+  autoInitializeWallets = true,
   ...props
 }: ReDotProviderProps) {
   return (
     <ScopeProvider atoms={[configAtom]}>
       <ReDotHydrator {...props} />
-      {autoReconnectWallets && (
+      {autoInitializeWallets && (
         <Suspense>
-          <WalletsReconnector />
+          <WalletsInitializer />
         </Suspense>
       )}
       <MutationEventSubjectContext.Provider

packages/react/src/hooks/use-wallets-reconnector.ts → packages/react/src/hooks/use-wallets-initializer.ts

@@ -9,22 +9,22 @@ import { initializeWallets } from "@reactive-dot/core/wallets.js";
 import { useCallback, useState } from "react";
 
 /**
- * Hook for reconnecting wallets.
+ * Hook for initializing wallets.
  *
- * @returns The reconnection state and reconnect function
+ * @returns The initialization state and initialize function
  */
-export function useWalletsReconnector() {
+export function useWalletsInitializer() {
   const wallets = useWallets();
 
   const [state, setState] = useState<AsyncValue<true, ReDotError>>(IDLE);
 
-  const reconnect = useCallback(async () => {
+  const initialize = useCallback(async () => {
     setState(PENDING);
     initializeWallets(wallets);
   }, [wallets]);
 
-  return [state, reconnect] as [
+  return [state, initialize] as [
     state: typeof state,
-    reconnect: typeof reconnect,
+    initialize: typeof initialize,
   ];
 }

packages/react/src/index.ts

@@ -30,5 +30,5 @@ export { useSigner } from "./hooks/use-signer.js";
 export { useTypedApi } from "./hooks/use-typed-api.js";
 export { useWalletConnector } from "./hooks/use-wallet-connector.js";
 export { useWalletDisconnector } from "./hooks/use-wallet-disconnector.js";
-export { useWalletsReconnector } from "./hooks/use-wallets-reconnector.js";
+export { useWalletsInitializer } from "./hooks/use-wallets-initializer.js";
 export { useConnectedWallets, useWallets } from "./hooks/use-wallets.js";