@reown/appkit-react-native 0.0.0-chore-use-theme-hook-20251105184714 → 0.0.0-chore-use-theme-hook-20251105193739

package/lib/module/hooks/useAppKitContext.js

@@ -0,0 +1,42 @@
+"use strict";
+
+import { useContext } from 'react';
+import { AppKitContext } from '../AppKitContext';
+
+/**
+ * Hook to access the AppKit context
+ *
+ * @remarks
+ * This is an internal hook used by other AppKit hooks to ensure they're used within
+ * the AppKitProvider. You typically don't need to use this hook directly - use the
+ * higher-level hooks like `useAppKit`, `useAccount`, `useAppKitTheme`, etc. instead.
+ *
+ * @returns {AppKitContextType} The AppKit context containing the AppKit instance
+ *
+ * @throws {Error} If used outside of an AppKitProvider
+ * @throws {Error} If the AppKit instance is not yet available in context
+ *
+ * @internal
+ *
+ * @example
+ * ```tsx
+ * // This is typically used internally by other hooks
+ * function MyCustomHook() {
+ *   const context = useAppKitContext();
+ *   // Use context.appKit...
+ * }
+ * ```
+ */
+
+export const useAppKitContext = () => {
+  const context = useContext(AppKitContext);
+  if (context === undefined) {
+    throw new Error('useAppKit must be used within an AppKitProvider');
+  }
+  if (!context.appKit) {
+    // This might happen if the provider is rendered before AppKit is initialized
+    throw new Error('AppKit instance is not yet available in context.');
+  }
+  return context;
+};
+//# sourceMappingURL=useAppKitContext.js.map

package/lib/module/hooks/useAppKitContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useContext","AppKitContext","useAppKitContext","context","undefined","Error","appKit"],"sourceRoot":"../../../src","sources":["hooks/useAppKitContext.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,OAAO;AAElC,SAASC,aAAa,QAAgC,kBAAkB;;AAExE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,MAAMC,gBAAgB,GAAGA,CAAA,KAAyB;EACvD,MAAMC,OAAO,GAAGH,UAAU,CAACC,aAAa,CAAC;EAEzC,IAAIE,OAAO,KAAKC,SAAS,EAAE;IACzB,MAAM,IAAIC,KAAK,CAAC,iDAAiD,CAAC;EACpE;EAEA,IAAI,CAACF,OAAO,CAACG,MAAM,EAAE;IACnB;IACA,MAAM,IAAID,KAAK,CAAC,kDAAkD,CAAC;EACrE;EAEA,OAAOF,OAAO;AAChB,CAAC","ignoreList":[]}

package/lib/module/hooks/useAppKitEvents.js

@@ -3,9 +3,42 @@
 import { useEffect } from 'react';
 import { useSnapshot } from 'valtio';
 import { EventsController } from '@reown/appkit-core-react-native';
