@tuwaio/nova-connect 0.10.5 → 0.10.7

package/dist/components/index.d.cts

@@ -4234,7 +4234,7 @@ type ConnectedModalCustomization = {
         MainContent?: ComponentType<ConnectedModalMainContentSlotProps>;
         /** Custom footer component */
         Footer?: ComponentType<ConnectedModalFooterProps>;
-        /** Custom motion container for animations */
+        /** Custom container of the opening animation (default: `motion.div`) */
         MotionContainer?: ComponentType<ComponentPropsWithoutRef<typeof motion.div>>;
     };
     /** Custom class name generators */
@@ -4252,7 +4252,7 @@ type ConnectedModalCustomization = {
             hasActiveWallet: boolean;
         }) => string;
         /**
-         * Returns the classes of the layout animation container.
+         * Returns the classes of the container of the opening animation.
          *
          * @returns The classes.
          */
@@ -4326,11 +4326,25 @@ type ConnectedModalCustomization = {
             /** Animation delay in seconds */
             delay?: number;
         };
-        /** Layout animation between screens */
+        /**
+         * The former layout animation between screens.
+         *
+         * @deprecated No longer applied: a layout animation stretched the window for a frame after a size change, and
+         * `DialogContent` of `@tuwaio/nova-core` follows the height of the content. It will be removed in the next major
+         * version.
+         */
         layout?: {
-            /** Animation duration in seconds (default: `0.0001`) */
+            /**
+             * Animation duration in seconds.
+             *
+             * @deprecated No longer applied.
+             */
             duration?: number;
-            /** Animation easing curve */
+            /**
+             * Animation easing curve.
+             *
+             * @deprecated No longer applied.
+             */
             ease?: Easing | Easing[];
         };
     };
