@nexus-cross/connect-kit-core 1.0.0-beta.1

package/README.md

@@ -0,0 +1,108 @@
+# @nexus-cross/connect-kit-core
+
+Pure domain layer for **crossx-kit** — TypeScript types, port interfaces, and
+framework-agnostic utilities. This package has **no runtime dependencies** on
+wagmi, viem, React, or any wallet SDK. It is the seam that lets the wagmi and
+React layers evolve independently.
+
+> DApp developers normally don't install this package directly. Install
+> [`@nexus-cross/connect-kit-react`](../react) (and optionally
+> [`@nexus-cross/connect-kit-wagmi`](../wagmi)) — both re-export the types you need.
+
+## Install
+
+```sh
+pnpm add @nexus-cross/connect-kit-core
+```
+
+## What's inside
+
+### Domain types
+
+```ts
+import type {
+  // Wallet taxonomy
+  WalletId,            // 'cross_embedded' | 'cross_wallet' | 'cross_extension' | 'metamask' | 'binance' | (string & {})
+  ConnectorType,       // 'embedded' | 'app' | 'extension' | 'external'
+  WalletDescriptor,
+
+  // Connection result
+  Account,
+  ConnectorResult,
+  ChainBalance,
+
+  // Kit config (input to createCrossxConfig)
+  CrossConnectKitConfig,
+  AppMetadata,
+  NetworkConfig,
+
+  // UI
+  ModalView,
+  Theme,
+
+  // Misc
+  Unsubscribe,
+  WalletState,
+} from '@nexus-cross/connect-kit-core';
+
+import { ConnectionStatus } from '@nexus-cross/connect-kit-core';
+// ConnectionStatus.CONNECTED | .DISCONNECTED | .CONNECTING | .RECONNECTING
+```
+
+### Ports (capability interfaces)
+
+Ports describe **what** the kit needs from its environment, not **how** it is
+delivered. Adapters in `@nexus-cross/connect-kit-wagmi` and `@nexus-cross/connect-kit-react` implement
+them.
+
+```ts
+import type {
+  ConnectorPort,        // Connect / disconnect / subscribe to wallet state
+  StoragePort,          // Async key-value storage (localStorage, cookies, …)
+  ModalControlPort,     // Open / close the kit's modal views
+  ThemePort,            // Read & write theme tokens
+  WalletDetectionPort,  // EIP-6963 / injected / SDK wallet discovery
+  BalancePort,          // Per-chain balance fetcher
+} from '@nexus-cross/connect-kit-core';
+```
+
+Ports are the only contract core has with the outside world — any new external
+capability must enter through a port, never as a direct dependency.
+
+### Utilities
+
+BigInt-safe formatters for blockchain numerics. These **always floor** when
+truncating decimals and never round up or use banker's rounding.
+
+```ts
+import { formatBalance, formatWei } from '@nexus-cross/connect-kit-core';
+
+formatBalance(1234567890000000000n, 18);      // '1.234567890000000000'
+formatBalance(1234567890000000000n, 18, 4);   // '1.2345'  (truncated)
+formatWei('0xde0b6b3a7640000');               // '1'       (1 ETH)
+```
+
+## Design rules
+
+The core package enforces the architectural spine:
+
+- **No environment dependencies** — no wagmi, viem, React, DOM, or Node APIs.
+  Anything impure lives behind a port.
+- **Constructor injection only** — no singletons, no module-level globals,
+  no hidden `window` access.
+- **BigInt end-to-end** — wei / gas / balance values stay in `BigInt` through
+  every computation; display values are UI-only and never fed back into
+  arithmetic.
+- **External SDK types don't leak** — the wagmi package converts between
+  external shapes (viem `Address`, wagmi `Connector`) and core's plain types
+  (`string` addresses, `WalletDescriptor`) at its own boundary.
+
+## Compatibility
+
+- TypeScript 5.x
+- Node 18+ / modern browsers (ES2020 target)
+- No peer dependencies
+
+## License
+
+MIT

package/dist/core/ports/BalancePort.d.ts

@@ -0,0 +1,14 @@
+import type { ChainBalance, Unsubscribe } from '../types/index.js';
+/**
+ * Tracks native/token balances across configured chains.
+ * Implementations fetch via viem public clients or RPC.
+ */
+export interface BalancePort {
+    /** Fetch balances for the given address across all configured chains */
+    fetchBalances(address: string): Promise<ChainBalance[]>;
+    /** Subscribe to balance updates (polling or event-driven) */
+    onBalanceChanged(address: string, cb: (balances: ChainBalance[]) => void): Unsubscribe;
+    /** Force-refresh cached balances */
+    invalidate(): void;
+}
+//# sourceMappingURL=BalancePort.d.ts.map

package/dist/core/ports/BalancePort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BalancePort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/BalancePort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAExD,6DAA6D;IAC7D,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,GACrC,WAAW,CAAC;IAEf,oCAAoC;IACpC,UAAU,IAAI,IAAI,CAAC;CACpB"}

