@n1xyz/wallet-widget 0.0.34 → 0.0.35-alpha.1

package/dist/src/providers/N1WalletProvider/SigningProvider.js

@@ -0,0 +1,134 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, } from 'react';
+import { useWalletStore, getWalletActions } from '../../store';
+// ---------------------------------------------------------------------------
+// Context
+// ---------------------------------------------------------------------------
+var SigningContext = createContext(null);
+// ---------------------------------------------------------------------------
+// Hooks
+// ---------------------------------------------------------------------------
+/**
+ * Hook to access signing state and actions.
+ * Must be used within a SigningProvider.
+ */
+export function useSigning() {
+    var context = useContext(SigningContext);
+    if (!context) {
+        throw new Error('useSigning must be used within a SigningProvider');
+    }
+    return context;
+}
+/**
+ * Hook to access signing functions only (no setters).
+ * Useful for components that only need to sign.
+ */
+export function useSigningState() {
+    var _a = useSigning(), signMessageWithSessionKey = _a.signMessageWithSessionKey, signMessageWithWalletKey = _a.signMessageWithWalletKey, signTransactionWithWalletKey = _a.signTransactionWithWalletKey;
+    return {
+        signMessageWithSessionKey: signMessageWithSessionKey,
+        signMessageWithWalletKey: signMessageWithWalletKey,
+        signTransactionWithWalletKey: signTransactionWithWalletKey,
+    };
+}
+/**
+ * Hook to access signing setters only (no functions).
+ * Useful for components that register signing functions.
+ */
+export function useSigningActions() {
+    var _a = useSigning(), setSignMessageWithSessionKey = _a.setSignMessageWithSessionKey, setSignMessageWithWalletKey = _a.setSignMessageWithWalletKey, setSignTransactionWithWalletKey = _a.setSignTransactionWithWalletKey;
+    return {
+        setSignMessageWithSessionKey: setSignMessageWithSessionKey,
+        setSignMessageWithWalletKey: setSignMessageWithWalletKey,
+        setSignTransactionWithWalletKey: setSignTransactionWithWalletKey,
+    };
+}
+// ---------------------------------------------------------------------------
+// Provider
+// ---------------------------------------------------------------------------
+/**
+ * SigningProvider manages signing functions for wallet operations.
+ *
+ * Uses clean Zustand approach - reads/writes directly from store.
+ *
+ * Responsibilities:
+ * - Store and provide signing functions
+ * - Support session key signing
+ * - Support wallet key signing (messages and transactions)
+ *
+ * Does NOT handle:
+ * - Modal state
+ * - Network/chain state
+ * - Session/authentication state
+ * - Theming
+ */
+export function SigningProvider(_a) {
+    // -------------------------------------------------------------------------
+    // State from Store (individual selectors for optimal re-renders)
+    // -------------------------------------------------------------------------
+    var children = _a.children;
+    var signMessageWithSessionKey = useWalletStore(function (state) { return state.signing.signMessageWithSessionKey; });
+    var signMessageWithWalletKey = useWalletStore(function (state) { return state.signing.signMessageWithWalletKey; });
+    var signTransactionWithWalletKey = useWalletStore(function (state) { return state.signing.signTransactionWithWalletKey; });
+    // -------------------------------------------------------------------------
+    // Store Actions (stable references via getWalletActions)
+    // -------------------------------------------------------------------------
+    var storeActions = getWalletActions().signing;
+    // -------------------------------------------------------------------------
+    // Action Wrappers (compatible with React.Dispatch signature)
+    // -------------------------------------------------------------------------
+    var setSignMessageWithSessionKey = useCallback(function (valueOrUpdater) {
+        if (typeof valueOrUpdater === 'function') {
+            var currentValue = useWalletStore.getState().signing.signMessageWithSessionKey;
+            storeActions.setSignMessageWithSessionKey(valueOrUpdater(currentValue));
+        }
+        else {
+            storeActions.setSignMessageWithSessionKey(valueOrUpdater);
+        }
+    }, [storeActions]);
+    var setSignMessageWithWalletKey = useCallback(function (valueOrUpdater) {
+        if (typeof valueOrUpdater === 'function') {
+            var currentValue = useWalletStore.getState().signing.signMessageWithWalletKey;
+            storeActions.setSignMessageWithWalletKey(valueOrUpdater(currentValue));
+        }
+        else {
+            storeActions.setSignMessageWithWalletKey(valueOrUpdater);
+        }
+    }, [storeActions]);
+    var setSignTransactionWithWalletKey = useCallback(function (valueOrUpdater) {
+        if (typeof valueOrUpdater === 'function') {
+            var currentValue = useWalletStore.getState().signing.signTransactionWithWalletKey;
+            storeActions.setSignTransactionWithWalletKey(valueOrUpdater(currentValue));
+        }
+        else {
+            storeActions.setSignTransactionWithWalletKey(valueOrUpdater);
+        }
+    }, [storeActions]);
+    // -------------------------------------------------------------------------
+    // Context Value
+    // -------------------------------------------------------------------------
+    var value = useMemo(function () { return ({
+        // State
+        signMessageWithSessionKey: signMessageWithSessionKey,
+        signMessageWithWalletKey: signMessageWithWalletKey,
+        signTransactionWithWalletKey: signTransactionWithWalletKey,
+        // Actions
+        setSignMessageWithSessionKey: setSignMessageWithSessionKey,
+        setSignMessageWithWalletKey: setSignMessageWithWalletKey,
+        setSignTransactionWithWalletKey: setSignTransactionWithWalletKey,
+    }); }, [
+        signMessageWithSessionKey,
+        signMessageWithWalletKey,
+        signTransactionWithWalletKey,
+        setSignMessageWithSessionKey,
+        setSignMessageWithWalletKey,
+        setSignTransactionWithWalletKey,
+    ]);
+    return _jsx(SigningContext.Provider, { value: value, children: children });
+}
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+export { SigningContext };
+//# sourceMappingURL=SigningProvider.js.map