-import { useAppKit } from './useAppKit';
+import { useAppKitContext } from './useAppKitContext';
+
+/**
+ * Hook to subscribe to all AppKit events
+ *
+ * @remarks
+ * This hook provides reactive access to AppKit's event system, allowing you to
+ * monitor all events that occur within the AppKit lifecycle (connections, disconnections,
+ * network changes, etc.). The callback is invoked whenever a new event is emitted.
+ *
+ * @param callback - Optional callback function invoked when any event occurs
+ *
+ * @returns An object containing:
+ *   - `data`: The most recent event data
+ *   - `timestamp`: The timestamp of the most recent event
+ *
+ * @throws {Error} If used outside of an AppKitProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { data, timestamp } = useAppKitEvents((event) => {
+ *     console.log('Event occurred:', event.data.event);
+ *   });
+ *
+ *   return (
+ *     <View>
+ *       <Text>Last event: {data?.event}</Text>
+ *       <Text>Time: {timestamp}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
 export function useAppKitEvents(callback) {
-  useAppKit(); // Use the hook for checks
+  useAppKitContext();
   const {
     data,
     timestamp
@@ -23,9 +56,37 @@ export function useAppKitEvents(callback) {
     timestamp
   };
 }
-export function useAppKitEventSubscription(event, callback) {
-  useAppKit(); // Use the hook for checks
 
+/**
+ * Hook to subscribe to a specific AppKit event
+ *
+ * @remarks
+ * This hook allows you to listen for a specific event type rather than all events.
+ * It's more efficient than `useAppKitEvents` when you only care about a particular event.
+ *
+ * @param event - The specific event name to subscribe to (e.g., 'MODAL_OPEN', 'CONNECT_SUCCESS')
+ * @param callback - Callback function invoked when the specified event occurs
+ *
+ * @throws {Error} If used outside of an AppKitProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   useAppKitEventSubscription('CONNECT_SUCCESS', (event) => {
+ *     console.log('Wallet connected!', event.data);
+ *   });
+ *
+ *   useAppKitEventSubscription('DISCONNECT_SUCCESS', (event) => {
+ *     console.log('Wallet disconnected!', event.data);
+ *   });
+ *
+ *   return <View>{/ Your component /}</View>;
+ * }
+ * ```
+ */
+
+export function useAppKitEventSubscription(event, callback) {
+  useAppKitContext();
   useEffect(() => {
     const unsubscribe = EventsController?.subscribeEvent(event, callback);
     return () => {

package/lib/module/hooks/useAppKitEvents.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useSnapshot","EventsController","useAppKit","useAppKitEvents","callback","data","timestamp","state","unsubscribe","subscribe","newEvent","useAppKitEventSubscription","event","subscribeEvent"],"sourceRoot":"../../../src","sources":["hooks/useAppKitEvents.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,OAAO;AACjC,SAASC,WAAW,QAAQ,QAAQ;AACpC,SAASC,gBAAgB,QAAoC,iCAAiC;AAE9F,SAASC,SAAS,QAAQ,aAAa;AAEvC,OAAO,SAASC,eAAeA,CAACC,QAAoD,EAAE;EACpFF,SAAS,CAAC,CAAC,CAAC,CAAC;EACb,MAAM;IAAEG,IAAI;IAAEC;EAAU,CAAC,GAAGN,WAAW,CAACC,gBAAgB,CAACM,KAAK,CAAC;EAE/DR,SAAS,CAAC,MAAM;IACd,MAAMS,WAAW,GAAGP,gBAAgB,CAACQ,SAAS,CAACC,QAAQ,IAAI;MACzDN,QAAQ,GAAGM,QAAQ,CAAC;IACtB,CAAC,CAAC;IAEF,OAAO,MAAM;MACXF,WAAW,GAAG,CAAC;IACjB,CAAC;EACH,CAAC,EAAE,CAACJ,QAAQ,CAAC,CAAC;EAEd,OAAO;IAAEC,IAAI;IAAEC;EAAU,CAAC;AAC5B;AAEA,OAAO,SAASK,0BAA0BA,CACxCC,KAAgB,EAChBR,QAAmD,EACnD;EACAF,SAAS,CAAC,CAAC,CAAC,CAAC;;EAEbH,SAAS,CAAC,MAAM;IACd,MAAMS,WAAW,GAAGP,gBAAgB,EAAEY,cAAc,CAACD,KAAK,EAAER,QAAQ,CAAC;IAErE,OAAO,MAAM;MACXI,WAAW,GAAG,CAAC;IACjB,CAAC;EACH,CAAC,EAAE,CAACJ,QAAQ,EAAEQ,KAAK,CAAC,CAAC;AACvB","ignoreList":[]}
+{"version":3,"names":["useEffect","useSnapshot","EventsController","useAppKitContext","useAppKitEvents","callback","data","timestamp","state","unsubscribe","subscribe","newEvent","useAppKitEventSubscription","event","subscribeEvent"],"sourceRoot":"../../../src","sources":["hooks/useAppKitEvents.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,OAAO;AACjC,SAASC,WAAW,QAAQ,QAAQ;AACpC,SAASC,gBAAgB,QAAoC,iCAAiC;AAE9F,SAASC,gBAAgB,QAAQ,oBAAoB;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAACC,QAAoD,EAAE;EACpFF,gBAAgB,CAAC,CAAC;EAClB,MAAM;IAAEG,IAAI;IAAEC;EAAU,CAAC,GAAGN,WAAW,CAACC,gBAAgB,CAACM,KAAK,CAAC;EAE/DR,SAAS,CAAC,MAAM;IACd,MAAMS,WAAW,GAAGP,gBAAgB,CAACQ,SAAS,CAACC,QAAQ,IAAI;MACzDN,QAAQ,GAAGM,QAAQ,CAAC;IACtB,CAAC,CAAC;IAEF,OAAO,MAAM;MACXF,WAAW,GAAG,CAAC;IACjB,CAAC;EACH,CAAC,EAAE,CAACJ,QAAQ,CAAC,CAAC;EAEd,OAAO;IAAEC,IAAI;IAAEC;EAAU,CAAC;AAC5B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASK,0BAA0BA,CACxCC,KAAgB,EAChBR,QAAmD,EACnD;EACAF,gBAAgB,CAAC,CAAC;EAElBH,SAAS,CAAC,MAAM;IACd,MAAMS,WAAW,GAAGP,gBAAgB,EAAEY,cAAc,CAACD,KAAK,EAAER,QAAQ,CAAC;IAErE,OAAO,MAAM;MACXI,WAAW,GAAG,CAAC;IACjB,CAAC;EACH,CAAC,EAAE,CAACJ,QAAQ,EAAEQ,KAAK,CAAC,CAAC;AACvB","ignoreList":[]}

package/lib/module/hooks/useAppKitLogs.js

@@ -1,9 +1,9 @@
 "use strict";
 
-import { useContext, useMemo } from 'react';
+import { useMemo } from 'react';
 import { useSnapshot } from 'valtio';
 import { LogController } from '@reown/appkit-core-react-native';
-import { AppKitContext } from '../AppKitContext';
+import { useAppKitContext } from './useAppKitContext';
 /**
  * React hook for accessing AppKit logs
  *
@@ -26,13 +26,7 @@ import { AppKitContext } from '../AppKitContext';
  * ```
  */
 export const useAppKitLogs = () => {
-  const context = useContext(AppKitContext);
-  if (context === undefined) {
-    throw new Error('useAppKitLogs must be used within an AppKitProvider');
-  }
-  if (!context.appKit) {
-    throw new Error('AppKit instance is not yet available in context.');
-  }
+  useAppKitContext();
   const {
     logs
   } = useSnapshot(LogController.state);

package/lib/module/hooks/useAppKitLogs.js.map

@@ -1 +1 @@
-{"version":3,"names":["useContext","useMemo","useSnapshot","LogController","AppKitContext","useAppKitLogs","context","undefined","Error","appKit","logs","state","stableFunctions","getLogsByLevel","level","getRecentLogs","count","exportLogs","getLogsStats","clearLogs","regularArrays","allLogs","errorLogs","warningLogs","infoLogs","debugLogs","log","push"],"sourceRoot":"../../../src","sources":["hooks/useAppKitLogs.ts"],"mappings":";;AAAA,SAASA,UAAU,EAAEC,OAAO,QAAQ,OAAO;AAC3C,SAASC,WAAW,QAAQ,QAAQ;AACpC,SAASC,aAAa,QAAsC,iCAAiC;AAC7F,SAASC,aAAa,QAAQ,kBAAkB;AA0ChD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,aAAa,GAAGA,CAAA,KAA2B;EACtD,MAAMC,OAAO,GAAGN,UAAU,CAACI,aAAa,CAAC;EAEzC,IAAIE,OAAO,KAAKC,SAAS,EAAE;IACzB,MAAM,IAAIC,KAAK,CAAC,qDAAqD,CAAC;EACxE;EAEA,IAAI,CAACF,OAAO,CAACG,MAAM,EAAE;IACnB,MAAM,IAAID,KAAK,CAAC,kDAAkD,CAAC;EACrE;EAEA,MAAM;IAAEE;EAAK,CAAC,GAAGR,WAAW,CAACC,aAAa,CAACQ,KAAK,CAAC;;EAEjD;EACA,MAAMC,eAAe,GAAGX,OAAO,CAC7B,OAAO;IACLY,cAAc,EAAGC,KAAe,IAAKX,aAAa,CAACU,cAAc,CAACC,KAAK,CAAC;IACxEC,aAAa,EAAGC,KAAc,IAAKb,aAAa,CAACY,aAAa,CAACC,KAAK,CAAC;IACrEC,UAAU,EAAEA,CAAA,KAAMd,aAAa,CAACc,UAAU,CAAC,CAAC;IAC5CC,YAAY,EAAEA,CAAA,KAAMf,aAAa,CAACe,YAAY,CAAC,CAAC;IAChDC,SAAS,EAAEA,CAAA,KAAMhB,aAAa,CAACgB,SAAS,CAAC;EAC3C,CAAC,CAAC,EACF,EACF,CAAC;EAED,MAAMC,aAAa,GAAGnB,OAAO,CAAC,MAAM;IAClC,MAAMoB,OAAO,GAAG,CAAC,GAAGX,IAAI,CAAC,CAAC,CAAC;IAC3B,MAAMY,SAAqB,GAAG,EAAE;IAChC,MAAMC,WAAuB,GAAG,EAAE;IAClC,MAAMC,QAAoB,GAAG,EAAE;IAC/B,MAAMC,SAAqB,GAAG,EAAE;IAEhC,KAAK,MAAMC,GAAG,IAAIL,OAAO,EAAE;MACzB,QAAQK,GAAG,CAACZ,KAAK;QACf,KAAK,OAAO;UACVQ,SAAS,CAACK,IAAI,CAACD,GAAG,CAAC;UACnB;QACF,KAAK,MAAM;UACTH,WAAW,CAACI,IAAI,CAACD,GAAG,CAAC;UACrB;QACF,KAAK,MAAM;UACTF,QAAQ,CAACG,IAAI,CAACD,GAAG,CAAC;UAClB;QACF,KAAK,OAAO;UACVD,SAAS,CAACE,IAAI,CAACD,GAAG,CAAC;UACnB;MACJ;IACF;IAEA,OAAO;MACLhB,IAAI,EAAEW,OAAO;MACbC,SAAS;MACTC,WAAW;MACXC,QAAQ;MACRC;IACF,CAAC;EACH,CAAC,EAAE,CAACf,IAAI,CAAC,CAAC;EAEV,OAAO;IACL,GAAGU,aAAa;IAChB,GAAGR;EACL,CAAC;AACH,CAAC","ignoreList":[]}
+{"version":3,"names":["useMemo","useSnapshot","LogController","useAppKitContext","useAppKitLogs","logs","state","stableFunctions","getLogsByLevel","level","getRecentLogs","count","exportLogs","getLogsStats","clearLogs","regularArrays","allLogs","errorLogs","warningLogs","infoLogs","debugLogs","log","push"],"sourceRoot":"../../../src","sources":["hooks/useAppKitLogs.ts"],"mappings":";;AAAA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,WAAW,QAAQ,QAAQ;AACpC,SAASC,aAAa,QAAsC,iCAAiC;AAC7F,SAASC,gBAAgB,QAAQ,oBAAoB;AA0CrD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,aAAa,GAAGA,CAAA,KAA2B;EACtDD,gBAAgB,CAAC,CAAC;EAElB,MAAM;IAAEE;EAAK,CAAC,GAAGJ,WAAW,CAACC,aAAa,CAACI,KAAK,CAAC;;EAEjD;EACA,MAAMC,eAAe,GAAGP,OAAO,CAC7B,OAAO;IACLQ,cAAc,EAAGC,KAAe,IAAKP,aAAa,CAACM,cAAc,CAACC,KAAK,CAAC;IACxEC,aAAa,EAAGC,KAAc,IAAKT,aAAa,CAACQ,aAAa,CAACC,KAAK,CAAC;IACrEC,UAAU,EAAEA,CAAA,KAAMV,aAAa,CAACU,UAAU,CAAC,CAAC;IAC5CC,YAAY,EAAEA,CAAA,KAAMX,aAAa,CAACW,YAAY,CAAC,CAAC;IAChDC,SAAS,EAAEA,CAAA,KAAMZ,aAAa,CAACY,SAAS,CAAC;EAC3C,CAAC,CAAC,EACF,EACF,CAAC;EAED,MAAMC,aAAa,GAAGf,OAAO,CAAC,MAAM;IAClC,MAAMgB,OAAO,GAAG,CAAC,GAAGX,IAAI,CAAC,CAAC,CAAC;IAC3B,MAAMY,SAAqB,GAAG,EAAE;IAChC,MAAMC,WAAuB,GAAG,EAAE;IAClC,MAAMC,QAAoB,GAAG,EAAE;IAC/B,MAAMC,SAAqB,GAAG,EAAE;IAEhC,KAAK,MAAMC,GAAG,IAAIL,OAAO,EAAE;MACzB,QAAQK,GAAG,CAACZ,KAAK;QACf,KAAK,OAAO;UACVQ,SAAS,CAACK,IAAI,CAACD,GAAG,CAAC;UACnB;QACF,KAAK,MAAM;UACTH,WAAW,CAACI,IAAI,CAACD,GAAG,CAAC;UACrB;QACF,KAAK,MAAM;UACTF,QAAQ,CAACG,IAAI,CAACD,GAAG,CAAC;UAClB;QACF,KAAK,OAAO;UACVD,SAAS,CAACE,IAAI,CAACD,GAAG,CAAC;UACnB;MACJ;IACF;IAEA,OAAO;MACLhB,IAAI,EAAEW,OAAO;MACbC,SAAS;MACTC,WAAW;MACXC,QAAQ;MACRC;IACF,CAAC;EACH,CAAC,EAAE,CAACf,IAAI,CAAC,CAAC;EAEV,OAAO;IACL,GAAGU,aAAa;IAChB,GAAGR;EACL,CAAC;AACH,CAAC","ignoreList":[]}

package/lib/module/hooks/useAppKitState.js

@@ -4,9 +4,43 @@
 import { useMemo } from 'react';
 import { useSnapshot } from 'valtio';
 import { ConnectionsController, ModalController } from '@reown/appkit-core-react-native';
-import { useAppKit } from './useAppKit';
+import { useAppKitContext } from './useAppKitContext';
+
+/**
+ * Hook to access the overall state of the AppKit modal and connection
+ *
+ * @remarks
+ * This hook provides a high-level view of the AppKit's current state, including
+ * whether the modal is open, if it's loading, connection status, and the active chain.
+ * It's useful for coordinating UI elements with the AppKit's state.
+ *
+ * @returns An object containing:
+ *   - `isOpen`: Whether the AppKit modal is currently open
+ *   - `isLoading`: Whether the AppKit is in a loading state
+ *   - `isConnected`: Whether a wallet is currently connected
+ *   - `chain`: The currently active blockchain network
+ *
+ * @throws {Error} If used outside of an AppKitProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { isOpen, isLoading, isConnected, chain } = useAppKitState();
+ *
+ *   return (
+ *     <View>
+ *       <Text>Modal: {isOpen ? 'Open' : 'Closed'}</Text>
+ *       <Text>Loading: {isLoading ? 'Yes' : 'No'}</Text>
+ *       <Text>Connected: {isConnected ? 'Yes' : 'No'}</Text>
+ *       {chain && <Text>Chain: {chain.name}</Text>}
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+
 export function useAppKitState() {
-  useAppKit(); // Use the hook for checks
+  useAppKitContext();
   const {
     activeAddress: address,
     connection,

package/lib/module/hooks/useAppKitState.js.map

@@ -1 +1 @@
-{"version":3,"names":["useMemo","useSnapshot","ConnectionsController","ModalController","useAppKit","useAppKitState","activeAddress","address","connection","networks","state","open","loading","activeChain","caipNetwork","find","network","caipNetworkId","undefined","isOpen","isLoading","isConnected","chain"],"sourceRoot":"../../../src","sources":["hooks/useAppKitState.ts"],"mappings":";;AAAA;AACA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,WAAW,QAAQ,QAAQ;AACpC,SAASC,qBAAqB,EAAEC,eAAe,QAAQ,iCAAiC;AACxF,SAASC,SAAS,QAAQ,aAAa;AAEvC,OAAO,SAASC,cAAcA,CAAA,EAAG;EAC/BD,SAAS,CAAC,CAAC,CAAC,CAAC;EACb,MAAM;IAAEE,aAAa,EAAEC,OAAO;IAAEC,UAAU;IAAEC;EAAS,CAAC,GAAGR,WAAW,CAACC,qBAAqB,CAACQ,KAAK,CAAC;EACjG,MAAM;IAAEC,IAAI;IAAEC;EAAQ,CAAC,GAAGX,WAAW,CAACE,eAAe,CAACO,KAAK,CAAC;EAE5D,MAAMG,WAAW,GAAGb,OAAO,CACzB,MACEQ,UAAU,EAAEM,WAAW,GACnBL,QAAQ,CAACM,IAAI,CAACC,OAAO,IAAIA,OAAO,CAACC,aAAa,KAAKT,UAAU,EAAEM,WAAW,CAAC,GAC3EI,SAAS,EACf,CAACV,UAAU,EAAEM,WAAW,EAAEL,QAAQ,CACpC,CAAC;EAED,OAAO;IACLU,MAAM,EAAER,IAAI;IACZS,SAAS,EAAER,OAAO;IAClBS,WAAW,EAAE,CAAC,CAACd,OAAO;IACtBe,KAAK,EAAET;EACT,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["useMemo","useSnapshot","ConnectionsController","ModalController","useAppKitContext","useAppKitState","activeAddress","address","connection","networks","state","open","loading","activeChain","caipNetwork","find","network","caipNetworkId","undefined","isOpen","isLoading","isConnected","chain"],"sourceRoot":"../../../src","sources":["hooks/useAppKitState.ts"],"mappings":";;AAAA;AACA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,WAAW,QAAQ,QAAQ;AACpC,SAASC,qBAAqB,EAAEC,eAAe,QAAQ,iCAAiC;AACxF,SAASC,gBAAgB,QAAQ,oBAAoB;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASC,cAAcA,CAAA,EAAG;EAC/BD,gBAAgB,CAAC,CAAC;EAClB,MAAM;IAAEE,aAAa,EAAEC,OAAO;IAAEC,UAAU;IAAEC;EAAS,CAAC,GAAGR,WAAW,CAACC,qBAAqB,CAACQ,KAAK,CAAC;EACjG,MAAM;IAAEC,IAAI;IAAEC;EAAQ,CAAC,GAAGX,WAAW,CAACE,eAAe,CAACO,KAAK,CAAC;EAE5D,MAAMG,WAAW,GAAGb,OAAO,CACzB,MACEQ,UAAU,EAAEM,WAAW,GACnBL,QAAQ,CAACM,IAAI,CAACC,OAAO,IAAIA,OAAO,CAACC,aAAa,KAAKT,UAAU,EAAEM,WAAW,CAAC,GAC3EI,SAAS,EACf,CAACV,UAAU,EAAEM,WAAW,EAAEL,QAAQ,CACpC,CAAC;EAED,OAAO;IACLU,MAAM,EAAER,IAAI;IACZS,SAAS,EAAER,OAAO;IAClBS,WAAW,EAAE,CAAC,CAACd,OAAO;IACtBe,KAAK,EAAET;EACT,CAAC;AACH","ignoreList":[]}

package/lib/module/hooks/useAppKitTheme.js

@@ -3,7 +3,7 @@
 import { useMemo } from 'react';
 import { useSnapshot } from 'valtio';
 import { ThemeController } from '@reown/appkit-core-react-native';
-import { useAppKit } from './useAppKit';
+import { useAppKitContext } from './useAppKitContext';
 
 /**
  * Interface representing the result of the useAppKitTheme hook
@@ -53,7 +53,7 @@ import { useAppKit } from './useAppKit';
  * ```
  */
 export function useAppKitTheme() {
-  useAppKit(); // Use the hook for checks
+  useAppKitContext();
   const {
     themeMode,
     themeVariables

package/lib/module/hooks/useAppKitTheme.js.map

@@ -1 +1 @@
-{"version":3,"names":["useMemo","useSnapshot","ThemeController","useAppKit","useAppKitTheme","themeMode","themeVariables","state","stableFunctions","setThemeMode","bind","setThemeVariables"],"sourceRoot":"../../../src","sources":["hooks/useAppKitTheme.ts"],"mappings":";;AAAA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,WAAW,QAAQ,QAAQ;AAEpC,SAASC,eAAe,QAAQ,iCAAiC;AACjE,SAASC,SAAS,QAAQ,aAAa;;AAEvC;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAyB;EACrDD,SAAS,CAAC,CAAC,CAAC,CAAC;EACb,MAAM;IAAEE,SAAS;IAAEC;EAAe,CAAC,GAAGL,WAAW,CAACC,eAAe,CAACK,KAAK,CAAC;EAExE,MAAMC,eAAe,GAAGR,OAAO,CAC7B,OAAO;IACLS,YAAY,EAAEP,eAAe,CAACO,YAAY,CAACC,IAAI,CAACR,eAAe,CAAC;IAChES,iBAAiB,EAAET,eAAe,CAACS,iBAAiB,CAACD,IAAI,CAACR,eAAe;EAC3E,CAAC,CAAC,EACF,EACF,CAAC;EAED,OAAO;IACLG,SAAS;IACTC,cAAc;IACd,GAAGE;EACL,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["useMemo","useSnapshot","ThemeController","useAppKitContext","useAppKitTheme","themeMode","themeVariables","state","stableFunctions","setThemeMode","bind","setThemeVariables"],"sourceRoot":"../../../src","sources":["hooks/useAppKitTheme.ts"],"mappings":";;AAAA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,WAAW,QAAQ,QAAQ;AAEpC,SAASC,eAAe,QAAQ,iCAAiC;AACjE,SAASC,gBAAgB,QAAQ,oBAAoB;;AAErD;AACA;AACA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAyB;EACrDD,gBAAgB,CAAC,CAAC;EAClB,MAAM;IAAEE,SAAS;IAAEC;EAAe,CAAC,GAAGL,WAAW,CAACC,eAAe,CAACK,KAAK,CAAC;EAExE,MAAMC,eAAe,GAAGR,OAAO,CAC7B,OAAO;IACLS,YAAY,EAAEP,eAAe,CAACO,YAAY,CAACC,IAAI,CAACR,eAAe,CAAC;IAChES,iBAAiB,EAAET,eAAe,CAACS,iBAAiB,CAACD,IAAI,CAACR,eAAe;EAC3E,CAAC,CAAC,EACF,EACF,CAAC;EAED,OAAO;IACLG,SAAS;IACTC,cAAc;IACd,GAAGE;EACL,CAAC;AACH","ignoreList":[]}

package/lib/module/hooks/useProvider.js

@@ -4,6 +4,7 @@
 import { useMemo } from 'react';
 import { useSnapshot } from 'valtio';
 import { ConnectionsController, LogController } from '@reown/appkit-core-react-native';
+import { useAppKitContext } from './useAppKitContext';
 
 /**
  * Interface representing the result of the useProvider hook
@@ -24,14 +25,12 @@ import { ConnectionsController, LogController } from '@reown/appkit-core-react-n
  *
  * if (provider) {
  *   // Use the provider for blockchain operations
- *   const balance = await provider.request({
- *     method: 'eth_getBalance',
- *     params: [address, 'latest']
- *   });
+ *   const balance = await provider.request({...});
  * }
  * ```
  */
 export function useProvider() {
+  useAppKitContext();
   const {
     connection
   } = useSnapshot(ConnectionsController.state);

package/lib/module/hooks/useProvider.js.map

@@ -1 +1 @@
-{"version":3,"names":["useMemo","useSnapshot","ConnectionsController","LogController","useProvider","connection","state","returnValue","adapter","provider","undefined","providerType","getProvider","getSupportedNamespace","error","sendError"],"sourceRoot":"../../../src","sources":["hooks/useProvider.ts"],"mappings":";;AAAA;AACA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,WAAW,QAAQ,QAAQ;AACpC,SAASC,qBAAqB,EAAEC,aAAa,QAAQ,iCAAiC;;AAGtF;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAmB;EAC5C,MAAM;IAAEC;EAAW,CAAC,GAAGJ,WAAW,CAACC,qBAAqB,CAACI,KAAK,CAAC;EAE/D,MAAMC,WAAW,GAAGP,OAAO,CAAC,MAAM;IAChC,IAAI,CAACK,UAAU,IAAI,CAACA,UAAU,CAACG,OAAO,EAAE;MACtC,OAAO;QAAEC,QAAQ,EAAEC,SAAS;QAAEC,YAAY,EAAED;MAAU,CAAC;IACzD;IAEA,IAAI;MACF,OAAO;QACLD,QAAQ,EAAEJ,UAAU,CAACG,OAAO,CAACI,WAAW,CAAC,CAAC;QAC1CD,YAAY,EAAEN,UAAU,CAACG,OAAO,CAACK,qBAAqB,CAAC;MACzD,CAAC;IACH,CAAC,CAAC,OAAOC,KAAK,EAAE;MACdX,aAAa,CAACY,SAAS,CAACD,KAAK,EAAE,aAAa,EAAE,aAAa,CAAC;;MAE5D;MACA,OAAO;QAAEL,QAAQ,EAAEC,SAAS;QAAEC,YAAY,EAAED;MAAU,CAAC;IACzD;EACF,CAAC,EAAE,CAACL,UAAU,CAAC,CAAC;EAEhB,OAAOE,WAAW;AACpB","ignoreList":[]}
+{"version":3,"names":["useMemo","useSnapshot","ConnectionsController","LogController","useAppKitContext","useProvider","connection","state","returnValue","adapter","provider","undefined","providerType","getProvider","getSupportedNamespace","error","sendError"],"sourceRoot":"../../../src","sources":["hooks/useProvider.ts"],"mappings":";;AAAA;AACA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,WAAW,QAAQ,QAAQ;AACpC,SAASC,qBAAqB,EAAEC,aAAa,QAAQ,iCAAiC;AAEtF,SAASC,gBAAgB,QAAQ,oBAAoB;;AAErD;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAmB;EAC5CD,gBAAgB,CAAC,CAAC;EAClB,MAAM;IAAEE;EAAW,CAAC,GAAGL,WAAW,CAACC,qBAAqB,CAACK,KAAK,CAAC;EAE/D,MAAMC,WAAW,GAAGR,OAAO,CAAC,MAAM;IAChC,IAAI,CAACM,UAAU,IAAI,CAACA,UAAU,CAACG,OAAO,EAAE;MACtC,OAAO;QAAEC,QAAQ,EAAEC,SAAS;QAAEC,YAAY,EAAED;MAAU,CAAC;IACzD;IAEA,IAAI;MACF,OAAO;QACLD,QAAQ,EAAEJ,UAAU,CAACG,OAAO,CAACI,WAAW,CAAC,CAAC;QAC1CD,YAAY,EAAEN,UAAU,CAACG,OAAO,CAACK,qBAAqB,CAAC;MACzD,CAAC;IACH,CAAC,CAAC,OAAOC,KAAK,EAAE;MACdZ,aAAa,CAACa,SAAS,CAACD,KAAK,EAAE,aAAa,EAAE,aAAa,CAAC;;MAE5D;MACA,OAAO;QAAEL,QAAQ,EAAEC,SAAS;QAAEC,YAAY,EAAED;MAAU,CAAC;IACzD;EACF,CAAC,EAAE,CAACL,UAAU,CAAC,CAAC;EAEhB,OAAOE,WAAW;AACpB","ignoreList":[]}

package/lib/module/hooks/useWalletInfo.js

@@ -3,9 +3,41 @@
 import { useMemo } from 'react';
 import { useSnapshot } from 'valtio';
 import { ConnectionsController } from '@reown/appkit-core-react-native';
-import { useAppKit } from './useAppKit';
+import { useAppKitContext } from './useAppKitContext';
+
+/**
+ * Hook to access information about the currently connected wallet
+ *
+ * @remarks
+ * This hook provides access to metadata about the connected wallet, such as its name,
+ * icon, and other identifying information. It automatically subscribes to wallet info
+ * changes via valtio.
+ *
+ * @returns An object containing:
+ *   - `walletInfo`: Metadata about the currently connected wallet (name, icon, etc.)
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { walletInfo } = useWalletInfo();
+ *
+ *   return (
+ *     <View>
+ *       {walletInfo && (
+ *         <>
+ *           <Image source={{ uri: walletInfo.icon }} />
+ *           <Text>{walletInfo.name}</Text>
+ *         </>
+ *       )}
+ *     </View>
+ *   );
+ * }
+ * ```
+ *
+ * @throws {Error} If used outside of an AppKitProvider
+ */
 export function useWalletInfo() {
-  useAppKit(); // Use the hook for checks
+  useAppKitContext();
   const {
     walletInfo: walletInfoSnapshot
   } = useSnapshot(ConnectionsController.state);

package/lib/module/hooks/useWalletInfo.js.map

@@ -1 +1 @@
-{"version":3,"names":["useMemo","useSnapshot","ConnectionsController","useAppKit","useWalletInfo","walletInfo","walletInfoSnapshot","state"],"sourceRoot":"../../../src","sources":["hooks/useWalletInfo.ts"],"mappings":";;AAAA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,WAAW,QAAQ,QAAQ;AACpC,SAASC,qBAAqB,QAAQ,iCAAiC;AACvE,SAASC,SAAS,QAAQ,aAAa;AAEvC,OAAO,SAASC,aAAaA,CAAA,EAAG;EAC9BD,SAAS,CAAC,CAAC,CAAC,CAAC;EACb,MAAM;IAAEE,UAAU,EAAEC;EAAmB,CAAC,GAAGL,WAAW,CAACC,qBAAqB,CAACK,KAAK,CAAC;EAEnF,MAAMF,UAAU,GAAGL,OAAO,CAAC,OAAO;IAAEK,UAAU,EAAEC;EAAmB,CAAC,CAAC,EAAE,CAACA,kBAAkB,CAAC,CAAC;EAE5F,OAAOD,UAAU;AACnB","ignoreList":[]}
+{"version":3,"names":["useMemo","useSnapshot","ConnectionsController","useAppKitContext","useWalletInfo","walletInfo","walletInfoSnapshot","state"],"sourceRoot":"../../../src","sources":["hooks/useWalletInfo.ts"],"mappings":";;AAAA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,WAAW,QAAQ,QAAQ;AACpC,SAASC,qBAAqB,QAAQ,iCAAiC;AACvE,SAASC,gBAAgB,QAAQ,oBAAoB;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAG;EAC9BD,gBAAgB,CAAC,CAAC;EAClB,MAAM;IAAEE,UAAU,EAAEC;EAAmB,CAAC,GAAGL,WAAW,CAACC,qBAAqB,CAACK,KAAK,CAAC;EAEnF,MAAMF,UAAU,GAAGL,OAAO,CAAC,OAAO;IAAEK,UAAU,EAAEC;EAAmB,CAAC,CAAC,EAAE,CAACA,kBAAkB,CAAC,CAAC;EAE5F,OAAOD,UAAU;AACnB","ignoreList":[]}

package/lib/module/index.js

@@ -15,6 +15,7 @@ export { AppKit } from './modal/w3m-modal';
 export { useAppKit } from './hooks/useAppKit';
 export { useProvider } from './hooks/useProvider';
 export { useAccount } from './hooks/useAccount';
+export { useAppKitTheme } from './hooks/useAppKitTheme';
 export { useWalletInfo } from './hooks/useWalletInfo';
 export { useAppKitEvents, useAppKitEventSubscription } from './hooks/useAppKitEvents';
 export { useAppKitState } from './hooks/useAppKitState';

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["AccountButton","AppKitButton","ConnectButton","NetworkButton","AppKit","useAppKit","useProvider","useAccount","useWalletInfo","useAppKitEvents","useAppKitEventSubscription","useAppKitState","useAppKitLogs","solana","solanaDevnet","solanaTestnet","bitcoin","bitcoinTestnet","ReownAuthentication","createAppKit","AppKitProvider"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,OAAO,oCAAoC;;AAE3C;AACA,SACEA,aAA8B,QAEzB,4BAA4B;AACnC,SAASC,YAAY,QAAgC,oBAAoB;AACzE,SACEC,aAA8B,QAEzB,4BAA4B;AACnC,SACEC,aAA8B,QAEzB,4BAA4B;AACnC,SAASC,MAAM,QAAQ,mBAAmB;;AAE1C;;AAYA;AACA,SAASC,SAAS,QAAQ,mBAAmB;AAC7C,SAASC,WAAW,QAAQ,qBAAqB;AACjD,SAASC,UAAU,QAA0C,oBAAoB;AACjF,SAASC,aAAa,QAAQ,uBAAuB;AACrD,SAASC,eAAe,EAAEC,0BAA0B,QAAQ,yBAAyB;AACrF,SAASC,cAAc,QAAQ,wBAAwB;AACvD,SAASC,aAAa,QAAkC,uBAAuB;;AAE/E;AACA,SAASC,MAAM,EAAEC,YAAY,EAAEC,aAAa,QAAQ,mCAAmC;AACvF,SAASC,OAAO,EAAEC,cAAc,QAAQ,mCAAmC;;AAE3E;AACA,SAASC,mBAAmB,QAAQ,iCAAiC;;AAErE;AACA,SAASC,YAAY,QAAQ,UAAU;AACvC,SAASC,cAAc,QAAQ,iBAAiB","ignoreList":[]}
+{"version":3,"names":["AccountButton","AppKitButton","ConnectButton","NetworkButton","AppKit","useAppKit","useProvider","useAccount","useAppKitTheme","useWalletInfo","useAppKitEvents","useAppKitEventSubscription","useAppKitState","useAppKitLogs","solana","solanaDevnet","solanaTestnet","bitcoin","bitcoinTestnet","ReownAuthentication","createAppKit","AppKitProvider"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,OAAO,oCAAoC;;AAE3C;AACA,SACEA,aAA8B,QAEzB,4BAA4B;AACnC,SAASC,YAAY,QAAgC,oBAAoB;AACzE,SACEC,aAA8B,QAEzB,4BAA4B;AACnC,SACEC,aAA8B,QAEzB,4BAA4B;AACnC,SAASC,MAAM,QAAQ,mBAAmB;;AAE1C;;AAYA;AACA,SAASC,SAAS,QAAQ,mBAAmB;AAC7C,SAASC,WAAW,QAAQ,qBAAqB;AACjD,SAASC,UAAU,QAA0C,oBAAoB;AACjF,SAASC,cAAc,QAAmC,wBAAwB;AAClF,SAASC,aAAa,QAAQ,uBAAuB;AACrD,SAASC,eAAe,EAAEC,0BAA0B,QAAQ,yBAAyB;AACrF,SAASC,cAAc,QAAQ,wBAAwB;AACvD,SAASC,aAAa,QAAkC,uBAAuB;;AAE/E;AACA,SAASC,MAAM,EAAEC,YAAY,EAAEC,aAAa,QAAQ,mCAAmC;AACvF,SAASC,OAAO,EAAEC,cAAc,QAAQ,mCAAmC;;AAE3E;AACA,SAASC,mBAAmB,QAAQ,iCAAiC;;AAErE;AACA,SAASC,YAAY,QAAQ,UAAU;AACvC,SAASC,cAAc,QAAQ,iBAAiB","ignoreList":[]}

package/lib/typescript/AppKitContext.d.ts

@@ -1,6 +1,6 @@
 import React, { type ReactNode } from 'react';
 import { AppKit } from './AppKit';
-interface AppKitContextType {
+export interface AppKitContextType {
     appKit: AppKit | null;
 }
 export declare const AppKitContext: React.Context<AppKitContextType>;

package/lib/typescript/AppKitContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppKitContext.d.ts","sourceRoot":"","sources":["../../src/AppKitContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,kCAAqD,CAAC;AAEhF,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAExD,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;CA4B7B,CAAC"}
+{"version":3,"file":"AppKitContext.d.ts","sourceRoot":"","sources":["../../src/AppKitContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,eAAO,MAAM,aAAa,kCAAqD,CAAC;AAEhF,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAExD,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;CA4B7B,CAAC"}

package/lib/typescript/hooks/useAccount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAccount.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAccount.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,UAAU;;;;;;;EAsDzB"}
+{"version":3,"file":"useAccount.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAccount.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAGpF;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,UAAU;;;;;;;EAsDzB"}

package/lib/typescript/hooks/useAppKit.d.ts

@@ -1,11 +1,53 @@
 import type { ChainNamespace } from '@reown/appkit-common-react-native';
 import type { AppKit } from '../AppKit';
+/**
+ * Interface representing the return value of the useAppKit hook
+ */
 interface UseAppKitReturn {
+    /** Function to open the AppKit modal with optional view configuration */
     open: AppKit['open'];
+    /** Function to close the AppKit modal */
     close: AppKit['close'];
+    /** Function to disconnect the wallet, optionally scoped to a specific namespace */
     disconnect: (namespace?: ChainNamespace) => void;
+    /** Function to switch to a different network */
     switchNetwork: AppKit['switchNetwork'];
 }
+/**
+ * Hook to access core AppKit functionality for controlling the modal
+ *
+ * @remarks
+ * This hook provides access to the main AppKit instance methods for opening/closing
+ * the modal, disconnecting wallets, and switching networks. All functions are memoized
+ * and properly bound to ensure stable references across renders.
+ *
+ * @returns {UseAppKitReturn} An object containing:
+ *   - `open`: Opens the AppKit modal, optionally with a specific view
+ *   - `close`: Closes the AppKit modal
+ *   - `disconnect`: Disconnects the current wallet connection (optionally for a specific namespace)
+ *   - `switchNetwork`: Switches to a different blockchain network
+ *
+ * @throws {Error} If used outside of an AppKitProvider
+ * @throws {Error} If AppKit instance is not available in context
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { open, close, disconnect, switchNetwork } = useAppKit();
+ *
+ *   return (
+ *     <View>
+ *       <Button onPress={() => open()} title="Connect Wallet" />
+ *       <Button onPress={() => disconnect()} title="Disconnect" />
+ *       <Button
+ *         onPress={() => switchNetwork('eip155:1')}
+ *         title="Switch to Ethereum"
+ *       />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
 export declare const useAppKit: () => UseAppKitReturn;
 export {};
 //# sourceMappingURL=useAppKit.d.ts.map

package/lib/typescript/hooks/useAppKit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAppKit.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACjD,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,SAAS,QAAO,eA2B5B,CAAC"}
+{"version":3,"file":"useAppKit.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC;;GAEG;AACH,UAAU,eAAe;IACvB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,mFAAmF;IACnF,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACjD,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,SAAS,QAAO,eAkB5B,CAAC"}

package/lib/typescript/hooks/useAppKitContext.d.ts

@@ -0,0 +1,27 @@
+import { type AppKitContextType } from '../AppKitContext';
+/**
+ * Hook to access the AppKit context
+ *
+ * @remarks
+ * This is an internal hook used by other AppKit hooks to ensure they're used within
+ * the AppKitProvider. You typically don't need to use this hook directly - use the
+ * higher-level hooks like `useAppKit`, `useAccount`, `useAppKitTheme`, etc. instead.
+ *
+ * @returns {AppKitContextType} The AppKit context containing the AppKit instance
+ *
+ * @throws {Error} If used outside of an AppKitProvider
+ * @throws {Error} If the AppKit instance is not yet available in context
+ *
+ * @internal
+ *
+ * @example
+ * ```tsx
+ * // This is typically used internally by other hooks
+ * function MyCustomHook() {
+ *   const context = useAppKitContext();
+ *   // Use context.appKit...
+ * }
+ * ```
+ */
+export declare const useAppKitContext: () => AppKitContextType;
+//# sourceMappingURL=useAppKitContext.d.ts.map

package/lib/typescript/hooks/useAppKitContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppKitContext.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKitContext.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,eAAO,MAAM,gBAAgB,QAAO,iBAanC,CAAC"}

package/lib/typescript/hooks/useAppKitEvents.d.ts

@@ -1,5 +1,37 @@
 import { type EventsControllerState } from '@reown/appkit-core-react-native';
 import { type EventName } from '@reown/appkit-common-react-native';
+/**
+ * Hook to subscribe to all AppKit events
+ *
+ * @remarks
+ * This hook provides reactive access to AppKit's event system, allowing you to
+ * monitor all events that occur within the AppKit lifecycle (connections, disconnections,
+ * network changes, etc.). The callback is invoked whenever a new event is emitted.
+ *
+ * @param callback - Optional callback function invoked when any event occurs
+ *
+ * @returns An object containing:
+ *   - `data`: The most recent event data
+ *   - `timestamp`: The timestamp of the most recent event
+ *
+ * @throws {Error} If used outside of an AppKitProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { data, timestamp } = useAppKitEvents((event) => {
+ *     console.log('Event occurred:', event.data.event);
+ *   });
+ *
+ *   return (
+ *     <View>
+ *       <Text>Last event: {data?.event}</Text>
+ *       <Text>Time: {timestamp}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
 export declare function useAppKitEvents(callback?: (newEvent: EventsControllerState) => void): {
     data: {
         readonly type: "track";
@@ -371,5 +403,32 @@ export declare function useAppKitEvents(callback?: (newEvent: EventsControllerSt
     };
     timestamp: number;
 };
+/**
+ * Hook to subscribe to a specific AppKit event
+ *
+ * @remarks
+ * This hook allows you to listen for a specific event type rather than all events.
+ * It's more efficient than `useAppKitEvents` when you only care about a particular event.
+ *
+ * @param event - The specific event name to subscribe to (e.g., 'MODAL_OPEN', 'CONNECT_SUCCESS')
+ * @param callback - Callback function invoked when the specified event occurs
+ *
+ * @throws {Error} If used outside of an AppKitProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   useAppKitEventSubscription('CONNECT_SUCCESS', (event) => {
+ *     console.log('Wallet connected!', event.data);
+ *   });
+ *
+ *   useAppKitEventSubscription('DISCONNECT_SUCCESS', (event) => {
+ *     console.log('Wallet disconnected!', event.data);
+ *   });
+ *
+ *   return <View>{/ Your component /}</View>;
+ * }
+ * ```
+ */
 export declare function useAppKitEventSubscription(event: EventName, callback: (newEvent: EventsControllerState) => void): void;
 //# sourceMappingURL=useAppKitEvents.d.ts.map

package/lib/typescript/hooks/useAppKitEvents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAppKitEvents.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKitEvents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAGnE,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAenF;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,QAWpD"}
+{"version":3,"file":"useAppKitEvents.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKitEvents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAGnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAenF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,QAWpD"}

package/lib/typescript/hooks/useAppKitLogs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAppKitLogs.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKitLogs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG9F,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,QAAQ,EAAE,CAAC;IAEjB;;OAEG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC;IAEhD;;OAEG;IACH,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;IAE9C;;OAEG;IACH,UAAU,EAAE,MAAM,MAAM,CAAC;IAEzB;;OAEG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE7C;;OAEG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;IAEtB;;OAEG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa,QAAO,mBA8DhC,CAAC"}
+{"version":3,"file":"useAppKitLogs.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKitLogs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG9F,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,QAAQ,EAAE,CAAC;IAEjB;;OAEG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,QAAQ,EAAE,CAAC;IAEhD;;OAEG;IACH,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;IAE9C;;OAEG;IACH,UAAU,EAAE,MAAM,MAAM,CAAC;IAEzB;;OAEG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE7C;;OAEG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;IAEtB;;OAEG;IACH,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa,QAAO,mBAsDhC,CAAC"}

package/lib/typescript/hooks/useAppKitState.d.ts

@@ -1,3 +1,35 @@
+/**
+ * Hook to access the overall state of the AppKit modal and connection
+ *
+ * @remarks
+ * This hook provides a high-level view of the AppKit's current state, including
+ * whether the modal is open, if it's loading, connection status, and the active chain.
+ * It's useful for coordinating UI elements with the AppKit's state.
+ *
+ * @returns An object containing:
+ *   - `isOpen`: Whether the AppKit modal is currently open
+ *   - `isLoading`: Whether the AppKit is in a loading state
+ *   - `isConnected`: Whether a wallet is currently connected
+ *   - `chain`: The currently active blockchain network
+ *
+ * @throws {Error} If used outside of an AppKitProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { isOpen, isLoading, isConnected, chain } = useAppKitState();
+ *
+ *   return (
+ *     <View>
+ *       <Text>Modal: {isOpen ? 'Open' : 'Closed'}</Text>
+ *       <Text>Loading: {isLoading ? 'Yes' : 'No'}</Text>
+ *       <Text>Connected: {isConnected ? 'Yes' : 'No'}</Text>
+ *       {chain && <Text>Chain: {chain.name}</Text>}
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
 export declare function useAppKitState(): {
     isOpen: boolean;
     isLoading: boolean;

package/lib/typescript/hooks/useAppKitState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAppKitState.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKitState.ts"],"names":[],"mappings":"AAMA,wBAAgB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB7B"}
+{"version":3,"file":"useAppKitState.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKitState.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,wBAAgB,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB7B"}

package/lib/typescript/hooks/useAppKitTheme.d.ts

@@ -2,7 +2,7 @@ import type { ThemeMode, ThemeVariables } from '@reown/appkit-common-react-nativ
 /**
  * Interface representing the result of the useAppKitTheme hook
  */
-interface UseAppKitThemeReturn {
+export interface UseAppKitThemeReturn {
     /** The current theme mode ('dark' or 'light'), or undefined if using system default */
     themeMode: ThemeMode | undefined;
     /** The current theme variables, currently only supports 'accent' color */
@@ -56,5 +56,4 @@ interface UseAppKitThemeReturn {
  * ```
  */
 export declare function useAppKitTheme(): UseAppKitThemeReturn;
-export {};
 //# sourceMappingURL=useAppKitTheme.d.ts.map

package/lib/typescript/hooks/useAppKitTheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAppKitTheme.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKitTheme.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAInF;;GAEG;AACH,UAAU,oBAAoB;IAC5B,uFAAuF;IACvF,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,0EAA0E;IAC1E,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,qCAAqC;IACrC,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IACzD,sCAAsC;IACtC,iBAAiB,EAAE,CAAC,cAAc,EAAE,cAAc,GAAG,SAAS,KAAK,IAAI,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CAiBrD"}
+{"version":3,"file":"useAppKitTheme.d.ts","sourceRoot":"","sources":["../../../src/hooks/useAppKitTheme.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAInF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uFAAuF;IACvF,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,0EAA0E;IAC1E,cAAc,EAAE,cAAc,GAAG,SAAS,CAAC;IAC3C,qCAAqC;IACrC,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IACzD,sCAAsC;IACtC,iBAAiB,EAAE,CAAC,cAAc,EAAE,cAAc,GAAG,SAAS,KAAK,IAAI,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CAiBrD"}