package/dist/core/ports/BalancePort.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BalancePort.js.map

package/dist/core/ports/BalancePort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BalancePort.js","sourceRoot":"","sources":["../../../src/core/ports/BalancePort.ts"],"names":[],"mappings":""}

package/dist/core/ports/ConnectorPort.d.ts

@@ -0,0 +1,32 @@
+import type { Account, ConnectorResult, ConnectorType, Unsubscribe, WalletId } from '../types/index.js';
+/**
+ * Abstracts a wallet connector's lifecycle.
+ *
+ * In crossx-kit the wagmi package provides concrete implementations:
+ * - EmbeddedWalletConnector (crossy-sdk-js → wagmi connector)
+ * - CrossAppConnector       (cross-sdk-js → wagmi connector, QR/deep-link)
+ * - CrossExtensionConnector (injected CROSSx Extension)
+ * - ExternalWalletConnector (Reown/WalletConnect for MetaMask, Binance, etc.)
+ */
+export interface ConnectorPort {
+    readonly id: WalletId;
+    readonly name: string;
+    readonly type: ConnectorType;
+    readonly iconUrl?: string;
+    connect(params?: Record<string, unknown>): Promise<ConnectorResult>;
+    disconnect(): Promise<void>;
+    getAccount(): Promise<Account | null>;
+    isConnected(): boolean;
+    /**
+     * For embedded wallets: switch to a different sub-wallet (account index).
+     * Returns null if the connector does not support wallet selection.
+     */
+    selectWallet?(): Promise<{
+        address: string;
+        index: number;
+    } | null>;
+    onAccountChanged(cb: (account: Account) => void): Unsubscribe;
+    onChainChanged(cb: (chainId: number) => void): Unsubscribe;
+    onDisconnect(cb: () => void): Unsubscribe;
+}
+//# sourceMappingURL=ConnectorPort.d.ts.map

package/dist/core/ports/ConnectorPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorPort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/ConnectorPort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,aAAa,EACb,WAAW,EACX,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACpE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,UAAU,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtC,WAAW,IAAI,OAAO,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAEpE,gBAAgB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,WAAW,CAAC;IAC9D,cAAc,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW,CAAC;IAC3D,YAAY,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,WAAW,CAAC;CAC3C"}

package/dist/core/ports/ConnectorPort.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ConnectorPort.js.map

package/dist/core/ports/ConnectorPort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorPort.js","sourceRoot":"","sources":["../../../src/core/ports/ConnectorPort.ts"],"names":[],"mappings":""}

package/dist/core/ports/ModalControlPort.d.ts

@@ -0,0 +1,8 @@
+import type { ModalView, Unsubscribe } from '../types/index.js';
+export interface ModalControlPort {
+    open(view: ModalView): void;
+    close(): void;
+    isOpen(): boolean;
+    onStateChange(cb: (isOpen: boolean, view: ModalView | null) => void): Unsubscribe;
+}
+//# sourceMappingURL=ModalControlPort.d.ts.map

package/dist/core/ports/ModalControlPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalControlPort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/ModalControlPort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,GAAG,WAAW,CAAC;CACnF"}

package/dist/core/ports/ModalControlPort.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ModalControlPort.js.map

package/dist/core/ports/ModalControlPort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalControlPort.js","sourceRoot":"","sources":["../../../src/core/ports/ModalControlPort.ts"],"names":[],"mappings":""}

package/dist/core/ports/StoragePort.d.ts

@@ -0,0 +1,6 @@
+export interface StoragePort {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+//# sourceMappingURL=StoragePort.d.ts.map

package/dist/core/ports/StoragePort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoragePort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/StoragePort.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}

package/dist/core/ports/StoragePort.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=StoragePort.js.map

package/dist/core/ports/StoragePort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoragePort.js","sourceRoot":"","sources":["../../../src/core/ports/StoragePort.ts"],"names":[],"mappings":""}

package/dist/core/ports/ThemePort.d.ts

@@ -0,0 +1,7 @@
+import type { Theme, Unsubscribe } from '../types/index.js';
+export interface ThemePort {
+    getTheme(): Theme;
+    setTheme(theme: Partial<Theme>): void;
+    onThemeChange(cb: (theme: Theme) => void): Unsubscribe;
+}
+//# sourceMappingURL=ThemePort.d.ts.map

package/dist/core/ports/ThemePort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemePort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/ThemePort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,SAAS;IACxB,QAAQ,IAAI,KAAK,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACtC,aAAa,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,WAAW,CAAC;CACxD"}

package/dist/core/ports/ThemePort.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ThemePort.js.map

package/dist/core/ports/ThemePort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemePort.js","sourceRoot":"","sources":["../../../src/core/ports/ThemePort.ts"],"names":[],"mappings":""}

package/dist/core/ports/WalletDetectionPort.d.ts