@@ -4369,7 +4383,7 @@ type ConnectedModalCustomization = {
     };
     /** Configuration options */
     config?: {
-        /** Disables the modal and layout animations (default: `false`) */
+        /** Disables the opening animation of the modal (default: `false`) */
         disableAnimation?: boolean;
         /** Same as `disableAnimation` (default: `false`) */
         reduceMotion?: boolean;
@@ -6036,13 +6050,12 @@ interface ConnectorsBlockProps extends Pick<ConnectorsSelectionsProps, 'setIsOpe
  * ```tsx
  * import { getFilteredConnectors } from '@tuwaio/nova-connect';
  * import { ConnectorsBlock } from '@tuwaio/nova-connect/components';
- * import { useNovaConnect } from '@tuwaio/nova-connect/hooks';
- * import { useSatelliteConnectStore } from '@tuwaio/nova-connect/satellite';
+ * import { useNovaConnect, useWalletConnectors } from '@tuwaio/nova-connect/hooks';
  * import { OrbitAdapter } from '@tuwaio/orbit-core';
  * import { mainnet } from 'viem/chains';
  *
  * export function InstalledWallets() {
- *   const getConnectors = useSatelliteConnectStore((store) => store.getConnectors);
+ *   const connectors = useWalletConnectors() ?? {};
  *   const { setIsConnected, setIsConnectModalOpen } = useNovaConnect();
  *
  *   return (
@@ -6050,7 +6063,7 @@ interface ConnectorsBlockProps extends Pick<ConnectorsSelectionsProps, 'setIsOpe
  *       title="Installed"
  *       isTitleBold
  *       selectedAdapter={OrbitAdapter.EVM}
- *       connectors={getFilteredConnectors({ connectors: getConnectors(), selectedAdapter: OrbitAdapter.EVM })}
+ *       connectors={getFilteredConnectors({ connectors, selectedAdapter: OrbitAdapter.EVM })}
  *       onClick={(connector) => console.log('selected', connector.name)}
  *       setIsConnected={setIsConnected}
  *       setIsOpen={setIsConnectModalOpen}
@@ -6752,19 +6765,18 @@ interface ConnectorsSelectionsProps extends InitialChains {
  * ```tsx
  * import { getFilteredConnectors } from '@tuwaio/nova-connect';
  * import { ConnectorsSelections } from '@tuwaio/nova-connect/components';
- * import { useNovaConnect } from '@tuwaio/nova-connect/hooks';
- * import { useSatelliteConnectStore } from '@tuwaio/nova-connect/satellite';
+ * import { useNovaConnect, useWalletConnectors } from '@tuwaio/nova-connect/hooks';
  * import { OrbitAdapter } from '@tuwaio/orbit-core';
  * import { mainnet } from 'viem/chains';
  *
  * export function EvmWallets() {
- *   const getConnectors = useSatelliteConnectStore((store) => store.getConnectors);
+ *   const connectors = useWalletConnectors() ?? {};
  *   const { setIsConnected, setIsConnectModalOpen, setConnectModalContentType } = useNovaConnect();
  *
  *   return (
  *     <ConnectorsSelections
  *       selectedAdapter={OrbitAdapter.EVM}
- *       connectors={getFilteredConnectors({ connectors: getConnectors(), selectedAdapter: OrbitAdapter.EVM })}
+ *       connectors={getFilteredConnectors({ connectors, selectedAdapter: OrbitAdapter.EVM })}
  *       onClick={(connector) => console.log('selected', connector.name)}
  *       setIsConnected={setIsConnected}
  *       setIsOpen={setIsConnectModalOpen}
@@ -8067,17 +8079,18 @@ interface NetworkSelectionsProps {
  * ```tsx
  * import { getFilteredConnectors } from '@tuwaio/nova-connect';
  * import { NetworkSelections } from '@tuwaio/nova-connect/components';
+ * import { useWalletConnectors } from '@tuwaio/nova-connect/hooks';
  * import { useSatelliteConnectStore } from '@tuwaio/nova-connect/satellite';
  * import { OrbitAdapter } from '@tuwaio/orbit-core';
  *
  * export function MetaMaskNetworks() {
- *   const getConnectors = useSatelliteConnectStore((store) => store.getConnectors);
+ *   const connectors = useWalletConnectors() ?? {};
  *   const connect = useSatelliteConnectStore((store) => store.connect);
  *
  *   return (
  *     <NetworkSelections
  *       activeConnector="metamask"
- *       connectors={getFilteredConnectors({ connectors: getConnectors() })}
+ *       connectors={getFilteredConnectors({ connectors })}
  *       onClick={(adapter, connectorType) =>
  *         connect({ connectorType, chainId: adapter === OrbitAdapter.EVM ? 1 : 'solana:devnet' })
  *       }
@@ -8567,7 +8580,10 @@ interface ConnectModalData {
     isOpen: boolean;
     /** `connectionError` of the Satellite store, or `null` */
     error: Error | TuwaErrorState | null | undefined;
-    /** Connectors of the Satellite store by adapter (`getConnectors()`; `undefined` while the modal is closed) */
+    /**
+     * Connectors of the Satellite store by adapter (`useWalletConnectors`: updated while the modal is open when wallets are
+     * added or removed; `undefined` while the modal is closed)
+     */
     connectors: Record<string, Connector[]>;
     /** Filtered connectors for current adapter */
     filteredConnectors: GroupedConnector[];
@@ -8588,11 +8604,23 @@ interface BottomButtonConfig {
     loading?: boolean;
 }
 /**
- * Props for a custom container of the modal content.
+ * Props for a custom container of the modal content (`customization.components.ModalContainer`). To keep the height of
+ * the wallet list on the network and connecting screens, a custom container forwards `ref` to its element (the modal
+ * measures it on the wallet list), passes `className` and `style` to it and is a flex column; a custom `MainContent` is a
+ * flex container. Without `ref`, these screens take the height of their content.
  */
 type ConnectModalContainerProps = {
-    /** Classes from `classNames.modalContainer` */
+    /**
+     * Classes from `classNames.modalContainer`; on the `network` and `connecting` screens, preceded by
+     * `novacon:min-h-[min(var(--novacon-connect-list-height),calc(100dvh_-_2rem))]`, which keeps the height of the wallet
+     * list (at most the height of the window less 2rem)
+     */
     className?: string;
+    /**
+     * On the `network` and `connecting` screens, the `--novacon-connect-list-height` variable: the height of the wallet
+     * list shown before them, in pixels
+     */
+    style?: React__default.CSSProperties;
     /** The header, main content and footer */
     children: React__default.ReactNode;
     /** State of the modal */
@@ -8758,7 +8786,10 @@ type ConnectModalCustomization = {
         Dialog?: ComponentType<ComponentPropsWithoutRef<typeof Dialog>>;
         /** Custom dialog content (default: `DialogContent` from `@tuwaio/nova-core`) */
         DialogContent?: ComponentType<ComponentPropsWithoutRef<typeof DialogContent>>;
-        /** Custom layout animation wrapper (default: `motion.div`) */
+        /**
+         * Custom wrapper of the screens (default: `motion.div`). It receives `layoutRoot`: the layout animations inside it
+         * (the network tabs) are measured relative to it, so they do not follow the window when it moves to stay centered.
+         */
         MotionDiv?: ComponentType<ComponentPropsWithoutRef<typeof motion.div>>;
         /** Custom empty state */
         EmptyState?: ComponentType<ConnectModalEmptyProps>;
@@ -8968,11 +8999,24 @@ type ConnectModalCustomization = {
              */
             backButton?: (modalData: ConnectModalData) => string;
         };
-        /** Animation configuration */
+        /**
+         * Animation configuration.
+         *
+         * @deprecated No longer applied: the screens have no layout transition, and `DialogContent` of
+         * `@tuwaio/nova-core` follows the height of the content. It will be removed in the next major version.
+         */
         animation?: {
-            /** Duration of the layout transition between screens, in seconds (default: `0.0001`) */
+            /**
+             * Duration of the former layout transition between screens, in seconds.
+             *
+             * @deprecated No longer applied (a layout transition stretched the window for a frame after a size change).
+             */
             layoutDuration?: number;
-            /** Sets the duration of the layout transition to `0` */
+            /**
+             * Set the duration of the former layout transition to `0`.
+             *
+             * @deprecated No longer applied.
+             */
             disabled?: boolean;
         };
     };
@@ -9012,8 +9056,11 @@ interface ConnectModalProps extends InitialChains {
  *
  * Opening the modal resets it to the wallet list. A wallet connects through `connect` of the Satellite store to the
  * first chain of `appChains` (EVM) or the first cluster of `solanaRPCUrls` (Solana), and the modal closes 400 ms after
- * the wallet reports the connection (it waits up to 10 seconds). Texts come from the Nova Connect labels, except a
- * few English accessibility texts.
+ * the wallet reports the connection (it waits up to 10 seconds). The network and connecting screens keep the height of
+ * the wallet list (measured with a `ResizeObserver` while the list is shown and forgotten when the modal closes; at most
+ * the height of the window less 2rem), with the footer at the bottom and the connection status in the middle, so
+ * choosing a wallet, its network and going back do not resize the modal. Texts
+ * come from the Nova Connect labels, except a few English accessibility texts.
  *
  * Props: {@link ConnectModalProps}.
  *
@@ -9053,7 +9100,10 @@ type ConnectionState = 'connecting' | 'success' | 'error';
 interface ConnectingStatusData {
     /** Connection state */
     state: ConnectionState;
-    /** The heading: `customErrorMessage` or the `connectionError` label, `connectedSuccessfully`, or `connectingTo` */
+    /**
+     * The heading: `customErrorMessage` or the `connectionError` label, `connectedSuccessfully`, or `connectingTo`
+     * followed by the name of the wallet (the `name` of `currentConnector`, such as `MetaMask`)
+     */
     message: string;
     /**
      * Text under the heading in the `error` state (`customErrorMessage` with `showDetailedError`, or the
@@ -9064,7 +9114,10 @@ interface ConnectingStatusData {
     activeConnector: string | undefined;
     /** The `selectedAdapter` prop */
     selectedAdapter: OrbitAdapter | undefined;
-    /** The wallet of `connectors` whose formatted name contains `activeConnector` */
+    /**
+     * The wallet of `connectors` whose connector type (`formatConnectorName` of its name) is `activeConnector`, or, when
+     * none is, the first one whose connector type contains it
+     */
     currentConnector: GroupedConnector | null;
     /** The `showDetailedError` prop */
     showDetailedError: boolean;
@@ -9397,12 +9450,14 @@ type ConnectingCustomization = {
  */
 interface ConnectingProps {
     /**
-     * The wallet being connected, as `formatConnectorName` of `@tuwaio/orbit-core` returns it (for example `metamask`)
+     * The wallet being connected, as `formatConnectorName` of `@tuwaio/orbit-core` returns it (for example `metamask`).
+     * The texts name the wallet of `connectors` with exactly this connector type (`MetaMask`), or, when none has it, the
+     * first one whose connector type contains it, or this value when none does.
      */
     activeConnector: string | undefined;
     /** Selected orbit adapter for the connection */
     selectedAdapter: OrbitAdapter | undefined;
-    /** Wallets with their connectors (the icon comes from the wallet matching `activeConnector`) */
+    /** Wallets with their connectors (the icon and the name come from the wallet matching `activeConnector`) */
     connectors: GroupedConnector[];
     /** Whether the wallet connection is successfully established */
     isConnected: boolean;
@@ -9425,12 +9480,14 @@ interface ConnectingProps {
  * ```tsx
  * import { getFilteredConnectors } from '@tuwaio/nova-connect';
  * import { Connecting } from '@tuwaio/nova-connect/components';
- * import { useSatelliteConnectStore } from '@tuwaio/nova-connect/satellite';
+ * import { useWalletConnectors } from '@tuwaio/nova-connect/hooks';
  * import { OrbitAdapter } from '@tuwaio/orbit-core';
  *
  * export function MetaMaskStatus({ isConnected }: { isConnected: boolean }) {
- *   const getConnectors = useSatelliteConnectStore((store) => store.getConnectors);
- *   const connectors = getFilteredConnectors({ connectors: getConnectors(), selectedAdapter: OrbitAdapter.EVM });
+ *   const connectors = getFilteredConnectors({
+ *     connectors: useWalletConnectors() ?? {},
+ *     selectedAdapter: OrbitAdapter.EVM,
+ *   });
  *
  *   return (
  *     <Connecting

package/dist/components/index.d.ts

@@ -4234,7 +4234,7 @@ type ConnectedModalCustomization = {
         MainContent?: ComponentType<ConnectedModalMainContentSlotProps>;
         /** Custom footer component */
         Footer?: ComponentType<ConnectedModalFooterProps>;
-        /** Custom motion container for animations */
+        /** Custom container of the opening animation (default: `motion.div`) */
         MotionContainer?: ComponentType<ComponentPropsWithoutRef<typeof motion.div>>;
     };
     /** Custom class name generators */
@@ -4252,7 +4252,7 @@ type ConnectedModalCustomization = {
             hasActiveWallet: boolean;
         }) => string;
         /**
-         * Returns the classes of the layout animation container.
+         * Returns the classes of the container of the opening animation.
          *
          * @returns The classes.
          */
@@ -4326,11 +4326,25 @@ type ConnectedModalCustomization = {
             /** Animation delay in seconds */
             delay?: number;
         };
-        /** Layout animation between screens */
+        /**
+         * The former layout animation between screens.
+         *
+         * @deprecated No longer applied: a layout animation stretched the window for a frame after a size change, and
+         * `DialogContent` of `@tuwaio/nova-core` follows the height of the content. It will be removed in the next major
+         * version.
+         */
         layout?: {
-            /** Animation duration in seconds (default: `0.0001`) */
+            /**
+             * Animation duration in seconds.
+             *
+             * @deprecated No longer applied.
+             */
             duration?: number;
-            /** Animation easing curve */
+            /**
+             * Animation easing curve.
+             *
+             * @deprecated No longer applied.
+             */
             ease?: Easing | Easing[];
         };
     };
@@ -4369,7 +4383,7 @@ type ConnectedModalCustomization = {
     };
     /** Configuration options */
     config?: {
-        /** Disables the modal and layout animations (default: `false`) */
+        /** Disables the opening animation of the modal (default: `false`) */
         disableAnimation?: boolean;
         /** Same as `disableAnimation` (default: `false`) */
         reduceMotion?: boolean;
@@ -6036,13 +6050,12 @@ interface ConnectorsBlockProps extends Pick<ConnectorsSelectionsProps, 'setIsOpe
  * ```tsx
  * import { getFilteredConnectors } from '@tuwaio/nova-connect';
  * import { ConnectorsBlock } from '@tuwaio/nova-connect/components';
- * import { useNovaConnect } from '@tuwaio/nova-connect/hooks';
- * import { useSatelliteConnectStore } from '@tuwaio/nova-connect/satellite';
+ * import { useNovaConnect, useWalletConnectors } from '@tuwaio/nova-connect/hooks';
  * import { OrbitAdapter } from '@tuwaio/orbit-core';
  * import { mainnet } from 'viem/chains';
  *
  * export function InstalledWallets() {
- *   const getConnectors = useSatelliteConnectStore((store) => store.getConnectors);
+ *   const connectors = useWalletConnectors() ?? {};
  *   const { setIsConnected, setIsConnectModalOpen } = useNovaConnect();
  *
  *   return (
@@ -6050,7 +6063,7 @@ interface ConnectorsBlockProps extends Pick<ConnectorsSelectionsProps, 'setIsOpe
  *       title="Installed"
  *       isTitleBold
  *       selectedAdapter={OrbitAdapter.EVM}
- *       connectors={getFilteredConnectors({ connectors: getConnectors(), selectedAdapter: OrbitAdapter.EVM })}
+ *       connectors={getFilteredConnectors({ connectors, selectedAdapter: OrbitAdapter.EVM })}
  *       onClick={(connector) => console.log('selected', connector.name)}
  *       setIsConnected={setIsConnected}
  *       setIsOpen={setIsConnectModalOpen}
@@ -6752,19 +6765,18 @@ interface ConnectorsSelectionsProps extends InitialChains {
  * ```tsx
  * import { getFilteredConnectors } from '@tuwaio/nova-connect';
  * import { ConnectorsSelections } from '@tuwaio/nova-connect/components';
- * import { useNovaConnect } from '@tuwaio/nova-connect/hooks';
- * import { useSatelliteConnectStore } from '@tuwaio/nova-connect/satellite';
+ * import { useNovaConnect, useWalletConnectors } from '@tuwaio/nova-connect/hooks';
  * import { OrbitAdapter } from '@tuwaio/orbit-core';
  * import { mainnet } from 'viem/chains';
  *
  * export function EvmWallets() {
- *   const getConnectors = useSatelliteConnectStore((store) => store.getConnectors);
+ *   const connectors = useWalletConnectors() ?? {};
  *   const { setIsConnected, setIsConnectModalOpen, setConnectModalContentType } = useNovaConnect();
  *
  *   return (
  *     <ConnectorsSelections
  *       selectedAdapter={OrbitAdapter.EVM}
- *       connectors={getFilteredConnectors({ connectors: getConnectors(), selectedAdapter: OrbitAdapter.EVM })}
+ *       connectors={getFilteredConnectors({ connectors, selectedAdapter: OrbitAdapter.EVM })}
  *       onClick={(connector) => console.log('selected', connector.name)}
  *       setIsConnected={setIsConnected}
  *       setIsOpen={setIsConnectModalOpen}
@@ -8067,17 +8079,18 @@ interface NetworkSelectionsProps {
  * ```tsx
  * import { getFilteredConnectors } from '@tuwaio/nova-connect';
  * import { NetworkSelections } from '@tuwaio/nova-connect/components';
+ * import { useWalletConnectors } from '@tuwaio/nova-connect/hooks';
  * import { useSatelliteConnectStore } from '@tuwaio/nova-connect/satellite';
  * import { OrbitAdapter } from '@tuwaio/orbit-core';
  *
  * export function MetaMaskNetworks() {
- *   const getConnectors = useSatelliteConnectStore((store) => store.getConnectors);
+ *   const connectors = useWalletConnectors() ?? {};
  *   const connect = useSatelliteConnectStore((store) => store.connect);
  *
  *   return (
  *     <NetworkSelections
  *       activeConnector="metamask"
- *       connectors={getFilteredConnectors({ connectors: getConnectors() })}
+ *       connectors={getFilteredConnectors({ connectors })}
  *       onClick={(adapter, connectorType) =>
  *         connect({ connectorType, chainId: adapter === OrbitAdapter.EVM ? 1 : 'solana:devnet' })
  *       }
@@ -8567,7 +8580,10 @@ interface ConnectModalData {
     isOpen: boolean;
     /** `connectionError` of the Satellite store, or `null` */
     error: Error | TuwaErrorState | null | undefined;
-    /** Connectors of the Satellite store by adapter (`getConnectors()`; `undefined` while the modal is closed) */
+    /**
+     * Connectors of the Satellite store by adapter (`useWalletConnectors`: updated while the modal is open when wallets are
+     * added or removed; `undefined` while the modal is closed)
+     */
     connectors: Record<string, Connector[]>;
     /** Filtered connectors for current adapter */
     filteredConnectors: GroupedConnector[];
@@ -8588,11 +8604,23 @@ interface BottomButtonConfig {
     loading?: boolean;
 }
 /**
- * Props for a custom container of the modal content.
+ * Props for a custom container of the modal content (`customization.components.ModalContainer`). To keep the height of
+ * the wallet list on the network and connecting screens, a custom container forwards `ref` to its element (the modal
+ * measures it on the wallet list), passes `className` and `style` to it and is a flex column; a custom `MainContent` is a
+ * flex container. Without `ref`, these screens take the height of their content.
  */
 type ConnectModalContainerProps = {
-    /** Classes from `classNames.modalContainer` */
+    /**
+     * Classes from `classNames.modalContainer`; on the `network` and `connecting` screens, preceded by
+     * `novacon:min-h-[min(var(--novacon-connect-list-height),calc(100dvh_-_2rem))]`, which keeps the height of the wallet
+     * list (at most the height of the window less 2rem)
+     */
     className?: string;
+    /**
+     * On the `network` and `connecting` screens, the `--novacon-connect-list-height` variable: the height of the wallet
+     * list shown before them, in pixels
+     */
+    style?: React__default.CSSProperties;
     /** The header, main content and footer */
     children: React__default.ReactNode;
     /** State of the modal */
@@ -8758,7 +8786,10 @@ type ConnectModalCustomization = {
         Dialog?: ComponentType<ComponentPropsWithoutRef<typeof Dialog>>;
         /** Custom dialog content (default: `DialogContent` from `@tuwaio/nova-core`) */
         DialogContent?: ComponentType<ComponentPropsWithoutRef<typeof DialogContent>>;
-        /** Custom layout animation wrapper (default: `motion.div`) */
+        /**
+         * Custom wrapper of the screens (default: `motion.div`). It receives `layoutRoot`: the layout animations inside it
+         * (the network tabs) are measured relative to it, so they do not follow the window when it moves to stay centered.
+         */
         MotionDiv?: ComponentType<ComponentPropsWithoutRef<typeof motion.div>>;
         /** Custom empty state */
         EmptyState?: ComponentType<ConnectModalEmptyProps>;
@@ -8968,11 +8999,24 @@ type ConnectModalCustomization = {
              */
             backButton?: (modalData: ConnectModalData) => string;
         };
-        /** Animation configuration */
+        /**
+         * Animation configuration.
+         *
+         * @deprecated No longer applied: the screens have no layout transition, and `DialogContent` of
+         * `@tuwaio/nova-core` follows the height of the content. It will be removed in the next major version.
+         */
         animation?: {
-            /** Duration of the layout transition between screens, in seconds (default: `0.0001`) */
+            /**
+             * Duration of the former layout transition between screens, in seconds.
+             *
+             * @deprecated No longer applied (a layout transition stretched the window for a frame after a size change).
+             */
             layoutDuration?: number;
-            /** Sets the duration of the layout transition to `0` */
+            /**
+             * Set the duration of the former layout transition to `0`.
+             *
+             * @deprecated No longer applied.
+             */
             disabled?: boolean;
         };
     };
@@ -9012,8 +9056,11 @@ interface ConnectModalProps extends InitialChains {
  *
  * Opening the modal resets it to the wallet list. A wallet connects through `connect` of the Satellite store to the
  * first chain of `appChains` (EVM) or the first cluster of `solanaRPCUrls` (Solana), and the modal closes 400 ms after
- * the wallet reports the connection (it waits up to 10 seconds). Texts come from the Nova Connect labels, except a
- * few English accessibility texts.
+ * the wallet reports the connection (it waits up to 10 seconds). The network and connecting screens keep the height of
+ * the wallet list (measured with a `ResizeObserver` while the list is shown and forgotten when the modal closes; at most
+ * the height of the window less 2rem), with the footer at the bottom and the connection status in the middle, so
+ * choosing a wallet, its network and going back do not resize the modal. Texts
+ * come from the Nova Connect labels, except a few English accessibility texts.
  *
  * Props: {@link ConnectModalProps}.
  *
@@ -9053,7 +9100,10 @@ type ConnectionState = 'connecting' | 'success' | 'error';
 interface ConnectingStatusData {
     /** Connection state */
     state: ConnectionState;
-    /** The heading: `customErrorMessage` or the `connectionError` label, `connectedSuccessfully`, or `connectingTo` */
+    /**
+     * The heading: `customErrorMessage` or the `connectionError` label, `connectedSuccessfully`, or `connectingTo`
+     * followed by the name of the wallet (the `name` of `currentConnector`, such as `MetaMask`)
+     */
     message: string;
     /**
      * Text under the heading in the `error` state (`customErrorMessage` with `showDetailedError`, or the
@@ -9064,7 +9114,10 @@ interface ConnectingStatusData {
     activeConnector: string | undefined;
     /** The `selectedAdapter` prop */
     selectedAdapter: OrbitAdapter | undefined;
-    /** The wallet of `connectors` whose formatted name contains `activeConnector` */
+    /**
+     * The wallet of `connectors` whose connector type (`formatConnectorName` of its name) is `activeConnector`, or, when
+     * none is, the first one whose connector type contains it
+     */
     currentConnector: GroupedConnector | null;
     /** The `showDetailedError` prop */
     showDetailedError: boolean;
@@ -9397,12 +9450,14 @@ type ConnectingCustomization = {
  */
 interface ConnectingProps {
     /**
-     * The wallet being connected, as `formatConnectorName` of `@tuwaio/orbit-core` returns it (for example `metamask`)
+     * The wallet being connected, as `formatConnectorName` of `@tuwaio/orbit-core` returns it (for example `metamask`).
+     * The texts name the wallet of `connectors` with exactly this connector type (`MetaMask`), or, when none has it, the
+     * first one whose connector type contains it, or this value when none does.
      */
     activeConnector: string | undefined;
     /** Selected orbit adapter for the connection */
     selectedAdapter: OrbitAdapter | undefined;
-    /** Wallets with their connectors (the icon comes from the wallet matching `activeConnector`) */
+    /** Wallets with their connectors (the icon and the name come from the wallet matching `activeConnector`) */
     connectors: GroupedConnector[];
     /** Whether the wallet connection is successfully established */
     isConnected: boolean;
@@ -9425,12 +9480,14 @@ interface ConnectingProps {
  * ```tsx
  * import { getFilteredConnectors } from '@tuwaio/nova-connect';
  * import { Connecting } from '@tuwaio/nova-connect/components';
- * import { useSatelliteConnectStore } from '@tuwaio/nova-connect/satellite';
+ * import { useWalletConnectors } from '@tuwaio/nova-connect/hooks';
  * import { OrbitAdapter } from '@tuwaio/orbit-core';
  *
  * export function MetaMaskStatus({ isConnected }: { isConnected: boolean }) {
- *   const getConnectors = useSatelliteConnectStore((store) => store.getConnectors);
- *   const connectors = getFilteredConnectors({ connectors: getConnectors(), selectedAdapter: OrbitAdapter.EVM });
+ *   const connectors = getFilteredConnectors({
+ *     connectors: useWalletConnectors() ?? {},
+ *     selectedAdapter: OrbitAdapter.EVM,
+ *   });
  *
  *   return (
  *     <Connecting

package/dist/components/index.js

@@ -1 +1 @@
-export{u as AboutWallets,a as BalanceDisplay,b as ChainListRenderer,g as ChainSelector,l as ConnectButton,w as ConnectCard,H as ConnectModal,j as ConnectedContent,t as ConnectedModal,m as ConnectedModalFooter,q as ConnectedModalMainContent,n as ConnectedModalNameAndBalance,r as ConnectedModalTxHistory,x as Connecting,s as ConnectionsContent,y as ConnectorsBlock,A as ConnectorsSelections,z as Disclaimer,B as GetWallet,p as IconButton,C as ImpersonateForm,D as LegalDisclaimer,E as NetworkSelections,F as NetworkTabs,v as RecentBadge,G as RememberWallet,f as ScrollableChainList,e as SelectContentAnimated,i as StatusIcon,c as ToBottomButton,d as ToTopButton,I as ToastError,k as WaitForConnectionContent,h as WalletAvatar,o as WalletIcon}from'../chunk-DRTK4IQH.js';import'../chunk-XB2YJOYJ.js';import'../chunk-AVCOIAAU.js';import'../chunk-ZVADGOGQ.js';import'../chunk-3LWAAUG4.js';
+export{u as AboutWallets,a as BalanceDisplay,b as ChainListRenderer,g as ChainSelector,l as ConnectButton,w as ConnectCard,H as ConnectModal,j as ConnectedContent,t as ConnectedModal,m as ConnectedModalFooter,q as ConnectedModalMainContent,n as ConnectedModalNameAndBalance,r as ConnectedModalTxHistory,x as Connecting,s as ConnectionsContent,y as ConnectorsBlock,A as ConnectorsSelections,z as Disclaimer,B as GetWallet,p as IconButton,C as ImpersonateForm,D as LegalDisclaimer,E as NetworkSelections,F as NetworkTabs,v as RecentBadge,G as RememberWallet,f as ScrollableChainList,e as SelectContentAnimated,i as StatusIcon,c as ToBottomButton,d as ToTopButton,I as ToastError,k as WaitForConnectionContent,h as WalletAvatar,o as WalletIcon}from'../chunk-Y4JUUZX7.js';import'../chunk-X5SXUZJR.js';import'../chunk-AVCOIAAU.js';import'../chunk-ZVADGOGQ.js';import'../chunk-3LWAAUG4.js';

package/dist/hooks/index.cjs

@@ -1 +1 @@
-'use strict';var chunkU6UN2I7D_cjs=require('../chunk-U6UN2I7D.cjs');require('../chunk-WAFPT2CO.cjs'),require('../chunk-EGATOYHY.cjs'),require('../chunk-YJRNNNR6.cjs');Object.defineProperty(exports,"NovaConnectLabelsContext",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.g}});Object.defineProperty(exports,"NovaConnectProviderContext",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.c}});Object.defineProperty(exports,"NovaConnectProviderError",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.b}});Object.defineProperty(exports,"createLabelsSubset",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.o}});Object.defineProperty(exports,"getLabelWithFallback",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.n}});Object.defineProperty(exports,"hasLabel",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.k}});Object.defineProperty(exports,"isDefaultLabels",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.m}});Object.defineProperty(exports,"useGetWalletNameAndAvatar",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.a}});Object.defineProperty(exports,"useHasNovaConnectContext",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.e}});Object.defineProperty(exports,"useLabelsByCategory",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.l}});Object.defineProperty(exports,"useNovaConnect",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.d}});Object.defineProperty(exports,"useNovaConnectLabel",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.i}});Object.defineProperty(exports,"useNovaConnectLabels",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.h}});Object.defineProperty(exports,"useNovaConnectLabelsSubset",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.j}});Object.defineProperty(exports,"useNovaConnectOptional",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.f}});Object.defineProperty(exports,"useNovaSiwx",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.p}});Object.defineProperty(exports,"useWalletChainsList",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.A}});Object.defineProperty(exports,"useWalletNativeBalance",{enumerable:true,get:function(){return chunkU6UN2I7D_cjs.B}});
+'use strict';var chunk3M5KO5JH_cjs=require('../chunk-3M5KO5JH.cjs');require('../chunk-WAFPT2CO.cjs'),require('../chunk-EGATOYHY.cjs'),require('../chunk-YJRNNNR6.cjs');Object.defineProperty(exports,"NovaConnectLabelsContext",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.g}});Object.defineProperty(exports,"NovaConnectProviderContext",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.c}});Object.defineProperty(exports,"NovaConnectProviderError",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.b}});Object.defineProperty(exports,"createLabelsSubset",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.o}});Object.defineProperty(exports,"getLabelWithFallback",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.n}});Object.defineProperty(exports,"hasLabel",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.k}});Object.defineProperty(exports,"isDefaultLabels",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.m}});Object.defineProperty(exports,"useGetWalletNameAndAvatar",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.a}});Object.defineProperty(exports,"useHasNovaConnectContext",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.e}});Object.defineProperty(exports,"useLabelsByCategory",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.l}});Object.defineProperty(exports,"useNovaConnect",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.d}});Object.defineProperty(exports,"useNovaConnectLabel",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.i}});Object.defineProperty(exports,"useNovaConnectLabels",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.h}});Object.defineProperty(exports,"useNovaConnectLabelsSubset",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.j}});Object.defineProperty(exports,"useNovaConnectOptional",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.f}});Object.defineProperty(exports,"useNovaSiwx",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.p}});Object.defineProperty(exports,"useWalletChainsList",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.A}});Object.defineProperty(exports,"useWalletConnectors",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.B}});Object.defineProperty(exports,"useWalletNativeBalance",{enumerable:true,get:function(){return chunk3M5KO5JH_cjs.C}});

