@openzeppelin/ui-react 3.0.0 → 3.1.0

package/dist/index.d.cts

@@ -1,7 +1,8 @@
 import * as react0 from "react";
-import React, { ReactNode } from "react";
-import { BaseComponentProps, Connector, EcosystemRuntime, EcosystemSpecificReactHooks, EcosystemWalletComponents, NativeConfigLoader, NetworkCatalogCapability, NetworkConfig, RuntimeCapability, UiKitConfiguration, WalletCapability } from "@openzeppelin/ui-types";
+import React, { Context, ReactNode } from "react";
+import { BaseComponentProps, Connector, EcosystemRuntime, EcosystemSpecificReactHooks, EcosystemWalletComponents, NameResolutionError, NameResolver, NativeConfigLoader, NetworkCatalogCapability, NetworkConfig, ResolvedAddress, ResolvedName, RuntimeCapability, UiKitConfiguration, WalletCapability } from "@openzeppelin/ui-types";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { QueryClient } from "@tanstack/react-query";
 
 //#region src/version.d.ts
 declare const VERSION: string;
@@ -36,7 +37,6 @@ interface RuntimeContextValue {
 declare const RuntimeContext: react0.Context<RuntimeContextValue | null>;
 //#endregion
 //#region src/hooks/AdapterProvider.d.ts
-
 interface RuntimeProviderProps {
   children: ReactNode;
   /** Function to resolve/create a runtime instance for a given NetworkConfig. */
@@ -406,6 +406,224 @@ declare function useDerivedDisconnect(): DerivedDisconnectStatus;
  */
 declare function useWalletReconnectionHandler(selectedNetworkConfigId: string | null, selectedCapability: RuntimeCapability | null, networkToSwitchTo: string | null, onRequeueSwitch: (networkId: string) => void): void;
 //#endregion
+//#region src/hooks/nameResolution/resolutionState.d.ts
+/**
+ * Lifecycle status shared by both resolution hooks. `debouncing` is distinct from
+ * `loading` so an input field can show a subtle "typing…" state separate from an
+ * in-flight call (the reverse hook omits `debouncing`; see {@link UseResolveAddressResult}).
+ */
+type NameResolutionStatus = 'idle' | 'debouncing' | 'loading' | 'resolved' | 'error';
+/**
+ * Forward-resolution (`useResolveName`) result. A discriminated union keyed on
+ * `status` so illegal field combinations — e.g. holding both `data` and `error`,
+ * or reading `.data` without narrowing — are unrepresentable (INV-23). This is the
+ * component-boundary shadow of SC-004: an unresolved name can never be read as a
+ * resolved address.
+ */
+type UseResolveNameResult = {
+  readonly status: 'idle';
+} | {
+  readonly status: 'debouncing';
+  readonly name: string;
+} | {
+  readonly status: 'loading';
+  readonly name: string;
+} | {
+  readonly status: 'resolved';
+  readonly name: string;
+  readonly data: ResolvedAddress;
+} | {
+  readonly status: 'error';
+  readonly name: string;
+  readonly error: NameResolutionError;
+  readonly retry: () => void;
+};
+/**
+ * Reverse-resolution (`useResolveAddress`) result. No `debouncing` arm — reverse
+ * debounce defaults to 0 (addresses are pasted, not typed). A caller-supplied
+ * non-zero `debounceMs` surfaces as `loading` rather than widening this type.
+ */
+type UseResolveAddressResult = {
+  readonly status: 'idle';
+} | {
+  readonly status: 'loading';
+  readonly address: string;
+} | {
+  readonly status: 'resolved';
+  readonly address: string;
+  readonly data: ResolvedName;
+} | {
+  readonly status: 'error';
+  readonly address: string;
+  readonly error: NameResolutionError;
+  readonly retry: () => void;
+};
+//#endregion
+//#region src/hooks/nameResolution/useResolveName.d.ts
+/** Options for {@link useResolveName}. */
+interface UseResolveNameOptions {
+  /** Override the forward debounce window (ms). Default: `config.forwardDebounceMs` (300). */
+  readonly debounceMs?: number;
+  /** When `false`, the hook stays `idle` and issues no resolution. Default `true`. */
+  readonly enabled?: boolean;
+}
+/**
+ * Forward-resolve a name to an address. Soft-reads the active runtime from
+ * `WalletStateContext` (never throws when no provider is mounted — degrades to
+ * idle / UNSUPPORTED_NETWORK) and calls `runtime.nameResolution?.resolveName`.
+ * Debounces `name`, caches per (network, name) via the owned QueryClient, and is
+ * protected against out-of-order responses (distinct inputs → distinct query keys).
+ *
+ * Returns a discriminated union keyed on `status`; it never throws for expected
+ * failures (they surface in the `error` arm) and never pairs a name with a
+ * different name's resolved address (INV-24).
+ *
+ * @param name    - The name to resolve. `null` / empty / a value failing the
+ *   adapter's `isValidName` yields `status: 'idle'` (never `error`).
+ * @param options - `debounceMs` / `enabled` overrides.
+ * @returns The current {@link UseResolveNameResult}.
+ */
+declare function useResolveName(name: string | null | undefined, options?: UseResolveNameOptions): UseResolveNameResult;
+//#endregion
+//#region src/hooks/nameResolution/useResolveAddress.d.ts
+/** Options for {@link useResolveAddress}. */
+interface UseResolveAddressOptions {
+  /** Override the reverse debounce window (ms). Default: `config.reverseDebounceMs` (0). */
+  readonly debounceMs?: number;
+  /** When `false`, the hook stays `idle` and issues no resolution. Default `true`. */
+  readonly enabled?: boolean;
+}
+/**
+ * Reverse-resolve an address to a name. Soft-reads the active runtime from
+ * `WalletStateContext` (never throws when no provider is mounted — degrades to
+ * idle / UNSUPPORTED_NETWORK) and calls `runtime.nameResolution?.resolveAddress`.
+ * Caches per (network, address) via the owned QueryClient. Not debounced by
+ * default — addresses are pasted, not typed char-by-char.
+ *
+ * Applies no client-side address-shape check (INV-32): resolution is attempted on
+ * any non-empty input and malformed addresses are rejected via the adapter's typed
+ * error union. Address-shape validation is SF-3's concern.
+ *
+ * @param address - The address to reverse-resolve. `null` / empty yields
+ *   `status: 'idle'`.
+ * @param options - `debounceMs` / `enabled` overrides.
+ * @returns The current {@link UseResolveAddressResult}.
+ */
+declare function useResolveAddress(address: string | null | undefined, options?: UseResolveAddressOptions): UseResolveAddressResult;
+//#endregion
+//#region src/hooks/nameResolution/resolutionConfig.d.ts
+/**
+ * Tunable knobs for the resolution hooks, overridable per-app via
+ * `NameResolutionProvider`'s `config` prop and merged over {@link DEFAULT_CONFIG}.
+ */
+interface ResolutionConfig {
+  /** Time a resolved value is considered fresh (no refetch). Maps to react-query `staleTime`. */
+  readonly staleTimeMs: number;
+  /** Time an unobserved cache entry is retained before GC. Maps to react-query `gcTime`. */
+  readonly gcTimeMs: number;
+  /** Debounce window (ms) for the forward hook before a settled input becomes the query key. */
+  readonly forwardDebounceMs: number;
+  /** Debounce window (ms) for the reverse hook. Addresses are pasted/stable, so this defaults to 0. */
+  readonly reverseDebounceMs: number;
+  /** Max retries for TRANSIENT errors. Definitive negatives are never retried. */
+  readonly transientRetryCount: number;
+}
+/**
+ * Default resolution config. Values sit within the spec's "seconds-to-minutes"
+ * caching guidance; forward debounce is 300ms (typed char-by-char), reverse is 0.
+ */
+declare const DEFAULT_CONFIG: ResolutionConfig;
+//#endregion
+//#region src/hooks/nameResolution/NameResolutionProvider.d.ts
+/**
+ * Props for {@link NameResolutionProvider}. Mounting the Provider is OPTIONAL —
+ * absent it, hooks use the module-singleton client and {@link DEFAULT_CONFIG}
+ * (INV-48). Mount it only to override config or share the cache with an existing
+ * QueryClient.
+ */
+interface NameResolutionProviderProps {
+  readonly children: ReactNode;
+  /** Partial override of the default config (TTLs, debounce, retry count). Merged per-field. */
+  readonly config?: Partial<ResolutionConfig>;
+  /**
+   * Inject a QueryClient to SHARE the resolution cache with the app / adapter
+   * client (unified devtools / persistence). Omit for an isolated owned client.
+   */
+  readonly queryClient?: QueryClient;
+}
+/**
+ * Optional provider that overrides resolution config and/or the QueryClient for
+ * its subtree. It does NOT render a `QueryClientProvider`: the client is passed
+ * explicitly to `useQuery` (INV-48), so no ambient react-query provider is needed.
+ *
+ * Config is merged field-by-field over {@link DEFAULT_CONFIG} (INV-30), and the
+ * context value is memoized so a Provider re-render does not cascade to every hook
+ * (INV-38).
+ */
+declare function NameResolutionProvider({
+  children,
+  config,
+  queryClient
+}: NameResolutionProviderProps): ReactNode;
+//#endregion
+//#region src/hooks/nameResolution/NameResolutionContext.d.ts
+/**
+ * Value carried by {@link NameResolutionContext}: the owned QueryClient (passed
+ * explicitly to `useQuery`, never via an ambient `QueryClientProvider`) and the
+ * merged resolution config.
+ */
+interface NameResolutionContextValue {
+  /** OWNED resolution QueryClient, passed explicitly to `useQuery` (INV-48). */
+  readonly queryClient: QueryClient;
+  /** Effective config (Provider overrides merged over {@link DEFAULT_CONFIG}). */
+  readonly config: ResolutionConfig;
+}
+/**
+ * React context for resolution. `null` default triggers the module-singleton
+ * fallback in {@link useNameResolutionContext} — no Provider is required (INV-48).
+ */
+declare const NameResolutionContext: Context<NameResolutionContextValue | null>;
+/**
+ * Read the resolution context, falling back to the zero-wiring default (global
+ * singleton client + {@link DEFAULT_CONFIG}) when no `NameResolutionProvider` is
+ * mounted (INV-48). Never throws for a missing provider.
+ *
+ * @returns The active {@link NameResolutionContextValue}.
+ */
+declare function useNameResolutionContext(): NameResolutionContextValue;
+//#endregion
+//#region src/hooks/nameResolution/useRuntimeNameResolver.d.ts
+/**
+ * Project the active runtime's `NameResolutionCapability` into the injected
+ * {@link NameResolver} seam consumed by `@openzeppelin/ui-components` (SF-3, D3).
+ * Mounted ambiently by the renderer:
+ *
+ * ```tsx
+ * <NameResolverProvider {...useRuntimeNameResolver()}>{form}</NameResolverProvider>
+ * ```
+ *
+ * Each imperative call is backed by SF-2's **owned** resolution `QueryClient`
+ * via `fetchQuery`, reusing SF-2's exact query-key convention
+ * (`buildResolutionKey('name', networkId, normalizedName)`) — so a name
+ * resolved through the field and the same name resolved by a bare
+ * `useResolveName` hit the SAME cache entry: shared cache, dedupe, and
+ * out-of-order safety, never a parallel cache (INV-119).
+ *
+ * Degradation, in order (all method-omission, never a throw):
+ * - No `WalletStateProvider` mounted → empty resolver. The context is read
+ *   directly (not via `useWalletState()`, which throws) so the ambient
+ *   renderer mount stays safe for wallet-less usage.
+ * - No active runtime, or runtime without the capability → empty resolver.
+ * - Capability without `resolveName` → `isValidName` only; forward unsupported.
+ *
+ * When the capability is present but the network itself is unsupported, the
+ * adapter's `resolveName` resolves `{ ok: false, error: UNSUPPORTED_NETWORK }`
+ * and that result passes through unchanged.
+ *
+ * @returns A referentially stable {@link NameResolver} for the active runtime.
+ */
+declare function useRuntimeNameResolver(): NameResolver;
+//#endregion
 //#region src/components/WalletConnectionHeader.d.ts
 /**
  * Component that renders the wallet connection UI.
@@ -481,5 +699,5 @@ interface NetworkSwitchManagerProps {
  */
 declare const NetworkSwitchManager: React.FC<NetworkSwitchManagerProps>;
 //#endregion
-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 };
+export { AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, DEFAULT_CONFIG, type DerivedAccountStatus, type DerivedChainInfo, type DerivedConnectStatus, type DerivedDisconnectStatus, type DerivedSwitchChainStatus, NameResolutionContext, type NameResolutionContextValue, NameResolutionProvider, type NameResolutionProviderProps, type NameResolutionStatus, NetworkSwitchManager, type NetworkSwitchManagerProps, type ResolutionConfig, RuntimeContext, type RuntimeContextValue, RuntimeProvider, type RuntimeProviderProps, type RuntimeRegistry, type UseResolveAddressOptions, type UseResolveAddressResult, type UseResolveNameOptions, type UseResolveNameResult, VERSION, WalletConnectionHeader, WalletConnectionUI, type WalletConnectionUIProps, WalletStateContext, type WalletStateContextValue, WalletStateProvider, type WalletStateProviderProps, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useNameResolutionContext, useResolveAddress, useResolveName, useRuntimeContext, useRuntimeNameResolver, useWalletComponents, useWalletReconnectionHandler, useWalletState };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +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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"}
+{"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/hooks/nameResolution/resolutionState.ts","../src/hooks/nameResolution/useResolveName.ts","../src/hooks/nameResolution/useResolveAddress.ts","../src/hooks/nameResolution/resolutionConfig.ts","../src/hooks/nameResolution/NameResolutionProvider.tsx","../src/hooks/nameResolution/NameResolutionContext.ts","../src/hooks/nameResolution/useRuntimeNameResolver.ts","../src/components/WalletConnectionHeader.tsx","../src/components/WalletConnectionUI.tsx","../src/components/NetworkSwitchManager.tsx"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -1,7 +1,8 @@
 import * as react0 from "react";
-import React, { ReactNode } from "react";
+import React, { Context, ReactNode } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
-import { BaseComponentProps, Connector, EcosystemRuntime, EcosystemSpecificReactHooks, EcosystemWalletComponents, NativeConfigLoader, NetworkCatalogCapability, NetworkConfig, RuntimeCapability, UiKitConfiguration, WalletCapability } from "@openzeppelin/ui-types";
+import { QueryClient } from "@tanstack/react-query";
+import { BaseComponentProps, Connector, EcosystemRuntime, EcosystemSpecificReactHooks, EcosystemWalletComponents, NameResolutionError, NameResolver, NativeConfigLoader, NetworkCatalogCapability, NetworkConfig, ResolvedAddress, ResolvedName, RuntimeCapability, UiKitConfiguration, WalletCapability } from "@openzeppelin/ui-types";
 
 //#region src/version.d.ts
 declare const VERSION: string;
@@ -36,7 +37,6 @@ interface RuntimeContextValue {
 declare const RuntimeContext: react0.Context<RuntimeContextValue | null>;
 //#endregion
 //#region src/hooks/AdapterProvider.d.ts
-
 interface RuntimeProviderProps {
   children: ReactNode;
   /** Function to resolve/create a runtime instance for a given NetworkConfig. */
@@ -406,6 +406,224 @@ declare function useDerivedDisconnect(): DerivedDisconnectStatus;
  */
 declare function useWalletReconnectionHandler(selectedNetworkConfigId: string | null, selectedCapability: RuntimeCapability | null, networkToSwitchTo: string | null, onRequeueSwitch: (networkId: string) => void): void;
 //#endregion
+//#region src/hooks/nameResolution/resolutionState.d.ts
+/**
+ * Lifecycle status shared by both resolution hooks. `debouncing` is distinct from
+ * `loading` so an input field can show a subtle "typing…" state separate from an
+ * in-flight call (the reverse hook omits `debouncing`; see {@link UseResolveAddressResult}).
+ */
+type NameResolutionStatus = 'idle' | 'debouncing' | 'loading' | 'resolved' | 'error';
+/**
+ * Forward-resolution (`useResolveName`) result. A discriminated union keyed on
+ * `status` so illegal field combinations — e.g. holding both `data` and `error`,
+ * or reading `.data` without narrowing — are unrepresentable (INV-23). This is the
+ * component-boundary shadow of SC-004: an unresolved name can never be read as a
+ * resolved address.
+ */
+type UseResolveNameResult = {
+  readonly status: 'idle';
+} | {
+  readonly status: 'debouncing';
+  readonly name: string;
+} | {
+  readonly status: 'loading';
+  readonly name: string;
+} | {
+  readonly status: 'resolved';
+  readonly name: string;
+  readonly data: ResolvedAddress;
+} | {
+  readonly status: 'error';
+  readonly name: string;
+  readonly error: NameResolutionError;
+  readonly retry: () => void;
+};
+/**
+ * Reverse-resolution (`useResolveAddress`) result. No `debouncing` arm — reverse
+ * debounce defaults to 0 (addresses are pasted, not typed). A caller-supplied
+ * non-zero `debounceMs` surfaces as `loading` rather than widening this type.
+ */
+type UseResolveAddressResult = {
+  readonly status: 'idle';
+} | {
+  readonly status: 'loading';
+  readonly address: string;
+} | {
+  readonly status: 'resolved';
+  readonly address: string;
+  readonly data: ResolvedName;
+} | {
+  readonly status: 'error';
+  readonly address: string;
+  readonly error: NameResolutionError;
+  readonly retry: () => void;
+};
+//#endregion
+//#region src/hooks/nameResolution/useResolveName.d.ts
+/** Options for {@link useResolveName}. */
+interface UseResolveNameOptions {
+  /** Override the forward debounce window (ms). Default: `config.forwardDebounceMs` (300). */
+  readonly debounceMs?: number;
+  /** When `false`, the hook stays `idle` and issues no resolution. Default `true`. */
+  readonly enabled?: boolean;
+}
+/**
+ * Forward-resolve a name to an address. Soft-reads the active runtime from
+ * `WalletStateContext` (never throws when no provider is mounted — degrades to
+ * idle / UNSUPPORTED_NETWORK) and calls `runtime.nameResolution?.resolveName`.
+ * Debounces `name`, caches per (network, name) via the owned QueryClient, and is
+ * protected against out-of-order responses (distinct inputs → distinct query keys).
+ *
+ * Returns a discriminated union keyed on `status`; it never throws for expected
+ * failures (they surface in the `error` arm) and never pairs a name with a
+ * different name's resolved address (INV-24).
+ *
+ * @param name    - The name to resolve. `null` / empty / a value failing the
+ *   adapter's `isValidName` yields `status: 'idle'` (never `error`).
+ * @param options - `debounceMs` / `enabled` overrides.
+ * @returns The current {@link UseResolveNameResult}.
+ */
+declare function useResolveName(name: string | null | undefined, options?: UseResolveNameOptions): UseResolveNameResult;
+//#endregion
+//#region src/hooks/nameResolution/useResolveAddress.d.ts
+/** Options for {@link useResolveAddress}. */
+interface UseResolveAddressOptions {
+  /** Override the reverse debounce window (ms). Default: `config.reverseDebounceMs` (0). */
+  readonly debounceMs?: number;
+  /** When `false`, the hook stays `idle` and issues no resolution. Default `true`. */
+  readonly enabled?: boolean;
+}
+/**
+ * Reverse-resolve an address to a name. Soft-reads the active runtime from
+ * `WalletStateContext` (never throws when no provider is mounted — degrades to
+ * idle / UNSUPPORTED_NETWORK) and calls `runtime.nameResolution?.resolveAddress`.
+ * Caches per (network, address) via the owned QueryClient. Not debounced by
+ * default — addresses are pasted, not typed char-by-char.
+ *
+ * Applies no client-side address-shape check (INV-32): resolution is attempted on
+ * any non-empty input and malformed addresses are rejected via the adapter's typed
+ * error union. Address-shape validation is SF-3's concern.
+ *
+ * @param address - The address to reverse-resolve. `null` / empty yields
+ *   `status: 'idle'`.
+ * @param options - `debounceMs` / `enabled` overrides.
+ * @returns The current {@link UseResolveAddressResult}.
+ */
+declare function useResolveAddress(address: string | null | undefined, options?: UseResolveAddressOptions): UseResolveAddressResult;
+//#endregion
+//#region src/hooks/nameResolution/resolutionConfig.d.ts
+/**
+ * Tunable knobs for the resolution hooks, overridable per-app via
+ * `NameResolutionProvider`'s `config` prop and merged over {@link DEFAULT_CONFIG}.
+ */
+interface ResolutionConfig {
+  /** Time a resolved value is considered fresh (no refetch). Maps to react-query `staleTime`. */
+  readonly staleTimeMs: number;
+  /** Time an unobserved cache entry is retained before GC. Maps to react-query `gcTime`. */
+  readonly gcTimeMs: number;
+  /** Debounce window (ms) for the forward hook before a settled input becomes the query key. */
+  readonly forwardDebounceMs: number;
+  /** Debounce window (ms) for the reverse hook. Addresses are pasted/stable, so this defaults to 0. */
+  readonly reverseDebounceMs: number;
+  /** Max retries for TRANSIENT errors. Definitive negatives are never retried. */
+  readonly transientRetryCount: number;
+}
+/**
+ * Default resolution config. Values sit within the spec's "seconds-to-minutes"
+ * caching guidance; forward debounce is 300ms (typed char-by-char), reverse is 0.
+ */
+declare const DEFAULT_CONFIG: ResolutionConfig;
+//#endregion
+//#region src/hooks/nameResolution/NameResolutionProvider.d.ts
+/**
+ * Props for {@link NameResolutionProvider}. Mounting the Provider is OPTIONAL —
+ * absent it, hooks use the module-singleton client and {@link DEFAULT_CONFIG}
+ * (INV-48). Mount it only to override config or share the cache with an existing
+ * QueryClient.
+ */
+interface NameResolutionProviderProps {
+  readonly children: ReactNode;
+  /** Partial override of the default config (TTLs, debounce, retry count). Merged per-field. */
+  readonly config?: Partial<ResolutionConfig>;
+  /**
+   * Inject a QueryClient to SHARE the resolution cache with the app / adapter
+   * client (unified devtools / persistence). Omit for an isolated owned client.
+   */
+  readonly queryClient?: QueryClient;
+}
+/**
+ * Optional provider that overrides resolution config and/or the QueryClient for
+ * its subtree. It does NOT render a `QueryClientProvider`: the client is passed
+ * explicitly to `useQuery` (INV-48), so no ambient react-query provider is needed.
+ *
+ * Config is merged field-by-field over {@link DEFAULT_CONFIG} (INV-30), and the
+ * context value is memoized so a Provider re-render does not cascade to every hook
+ * (INV-38).
+ */
+declare function NameResolutionProvider({
+  children,
+  config,
+  queryClient
+}: NameResolutionProviderProps): ReactNode;
+//#endregion
+//#region src/hooks/nameResolution/NameResolutionContext.d.ts
+/**
+ * Value carried by {@link NameResolutionContext}: the owned QueryClient (passed
+ * explicitly to `useQuery`, never via an ambient `QueryClientProvider`) and the
+ * merged resolution config.
+ */
+interface NameResolutionContextValue {
+  /** OWNED resolution QueryClient, passed explicitly to `useQuery` (INV-48). */
+  readonly queryClient: QueryClient;
+  /** Effective config (Provider overrides merged over {@link DEFAULT_CONFIG}). */
+  readonly config: ResolutionConfig;
+}
+/**
+ * React context for resolution. `null` default triggers the module-singleton
+ * fallback in {@link useNameResolutionContext} — no Provider is required (INV-48).
+ */
+declare const NameResolutionContext: Context<NameResolutionContextValue | null>;
+/**
+ * Read the resolution context, falling back to the zero-wiring default (global
+ * singleton client + {@link DEFAULT_CONFIG}) when no `NameResolutionProvider` is
+ * mounted (INV-48). Never throws for a missing provider.
+ *
+ * @returns The active {@link NameResolutionContextValue}.
+ */
+declare function useNameResolutionContext(): NameResolutionContextValue;
+//#endregion
+//#region src/hooks/nameResolution/useRuntimeNameResolver.d.ts
+/**
+ * Project the active runtime's `NameResolutionCapability` into the injected
+ * {@link NameResolver} seam consumed by `@openzeppelin/ui-components` (SF-3, D3).
+ * Mounted ambiently by the renderer:
+ *
+ * ```tsx
+ * <NameResolverProvider {...useRuntimeNameResolver()}>{form}</NameResolverProvider>
+ * ```
+ *
+ * Each imperative call is backed by SF-2's **owned** resolution `QueryClient`
+ * via `fetchQuery`, reusing SF-2's exact query-key convention
+ * (`buildResolutionKey('name', networkId, normalizedName)`) — so a name
+ * resolved through the field and the same name resolved by a bare
+ * `useResolveName` hit the SAME cache entry: shared cache, dedupe, and
+ * out-of-order safety, never a parallel cache (INV-119).
+ *
+ * Degradation, in order (all method-omission, never a throw):
+ * - No `WalletStateProvider` mounted → empty resolver. The context is read
+ *   directly (not via `useWalletState()`, which throws) so the ambient
+ *   renderer mount stays safe for wallet-less usage.
+ * - No active runtime, or runtime without the capability → empty resolver.
+ * - Capability without `resolveName` → `isValidName` only; forward unsupported.
+ *
+ * When the capability is present but the network itself is unsupported, the
+ * adapter's `resolveName` resolves `{ ok: false, error: UNSUPPORTED_NETWORK }`
+ * and that result passes through unchanged.
+ *
+ * @returns A referentially stable {@link NameResolver} for the active runtime.
+ */
+declare function useRuntimeNameResolver(): NameResolver;
+//#endregion
 //#region src/components/WalletConnectionHeader.d.ts
 /**
  * Component that renders the wallet connection UI.
@@ -481,5 +699,5 @@ interface NetworkSwitchManagerProps {
  */
 declare const NetworkSwitchManager: React.FC<NetworkSwitchManagerProps>;
 //#endregion
-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 };
+export { AnalyticsContext, type AnalyticsContextValue, AnalyticsProvider, type AnalyticsProviderProps, DEFAULT_CONFIG, type DerivedAccountStatus, type DerivedChainInfo, type DerivedConnectStatus, type DerivedDisconnectStatus, type DerivedSwitchChainStatus, NameResolutionContext, type NameResolutionContextValue, NameResolutionProvider, type NameResolutionProviderProps, type NameResolutionStatus, NetworkSwitchManager, type NetworkSwitchManagerProps, type ResolutionConfig, RuntimeContext, type RuntimeContextValue, RuntimeProvider, type RuntimeProviderProps, type RuntimeRegistry, type UseResolveAddressOptions, type UseResolveAddressResult, type UseResolveNameOptions, type UseResolveNameResult, VERSION, WalletConnectionHeader, WalletConnectionUI, type WalletConnectionUIProps, WalletStateContext, type WalletStateContextValue, WalletStateProvider, type WalletStateProviderProps, useAnalytics, useDerivedAccountStatus, useDerivedChainInfo, useDerivedConnectStatus, useDerivedDisconnect, useDerivedSwitchChainStatus, useNameResolutionContext, useResolveAddress, useResolveName, useRuntimeContext, useRuntimeNameResolver, useWalletComponents, useWalletReconnectionHandler, useWalletState };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","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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"}
+{"version":3,"file":"index.d.mts","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/hooks/nameResolution/resolutionState.ts","../src/hooks/nameResolution/useResolveName.ts","../src/hooks/nameResolution/useResolveAddress.ts","../src/hooks/nameResolution/resolutionConfig.ts","../src/hooks/nameResolution/NameResolutionProvider.tsx","../src/hooks/nameResolution/NameResolutionContext.ts","../src/hooks/nameResolution/useRuntimeNameResolver.ts","../src/components/WalletConnectionHeader.tsx","../src/components/WalletConnectionUI.tsx","../src/components/NetworkSwitchManager.tsx"],"sourcesContent":[],"mappings":"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"}