@@ -0,0 +1,14 @@
+import type { WalletDescriptor, Unsubscribe } from '../types/index.js';
+/**
+ * Detects available wallets in the current environment.
+ * Implementations use EIP-6963, window.ethereum probing, etc.
+ */
+export interface WalletDetectionPort {
+    /** Returns currently detected wallets (snapshot) */
+    getDetectedWallets(): WalletDescriptor[];
+    /** Fires when the set of detected wallets changes (e.g. extension loads late) */
+    onWalletsChanged(cb: (wallets: WalletDescriptor[]) => void): Unsubscribe;
+    /** Check if a specific wallet is installed by its rdns or id */
+    isInstalled(walletId: string): boolean;
+}
+//# sourceMappingURL=WalletDetectionPort.d.ts.map

package/dist/core/ports/WalletDetectionPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletDetectionPort.d.ts","sourceRoot":"","sources":["../../../src/core/ports/WalletDetectionPort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,kBAAkB,IAAI,gBAAgB,EAAE,CAAC;IAEzC,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,IAAI,GAAG,WAAW,CAAC;IAEzE,gEAAgE;IAChE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACxC"}

package/dist/core/ports/WalletDetectionPort.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WalletDetectionPort.js.map

package/dist/core/ports/WalletDetectionPort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WalletDetectionPort.js","sourceRoot":"","sources":["../../../src/core/ports/WalletDetectionPort.ts"],"names":[],"mappings":""}

package/dist/core/theme/tokens.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Theme token resolver — bridges `CrossConnectKitConfig.{theme, themeTokens}`
+ * to:
+ *   - crossy-sdk's `SDKConfig.{theme, themeTokens}` (passed straight
+ *     through, same semantic keys)
+ *   - `--cck-*` CSS variables consumed by `@nexus-cross/dapp-ui`'s
+ *     WalletInfo / WalletPortfolio / WalletConnectModal / AppLauncher
+ *     stylesheets (they reference `var(--cck-<key>, <fallback>)` for
+ *     every token below)
+ *
+ * Defaults match crossy-sdk-js's built-in palette so an absent
+ * `themeTokens` still yields a consistent look across every surface.
+ */
+import type { ColorOverrides, ThemeMode, ThemeTokens } from '../types/index.js';
+/**
+ * Baseline palette. Light and dark default values mirror
+ * `crossy-sdk-js`'s `THEMES.light` / `THEMES.dark`.
+ */
+export declare const DEFAULT_THEME_TOKENS: Record<ThemeMode, Required<ColorOverrides>>;
+/**
+ * Merge user overrides onto the default palette for a given mode.
+ * Undefined/empty values fall through to the default — matching
+ * crossy-sdk's `resolveTokens` behavior so `@nexus-cross/connect-kit`
+ * renders the same resolved palette the embedded modal does.
+ */
+export declare function resolveColorTokens(mode: ThemeMode, overrides?: ColorOverrides): Required<ColorOverrides>;
+/**
+ * Resolve the effective {@link ThemeMode} that should be applied.
+ * When `autoDetect` is true (and a `window` is available), reads
+ * `prefers-color-scheme`; otherwise falls back to `explicit ?? 'dark'`.
+ */
+export declare function resolveThemeMode(explicit: ThemeMode | Partial<{
+    mode: ThemeMode;
+}> | undefined, autoDetect: boolean | undefined): ThemeMode;
+/**
+ * `ColorOverrides` key → CSS variable name under the shared `--cck-*`
+ * namespace.
+ *
+ * The dapp-ui feature stylesheets (`wallet-info/styles/theme.css`,
+ * `wallet-portfolio/styles/portfolio.css`, `wallet-connect-modal/
+ * styles/theme.css`, `app-launcher/styles/theme.css`) reference these
+ * names via `var(--cck-<key>, <fallback>)`, so emitting them on
+ * `:root` (or any ancestor) recolors every surface at once.
+ */
+export declare const CCK_VAR: Record<keyof ColorOverrides, string>;
+/**
+ * Serialize `{ light, dark }` token sets to a self-contained CSS string
+ * attached to a root (e.g. `:root` or `[data-ckit-root]`). Both modes
+ * are always emitted — one inside `[data-cck-theme="light"]` and one
+ * inside `[data-cck-theme="dark"]` — so flipping
+ * `document.documentElement.dataset.ckitTheme` is enough to switch
+ * palettes without re-rendering the `<style>` tag.
+ *
+ * The caller is responsible for setting `data-cck-theme` (and
+ * optionally `data-theme` on the same element) to match the active
+ * mode. `CrossConnectKitProvider` in `@nexus-cross/connect-kit-react` does
+ * both.
+ */
+export declare function buildThemeCssText(tokens: ThemeTokens | undefined, 
+/** Selector scope. Defaults to `:root` so the variables are globally available. */
+scope?: string): string;
+/**
+ * Convenience: flatten a resolved token set to a `CSSProperties`-style
+ * inline-style object. Useful when a DApp wants to apply the palette to
+ * a single subtree rather than the documentElement.
+ *
+ * ```tsx
+ * <div style={themeTokensToInlineStyle('dark', tokens.dark)}>
+ *   ...
+ * </div>
+ * ```
+ */
+export declare function themeTokensToInlineStyle(mode: ThemeMode, overrides?: ColorOverrides): Record<string, string>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/core/theme/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/core/theme/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,cAAc,CAAC,CA6B5E,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,SAAS,CAAC,EAAE,cAAc,GACzB,QAAQ,CAAC,cAAc,CAAC,CAS1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAAG,SAAS,EAC9D,UAAU,EAAE,OAAO,GAAG,SAAS,GAC9B,SAAS,CAeX;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,cAAc,EAAE,MAAM,CAaxD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,GAAG,SAAS;AAC/B,mFAAmF;AACnF,KAAK,GAAE,MAAgB,GACtB,MAAM,CAkBR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,EACf,SAAS,CAAC,EAAE,cAAc,GACzB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB"}