package/dist/src/providers/N1WalletProvider/SigningProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SigningProvider.js","sourceRoot":"","sources":["../../../../src/providers/N1WalletProvider/SigningProvider.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n} from 'react';\nimport { useWalletStore, getWalletActions, WalletStore } from '../../store';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Generic signing function type */\nexport type SigningFunction<T = unknown, R = unknown> = ((input: T) => Promise<R>) | null;\n\nexport interface SigningState {\n  /** Function to sign messages with the session key */\n  signMessageWithSessionKey: SigningFunction;\n  /** Function to sign messages with the wallet key */\n  signMessageWithWalletKey: SigningFunction;\n  /** Function to sign transactions with the wallet key */\n  signTransactionWithWalletKey: SigningFunction;\n}\n\nexport interface SigningActions {\n  /** Set the session key signing function */\n  setSignMessageWithSessionKey: React.Dispatch<React.SetStateAction<SigningFunction>>;\n  /** Set the wallet key message signing function */\n  setSignMessageWithWalletKey: React.Dispatch<React.SetStateAction<SigningFunction>>;\n  /** Set the wallet key transaction signing function */\n  setSignTransactionWithWalletKey: React.Dispatch<React.SetStateAction<SigningFunction>>;\n}\n\nexport interface SigningContextValue extends SigningState, SigningActions { }\n\nexport interface SigningProviderProps {\n  children: React.ReactNode;\n}\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\nconst SigningContext = createContext<SigningContextValue | null>(null);\n\n// ---------------------------------------------------------------------------\n// Hooks\n// ---------------------------------------------------------------------------\n\n/**\n * Hook to access signing state and actions.\n * Must be used within a SigningProvider.\n */\nexport function useSigning(): SigningContextValue {\n  const context = useContext(SigningContext);\n  if (!context) {\n    throw new Error('useSigning must be used within a SigningProvider');\n  }\n  return context;\n}\n\n/**\n * Hook to access signing functions only (no setters).\n * Useful for components that only need to sign.\n */\nexport function useSigningState(): SigningState {\n  const {\n    signMessageWithSessionKey,\n    signMessageWithWalletKey,\n    signTransactionWithWalletKey,\n  } = useSigning();\n\n  return {\n    signMessageWithSessionKey,\n    signMessageWithWalletKey,\n    signTransactionWithWalletKey,\n  };\n}\n\n/**\n * Hook to access signing setters only (no functions).\n * Useful for components that register signing functions.\n */\nexport function useSigningActions(): SigningActions {\n  const {\n    setSignMessageWithSessionKey,\n    setSignMessageWithWalletKey,\n    setSignTransactionWithWalletKey,\n  } = useSigning();\n\n  return {\n    setSignMessageWithSessionKey,\n    setSignMessageWithWalletKey,\n    setSignTransactionWithWalletKey,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\n/**\n * SigningProvider manages signing functions for wallet operations.\n *\n * Uses clean Zustand approach - reads/writes directly from store.\n *\n * Responsibilities:\n * - Store and provide signing functions\n * - Support session key signing\n * - Support wallet key signing (messages and transactions)\n *\n * Does NOT handle:\n * - Modal state\n * - Network/chain state\n * - Session/authentication state\n * - Theming\n */\nexport function SigningProvider({ children }: SigningProviderProps) {\n  // -------------------------------------------------------------------------\n  // State from Store (individual selectors for optimal re-renders)\n  // -------------------------------------------------------------------------\n\n  const signMessageWithSessionKey = useWalletStore((state: WalletStore) => state.signing.signMessageWithSessionKey);\n  const signMessageWithWalletKey = useWalletStore((state: WalletStore) => state.signing.signMessageWithWalletKey);\n  const signTransactionWithWalletKey = useWalletStore((state: WalletStore) => state.signing.signTransactionWithWalletKey);\n\n  // -------------------------------------------------------------------------\n  // Store Actions (stable references via getWalletActions)\n  // -------------------------------------------------------------------------\n\n  const storeActions = getWalletActions().signing;\n\n  // -------------------------------------------------------------------------\n  // Action Wrappers (compatible with React.Dispatch signature)\n  // -------------------------------------------------------------------------\n\n  const setSignMessageWithSessionKey = useCallback<React.Dispatch<React.SetStateAction<SigningFunction>>>(\n    (valueOrUpdater) => {\n      if (typeof valueOrUpdater === 'function') {\n        const currentValue = useWalletStore.getState().signing.signMessageWithSessionKey;\n        storeActions.setSignMessageWithSessionKey(valueOrUpdater(currentValue) as SigningFunction);\n      } else {\n        storeActions.setSignMessageWithSessionKey(valueOrUpdater);\n      }\n    },\n    [storeActions]\n  );\n\n  const setSignMessageWithWalletKey = useCallback<React.Dispatch<React.SetStateAction<SigningFunction>>>(\n    (valueOrUpdater) => {\n      if (typeof valueOrUpdater === 'function') {\n        const currentValue = useWalletStore.getState().signing.signMessageWithWalletKey;\n        storeActions.setSignMessageWithWalletKey(valueOrUpdater(currentValue) as SigningFunction);\n      } else {\n        storeActions.setSignMessageWithWalletKey(valueOrUpdater);\n      }\n    },\n    [storeActions]\n  );\n\n  const setSignTransactionWithWalletKey = useCallback<React.Dispatch<React.SetStateAction<SigningFunction>>>(\n    (valueOrUpdater) => {\n      if (typeof valueOrUpdater === 'function') {\n        const currentValue = useWalletStore.getState().signing.signTransactionWithWalletKey;\n        storeActions.setSignTransactionWithWalletKey(valueOrUpdater(currentValue) as SigningFunction);\n      } else {\n        storeActions.setSignTransactionWithWalletKey(valueOrUpdater);\n      }\n    },\n    [storeActions]\n  );\n\n  // -------------------------------------------------------------------------\n  // Context Value\n  // -------------------------------------------------------------------------\n\n  const value = useMemo<SigningContextValue>(\n    () => ({\n      // State\n      signMessageWithSessionKey,\n      signMessageWithWalletKey,\n      signTransactionWithWalletKey,\n      // Actions\n      setSignMessageWithSessionKey,\n      setSignMessageWithWalletKey,\n      setSignTransactionWithWalletKey,\n    }),\n    [\n      signMessageWithSessionKey,\n      signMessageWithWalletKey,\n      signTransactionWithWalletKey,\n      setSignMessageWithSessionKey,\n      setSignMessageWithWalletKey,\n      setSignTransactionWithWalletKey,\n    ]\n  );\n\n  return <SigningContext.Provider value={value}>{children}</SigningContext.Provider>;\n}\n\n// ---------------------------------------------------------------------------\n// Exports\n// ---------------------------------------------------------------------------\n\nexport { SigningContext };\n"]}

package/dist/src/providers/N1WalletProvider/ThemingProvider.d.ts