package/dist/hooks/index.d.cts

@@ -3,10 +3,11 @@ export { B as ButtonTxStatus, C as ConnectContentType, a as ConnectedContentType
 import * as _tuwaio_satellite_core from '@tuwaio/satellite-core';
 import { BaseConnector } from '@tuwaio/satellite-core';
 import { SatelliteSiwxFieldOptions, UseSiwxSignInOptions } from '@tuwaio/siwx-react';
+import { OrbitAdapter } from '@tuwaio/orbit-core';
+import { Connector } from '@tuwaio/satellite-react';
 import 'react';
 import '../types-DyqzrPMH.cjs';
 import 'framer-motion';
-import '@tuwaio/orbit-core';
 import '@tuwaio/pulsar-core';
 
 /**
@@ -146,5 +147,45 @@ declare function useWalletChainsList({ activeConnection, appChains, solanaRPCUrl
     chainsList: (string | number)[];
 };
 
-export { useGetWalletNameAndAvatar, useNovaSiwx, useWalletChainsList };
-export type { UseGetWalletNameAndAvatarOptions, UseNovaSiwxOptions, UseWalletChainsListProps, WalletNameAndAvatarData };
+/**
+ * Options of {@link useWalletConnectors}.
+ */
+interface UseWalletConnectorsParams {
+    /** Whether to read and follow the wallets (default `true`); `false` returns `undefined` and subscribes to nothing */
+    enabled?: boolean;
+}
+/**
+ * The wallets of the Satellite Connect store by adapter (`getConnectors()` of the store), read again whenever the store
+ * reports that the wallets of an adapter changed (`watchConnectors` of `@tuwaio/satellite-core`). A list shown before
+ * wagmi added the installed EIP-6963 wallets, or before a Wallet Standard wallet registered, fills in by itself. The
+ * connect modal and the connected modal list their wallets with it.
+ *
+ * The list is also read again on every render of the component: the wallets of an adapter that reports no changes (an
+ * adapter without `watchConnectors`, such as an older `@tuwaio/satellite-solana` or a custom adapter, or a
+ * `@tuwaio/satellite-core` without `watchConnectors`) appear at the next render.
+ *
+ * Side effects: while `enabled`, a subscription to the wallet list of the store (`watchConnectors`, which follows wagmi's
+ * connectors and the Wallet Standard registry), from the commit until `enabled` turns `false` or the component unmounts.
+ * Nothing is read or subscribed on the server.
+ *
+ * @param params - Options. See {@link UseWalletConnectorsParams}.
+ * @param params.enabled - Whether to read and follow the wallets (default `true`).
+ * @returns The wallets by adapter key, or `undefined` while disabled and on the server. The record stays the same object
+ * while the store returns the same wallet objects, so it can be a dependency of memos and effects.
+ * @throws {Error} `useSatelliteConnectStore must be used within a SatelliteConnectProvider` outside the provider.
+ *
+ * @example
+ * ```tsx
+ * import { OrbitAdapter } from '@tuwaio/orbit-core';
+ * import { useWalletConnectors } from '@tuwaio/nova-connect/hooks';
+ *
+ * export function EvmWalletCount() {
+ *   const connectors = useWalletConnectors();
+ *   return <span>{connectors?.[OrbitAdapter.EVM]?.length ?? 0} EVM wallets</span>;
+ * }
+ * ```
+ */
+declare function useWalletConnectors({ enabled }?: UseWalletConnectorsParams): Partial<Record<OrbitAdapter, Connector[]>> | undefined;
+
+export { useGetWalletNameAndAvatar, useNovaSiwx, useWalletChainsList, useWalletConnectors };
+export type { UseGetWalletNameAndAvatarOptions, UseNovaSiwxOptions, UseWalletChainsListProps, UseWalletConnectorsParams, WalletNameAndAvatarData };