package/dist/core/theme/tokens.js

@@ -0,0 +1,162 @@
+/**
+ * Theme token resolver — bridges `CrossConnectKitConfig.{theme, themeTokens}`
+ * to:
+ *   - crossy-sdk's `SDKConfig.{theme, themeTokens}` (passed straight
+ *     through, same semantic keys)
+ *   - `--cck-*` CSS variables consumed by `@nexus-cross/dapp-ui`'s
+ *     WalletInfo / WalletPortfolio / WalletConnectModal / AppLauncher
+ *     stylesheets (they reference `var(--cck-<key>, <fallback>)` for
+ *     every token below)
+ *
+ * Defaults match crossy-sdk-js's built-in palette so an absent
+ * `themeTokens` still yields a consistent look across every surface.
+ */
+/**
+ * Baseline palette. Light and dark default values mirror
+ * `crossy-sdk-js`'s `THEMES.light` / `THEMES.dark`.
+ */
+export const DEFAULT_THEME_TOKENS = {
+    light: {
+        primary: '#019D92',
+        secondary: '#E70077',
+        onPrimary: '#FFFFFF',
+        borderDefault: 'rgba(18, 18, 18, 0.05)',
+        borderSubtle: 'rgba(18, 18, 18, 0.1)',
+        textIconPrimary: '#121212',
+        textIconSecondary: 'rgba(18, 18, 18, 0.7)',
+        textIconTertiary: 'rgba(18, 18, 18, 0.5)',
+        surfaceDefault: 'rgba(18, 18, 18, 0.05)',
+        surfaceSubtle: 'rgba(18, 18, 18, 0.1)',
+        bg: '#FFFFFF',
+        error: '#E70077',
+    },
+    dark: {
+        primary: '#019D92',
+        secondary: '#E70077',
+        onPrimary: '#FFFFFF',
+        borderDefault: 'rgba(255, 255, 255, 0.05)',
+        borderSubtle: 'rgba(255, 255, 255, 0.1)',
+        textIconPrimary: '#FFFFFF',
+        textIconSecondary: 'rgba(255, 255, 255, 0.7)',
+        textIconTertiary: 'rgba(255, 255, 255, 0.5)',
+        surfaceDefault: 'rgba(255, 255, 255, 0.05)',
+        surfaceSubtle: 'rgba(255, 255, 255, 0.1)',
+        bg: '#121212',
+        error: '#E70077',
+    },
+};
+/**
+ * Merge user overrides onto the default palette for a given mode.
+ * Undefined/empty values fall through to the default — matching
+ * crossy-sdk's `resolveTokens` behavior so `@nexus-cross/connect-kit`
+ * renders the same resolved palette the embedded modal does.
+ */
+export function resolveColorTokens(mode, overrides) {
+    const base = DEFAULT_THEME_TOKENS[mode];
+    if (!overrides)
+        return { ...base };
+    const merged = { ...base };
+    Object.keys(base).forEach((key) => {
+        const v = overrides[key];
+        if (typeof v === 'string' && v.length > 0)
+            merged[key] = v;
+    });
+    return merged;
+}
+/**
+ * Resolve the effective {@link ThemeMode} that should be applied.
+ * When `autoDetect` is true (and a `window` is available), reads
+ * `prefers-color-scheme`; otherwise falls back to `explicit ?? 'dark'`.
+ */
+export function resolveThemeMode(explicit, autoDetect) {
+    if (autoDetect && typeof window !== 'undefined' && window.matchMedia) {
+        try {
+            return window.matchMedia('(prefers-color-scheme: dark)').matches
+                ? 'dark'
+                : 'light';
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    if (typeof explicit === 'string')
+        return explicit;
+    if (explicit && typeof explicit === 'object' && 'mode' in explicit) {
+        return explicit.mode ?? 'dark';
+    }
+    return 'dark';
+}
+/**
+ * `ColorOverrides` key → CSS variable name under the shared `--cck-*`
+ * namespace.
+ *
+ * The dapp-ui feature stylesheets (`wallet-info/styles/theme.css`,
+ * `wallet-portfolio/styles/portfolio.css`, `wallet-connect-modal/
+ * styles/theme.css`, `app-launcher/styles/theme.css`) reference these
+ * names via `var(--cck-<key>, <fallback>)`, so emitting them on
+ * `:root` (or any ancestor) recolors every surface at once.
+ */
+export const CCK_VAR = {
+    primary: '--cck-primary',
+    secondary: '--cck-secondary',
+    onPrimary: '--cck-on-primary',
+    borderDefault: '--cck-border-default',
+    borderSubtle: '--cck-border-subtle',
+    textIconPrimary: '--cck-texticon-primary',
+    textIconSecondary: '--cck-texticon-secondary',
+    textIconTertiary: '--cck-texticon-tertiary',
+    surfaceDefault: '--cck-surface-default',
+    surfaceSubtle: '--cck-surface-subtle',
+    bg: '--cck-surface-bg',
+    error: '--cck-error',
+};
+/**
+ * Serialize `{ light, dark }` token sets to a self-contained CSS string
+ * attached to a root (e.g. `:root` or `[data-ckit-root]`). Both modes
+ * are always emitted — one inside `[data-cck-theme="light"]` and one
+ * inside `[data-cck-theme="dark"]` — so flipping
+ * `document.documentElement.dataset.ckitTheme` is enough to switch
+ * palettes without re-rendering the `<style>` tag.
+ *
+ * The caller is responsible for setting `data-cck-theme` (and
+ * optionally `data-theme` on the same element) to match the active
+ * mode. `CrossConnectKitProvider` in `@nexus-cross/connect-kit-react` does
+ * both.
+ */
+export function buildThemeCssText(tokens, 
+/** Selector scope. Defaults to `:root` so the variables are globally available. */
+scope = ':root') {
+    const light = resolveColorTokens('light', tokens?.light);
+    const dark = resolveColorTokens('dark', tokens?.dark);
+    const emit = (mode, values) => {
+        const lines = [];
+        Object.keys(values).forEach((key) => {
+            lines.push(`  ${CCK_VAR[key]}: ${values[key]};`);
+        });
+        // Two selectors so it works whether the DApp tags the documentElement
+        // (`<html data-cck-theme="dark">`) or a deeper wrapper.
+        return (`${scope}[data-cck-theme="${mode}"],\n` +
+            `[data-cck-theme="${mode}"] {\n${lines.join('\n')}\n}`);
+    };
+    return `${emit('light', light)}\n${emit('dark', dark)}`;
+}
+/**
+ * Convenience: flatten a resolved token set to a `CSSProperties`-style
+ * inline-style object. Useful when a DApp wants to apply the palette to
+ * a single subtree rather than the documentElement.
+ *
+ * ```tsx
+ * <div style={themeTokensToInlineStyle('dark', tokens.dark)}>
+ *   ...
+ * </div>
+ * ```
+ */
+export function themeTokensToInlineStyle(mode, overrides) {
+    const values = resolveColorTokens(mode, overrides);
+    const out = {};
+    Object.keys(values).forEach((key) => {
+        out[CCK_VAR[key]] = values[key];
+    });
+    return out;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/core/theme/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/core/theme/tokens.ts"],"names":[],"mappings":"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"}

package/dist/core/types/index.d.ts

@@ -0,0 +1,189 @@
+/**
+ * How a connector reaches the blockchain:
+ * - embedded: In-app wallet via crossy-sdk-js (social login, no extension)
+ * - app: CROSSx mobile app deep-link / QR approval
+ * - extension: Browser extension (CROSSx Extension, injected EIP-1193)
+ * - external: Third-party wallets via Reown/WalletConnect (MetaMask, Binance …)
+ */
+export type ConnectorType = 'embedded' | 'app' | 'extension' | 'external';
+/**
+ * Well-known wallet identifiers used throughout the kit.
+ * Maps 1:1 to posa's WalletType union so existing apps migrate trivially.
+ */
+export type WalletId = 'cross_embedded' | 'cross_wallet' | 'cross_extension' | 'metamask' | 'binance' | (string & {});
+export interface WalletDescriptor {
+    readonly id: WalletId;
+    readonly name: string;
+    readonly type: ConnectorType;
+    readonly iconUrl?: string;
+    /** EIP-6963 rdns for browser-extension detection */
+    readonly rdns?: string;
+    /** Install URL when extension is not detected */
+    readonly installUrl?: string;
+    /** Whether the wallet is available in the current environment */
+    installed?: boolean;
+}
+export interface ConnectorResult {
+    account: Account;
+    chainId: number;
+}
+export interface Account {
+    /** 0x-prefixed hex string */
+    address: string;
+    chainId: number;
+}
+export interface ChainBalance {
+    /** EIP-155 numeric chain ID */
+    chainId: number;
+    /** Human-readable decimal string (e.g. "1234.5678") */
+    balance: string;
+    /** Raw integer string in wei */
+    balanceWei: string;
+}
+export declare const ConnectionStatus: {
+    readonly CONNECTED: "connected";
+    readonly DISCONNECTED: "disconnected";
+    readonly CONNECTING: "connecting";
+    readonly RECONNECTING: "reconnecting";
+};
+export type ConnectionStatus = (typeof ConnectionStatus)[keyof typeof ConnectionStatus];
+export interface WalletState {
+    status: ConnectionStatus;
+    /** Connected wallet address, undefined when disconnected */
+    address: string | undefined;
+    /** Currently active wallet identifier */
+    activeWalletId: WalletId | null;
+    /** True while auto-reconnecting from a previous session */
+    isReconnecting: boolean;
+    /** Per-chain balances (populated when balance tracking is enabled) */
+    chainBalances: ChainBalance[];
+}
+export type ModalView = 'connect' | 'account' | 'chain' | 'wallet-info';
+/**
+ * Theme mode — mirrors `crossy-sdk-js`'s `SDKConfig.theme` literal union.
+ * `autoDetectTheme: true` overrides this at runtime with
+ * `prefers-color-scheme`.
+ */
+export type ThemeMode = 'light' | 'dark';
+/**
+ * Semantic color overrides. Mirrors `crossy-sdk-js`'s `SDKColorOverrides`
+ * 1:1 so `@nexus-cross/connect-kit-core` can forward them into the
+ * embedded SDK and — via the CSS variables generated by
+ * `buildThemeCssText` — apply them uniformly to WalletInfo / Portfolio /
+ * AppLauncher / WalletConnectModal.
+ *
+ * All values are plain CSS color strings (e.g. `"#019D92"`,
+ * `"rgba(18,18,18,0.7)"`).
+ */
+export interface ColorOverrides {
+    /** Buttons, accents, active state. Default `#019D92`. */
+    primary?: string;
+    /** Error/alert highlight (PIN error etc.). Default `#E70077`. */
+    secondary?: string;
+    /** Text/icon color placed on top of `primary`. Default `#FFFFFF`. */
+    onPrimary?: string;
+    /** Card outline border. */
+    borderDefault?: string;
+    /** Dividers, input outlines. */
+    borderSubtle?: string;
+    /** Titles, primary text. */
+    textIconPrimary?: string;
+    /** Secondary copy, labels. */
+    textIconSecondary?: string;
+    /** Hints, disabled text, tertiary icons. */
+    textIconTertiary?: string;
+    /** Inline highlighted surfaces (pills, hover, input field bg). */
+    surfaceDefault?: string;
+    /** Stronger neutral surfaces (divider fill, secondary bg). */
+    surfaceSubtle?: string;
+    /** Modal / card root background. */
+    bg?: string;
+    /** Error state, independent from `secondary`. Default `#E70077`. */
+    error?: string;
+}
+/**
+ * Per-mode theme overrides. `light` is applied when `theme === 'light'`,
+ * `dark` is applied when `theme === 'dark'`. Omitted fields fall back to
+ * crossy-sdk's built-in palette.
+ *
+ * Mirrors `crossy-sdk-js`'s `SDKThemeTokens` so the same literal value
+ * can be forwarded straight into the embedded SDK.
+ */
+export interface ThemeTokens {
+    light?: ColorOverrides;
+    dark?: ColorOverrides;
+}
+/**
+ * @deprecated Use `ThemeMode` / `ThemeTokens` instead.
+ * Legacy shape kept for older consumers that typed on the `mode`/
+ * `accentColor` fields. New code should pass `theme: 'dark'` and
+ * `themeTokens: { dark: { primary: ... } }` at the `CrossConnectKitConfig`
+ * level.
+ */
+export interface Theme {
+    mode: ThemeMode;
+    accentColor?: string;
+    borderRadius?: 'none' | 'small' | 'medium' | 'large';
+    fontFamily?: string;
+}
+export interface CrossConnectKitConfig {
+    /** CROSS SDK project ID (for embedded/app wallet) */
+    crossProjectId: string;
+    /** Reown project ID (for WalletConnect / external wallets) */
+    reownProjectId?: string;
+    /** Embedded wallet project ID */
+    embeddedProjectId?: string;
+    /** App metadata for WalletConnect pairing */
+    appMetadata: AppMetadata;
+    /** Supported networks */
+    networks: readonly NetworkConfig[];
+    /** Default network (first connection lands here) */
+    defaultNetwork?: NetworkConfig;
+    /**
+     * Theme mode applied across every surface the kit renders:
+     *   - crossy-sdk confirmation / login modals
+     *   - `WalletInfo`, `WalletPortfolio`, `WalletConnectModal`, `AppLauncher`
+     * Defaults to `'dark'`.
+     *
+     * Accepts both the new literal (`'light' | 'dark'`) and the legacy
+     * `Partial<Theme>` object (`{ mode: 'dark' }`) so older DApps keep
+     * building while migrating.
+     */
+    theme?: ThemeMode | Partial<Theme>;
+    /**
+     * When `true`, ignore `theme` and follow `prefers-color-scheme`.
+     * Mirrors crossy-sdk's `SDKConfig.autoDetectTheme`.
+     */
+    autoDetectTheme?: boolean;
+    /**
+     * Color token overrides forwarded to crossy-sdk's `themeTokens` _and_
+     * published as CSS variables so WalletInfo / Portfolio / AppLauncher /
+     * WalletConnectModal render with the same palette.
+     */
+    themeTokens?: ThemeTokens;
+    /** Which wallets to show in connect modal (defaults to all) */
+    wallets?: WalletId[];
+    /** Enable SSR hydration support (Next.js App Router) */
+    ssr?: boolean;
+}
+export interface AppMetadata {
+    name: string;
+    description?: string;
+    url: string;
+    icons?: string[];
+}
+export interface NetworkConfig {
+    /** EIP-155 numeric chain ID */
+    id: number;
+    name: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    rpcUrl: string;
+    blockExplorerUrl?: string;
+    testnet?: boolean;
+}
+export type Unsubscribe = () => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"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"}

package/dist/core/types/index.js

@@ -0,0 +1,13 @@
+// ---------------------------------------------------------------------------
+// Connector taxonomy
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Wallet connection state
+// ---------------------------------------------------------------------------
+export const ConnectionStatus = {
+    CONNECTED: 'connected',
+    DISCONNECTED: 'disconnected',
+    CONNECTING: 'connecting',
+    RECONNECTING: 'reconnecting',
+};
+//# sourceMappingURL=index.js.map

package/dist/core/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAoE9E,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;CACpB,CAAC"}

package/dist/core/utils/balance.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Blockchain numeric formatting utilities — BigInt-only, floor-truncated.
+ *
+ * These utilities enforce CLAUDE.md §4 Blockchain Numeric Handling:
+ *  - Inputs are BigInt (never Number) for wei-scale values.
+ *  - Output is a display string; MUST NOT be parsed back into computation.
+ *  - Rounding is floor (truncate toward zero) — users never see more than
+ *    they actually have. BigInt division naturally floors.
+ *
+ * Signed inputs are accepted (e.g. PnL deltas): the sign is preserved and
+ * the magnitude is floor-truncated to `displayDecimals`.
+ */
+/**
+ * Format a BigInt balance in raw base units (e.g. wei) to a human-readable
+ * decimal string with floor truncation at `displayDecimals` digits.
+ *
+ * @param value Raw balance in the smallest unit (wei for ETH, etc.)
+ * @param decimals Token decimals (e.g. 18 for ETH, 6 for USDC)
+ * @param displayDecimals How many fractional digits to show. Defaults to 4.
+ *
+ * @example
+ * formatBalance(1234567890000000000n, 18)     // "1.2345"
+ * formatBalance(1234567890000000000n, 18, 2)  // "1.23"
+ * formatBalance(500000000n, 6)                // "500"
+ * formatBalance(-123n, 0)                      // "-123"
+ */
+export declare function formatBalance(value: bigint, decimals: number, displayDecimals?: number): string;
+/**
+ * Shortcut for 18-decimal tokens (native ETH/CROSS on EVM chains).
+ * Equivalent to `formatBalance(wei, 18, displayDecimals)`.
+ */
+export declare function formatWei(wei: bigint, displayDecimals?: number): string;
+//# sourceMappingURL=balance.d.ts.map

package/dist/core/utils/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../../src/core/utils/balance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,eAAe,SAAI,GAClB,MAAM,CAqCR;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,SAAI,GAAG,MAAM,CAElE"}

package/dist/core/utils/balance.js

@@ -0,0 +1,66 @@
+/**
+ * Blockchain numeric formatting utilities — BigInt-only, floor-truncated.
+ *
+ * These utilities enforce CLAUDE.md §4 Blockchain Numeric Handling:
+ *  - Inputs are BigInt (never Number) for wei-scale values.
+ *  - Output is a display string; MUST NOT be parsed back into computation.
+ *  - Rounding is floor (truncate toward zero) — users never see more than
+ *    they actually have. BigInt division naturally floors.
+ *
+ * Signed inputs are accepted (e.g. PnL deltas): the sign is preserved and
+ * the magnitude is floor-truncated to `displayDecimals`.
+ */
+/**
+ * Format a BigInt balance in raw base units (e.g. wei) to a human-readable
+ * decimal string with floor truncation at `displayDecimals` digits.
+ *
+ * @param value Raw balance in the smallest unit (wei for ETH, etc.)
+ * @param decimals Token decimals (e.g. 18 for ETH, 6 for USDC)
+ * @param displayDecimals How many fractional digits to show. Defaults to 4.
+ *
+ * @example
+ * formatBalance(1234567890000000000n, 18)     // "1.2345"
+ * formatBalance(1234567890000000000n, 18, 2)  // "1.23"
+ * formatBalance(500000000n, 6)                // "500"
+ * formatBalance(-123n, 0)                      // "-123"
+ */
+export function formatBalance(value, decimals, displayDecimals = 4) {
+    if (decimals < 0 || !Number.isInteger(decimals)) {
+        throw new RangeError(`formatBalance: decimals must be a non-negative integer, got ${decimals}`);
+    }
+    if (displayDecimals < 0 || !Number.isInteger(displayDecimals)) {
+        throw new RangeError(`formatBalance: displayDecimals must be a non-negative integer, got ${displayDecimals}`);
+    }
+    const negative = value < 0n;
+    const magnitude = negative ? -value : value;
+    if (decimals === 0) {
+        const integerOnly = magnitude.toString();
+        return negative ? `-${integerOnly}` : integerOnly;
+    }
+    const divisor = 10n ** BigInt(decimals);
+    const whole = magnitude / divisor;
+    const remainder = magnitude % divisor;
+    if (displayDecimals === 0) {
+        const out = whole.toString();
+        return negative ? `-${out}` : out;
+    }
+    const fracFull = remainder.toString().padStart(decimals, '0');
+    // Floor by slicing — never rounds up.
+    const fracSliced = fracFull.slice(0, displayDecimals);
+    // Trailing-zero trim via index walk (avoids /0+$/ regex flagged as ReDoS by
+    // Sonar S5852). Linear, backtracking-free, and cheaper than a regex engine.
+    let end = fracSliced.length;
+    while (end > 0 && fracSliced.charCodeAt(end - 1) === 48)
+        end--;
+    const fracTrimmed = fracSliced.slice(0, end);
+    const body = fracTrimmed ? `${whole}.${fracTrimmed}` : whole.toString();
+    return negative ? `-${body}` : body;
+}
+/**
+ * Shortcut for 18-decimal tokens (native ETH/CROSS on EVM chains).
+ * Equivalent to `formatBalance(wei, 18, displayDecimals)`.
+ */
+export function formatWei(wei, displayDecimals = 4) {
+    return formatBalance(wei, 18, displayDecimals);
+}
+//# sourceMappingURL=balance.js.map

package/dist/core/utils/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../../src/core/utils/balance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,QAAgB,EAChB,eAAe,GAAG,CAAC;IAEnB,IAAI,QAAQ,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,UAAU,CAAC,+DAA+D,QAAQ,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,UAAU,CAClB,sEAAsE,eAAe,EAAE,CACxF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,GAAG,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAE5C,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;QACzC,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IACpD,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC;IAClC,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAEtC,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACpC,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC9D,sCAAsC;IACtC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IACtD,4EAA4E;IAC5E,4EAA4E;IAC5E,IAAI,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC;IAC5B,OAAO,GAAG,GAAG,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,CAAC;IAC/D,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IACxE,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,eAAe,GAAG,CAAC;IACxD,OAAO,aAAa,CAAC,GAAG,EAAE,EAAE,EAAE,eAAe,CAAC,CAAC;AACjD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { ConnectorPort } from './core/ports/ConnectorPort.js';
+export type { StoragePort } from './core/ports/StoragePort.js';
+export type { ModalControlPort } from './core/ports/ModalControlPort.js';
+export type { ThemePort } from './core/ports/ThemePort.js';
+export type { WalletDetectionPort } from './core/ports/WalletDetectionPort.js';
+export type { BalancePort } from './core/ports/BalancePort.js';
+export type { ConnectorType, WalletId, WalletDescriptor, ConnectorResult, Account, ChainBalance, WalletState, ModalView, Theme, ThemeMode, ColorOverrides, ThemeTokens, CrossConnectKitConfig, AppMetadata, NetworkConfig, Unsubscribe, } from './core/types/index.js';
+export { ConnectionStatus } from './core/types/index.js';
+export { DEFAULT_THEME_TOKENS, CCK_VAR, resolveColorTokens, resolveThemeMode, buildThemeCssText, themeTokensToInlineStyle, } from './core/theme/tokens.js';
+export { formatBalance, formatWei } from './core/utils/balance.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG/D,YAAY,EACV,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,OAAO,EACP,YAAY,EACZ,WAAW,EACX,SAAS,EACT,KAAK,EACL,SAAS,EACT,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAKzD,OAAO,EACL,oBAAoB,EACpB,OAAO,EACP,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { ConnectionStatus } from './core/types/index.js';
+// Theme utilities — shared between `@nexus-cross/connect-kit-react` (for
+// the CSS variable runtime) and `@nexus-cross/connect-kit-wagmi` (for
+// forwarding into the crossy-sdk embedded connector).
+export { DEFAULT_THEME_TOKENS, CCK_VAR, resolveColorTokens, resolveThemeMode, buildThemeCssText, themeTokensToInlineStyle, } from './core/theme/tokens.js';
+// Utilities
+export { formatBalance, formatWei } from './core/utils/balance.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,yEAAyE;AACzE,sEAAsE;AACtE,sDAAsD;AACtD,OAAO,EACL,oBAAoB,EACpB,OAAO,EACP,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAEhC,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@nexus-cross/connect-kit-core",
+  "version": "1.0.0-beta.1",
+  "description": "Core domain logic for @nexus-cross/connect-kit — types, ports, utilities",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}