@openzeppelin/ui-react 1.1.0 → 2.0.0

package/dist/index.d.cts

@@ -1,65 +1,71 @@
 import * as react0 from "react";
 import React, { ReactNode } from "react";
-import { BaseComponentProps, Connector, ContractAdapter, EcosystemSpecificReactHooks, EcosystemWalletComponents, NativeConfigLoader, NetworkConfig, UiKitConfiguration } from "@openzeppelin/ui-types";
+import { BaseComponentProps, Connector, EcosystemRuntime, EcosystemSpecificReactHooks, EcosystemWalletComponents, NativeConfigLoader, NetworkCatalogCapability, NetworkConfig, RuntimeCapability, UiKitConfiguration, WalletCapability } from "@openzeppelin/ui-types";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
+//#region src/version.d.ts
+declare const VERSION: string;
+//#endregion
 //#region src/hooks/AdapterContext.d.ts
 /**
- * Registry type that maps network IDs to their corresponding adapter instances
- * This is the core data structure for the singleton pattern
+ * Registry type that maps network IDs to their corresponding runtime instances.
  */
-interface AdapterRegistry {
-  [networkId: string]: ContractAdapter;
+interface RuntimeRegistry {
+  [networkId: string]: EcosystemRuntime;
 }
 /**
- * Context value interface defining what's provided through the context
- * The main functionality is getAdapterForNetwork which either returns
- * an existing adapter or initiates loading of a new one
+ * Context value interface defining what's provided through the context.
+ * The main functionality is `getRuntimeForNetwork`, which either returns an existing
+ * runtime or initiates loading of a new one.
  */
-interface AdapterContextValue {
-  getAdapterForNetwork: (networkConfig: NetworkConfig | null) => {
-    adapter: ContractAdapter | null;
+interface RuntimeContextValue {
+  getRuntimeForNetwork: (networkConfig: NetworkConfig | null) => {
+    runtime: EcosystemRuntime | null;
     isLoading: boolean;
   };
+  /**
+   * Evicts a runtime from the registry and calls `dispose()` on it.
+   * Used by WalletStateProvider to release superseded runtimes after a safe handoff.
+   */
+  releaseRuntime: (networkId: string) => void;
 }
 /**
- * The React Context that provides adapter registry access throughout the app
- * Components can access this through the useAdapterContext hook
+ * The React Context that provides runtime registry access throughout the app.
+ * Components can access this through the `useRuntimeContext` hook.
  */
-declare const AdapterContext: react0.Context<AdapterContextValue | null>;
-//# sourceMappingURL=AdapterContext.d.ts.map
+declare const RuntimeContext: react0.Context<RuntimeContextValue | null>;
 //#endregion
 //#region src/hooks/AdapterProvider.d.ts
-interface AdapterProviderProps {
+
+interface RuntimeProviderProps {
   children: ReactNode;
-  /** Function to resolve/create an adapter instance for a given NetworkConfig. */
-  resolveAdapter: (networkConfig: NetworkConfig) => Promise<ContractAdapter>;
+  /** Function to resolve/create a runtime instance for a given NetworkConfig. */
+  resolveRuntime: (networkConfig: NetworkConfig) => Promise<EcosystemRuntime>;
 }
 /**
- * Provider component that manages adapter instances centrally
- * to avoid creating multiple instances of the same adapter.
+ * Provider component that manages runtime instances centrally
+ * to avoid creating multiple instances of the same runtime.
  *
  * This component:
- * 1. Maintains a registry of adapter instances by network ID
- * 2. Tracks loading states for adapters being initialized
- * 3. Provides a function to get or load adapters for specific networks
- * 4. Ensures adapter instances are reused when possible
+ * 1. Maintains a registry of runtime instances by network ID
+ * 2. Tracks loading states for runtimes being initialized
+ * 3. Provides a function to get or load runtimes for specific networks
+ * 4. Ensures runtime instances are reused when possible
  */
-declare function AdapterProvider({
+declare function RuntimeProvider({
   children,
-  resolveAdapter
-}: AdapterProviderProps): react_jsx_runtime0.JSX.Element;
-//# sourceMappingURL=AdapterProvider.d.ts.map
+  resolveRuntime
+}: RuntimeProviderProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/hooks/WalletStateContext.d.ts
 interface WalletStateContextValue {
   activeNetworkId: string | null;
   setActiveNetworkId: (networkId: string | null) => void;
   activeNetworkConfig: NetworkConfig | null;
-  activeAdapter: ContractAdapter | null;
-  isAdapterLoading: boolean;
+  activeRuntime: EcosystemRuntime | null;
+  isRuntimeLoading: boolean;
   walletFacadeHooks: EcosystemSpecificReactHooks | null;
-  reconfigureActiveAdapterUiKit: (uiKitConfig?: Partial<UiKitConfiguration>) => void;
+  reconfigureActiveUiKit: (uiKitConfig?: Partial<UiKitConfiguration>) => void;
 }
 declare const WalletStateContext: React.Context<WalletStateContextValue | undefined>;
 /**
@@ -67,7 +73,6 @@ declare const WalletStateContext: React.Context<WalletStateContextValue | undefi
  * @throws Error if used outside of WalletStateProvider
  */
 declare function useWalletState(): WalletStateContextValue;
-//# sourceMappingURL=WalletStateContext.d.ts.map
 //#endregion
 //#region src/hooks/WalletStateProvider.d.ts
 interface WalletStateProviderProps {
@@ -90,15 +95,16 @@ interface WalletStateProviderProps {
  * It is responsible for:
  * 1. Managing the globally selected active network ID (`activeNetworkId`).
  * 2. Deriving the full `NetworkConfig` object (`activeNetworkConfig`) for the active network.
- * 3. Fetching and providing the corresponding `ContractAdapter` instance (`activeAdapter`) for the active network,
- *    leveraging the `AdapterProvider` to ensure adapter singletons.
- * 4. Storing and providing the `EcosystemSpecificReactHooks` (`walletFacadeHooks`) from the active adapter.
- * 5. Rendering the adapter-specific UI context provider (e.g., WagmiProvider for EVM) around its children,
- *    which is essential for the facade hooks to function correctly.
+ * 3. Fetching and providing the corresponding `EcosystemRuntime` (`activeRuntime`) for the active network,
+ *    leveraging the `RuntimeProvider` to ensure runtime singletons.
+ * 4. Caching ecosystem-scoped wallet session artifacts (provider roots and facade hooks)
+ *    independently from the network-scoped runtime.
+ * 5. Rendering the active ecosystem wallet provider (e.g., WagmiProvider for EVM) around its
+ *    children, which is essential for the facade hooks to function correctly.
  * 6. Providing a function (`setActiveNetworkId`) to change the globally active network.
  *
  * Consumers use the `useWalletState()` hook to access this global state.
- * It should be placed high in the component tree, inside an `<AdapterProvider>`.
+ * It should be placed high in the component tree, inside a `<RuntimeProvider>`.
  */
 declare function WalletStateProvider({
   children,
@@ -106,7 +112,6 @@ declare function WalletStateProvider({
   getNetworkConfigById,
   loadConfigModule
 }: WalletStateProviderProps): react_jsx_runtime0.JSX.Element;
-//# sourceMappingURL=WalletStateProvider.d.ts.map
 //#endregion
 //#region src/hooks/AnalyticsContext.d.ts
 /**
@@ -157,13 +162,6 @@ interface AnalyticsContextValue {
  * Must be used within an AnalyticsProvider.
  */
 declare const AnalyticsContext: react0.Context<AnalyticsContextValue | null>;
-/**
- * Internal hook to access analytics context.
- * Throws an error if used outside of an AnalyticsProvider.
- *
- * @internal
- * @throws Error if used outside of AnalyticsProvider
- */
 //#endregion
 //#region src/hooks/AnalyticsProvider.d.ts
 /**
@@ -193,8 +191,6 @@ interface AnalyticsProviderProps {
  * ```
  */
 declare const AnalyticsProvider: React.FC<AnalyticsProviderProps>;
-//# sourceMappingURL=AnalyticsProvider.d.ts.map
-
 //#endregion
 //#region src/hooks/useAnalytics.d.ts
 /**
@@ -244,35 +240,32 @@ declare const AnalyticsProvider: React.FC<AnalyticsProviderProps>;
  * @throws Error if used outside of AnalyticsProvider
  */
 declare const useAnalytics: () => AnalyticsContextValue;
-//# sourceMappingURL=useAnalytics.d.ts.map
 //#endregion
 //#region src/hooks/useAdapterContext.d.ts
 /**
- * Hook to access the adapter context
+ * Hook to access the runtime context
  *
- * This hook provides access to the getAdapterForNetwork function which
- * retrieves or creates adapter instances from the singleton registry.
+ * This hook provides access to the `getRuntimeForNetwork` function which
+ * retrieves or creates runtime instances from the singleton registry.
  *
- * Components should typically use useConfiguredAdapterSingleton instead
+ * Components should typically use the higher-level wallet/runtime hooks instead
  * of this hook directly, as it handles React state update timing properly.
  *
- * @throws Error if used outside of an AdapterProvider context
- * @returns The adapter context value
+ * @throws Error if used outside of a RuntimeProvider context
+ * @returns The runtime context value
  */
-declare function useAdapterContext(): AdapterContextValue;
-//# sourceMappingURL=useAdapterContext.d.ts.map
-
+declare function useRuntimeContext(): RuntimeContextValue;
 //#endregion
 //#region src/hooks/useWalletComponents.d.ts
 /**
- * Hook that provides direct access to wallet UI components from the active adapter.
+ * Hook that provides direct access to wallet UI components from the active runtime.
  *
  * Use this hook when you need full control over the layout and composition of
  * wallet components. For standard layouts, prefer using `WalletConnectionUI`
  * with its props forwarding capabilities.
  *
- * @returns The wallet components object, or null if no adapter is active or
- *          the adapter doesn't provide wallet components.
+ * @returns The wallet components object, or null if no runtime is active or
+ *          the runtime doesn't provide wallet components.
  *
  * @example
  * ```tsx
@@ -307,11 +300,14 @@ declare function useAdapterContext(): AdapterContextValue;
  * ```
  */
 declare function useWalletComponents(): EcosystemWalletComponents | null;
-//# sourceMappingURL=useWalletComponents.d.ts.map
 //#endregion
 //#region src/hooks/useDerivedAccountStatus.d.ts
 interface DerivedAccountStatus {
   isConnected: boolean;
+  isConnecting: boolean;
+  isDisconnected: boolean;
+  isReconnecting: boolean;
+  status: string;
   address?: string;
   chainId?: number;
 }
@@ -322,7 +318,6 @@ interface DerivedAccountStatus {
  * Provides default values if the hook or its properties are unavailable.
  */
 declare function useDerivedAccountStatus(): DerivedAccountStatus;
-//# sourceMappingURL=useDerivedAccountStatus.d.ts.map
 //#endregion
 //#region src/hooks/useDerivedSwitchChainStatus.d.ts
 interface DerivedSwitchChainStatus {
@@ -342,7 +337,6 @@ interface DerivedSwitchChainStatus {
  * Provides default values if the hook or its properties are unavailable.
  */
 declare function useDerivedSwitchChainStatus(): DerivedSwitchChainStatus;
-//# sourceMappingURL=useDerivedSwitchChainStatus.d.ts.map
 //#endregion
 //#region src/hooks/useDerivedChainInfo.d.ts
 interface DerivedChainInfo {
@@ -358,7 +352,6 @@ interface DerivedChainInfo {
  * Provides default values if the hooks or their properties are unavailable.
  */
 declare function useDerivedChainInfo(): DerivedChainInfo;
-//# sourceMappingURL=useDerivedChainInfo.d.ts.map
 //#endregion
 //#region src/hooks/useDerivedConnectStatus.d.ts
 interface DerivedConnectStatus {
@@ -381,7 +374,6 @@ interface DerivedConnectStatus {
  * safely-accessed status and control functions for wallet connection.
  */
 declare function useDerivedConnectStatus(): DerivedConnectStatus;
-//# sourceMappingURL=useDerivedConnectStatus.d.ts.map
 //#endregion
 //#region src/hooks/useDerivedDisconnect.d.ts
 interface DerivedDisconnectStatus {
@@ -398,7 +390,6 @@ interface DerivedDisconnectStatus {
  * safely-accessed status and control function for wallet disconnection.
  */
 declare function useDerivedDisconnect(): DerivedDisconnectStatus;
-//# sourceMappingURL=useDerivedDisconnect.d.ts.map
 //#endregion
 //#region src/hooks/useWalletReconnectionHandler.d.ts
 /**
@@ -409,12 +400,11 @@ declare function useDerivedDisconnect(): DerivedDisconnectStatus;
  * This hook detects that scenario and invokes a callback to re-queue the network switch.
  *
  * @param selectedNetworkConfigId - Currently selected network in the app
- * @param selectedAdapter - Currently active adapter instance
+ * @param selectedCapability - Currently active wallet capability instance
  * @param networkToSwitchTo - Current network switch queue state (null if no switch pending)
  * @param onRequeueSwitch - Callback invoked when a network switch should be re-queued
  */
-declare function useWalletReconnectionHandler(selectedNetworkConfigId: string | null, selectedAdapter: ContractAdapter | null, networkToSwitchTo: string | null, onRequeueSwitch: (networkId: string) => void): void;
-//# sourceMappingURL=useWalletReconnectionHandler.d.ts.map
+declare function useWalletReconnectionHandler(selectedNetworkConfigId: string | null, selectedCapability: RuntimeCapability | null, networkToSwitchTo: string | null, onRequeueSwitch: (networkId: string) => void): void;
 //#endregion
 //#region src/components/WalletConnectionHeader.d.ts
 /**
@@ -422,7 +412,6 @@ declare function useWalletReconnectionHandler(selectedNetworkConfigId: string |
  * Uses useWalletState to get its data.
  */
 declare const WalletConnectionHeader: React.FC;
-//# sourceMappingURL=WalletConnectionHeader.d.ts.map
 //#endregion
 //#region src/components/WalletConnectionUI.d.ts
 /**
@@ -461,15 +450,16 @@ interface WalletConnectionUIProps {
  * ```
  */
 declare const WalletConnectionUI: React.FC<WalletConnectionUIProps>;
-//# sourceMappingURL=WalletConnectionUI.d.ts.map
 //#endregion
 //#region src/components/NetworkSwitchManager.d.ts
 /**
  * Props for the NetworkSwitchManager component.
  */
 interface NetworkSwitchManagerProps {
-  /** The adapter instance for the target network */
-  adapter: ContractAdapter;
+  /** Wallet capability for the target network */
+  wallet: WalletCapability;
+  /** Network catalog capability used to validate the target network id */
+  networkCatalog: NetworkCatalogCapability;
   /** The network ID we want to switch to */
   targetNetworkId: string;
   /** Callback when network switch completes (success or error) */
@@ -490,8 +480,6 @@ interface NetworkSwitchManagerProps {
  * - Provides completion callback for parent components to handle state cleanup
  */
 declare const NetworkSwitchManager: React.FC<NetworkSwitchManagerProps>;
-//# sourceMappingURL=NetworkSwitchManager.d.ts.map
-
 //#endregion
-export { AdapterContext, type AdapterContextValue, AdapterProvider, type AdapterProviderProps, type AdapterRegistry, AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, type DerivedAccountStatus, type DerivedChainInfo, type DerivedConnectStatus, type DerivedDisconnectStatus, type DerivedSwitchChainStatus, NetworkSwitchManager, type NetworkSwitchManagerProps, WalletConnectionHeader, WalletConnectionUI, type WalletConnectionUIProps, WalletStateContext, type WalletStateContextValue, WalletStateProvider, type WalletStateProviderProps, useAdapterContext, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useWalletComponents, useWalletReconnectionHandler, useWalletState };
-//# sourceMappingURL=index-BlmRKpng.d.cts.map
+export { AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, type DerivedAccountStatus, type DerivedChainInfo, type DerivedConnectStatus, type DerivedDisconnectStatus, type DerivedSwitchChainStatus, NetworkSwitchManager, type NetworkSwitchManagerProps, RuntimeContext, type RuntimeContextValue, RuntimeProvider, type RuntimeProviderProps, type RuntimeRegistry, VERSION, WalletConnectionHeader, WalletConnectionUI, type WalletConnectionUIProps, WalletStateContext, type WalletStateContextValue, WalletStateProvider, type WalletStateProviderProps, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useRuntimeContext, useWalletComponents, useWalletReconnectionHandler, useWalletState };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/version.ts","../src/hooks/AdapterContext.tsx","../src/hooks/AdapterProvider.tsx","../src/hooks/WalletStateContext.ts","../src/hooks/WalletStateProvider.tsx","../src/hooks/AnalyticsContext.tsx","../src/hooks/AnalyticsProvider.tsx","../src/hooks/useAnalytics.ts","../src/hooks/useAdapterContext.ts","../src/hooks/useWalletComponents.ts","../src/hooks/useDerivedAccountStatus.ts","../src/hooks/useDerivedSwitchChainStatus.ts","../src/hooks/useDerivedChainInfo.ts","../src/hooks/useDerivedConnectStatus.ts","../src/hooks/useDerivedDisconnect.ts","../src/hooks/useWalletReconnectionHandler.ts","../src/components/WalletConnectionHeader.tsx","../src/components/WalletConnectionUI.tsx","../src/components/NetworkSwitchManager.tsx"],"sourcesContent":[],"mappings":"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"}

package/dist/{index.d.ts → index.d.mts}

@@ -1,65 +1,71 @@
 import * as react0 from "react";
 import React, { ReactNode } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
-import { BaseComponentProps, Connector, ContractAdapter, EcosystemSpecificReactHooks, EcosystemWalletComponents, NativeConfigLoader, NetworkConfig, UiKitConfiguration } from "@openzeppelin/ui-types";
+import { BaseComponentProps, Connector, EcosystemRuntime, EcosystemSpecificReactHooks, EcosystemWalletComponents, NativeConfigLoader, NetworkCatalogCapability, NetworkConfig, RuntimeCapability, UiKitConfiguration, WalletCapability } from "@openzeppelin/ui-types";
 
+//#region src/version.d.ts
+declare const VERSION: string;
+//#endregion
 //#region src/hooks/AdapterContext.d.ts
 /**
- * Registry type that maps network IDs to their corresponding adapter instances
- * This is the core data structure for the singleton pattern
+ * Registry type that maps network IDs to their corresponding runtime instances.
  */
-interface AdapterRegistry {
-  [networkId: string]: ContractAdapter;
+interface RuntimeRegistry {
+  [networkId: string]: EcosystemRuntime;
 }
 /**
- * Context value interface defining what's provided through the context
- * The main functionality is getAdapterForNetwork which either returns
- * an existing adapter or initiates loading of a new one
+ * Context value interface defining what's provided through the context.
+ * The main functionality is `getRuntimeForNetwork`, which either returns an existing
+ * runtime or initiates loading of a new one.
  */
-interface AdapterContextValue {
-  getAdapterForNetwork: (networkConfig: NetworkConfig | null) => {
-    adapter: ContractAdapter | null;
+interface RuntimeContextValue {
+  getRuntimeForNetwork: (networkConfig: NetworkConfig | null) => {
+    runtime: EcosystemRuntime | null;
     isLoading: boolean;
   };
+  /**
+   * Evicts a runtime from the registry and calls `dispose()` on it.
+   * Used by WalletStateProvider to release superseded runtimes after a safe handoff.
+   */
+  releaseRuntime: (networkId: string) => void;
 }
 /**
- * The React Context that provides adapter registry access throughout the app
- * Components can access this through the useAdapterContext hook
+ * The React Context that provides runtime registry access throughout the app.
+ * Components can access this through the `useRuntimeContext` hook.
  */
-declare const AdapterContext: react0.Context<AdapterContextValue | null>;
-//# sourceMappingURL=AdapterContext.d.ts.map
+declare const RuntimeContext: react0.Context<RuntimeContextValue | null>;
 //#endregion
 //#region src/hooks/AdapterProvider.d.ts
-interface AdapterProviderProps {
+
+interface RuntimeProviderProps {
   children: ReactNode;
-  /** Function to resolve/create an adapter instance for a given NetworkConfig. */
-  resolveAdapter: (networkConfig: NetworkConfig) => Promise<ContractAdapter>;
+  /** Function to resolve/create a runtime instance for a given NetworkConfig. */
+  resolveRuntime: (networkConfig: NetworkConfig) => Promise<EcosystemRuntime>;
 }
 /**
- * Provider component that manages adapter instances centrally
- * to avoid creating multiple instances of the same adapter.
+ * Provider component that manages runtime instances centrally
+ * to avoid creating multiple instances of the same runtime.
  *
  * This component:
- * 1. Maintains a registry of adapter instances by network ID
- * 2. Tracks loading states for adapters being initialized
- * 3. Provides a function to get or load adapters for specific networks
- * 4. Ensures adapter instances are reused when possible
+ * 1. Maintains a registry of runtime instances by network ID
+ * 2. Tracks loading states for runtimes being initialized
+ * 3. Provides a function to get or load runtimes for specific networks
+ * 4. Ensures runtime instances are reused when possible
  */
-declare function AdapterProvider({
+declare function RuntimeProvider({
   children,
-  resolveAdapter
-}: AdapterProviderProps): react_jsx_runtime0.JSX.Element;
-//# sourceMappingURL=AdapterProvider.d.ts.map
+  resolveRuntime
+}: RuntimeProviderProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 //#region src/hooks/WalletStateContext.d.ts
 interface WalletStateContextValue {
   activeNetworkId: string | null;
   setActiveNetworkId: (networkId: string | null) => void;
   activeNetworkConfig: NetworkConfig | null;
-  activeAdapter: ContractAdapter | null;
-  isAdapterLoading: boolean;
+  activeRuntime: EcosystemRuntime | null;
+  isRuntimeLoading: boolean;
   walletFacadeHooks: EcosystemSpecificReactHooks | null;
-  reconfigureActiveAdapterUiKit: (uiKitConfig?: Partial<UiKitConfiguration>) => void;
+  reconfigureActiveUiKit: (uiKitConfig?: Partial<UiKitConfiguration>) => void;
 }
 declare const WalletStateContext: React.Context<WalletStateContextValue | undefined>;
 /**
@@ -67,7 +73,6 @@ declare const WalletStateContext: React.Context<WalletStateContextValue | undefi
  * @throws Error if used outside of WalletStateProvider
  */
 declare function useWalletState(): WalletStateContextValue;
-//# sourceMappingURL=WalletStateContext.d.ts.map
 //#endregion
 //#region src/hooks/WalletStateProvider.d.ts
 interface WalletStateProviderProps {
@@ -90,15 +95,16 @@ interface WalletStateProviderProps {
  * It is responsible for:
  * 1. Managing the globally selected active network ID (`activeNetworkId`).
  * 2. Deriving the full `NetworkConfig` object (`activeNetworkConfig`) for the active network.
- * 3. Fetching and providing the corresponding `ContractAdapter` instance (`activeAdapter`) for the active network,
- *    leveraging the `AdapterProvider` to ensure adapter singletons.
- * 4. Storing and providing the `EcosystemSpecificReactHooks` (`walletFacadeHooks`) from the active adapter.
- * 5. Rendering the adapter-specific UI context provider (e.g., WagmiProvider for EVM) around its children,
- *    which is essential for the facade hooks to function correctly.
+ * 3. Fetching and providing the corresponding `EcosystemRuntime` (`activeRuntime`) for the active network,
+ *    leveraging the `RuntimeProvider` to ensure runtime singletons.
+ * 4. Caching ecosystem-scoped wallet session artifacts (provider roots and facade hooks)
+ *    independently from the network-scoped runtime.
+ * 5. Rendering the active ecosystem wallet provider (e.g., WagmiProvider for EVM) around its
+ *    children, which is essential for the facade hooks to function correctly.
  * 6. Providing a function (`setActiveNetworkId`) to change the globally active network.
  *
  * Consumers use the `useWalletState()` hook to access this global state.
- * It should be placed high in the component tree, inside an `<AdapterProvider>`.
+ * It should be placed high in the component tree, inside a `<RuntimeProvider>`.
  */
 declare function WalletStateProvider({
   children,
@@ -106,7 +112,6 @@ declare function WalletStateProvider({
   getNetworkConfigById,
   loadConfigModule
 }: WalletStateProviderProps): react_jsx_runtime0.JSX.Element;
-//# sourceMappingURL=WalletStateProvider.d.ts.map
 //#endregion
 //#region src/hooks/AnalyticsContext.d.ts
 /**
@@ -157,13 +162,6 @@ interface AnalyticsContextValue {
  * Must be used within an AnalyticsProvider.
  */
 declare const AnalyticsContext: react0.Context<AnalyticsContextValue | null>;
-/**
- * Internal hook to access analytics context.
- * Throws an error if used outside of an AnalyticsProvider.
- *
- * @internal
- * @throws Error if used outside of AnalyticsProvider
- */
 //#endregion
 //#region src/hooks/AnalyticsProvider.d.ts
 /**
@@ -193,8 +191,6 @@ interface AnalyticsProviderProps {
  * ```
  */
 declare const AnalyticsProvider: React.FC<AnalyticsProviderProps>;
-//# sourceMappingURL=AnalyticsProvider.d.ts.map
-
 //#endregion
 //#region src/hooks/useAnalytics.d.ts
 /**
@@ -244,35 +240,32 @@ declare const AnalyticsProvider: React.FC<AnalyticsProviderProps>;
  * @throws Error if used outside of AnalyticsProvider
  */
 declare const useAnalytics: () => AnalyticsContextValue;
-//# sourceMappingURL=useAnalytics.d.ts.map
 //#endregion
 //#region src/hooks/useAdapterContext.d.ts
 /**
- * Hook to access the adapter context
+ * Hook to access the runtime context
  *
- * This hook provides access to the getAdapterForNetwork function which
- * retrieves or creates adapter instances from the singleton registry.
+ * This hook provides access to the `getRuntimeForNetwork` function which
+ * retrieves or creates runtime instances from the singleton registry.
  *
- * Components should typically use useConfiguredAdapterSingleton instead
+ * Components should typically use the higher-level wallet/runtime hooks instead
  * of this hook directly, as it handles React state update timing properly.
  *
- * @throws Error if used outside of an AdapterProvider context
- * @returns The adapter context value
+ * @throws Error if used outside of a RuntimeProvider context
+ * @returns The runtime context value
  */
-declare function useAdapterContext(): AdapterContextValue;
-//# sourceMappingURL=useAdapterContext.d.ts.map
-
+declare function useRuntimeContext(): RuntimeContextValue;
 //#endregion
 //#region src/hooks/useWalletComponents.d.ts
 /**
- * Hook that provides direct access to wallet UI components from the active adapter.
+ * Hook that provides direct access to wallet UI components from the active runtime.
  *
  * Use this hook when you need full control over the layout and composition of
  * wallet components. For standard layouts, prefer using `WalletConnectionUI`
  * with its props forwarding capabilities.
  *
- * @returns The wallet components object, or null if no adapter is active or
- *          the adapter doesn't provide wallet components.
+ * @returns The wallet components object, or null if no runtime is active or
+ *          the runtime doesn't provide wallet components.
  *
  * @example
  * ```tsx
@@ -307,11 +300,14 @@ declare function useAdapterContext(): AdapterContextValue;
  * ```
  */
 declare function useWalletComponents(): EcosystemWalletComponents | null;
-//# sourceMappingURL=useWalletComponents.d.ts.map
 //#endregion
 //#region src/hooks/useDerivedAccountStatus.d.ts
 interface DerivedAccountStatus {
   isConnected: boolean;
+  isConnecting: boolean;
+  isDisconnected: boolean;
+  isReconnecting: boolean;
+  status: string;
   address?: string;
   chainId?: number;
 }
@@ -322,7 +318,6 @@ interface DerivedAccountStatus {
  * Provides default values if the hook or its properties are unavailable.
  */
 declare function useDerivedAccountStatus(): DerivedAccountStatus;
-//# sourceMappingURL=useDerivedAccountStatus.d.ts.map
 //#endregion
 //#region src/hooks/useDerivedSwitchChainStatus.d.ts
 interface DerivedSwitchChainStatus {
@@ -342,7 +337,6 @@ interface DerivedSwitchChainStatus {
  * Provides default values if the hook or its properties are unavailable.
  */
 declare function useDerivedSwitchChainStatus(): DerivedSwitchChainStatus;
-//# sourceMappingURL=useDerivedSwitchChainStatus.d.ts.map
 //#endregion
 //#region src/hooks/useDerivedChainInfo.d.ts
 interface DerivedChainInfo {
@@ -358,7 +352,6 @@ interface DerivedChainInfo {
  * Provides default values if the hooks or their properties are unavailable.
  */
 declare function useDerivedChainInfo(): DerivedChainInfo;
-//# sourceMappingURL=useDerivedChainInfo.d.ts.map
 //#endregion
 //#region src/hooks/useDerivedConnectStatus.d.ts
 interface DerivedConnectStatus {
@@ -381,7 +374,6 @@ interface DerivedConnectStatus {
  * safely-accessed status and control functions for wallet connection.
  */
 declare function useDerivedConnectStatus(): DerivedConnectStatus;
-//# sourceMappingURL=useDerivedConnectStatus.d.ts.map
 //#endregion
 //#region src/hooks/useDerivedDisconnect.d.ts
 interface DerivedDisconnectStatus {
@@ -398,7 +390,6 @@ interface DerivedDisconnectStatus {
  * safely-accessed status and control function for wallet disconnection.
  */
 declare function useDerivedDisconnect(): DerivedDisconnectStatus;
-//# sourceMappingURL=useDerivedDisconnect.d.ts.map
 //#endregion
 //#region src/hooks/useWalletReconnectionHandler.d.ts
 /**
@@ -409,12 +400,11 @@ declare function useDerivedDisconnect(): DerivedDisconnectStatus;
  * This hook detects that scenario and invokes a callback to re-queue the network switch.
  *
  * @param selectedNetworkConfigId - Currently selected network in the app
- * @param selectedAdapter - Currently active adapter instance
+ * @param selectedCapability - Currently active wallet capability instance
  * @param networkToSwitchTo - Current network switch queue state (null if no switch pending)
  * @param onRequeueSwitch - Callback invoked when a network switch should be re-queued
  */
-declare function useWalletReconnectionHandler(selectedNetworkConfigId: string | null, selectedAdapter: ContractAdapter | null, networkToSwitchTo: string | null, onRequeueSwitch: (networkId: string) => void): void;
-//# sourceMappingURL=useWalletReconnectionHandler.d.ts.map
+declare function useWalletReconnectionHandler(selectedNetworkConfigId: string | null, selectedCapability: RuntimeCapability | null, networkToSwitchTo: string | null, onRequeueSwitch: (networkId: string) => void): void;
 //#endregion
 //#region src/components/WalletConnectionHeader.d.ts
 /**
@@ -422,7 +412,6 @@ declare function useWalletReconnectionHandler(selectedNetworkConfigId: string |
  * Uses useWalletState to get its data.
  */
 declare const WalletConnectionHeader: React.FC;
-//# sourceMappingURL=WalletConnectionHeader.d.ts.map
 //#endregion
 //#region src/components/WalletConnectionUI.d.ts
 /**
@@ -461,15 +450,16 @@ interface WalletConnectionUIProps {
  * ```
  */
 declare const WalletConnectionUI: React.FC<WalletConnectionUIProps>;
-//# sourceMappingURL=WalletConnectionUI.d.ts.map
 //#endregion
 //#region src/components/NetworkSwitchManager.d.ts
 /**
  * Props for the NetworkSwitchManager component.
  */
 interface NetworkSwitchManagerProps {
-  /** The adapter instance for the target network */
-  adapter: ContractAdapter;
+  /** Wallet capability for the target network */
+  wallet: WalletCapability;
+  /** Network catalog capability used to validate the target network id */
+  networkCatalog: NetworkCatalogCapability;
   /** The network ID we want to switch to */
   targetNetworkId: string;
   /** Callback when network switch completes (success or error) */
@@ -490,8 +480,6 @@ interface NetworkSwitchManagerProps {
  * - Provides completion callback for parent components to handle state cleanup
  */
 declare const NetworkSwitchManager: React.FC<NetworkSwitchManagerProps>;
-//# sourceMappingURL=NetworkSwitchManager.d.ts.map
-
 //#endregion
-export { AdapterContext, type AdapterContextValue, AdapterProvider, type AdapterProviderProps, type AdapterRegistry, AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, type DerivedAccountStatus, type DerivedChainInfo, type DerivedConnectStatus, type DerivedDisconnectStatus, type DerivedSwitchChainStatus, NetworkSwitchManager, type NetworkSwitchManagerProps, WalletConnectionHeader, WalletConnectionUI, type WalletConnectionUIProps, WalletStateContext, type WalletStateContextValue, WalletStateProvider, type WalletStateProviderProps, useAdapterContext, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useWalletComponents, useWalletReconnectionHandler, useWalletState };
-//# sourceMappingURL=index-Deip8V0M.d.ts.map
+export { AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, type DerivedAccountStatus, type DerivedChainInfo, type DerivedConnectStatus, type DerivedDisconnectStatus, type DerivedSwitchChainStatus, NetworkSwitchManager, type NetworkSwitchManagerProps, RuntimeContext, type RuntimeContextValue, RuntimeProvider, type RuntimeProviderProps, type RuntimeRegistry, VERSION, WalletConnectionHeader, WalletConnectionUI, type WalletConnectionUIProps, WalletStateContext, type WalletStateContextValue, WalletStateProvider, type WalletStateProviderProps, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useRuntimeContext, useWalletComponents, useWalletReconnectionHandler, useWalletState };
+//# sourceMappingURL=index.d.mts.map