@@ -0,0 +1,50 @@
+import React from 'react';
+export interface ColorOverride {
+    color: string;
+    replacement: string;
+}
+export interface ThemingState {
+    /** The processed CSS with color overrides applied (without @font-face rules) */
+    injectedCss: string;
+    /** The original color overrides */
+    colorOverrides: ColorOverride[];
+}
+export interface ThemingContextValue extends ThemingState {
+}
+export interface ThemingProviderProps {
+    children: React.ReactNode;
+    /** Color overrides to apply to the CSS */
+    colorOverrides?: ColorOverride[];
+}
+declare const ThemingContext: React.Context<ThemingContextValue | null>;
+/**
+ * Hook to access theming state.
+ * Must be used within a ThemingProvider.
+ */
+export declare function useTheming(): ThemingContextValue;
+/**
+ * Hook to get the processed CSS string.
+ * Convenience hook for components that only need the CSS.
+ */
+export declare function useInjectedCss(): string;
+/**
+ * ThemingProvider manages CSS injection and color overrides.
+ *
+ * NOTE: This provider's state comes from props (not internal state).
+ * The store is synced for external observers but props are the source of truth.
+ * We don't subscribe to the store (no useWalletStore) to avoid infinite loops.
+ *
+ * Responsibilities:
+ * - Process base CSS with color overrides
+ * - Provide processed CSS to components
+ * - Handle theme customization
+ * - Sync to store for external access
+ *
+ * Does NOT handle:
+ * - Modal state
+ * - Network/chain state
+ * - Session/authentication state
+ * - Signing functions
+ */
+export declare function ThemingProvider({ children, colorOverrides }: ThemingProviderProps): import("react/jsx-runtime").JSX.Element;
+export { ThemingContext };

package/dist/src/providers/N1WalletProvider/ThemingProvider.js

@@ -0,0 +1,102 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, } from 'react';
+import mainCss from '../../styles/embedded-main-css';
+import { getWalletActions } from '../../store';
+// ---------------------------------------------------------------------------
+// Context
+// ---------------------------------------------------------------------------
+var ThemingContext = createContext(null);
+// ---------------------------------------------------------------------------
+// Hooks
+// ---------------------------------------------------------------------------
+/**
+ * Hook to access theming state.
+ * Must be used within a ThemingProvider.
+ */
+export function useTheming() {
+    var context = useContext(ThemingContext);
+    if (!context) {
+        throw new Error('useTheming must be used within a ThemingProvider');
+    }
+    return context;
+}
+/**
+ * Hook to get the processed CSS string.
+ * Convenience hook for components that only need the CSS.
+ */
+export function useInjectedCss() {
+    return useTheming().injectedCss;
+}
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+/**
+ * Apply color overrides to the base CSS string.
+ * Replaces all instances of each color with its replacement (case-insensitive).
+ */
+function applyColorOverrides(baseCss, overrides) {
+    if (!Array.isArray(overrides) || overrides.length === 0) {
+        return baseCss;
+    }
+    var result = baseCss;
+    overrides.forEach(function (_a) {
+        var color = _a.color, replacement = _a.replacement;
+        if (color && replacement) {
+            // Escape special regex characters and replace all instances case-insensitively
+            var regex = new RegExp(color.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi');
+            result = result.replace(regex, replacement);
+        }
+    });
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Provider
+// ---------------------------------------------------------------------------
+/**
+ * ThemingProvider manages CSS injection and color overrides.
+ *
+ * NOTE: This provider's state comes from props (not internal state).
+ * The store is synced for external observers but props are the source of truth.
+ * We don't subscribe to the store (no useWalletStore) to avoid infinite loops.
+ *
+ * Responsibilities:
+ * - Process base CSS with color overrides
+ * - Provide processed CSS to components
+ * - Handle theme customization
+ * - Sync to store for external access
+ *
+ * Does NOT handle:
+ * - Modal state
+ * - Network/chain state
+ * - Session/authentication state
+ * - Signing functions
+ */
+export function ThemingProvider(_a) {
+    // -------------------------------------------------------------------------
+    // Derived State (from props - props are source of truth)
+    // -------------------------------------------------------------------------
+    var children = _a.children, _b = _a.colorOverrides, colorOverrides = _b === void 0 ? [] : _b;
+    var injectedCss = useMemo(function () { return applyColorOverrides(mainCss, colorOverrides); }, [colorOverrides]);
+    // -------------------------------------------------------------------------
+    // Store Sync (write-only, no subscription to avoid infinite loop)
+    // -------------------------------------------------------------------------
+    var storeActions = getWalletActions().config;
+    useEffect(function () {
+        storeActions.setInjectedCss(injectedCss);
+        storeActions.setColorOverrides(colorOverrides);
+    }, [injectedCss, colorOverrides, storeActions]);
+    // -------------------------------------------------------------------------
+    // Context Value
+    // -------------------------------------------------------------------------
+    var value = useMemo(function () { return ({
+        injectedCss: injectedCss,
+        colorOverrides: colorOverrides,
+    }); }, [injectedCss, colorOverrides]);
+    return _jsx(ThemingContext.Provider, { value: value, children: children });
+}
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+export { ThemingContext };
+//# sourceMappingURL=ThemingProvider.js.map

package/dist/src/providers/N1WalletProvider/ThemingProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemingProvider.js","sourceRoot":"","sources":["../../../../src/providers/N1WalletProvider/ThemingProvider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,OAAO,GACR,MAAM,OAAO,CAAC;AACf,OAAO,OAAO,MAAM,gCAAgC,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA0B/C,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,IAAM,cAAc,GAAG,aAAa,CAA6B,IAAI,CAAC,CAAC;AAEvE,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,IAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,EAAE,CAAC,WAAW,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,mBAAmB,CAAC,OAAe,EAAE,SAA0B;IACtE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,GAAG,OAAO,CAAC;IACrB,SAAS,CAAC,OAAO,CAAC,UAAC,EAAsB;YAApB,KAAK,WAAA,EAAE,WAAW,iBAAA;QACrC,IAAI,KAAK,IAAI,WAAW,EAAE,CAAC;YACzB,+EAA+E;YAC/E,IAAM,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;YAC7E,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAAC,EAAuD;IACrF,4EAA4E;IAC5E,yDAAyD;IACzD,4EAA4E;QAH5C,QAAQ,cAAA,EAAE,sBAAmB,EAAnB,cAAc,mBAAG,EAAE,KAAA;IAK7D,IAAM,WAAW,GAAG,OAAO,CACzB,cAAM,OAAA,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,EAA5C,CAA4C,EAClD,CAAC,cAAc,CAAC,CACjB,CAAC;IAEF,4EAA4E;IAC5E,kEAAkE;IAClE,4EAA4E;IAE5E,IAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC,MAAM,CAAC;IAE/C,SAAS,CAAC;QACR,YAAY,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACzC,YAAY,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC;IAEhD,4EAA4E;IAC5E,gBAAgB;IAChB,4EAA4E;IAE5E,IAAM,KAAK,GAAG,OAAO,CACnB,cAAM,OAAA,CAAC;QACL,WAAW,aAAA;QACX,cAAc,gBAAA;KACf,CAAC,EAHI,CAGJ,EACF,CAAC,WAAW,EAAE,cAAc,CAAC,CAC9B,CAAC;IAEF,OAAO,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA2B,CAAC;AACrF,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["'use client';\n\nimport React, {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n} from 'react';\nimport mainCss from '../../styles/embedded-main-css';\nimport { getWalletActions } from '../../store';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface ColorOverride {\n  color: string;\n  replacement: string;\n}\n\nexport interface ThemingState {\n  /** The processed CSS with color overrides applied (without @font-face rules) */\n  injectedCss: string;\n  /** The original color overrides */\n  colorOverrides: ColorOverride[];\n}\n\nexport interface ThemingContextValue extends ThemingState {}\n\nexport interface ThemingProviderProps {\n  children: React.ReactNode;\n  /** Color overrides to apply to the CSS */\n  colorOverrides?: ColorOverride[];\n}\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\nconst ThemingContext = createContext<ThemingContextValue | null>(null);\n\n// ---------------------------------------------------------------------------\n// Hooks\n// ---------------------------------------------------------------------------\n\n/**\n * Hook to access theming state.\n * Must be used within a ThemingProvider.\n */\nexport function useTheming(): ThemingContextValue {\n  const context = useContext(ThemingContext);\n  if (!context) {\n    throw new Error('useTheming must be used within a ThemingProvider');\n  }\n  return context;\n}\n\n/**\n * Hook to get the processed CSS string.\n * Convenience hook for components that only need the CSS.\n */\nexport function useInjectedCss(): string {\n  return useTheming().injectedCss;\n}\n\n// ---------------------------------------------------------------------------\n// Helper\n// ---------------------------------------------------------------------------\n\n/**\n * Apply color overrides to the base CSS string.\n * Replaces all instances of each color with its replacement (case-insensitive).\n */\nfunction applyColorOverrides(baseCss: string, overrides: ColorOverride[]): string {\n  if (!Array.isArray(overrides) || overrides.length === 0) {\n    return baseCss;\n  }\n\n  let result = baseCss;\n  overrides.forEach(({ color, replacement }) => {\n    if (color && replacement) {\n      // Escape special regex characters and replace all instances case-insensitively\n      const regex = new RegExp(color.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'), 'gi');\n      result = result.replace(regex, replacement);\n    }\n  });\n\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\n/**\n * ThemingProvider manages CSS injection and color overrides.\n *\n * NOTE: This provider's state comes from props (not internal state).\n * The store is synced for external observers but props are the source of truth.\n * We don't subscribe to the store (no useWalletStore) to avoid infinite loops.\n *\n * Responsibilities:\n * - Process base CSS with color overrides\n * - Provide processed CSS to components\n * - Handle theme customization\n * - Sync to store for external access\n *\n * Does NOT handle:\n * - Modal state\n * - Network/chain state\n * - Session/authentication state\n * - Signing functions\n */\nexport function ThemingProvider({ children, colorOverrides = [] }: ThemingProviderProps) {\n  // -------------------------------------------------------------------------\n  // Derived State (from props - props are source of truth)\n  // -------------------------------------------------------------------------\n\n  const injectedCss = useMemo(\n    () => applyColorOverrides(mainCss, colorOverrides),\n    [colorOverrides]\n  );\n\n  // -------------------------------------------------------------------------\n  // Store Sync (write-only, no subscription to avoid infinite loop)\n  // -------------------------------------------------------------------------\n\n  const storeActions = getWalletActions().config;\n\n  useEffect(() => {\n    storeActions.setInjectedCss(injectedCss);\n    storeActions.setColorOverrides(colorOverrides);\n  }, [injectedCss, colorOverrides, storeActions]);\n\n  // -------------------------------------------------------------------------\n  // Context Value\n  // -------------------------------------------------------------------------\n\n  const value = useMemo<ThemingContextValue>(\n    () => ({\n      injectedCss,\n      colorOverrides,\n    }),\n    [injectedCss, colorOverrides]\n  );\n\n  return <ThemingContext.Provider value={value}>{children}</ThemingContext.Provider>;\n}\n\n// ---------------------------------------------------------------------------\n// Exports\n// ---------------------------------------------------------------------------\n\nexport { ThemingContext };\n"]}

package/dist/src/providers/N1WalletProvider/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * N1WalletProvider sub-providers
+ *
+ * These providers split the monolithic N1WalletProvider into focused,
+ * single-responsibility providers for better maintainability and testing.
+ *
+ * Provider hierarchy:
+ * - ThemingProvider: CSS injection, color overrides (outermost)
+ * - NetworkProvider: Wallet network, chain, address normalization
+ * - SessionProvider: Session keys, nordUser, authentication state
+ * - SigningProvider: Signing functions with unified interface
+ * - ModalProvider: Modal visibility, cooldown, deposit-only flow
+ * - ContextBridge: Maps sub-providers to legacy N1WalletContext/N1InternalWalletContext
+ */
+export { ModalProvider, ModalContext, useModal, useModalState, useModalActions, type ModalStateValues, type ModalActions, type ModalContextValue, type ModalProviderProps, } from './ModalProvider';
+export type { ModalState } from '../../store/types';
+export { NetworkProvider, NetworkContext, useNetwork, useNetworkState, useNetworkActions, type WalletNetworkType, type NetworkState, type NetworkActions, type NetworkContextValue, type NetworkProviderProps, } from './NetworkProvider';
+export { SessionProvider, SessionContext, useSession, useSessionState, useSessionActions, type SessionState, type SessionActions, type SessionContextValue, type SessionProviderProps, } from './SessionProvider';
+export { SigningProvider, SigningContext, useSigning, useSigningState, useSigningActions, type SigningFunction, type SigningState, type SigningActions, type SigningContextValue, type SigningProviderProps, } from './SigningProvider';
+export { ThemingProvider, ThemingContext, useTheming, useInjectedCss, type ColorOverride, type ThemingState, type ThemingContextValue, type ThemingProviderProps, } from './ThemingProvider';
+export { ContextBridge, type ContextBridgeProps, } from './ContextBridge';

package/dist/src/providers/N1WalletProvider/index.js

@@ -0,0 +1,27 @@
+/**
+ * N1WalletProvider sub-providers
+ *
+ * These providers split the monolithic N1WalletProvider into focused,
+ * single-responsibility providers for better maintainability and testing.
+ *
+ * Provider hierarchy:
+ * - ThemingProvider: CSS injection, color overrides (outermost)
+ * - NetworkProvider: Wallet network, chain, address normalization
+ * - SessionProvider: Session keys, nordUser, authentication state
+ * - SigningProvider: Signing functions with unified interface
+ * - ModalProvider: Modal visibility, cooldown, deposit-only flow
+ * - ContextBridge: Maps sub-providers to legacy N1WalletContext/N1InternalWalletContext
+ */
+// ModalProvider
+export { ModalProvider, ModalContext, useModal, useModalState, useModalActions, } from './ModalProvider';
+// NetworkProvider
+export { NetworkProvider, NetworkContext, useNetwork, useNetworkState, useNetworkActions, } from './NetworkProvider';
+// SessionProvider
+export { SessionProvider, SessionContext, useSession, useSessionState, useSessionActions, } from './SessionProvider';
+// SigningProvider
+export { SigningProvider, SigningContext, useSigning, useSigningState, useSigningActions, } from './SigningProvider';
+// ThemingProvider
+export { ThemingProvider, ThemingContext, useTheming, useInjectedCss, } from './ThemingProvider';
+// ContextBridge
+export { ContextBridge, } from './ContextBridge';
+//# sourceMappingURL=index.js.map

package/dist/src/providers/N1WalletProvider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/providers/N1WalletProvider/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,gBAAgB;AAChB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,eAAe,GAKhB,MAAM,iBAAiB,CAAC;AAKzB,kBAAkB;AAClB,OAAO,EACL,eAAe,EACf,cAAc,EACd,UAAU,EACV,eAAe,EACf,iBAAiB,GAMlB,MAAM,mBAAmB,CAAC;AAE3B,kBAAkB;AAClB,OAAO,EACL,eAAe,EACf,cAAc,EACd,UAAU,EACV,eAAe,EACf,iBAAiB,GAKlB,MAAM,mBAAmB,CAAC;AAE3B,kBAAkB;AAClB,OAAO,EACL,eAAe,EACf,cAAc,EACd,UAAU,EACV,eAAe,EACf,iBAAiB,GAMlB,MAAM,mBAAmB,CAAC;AAE3B,kBAAkB;AAClB,OAAO,EACL,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,GAKf,MAAM,mBAAmB,CAAC;AAE3B,gBAAgB;AAChB,OAAO,EACL,aAAa,GAEd,MAAM,iBAAiB,CAAC","sourcesContent":["/**\n * N1WalletProvider sub-providers\n *\n * These providers split the monolithic N1WalletProvider into focused,\n * single-responsibility providers for better maintainability and testing.\n *\n * Provider hierarchy:\n * - ThemingProvider: CSS injection, color overrides (outermost)\n * - NetworkProvider: Wallet network, chain, address normalization\n * - SessionProvider: Session keys, nordUser, authentication state\n * - SigningProvider: Signing functions with unified interface\n * - ModalProvider: Modal visibility, cooldown, deposit-only flow\n * - ContextBridge: Maps sub-providers to legacy N1WalletContext/N1InternalWalletContext\n */\n\n// ModalProvider\nexport {\n  ModalProvider,\n  ModalContext,\n  useModal,\n  useModalState,\n  useModalActions,\n  type ModalStateValues,\n  type ModalActions,\n  type ModalContextValue,\n  type ModalProviderProps,\n} from './ModalProvider';\n\n// Re-export ModalState from store types for convenience\nexport type { ModalState } from '../../store/types';\n\n// NetworkProvider\nexport {\n  NetworkProvider,\n  NetworkContext,\n  useNetwork,\n  useNetworkState,\n  useNetworkActions,\n  type WalletNetworkType,\n  type NetworkState,\n  type NetworkActions,\n  type NetworkContextValue,\n  type NetworkProviderProps,\n} from './NetworkProvider';\n\n// SessionProvider\nexport {\n  SessionProvider,\n  SessionContext,\n  useSession,\n  useSessionState,\n  useSessionActions,\n  type SessionState,\n  type SessionActions,\n  type SessionContextValue,\n  type SessionProviderProps,\n} from './SessionProvider';\n\n// SigningProvider\nexport {\n  SigningProvider,\n  SigningContext,\n  useSigning,\n  useSigningState,\n  useSigningActions,\n  type SigningFunction,\n  type SigningState,\n  type SigningActions,\n  type SigningContextValue,\n  type SigningProviderProps,\n} from './SigningProvider';\n\n// ThemingProvider\nexport {\n  ThemingProvider,\n  ThemingContext,\n  useTheming,\n  useInjectedCss,\n  type ColorOverride,\n  type ThemingState,\n  type ThemingContextValue,\n  type ThemingProviderProps,\n} from './ThemingProvider';\n\n// ContextBridge\nexport {\n  ContextBridge,\n  type ContextBridgeProps,\n} from './ContextBridge';\n"]}

package/dist/src/providers/N1WalletProvider.d.ts

@@ -0,0 +1,17 @@
+import { N1WalletProviderProps } from '../types/wallet';
+/**
+ * Main provider component for the N1 wallet widget.
+ *
+ * Coordinates sub-providers for clean separation of concerns:
+ * - ThemingProvider: CSS injection and color overrides
+ * - NetworkProvider: Wallet network, chain, and address state
+ * - SessionProvider: Connection status, keys, and Nord user
+ * - SigningProvider: Message and transaction signing functions
+ * - ModalProvider: Modal visibility and flow control
+ * - ContextBridge: Legacy context compatibility layer
+ *
+ * External integrations:
+ * - Dynamic SDK for wallet connection (lazy loaded)
+ * - Optional Turnkey support for additional wallet features
+ */
+export declare function N1WalletProvider({ children, providedSessionMode, onError, nord, colorOverrides, skipFinalScreen, dynamicEnvironmentId, enableTurnkey, }: N1WalletProviderProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/providers/N1WalletProvider.js

@@ -0,0 +1,102 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import React, { Suspense, useCallback, useEffect, useMemo } from 'react';
+import root from 'react-shadow';
+import { N1WalletModal } from '../features/onboarding-flow/N1WalletModal';
+import { OnboardingProvider } from '../features/onboarding-flow/providers';
+import { logger } from '../utils/logger';
+import { createBootstrapError } from '../utils/errors';
+import WalletErrorBoundary from './WalletErrorBoundary';
+import { useNordUserInitialization } from '../hooks/useNordUserInitialization';
+import { N1SessionMode } from '../types/wallet';
+import { TurnkeyProvider } from '../turnkey';
+import { getDynamicEnvironmentId } from '../config/dynamic';
+import { ThemingProvider, NetworkProvider, SessionProvider, SigningProvider, ModalProvider, ContextBridge, useInjectedCss, useSession, } from './N1WalletProvider/index';
+import { initializeSubscriptions, cleanupSubscriptions, } from '../store/subscriptions';
+import { ensureCdnFontsLoaded } from '../styles/cdn-fonts';
+var LazyWalletProvider = React.lazy(function () {
+    return import('./LazyWalletProvider').then(function (mod) { return ({
+        default: mod.LazyWalletProvider,
+    }); });
+});
+/**
+ * ModalContent renders the modal with CSS from ThemingProvider.
+ * Must be rendered inside ThemingProvider.
+ *
+ * NOTE: Fonts are loaded via CDN using the FontFace API (see cdn-fonts.ts).
+ * This works regardless of Shadow DOM since fonts are registered globally.
+ */
+var ModalContent = React.memo(function () {
+    var css = useInjectedCss();
+    // Load CDN fonts on mount
+    useEffect(function () {
+        void ensureCdnFontsLoaded();
+    }, []);
+    return (_jsxs(root.div, { children: [_jsx("style", { children: css }), _jsx(N1WalletModal, {})] }));
+});
+var DynamicBridge = React.memo(function () { return null; });
+/**
+ * Wrapper component that initializes NordUser when the provider mounts.
+ * This ensures session keys and signing functions are set up before the widget is used.
+ */
+function NordWrapper(_a) {
+    var children = _a.children;
+    useNordUserInitialization();
+    return _jsx(_Fragment, { children: children });
+}
+/**
+ * Inner component that sets up ModalProvider with session dependencies.
+ * Must be rendered inside SessionProvider to access session state.
+ */
+function ModalProviderWrapper(_a) {
+    var children = _a.children, nord = _a.nord, handleError = _a.handleError, skipFinalScreen = _a.skipFinalScreen, turnkeyEnabled = _a.turnkeyEnabled, dynamicEnvironmentId = _a.dynamicEnvironmentId;
+    var _b = useSession(), dynamicSdkHasLoaded = _b.dynamicSdkHasLoaded, setLoading = _b.setLoading;
+    // Update loading state based on SDK readiness
+    useEffect(function () {
+        var isDynamicReady = Boolean(dynamicSdkHasLoaded);
+        setLoading(!isDynamicReady);
+    }, [dynamicSdkHasLoaded, setLoading]);
+    var body = (_jsx(NordWrapper, { children: _jsxs(_Fragment, { children: [_jsx(OnboardingProvider, { children: _jsxs(_Fragment, { children: [children, _jsx(ModalContent, {})] }) }), _jsx(Suspense, { fallback: null, children: _jsx(LazyWalletProvider, { dynamicEnvironmentId: dynamicEnvironmentId, children: _jsx(DynamicBridge, {}) }) })] }) }));
+    return (_jsx(ModalProvider, { children: _jsx(ContextBridge, { nord: nord, handleError: handleError, skipFinalScreen: skipFinalScreen, turnkeyEnabled: turnkeyEnabled, children: turnkeyEnabled ? _jsx(TurnkeyProvider, { children: body }) : body }) }));
+}
+/**
+ * Main provider component for the N1 wallet widget.
+ *
+ * Coordinates sub-providers for clean separation of concerns:
+ * - ThemingProvider: CSS injection and color overrides
+ * - NetworkProvider: Wallet network, chain, and address state
+ * - SessionProvider: Connection status, keys, and Nord user
+ * - SigningProvider: Message and transaction signing functions
+ * - ModalProvider: Modal visibility and flow control
+ * - ContextBridge: Legacy context compatibility layer
+ *
+ * External integrations:
+ * - Dynamic SDK for wallet connection (lazy loaded)
+ * - Optional Turnkey support for additional wallet features
+ */
+export function N1WalletProvider(_a) {
+    var children = _a.children, providedSessionMode = _a.providedSessionMode, onError = _a.onError, nord = _a.nord, colorOverrides = _a.colorOverrides, skipFinalScreen = _a.skipFinalScreen, dynamicEnvironmentId = _a.dynamicEnvironmentId, enableTurnkey = _a.enableTurnkey;
+    var resolvedDynamicEnvironmentId = useMemo(function () { return dynamicEnvironmentId !== null && dynamicEnvironmentId !== void 0 ? dynamicEnvironmentId : getDynamicEnvironmentId(); }, [dynamicEnvironmentId]);
+    var turnkeyEnabled = enableTurnkey !== false;
+    var handleError = useCallback(function (error) {
+        onError === null || onError === void 0 ? void 0 : onError(error);
+    }, [onError]);
+    // Initialize store subscriptions on mount
+    useEffect(function () {
+        initializeSubscriptions();
+        return function () {
+            cleanupSubscriptions();
+        };
+    }, []);
+    useEffect(function () {
+        if (providedSessionMode !== N1SessionMode.Nord) {
+            logger.warn("Only Nord session mode is supported. Received ".concat(providedSessionMode, ", defaulting to Nord."));
+        }
+    }, [providedSessionMode]);
+    if (!resolvedDynamicEnvironmentId) {
+        logger.logError(createBootstrapError('CONFIG_MISSING', 'Dynamic environment ID is required. Provide it via dynamicEnvironmentId prop or NEXT_PUBLIC_DYNAMIC_ENVIRONMENT_ID.'));
+        return null;
+    }
+    return (_jsx(WalletErrorBoundary, { onError: handleError, children: _jsx(ThemingProvider, { colorOverrides: colorOverrides, children: _jsx(NetworkProvider, { children: _jsx(SessionProvider, { children: _jsx(SigningProvider, { children: _jsx(ModalProviderWrapper, { nord: nord, handleError: handleError, skipFinalScreen: skipFinalScreen, turnkeyEnabled: turnkeyEnabled, dynamicEnvironmentId: resolvedDynamicEnvironmentId, children: children }) }) }) }) }) }));
+}
+//# sourceMappingURL=N1WalletProvider.js.map

package/dist/src/providers/N1WalletProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"N1WalletProvider.js","sourceRoot":"","sources":["../../../src/providers/N1WalletProvider.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport React, { Suspense, useCallback, useEffect, useMemo } from 'react';\nimport root from 'react-shadow';\nimport { N1WalletModal } from '../features/onboarding-flow/N1WalletModal';\nimport { OnboardingProvider } from '../features/onboarding-flow/providers';\nimport { logger } from '../utils/logger';\nimport { createBootstrapError } from '../utils/errors';\nimport WalletErrorBoundary from './WalletErrorBoundary';\nimport { useNordUserInitialization } from '../hooks/useNordUserInitialization';\nimport { N1SessionMode, N1WalletProviderProps } from '../types/wallet';\nimport { TurnkeyProvider } from '../turnkey';\nimport { getDynamicEnvironmentId } from '../config/dynamic';\nimport {\n  ThemingProvider,\n  NetworkProvider,\n  SessionProvider,\n  SigningProvider,\n  ModalProvider,\n  ContextBridge,\n  useInjectedCss,\n  useSession,\n} from './N1WalletProvider/index';\nimport { WalletError, N1Error } from '../errors/types';\nimport {\n  initializeSubscriptions,\n  cleanupSubscriptions,\n} from '../store/subscriptions';\nimport { ensureCdnFontsLoaded } from '../styles/cdn-fonts';\n\nconst LazyWalletProvider = React.lazy(() =>\n  import('./LazyWalletProvider').then((mod) => ({\n    default: mod.LazyWalletProvider,\n  }))\n);\n\n/**\n * ModalContent renders the modal with CSS from ThemingProvider.\n * Must be rendered inside ThemingProvider.\n *\n * NOTE: Fonts are loaded via CDN using the FontFace API (see cdn-fonts.ts).\n * This works regardless of Shadow DOM since fonts are registered globally.\n */\nconst ModalContent = React.memo(() => {\n  const css = useInjectedCss();\n\n  // Load CDN fonts on mount\n  useEffect(() => {\n    void ensureCdnFontsLoaded();\n  }, []);\n\n  return (\n    <root.div>\n      <style>{css}</style>\n      <N1WalletModal />\n    </root.div>\n  );\n});\n\nconst DynamicBridge = React.memo(() => null);\n\n/**\n * Wrapper component that initializes NordUser when the provider mounts.\n * This ensures session keys and signing functions are set up before the widget is used.\n */\nfunction NordWrapper({ children }: { children: React.ReactNode }) {\n  useNordUserInitialization();\n  return <>{children}</>;\n}\n\n/**\n * Inner component that sets up ModalProvider with session dependencies.\n * Must be rendered inside SessionProvider to access session state.\n */\nfunction ModalProviderWrapper({\n  children,\n  nord,\n  handleError,\n  skipFinalScreen,\n  turnkeyEnabled,\n  dynamicEnvironmentId,\n}: {\n  children: React.ReactNode;\n  nord: N1WalletProviderProps['nord'];\n  handleError: (error: WalletError | N1Error) => void;\n  skipFinalScreen: N1WalletProviderProps['skipFinalScreen'];\n  turnkeyEnabled: boolean;\n  dynamicEnvironmentId: string;\n}) {\n  const { dynamicSdkHasLoaded, setLoading } = useSession();\n\n  // Update loading state based on SDK readiness\n  useEffect(() => {\n    const isDynamicReady = Boolean(dynamicSdkHasLoaded);\n    setLoading(!isDynamicReady);\n  }, [dynamicSdkHasLoaded, setLoading]);\n\n  const body = (\n    <NordWrapper>\n      <>\n        <OnboardingProvider>\n          <>\n            {children}\n            <ModalContent />\n          </>\n        </OnboardingProvider>\n        <Suspense fallback={null}>\n          <LazyWalletProvider dynamicEnvironmentId={dynamicEnvironmentId}>\n            <DynamicBridge />\n          </LazyWalletProvider>\n        </Suspense>\n      </>\n    </NordWrapper>\n  );\n\n  return (\n    <ModalProvider>\n      <ContextBridge\n        nord={nord}\n        handleError={handleError}\n        skipFinalScreen={skipFinalScreen}\n        turnkeyEnabled={turnkeyEnabled}\n      >\n        {turnkeyEnabled ? <TurnkeyProvider>{body}</TurnkeyProvider> : body}\n      </ContextBridge>\n    </ModalProvider>\n  );\n}\n\n/**\n * Main provider component for the N1 wallet widget.\n *\n * Coordinates sub-providers for clean separation of concerns:\n * - ThemingProvider: CSS injection and color overrides\n * - NetworkProvider: Wallet network, chain, and address state\n * - SessionProvider: Connection status, keys, and Nord user\n * - SigningProvider: Message and transaction signing functions\n * - ModalProvider: Modal visibility and flow control\n * - ContextBridge: Legacy context compatibility layer\n *\n * External integrations:\n * - Dynamic SDK for wallet connection (lazy loaded)\n * - Optional Turnkey support for additional wallet features\n */\nexport function N1WalletProvider({\n  children,\n  providedSessionMode,\n  onError,\n  nord,\n  colorOverrides,\n  skipFinalScreen,\n  dynamicEnvironmentId,\n  enableTurnkey,\n}: N1WalletProviderProps) {\n  const resolvedDynamicEnvironmentId = useMemo(\n    () => dynamicEnvironmentId ?? getDynamicEnvironmentId(),\n    [dynamicEnvironmentId]\n  );\n\n  const turnkeyEnabled = enableTurnkey !== false;\n\n  const handleError = useCallback(\n    (error: WalletError | N1Error) => {\n      onError?.(error);\n    },\n    [onError]\n  );\n\n// Initialize store subscriptions on mount\n  useEffect(() => {\n    initializeSubscriptions();\n    return () => {\n      cleanupSubscriptions();\n    };\n  }, []);\n\n  useEffect(() => {\n    if (providedSessionMode !== N1SessionMode.Nord) {\n      logger.warn(\n        `Only Nord session mode is supported. Received ${providedSessionMode}, defaulting to Nord.`\n      );\n    }\n  }, [providedSessionMode]);\n\n  if (!resolvedDynamicEnvironmentId) {\n    logger.logError(createBootstrapError(\n      'CONFIG_MISSING',\n      'Dynamic environment ID is required. Provide it via dynamicEnvironmentId prop or NEXT_PUBLIC_DYNAMIC_ENVIRONMENT_ID.'\n    ));\n    return null;\n  }\n\n  return (\n    <WalletErrorBoundary onError={handleError}>\n      <ThemingProvider colorOverrides={colorOverrides}>\n        <NetworkProvider>\n          <SessionProvider>\n            <SigningProvider>\n              <ModalProviderWrapper\n                nord={nord}\n                handleError={handleError}\n                skipFinalScreen={skipFinalScreen}\n                turnkeyEnabled={turnkeyEnabled}\n                dynamicEnvironmentId={resolvedDynamicEnvironmentId}\n              >\n                {children}\n              </ModalProviderWrapper>\n            </SigningProvider>\n          </SessionProvider>\n        </NetworkProvider>\n      </ThemingProvider>\n    </WalletErrorBoundary>\n  );\n}\n"]}

package/dist/{providers → src/providers}/ShadowRootWrapper.d.ts

@@ -3,5 +3,9 @@ interface ShadowRootWrapperProps {
     children: React.ReactNode;
     injectedCss: string;
 }
+/**
+ * Wraps children in a shadow DOM root to isolate styles from host application.
+ * Used for the connect button to prevent CSS conflicts.
+ */
 export declare function ShadowRootWrapper({ children, injectedCss }: ShadowRootWrapperProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/{providers → src/providers}/ShadowRootWrapper.js

@@ -1,5 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import root from 'react-shadow';
+/**
+ * Wraps children in a shadow DOM root to isolate styles from host application.
+ * Used for the connect button to prevent CSS conflicts.
+ */
 export function ShadowRootWrapper(_a) {
     var children = _a.children, injectedCss = _a.injectedCss;
     return (_jsxs(root.div, { children: [_jsx("style", { children: injectedCss }), children] }));

package/dist/src/providers/ShadowRootWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShadowRootWrapper.js","sourceRoot":"","sources":["../../../src/providers/ShadowRootWrapper.tsx"],"names":[],"mappings":";AACA,OAAO,IAAI,MAAM,cAAc,CAAC;AAOhC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAiD;QAA/C,QAAQ,cAAA,EAAE,WAAW,iBAAA;IACvD,OAAO,CACL,MAAC,IAAI,CAAC,GAAG,eACP,0BAAQ,WAAW,GAAS,EAC3B,QAAQ,IACA,CACZ,CAAC;AACJ,CAAC","sourcesContent":["import React from 'react';\nimport root from 'react-shadow';\n\ninterface ShadowRootWrapperProps {\n  children: React.ReactNode;\n  injectedCss: string;\n}\n\n/**\n * Wraps children in a shadow DOM root to isolate styles from host application.\n * Used for the connect button to prevent CSS conflicts.\n */\nexport function ShadowRootWrapper({ children, injectedCss }: ShadowRootWrapperProps) {\n  return (\n    <root.div>\n      <style>{injectedCss}</style>\n      {children}\n    </root.div>\n  );\n} \n"]}

package/dist/{providers → src/providers}/WalletErrorBoundary.d.ts

@@ -1,12 +1,17 @@
 import React from 'react';
-import { WalletError } from '../errors/types';
+import { WalletError, N1Error } from '../errors/types';
 type WalletErrorBoundaryProps = {
     children: React.ReactNode;
-    onError: (error: WalletError) => void;
+    onError: (error: WalletError | N1Error) => void;
 };
 type WalletErrorBoundaryState = {
     hasError: boolean;
 };
+/**
+ * React error boundary that catches WalletErrors and unhandled exceptions.
+ * Converts unknown errors to WalletError format and calls onError callback.
+ * Resets error state when children change after an error.
+ */
 declare class WalletErrorBoundary extends React.Component<WalletErrorBoundaryProps, WalletErrorBoundaryState> {
     state: WalletErrorBoundaryState;
     static getDerivedStateFromError(): WalletErrorBoundaryState;

package/dist/{providers → src/providers}/WalletErrorBoundary.js

@@ -15,7 +15,11 @@ var __extends = (this && this.__extends) || (function () {
 })();
 import React from 'react';
 import { WalletError, WalletErrorCode } from '../errors/types';
-// Error boundary to catch WalletErrors
+/**
+ * React error boundary that catches WalletErrors and unhandled exceptions.
+ * Converts unknown errors to WalletError format and calls onError callback.
+ * Resets error state when children change after an error.
+ */
 var WalletErrorBoundary = /** @class */ (function (_super) {
     __extends(WalletErrorBoundary, _super);
     function WalletErrorBoundary() {

package/dist/src/providers/WalletErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletErrorBoundary.js","sourceRoot":"","sources":["../../../src/providers/WalletErrorBoundary.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,eAAe,EAAW,MAAM,iBAAiB,CAAC;AAWxE;;;;GAIG;AACH;IAAkC,uCAGjC;IAHD;;QAIE,WAAK,GAA6B;YAChC,QAAQ,EAAE,KAAK;SAChB,CAAC;;IAuCJ,CAAC;IArCQ,4CAAwB,GAA/B;QACE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,+CAAiB,GAAjB,UAAkB,KAAY;QAC5B,OAAO,CAAC,KAAK,CAAC,8DAA8D,EAAE,KAAK,CAAC,CAAC;QACrF,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,wCAAwC;YACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAChB,IAAI,WAAW,CACb,eAAe,CAAC,OAAO,EACvB,KAAK,CAAC,OAAO,IAAI,8BAA8B,EAC/C,EAAE,aAAa,EAAE,KAAK,EAAE,CACzB,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gDAAkB,GAAlB,UACE,SAAmC,EACnC,SAAmC;QAEnC,IAAI,SAAS,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC5F,wDAAwD;YACxD,yDAAyD;YACzD,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,oCAAM,GAAN;QACE,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IACH,0BAAC;AAAD,CAAC,AA7CD,CAAkC,KAAK,CAAC,SAAS,GA6ChD;AAED,eAAe,mBAAmB,CAAC","sourcesContent":["import React from 'react';\nimport { WalletError, WalletErrorCode, N1Error } from '../errors/types';\n\ntype WalletErrorBoundaryProps = {\n  children: React.ReactNode;\n  onError: (error: WalletError | N1Error) => void;\n};\n\ntype WalletErrorBoundaryState = {\n  hasError: boolean;\n};\n\n/**\n * React error boundary that catches WalletErrors and unhandled exceptions.\n * Converts unknown errors to WalletError format and calls onError callback.\n * Resets error state when children change after an error.\n */\nclass WalletErrorBoundary extends React.Component<\n  WalletErrorBoundaryProps,\n  WalletErrorBoundaryState\n> {\n  state: WalletErrorBoundaryState = {\n    hasError: false,\n  };\n\n  static getDerivedStateFromError(): WalletErrorBoundaryState {\n    return { hasError: true };\n  }\n\n  componentDidCatch(error: Error) {\n    console.error('[N1 Wallet] Unhandled error captured by WalletErrorBoundary:', error);\n    if (error instanceof WalletError) {\n      this.props.onError(error);\n    } else {\n      // Convert unknown errors to WalletError\n      this.props.onError(\n        new WalletError(\n          WalletErrorCode.UNKNOWN,\n          error.message || 'An unexpected error occurred',\n          { originalError: error }\n        )\n      );\n    }\n  }\n\n  componentDidUpdate(\n    prevProps: WalletErrorBoundaryProps,\n    prevState: WalletErrorBoundaryState\n  ) {\n    if (prevState.hasError && this.state.hasError && prevProps.children !== this.props.children) {\n      // reset error state when children change after an error\n      // eslint-disable-next-line react/no-did-update-set-state\n      this.setState({ hasError: false });\n    }\n  }\n\n  render() {\n    if (this.state.hasError) {\n      return null;\n    }\n    return this.props.children;\n  }\n}\n\nexport default WalletErrorBoundary;\n"]}