@kheopskit/core 5.3.0 → 6.0.0-rc.0

package/dist/walletconnect.mjs

@@ -0,0 +1,216 @@
+import { g as clearCachedObservablesByPrefix, l as WALLET_CONNECT_WALLET_ID, n as isWalletConnectWallet, s as toConnectError } from "./types-Yor672md.mjs";
+import { BehaviorSubject, Observable, distinctUntilChanged, from, map, of, shareReplay, switchMap, tap } from "rxjs";
+//#region src/api/walletconnect/plugin.ts
+/**
+* Dynamically import @reown/appkit/core to avoid loading browser-only code
+* during SSR or in edge runtimes like Cloudflare Workers.
+* The AppKit library uses Lit for web components which requires document.
+*/
+const loadAppKit = async () => {
+	try {
+		const { createAppKit } = await import("@reown/appkit/core");
+		return createAppKit;
+	} catch (cause) {
+		console.error("[kheopskit] WalletConnect is configured but @reown/appkit could not be loaded. Install it with `pnpm add @reown/appkit` (or remove config.walletConnect). WalletConnect wallets are disabled; injected wallets still work.", cause);
+		return null;
+	}
+};
+const WALLET_CONNECT_ICON = "data:image/svg+xml;base64,PHN2ZyBmaWxsPSJub25lIiBoZWlnaHQ9IjQwMCIgdmlld0JveD0iMCAwIDQwMCA0MDAiIHdpZHRoPSI0MDAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiPjxjbGlwUGF0aCBpZD0iYSI+PHBhdGggZD0ibTAgMGg0MDB2NDAwaC00MDB6Ii8+PC9jbGlwUGF0aD48ZyBjbGlwLXBhdGg9InVybCgjYSkiPjxjaXJjbGUgY3g9IjIwMCIgY3k9IjIwMCIgZmlsbD0iIzMzOTZmZiIgcj0iMTk5LjUiIHN0cm9rZT0iIzY2YjFmZiIvPjxwYXRoIGQ9Im0xMjIuNTE5IDE0OC45NjVjNDIuNzkxLTQxLjcyOSAxMTIuMTcxLTQxLjcyOSAxNTQuOTYyIDBsNS4xNSA1LjAyMmMyLjE0IDIuMDg2IDIuMTQgNS40NjkgMCA3LjU1NWwtMTcuNjE3IDE3LjE4Yy0xLjA3IDEuMDQzLTIuODA0IDEuMDQzLTMuODc0IDBsLTcuMDg3LTYuOTExYy0yOS44NTMtMjkuMTExLTc4LjI1My0yOS4xMTEtMTA4LjEwNiAwbC03LjU5IDcuNDAxYy0xLjA3IDEuMDQzLTIuODA0IDEuMDQzLTMuODc0IDBsLTE3LjYxNy0xNy4xOGMtMi4xNC0yLjA4Ni0yLjE0LTUuNDY5IDAtNy41NTV6bTE5MS4zOTcgMzUuNTI5IDE1LjY3OSAxNS4yOWMyLjE0IDIuMDg2IDIuMTQgNS40NjkgMCA3LjU1NWwtNzAuNyA2OC45NDRjLTIuMTM5IDIuMDg3LTUuNjA4IDIuMDg3LTcuNzQ4IDBsLTUwLjE3OC00OC45MzFjLS41MzUtLjUyMi0xLjQwMi0uNTIyLTEuOTM3IDBsLTUwLjE3OCA0OC45MzFjLTIuMTM5IDIuMDg3LTUuNjA4IDIuMDg3LTcuNzQ4IDBsLTcwLjcwMTUtNjguOTQ1Yy0yLjEzOTYtMi4wODYtMi4xMzk2LTUuNDY5IDAtNy41NTVsMTUuNjc5NS0xNS4yOWMyLjEzOTYtMi4wODYgNS42MDg1LTIuMDg2IDcuNzQ4MSAwbDUwLjE3ODkgNDguOTMyYy41MzUuNTIyIDEuNDAyLjUyMiAxLjkzNyAwbDUwLjE3Ny00OC45MzJjMi4xMzktMi4wODcgNS42MDgtMi4wODcgNy43NDggMGw1MC4xNzkgNDguOTMyYy41MzUuNTIyIDEuNDAyLjUyMiAxLjkzNyAwbDUwLjE3OS00OC45MzFjMi4xMzktMi4wODcgNS42MDgtMi4wODcgNy43NDggMHoiIGZpbGw9IiNmZmYiLz48L2c+PC9zdmc+";
+const APPKIT_SYMBOL = Symbol.for("kheopskit.cachedAppKit");
+const APPKIT_PROJECT_ID_SYMBOL = Symbol.for("kheopskit.cachedAppKitProjectId");
+const getCachedAppKit = () => globalThis[APPKIT_SYMBOL];
+const getCachedAppKitProjectId = () => globalThis[APPKIT_PROJECT_ID_SYMBOL];
+const setCachedAppKit = (value, projectId) => {
+	globalThis[APPKIT_SYMBOL] = value;
+	globalThis[APPKIT_PROJECT_ID_SYMBOL] = projectId;
+};
+/**
+* Clears the cached AppKit observable.
+* Use when configuration changes or for testing purposes.
+* Note: This does NOT destroy the appKit instance created by Reown.
+*/
+const resetAppKitCache = () => {
+	setCachedAppKit(void 0);
+};
+/**
+* Keys are `accounts:<walletId>:...`; the trailing colon scopes the prefix to
+* this wallet and avoids matching a sibling whose id is a string prefix.
+*/
+const dropAccountsCache = (platform) => {
+	clearCachedObservablesByPrefix(`accounts:${WALLET_CONNECT_WALLET_ID}:${platform}:`);
+};
+const namespaceOf = {
+	polkadot: "polkadot",
+	ethereum: "eip155",
+	solana: "solana"
+};
+const allPlatforms = [
+	"polkadot",
+	"ethereum",
+	"solana"
+];
+const createConnector$ = (appKit) => {
+	const appKitInstance = appKit;
+	const status$ = new BehaviorSubject({
+		isPolkadotConnected: false,
+		isEthereumConnected: false,
+		isSolanaConnected: false,
+		opening: false,
+		error: void 0
+	});
+	const syncProviders = (providers) => {
+		status$.next({
+			...status$.value,
+			isPolkadotConnected: !!providers.polkadot,
+			isEthereumConnected: !!providers.eip155,
+			isSolanaConnected: !!providers.solana
+		});
+	};
+	const openModal = async () => {
+		status$.next({
+			...status$.value,
+			opening: true,
+			error: void 0
+		});
+		try {
+			await appKit.open();
+		} catch (cause) {
+			const error = toConnectError(cause, WALLET_CONNECT_WALLET_ID, () => false);
+			status$.next({
+				...status$.value,
+				opening: false,
+				error
+			});
+			throw error;
+		}
+		status$.next({
+			...status$.value,
+			opening: false
+		});
+	};
+	const enabledPlatforms = allPlatforms.filter((p) => appKit.chainNamespaces.includes(namespaceOf[p]));
+	let prevConnected = {
+		polkadot: false,
+		ethereum: false,
+		solana: false
+	};
+	const wallet$ = status$.pipe(map((s) => ({
+		polkadot: s.isPolkadotConnected,
+		ethereum: s.isEthereumConnected,
+		solana: s.isSolanaConnected,
+		opening: s.opening,
+		error: s.error
+	})), distinctUntilChanged((a, b) => a.polkadot === b.polkadot && a.ethereum === b.ethereum && a.solana === b.solana && a.opening === b.opening && a.error === b.error), tap((connected) => {
+		for (const platform of allPlatforms) if (prevConnected[platform] && !connected[platform]) dropAccountsCache(platform);
+		prevConnected = connected;
+	}), map(({ opening, error, ...connected }) => {
+		const platforms = enabledPlatforms.filter((p) => connected[p]);
+		const isConnected = platforms.length > 0;
+		const walletInfo = appKit.getWalletInfo();
+		return {
+			id: WALLET_CONNECT_WALLET_ID,
+			type: "walletconnect",
+			platforms,
+			appKit: appKitInstance,
+			name: walletInfo?.name ?? "WalletConnect",
+			icon: walletInfo?.icon ?? WALLET_CONNECT_ICON,
+			connect: async () => {
+				if (!isConnected) await openModal();
+			},
+			disconnect: async () => {
+				if (isConnected) await appKit.disconnect();
+			},
+			status: isConnected ? "connected" : opening ? "connecting" : "disconnected",
+			error,
+			isConnected
+		};
+	}));
+	return new Observable((subscriber) => {
+		for (const platform of allPlatforms) dropAccountsCache(platform);
+		syncProviders({
+			polkadot: appKit.getProvider("polkadot"),
+			eip155: appKit.getProvider("eip155"),
+			solana: appKit.getProvider("solana")
+		});
+		const unsubProviders = appKit.subscribeProviders(syncProviders);
+		const sub = wallet$.subscribe(subscriber);
+		return () => {
+			sub.unsubscribe();
+			unsubProviders();
+		};
+	});
+};
+/**
+* @remarks
+* The AppKit instance is a process-wide singleton: a second instance would
+* share AppKit's module-level controller state with the first, so it is
+* created once. The **first** call with a `walletConnect` config wins;
+* later calls with a *different* `walletConnect` config reuse that first
+* instance. Call {@link resetAppKitCache} before re-initialising if the
+* WalletConnect config must change.
+*
+* One WalletConnect session is shared across every namespace, and a namespace
+* can only be established during the initial pairing — it can't be added to a
+* live session afterwards. So this exposes ONE connector (not one per platform):
+* `connect()` opens the modal; the wallet approves whichever namespaces it
+* supports in that single pairing, and `platforms` reflects what the live
+* session carries. Per-namespace accounts are derived by each platform plugin.
+*/
+const getWalletConnectWallet$ = (walletConnect, debug) => {
+	if (typeof window === "undefined") return of(null);
+	const cachedProjectId = getCachedAppKitProjectId();
+	if (cachedProjectId !== void 0 && cachedProjectId !== walletConnect.projectId) console.warn("[kheopskit] WalletConnect is already initialised with projectId %s; AppKit is a process-wide singleton, so the first configuration wins and projectId %s is ignored. Call resetAppKitCache() before re-initialising if the WalletConnect config must change.", cachedProjectId, walletConnect.projectId);
+	let cachedAppKit = getCachedAppKit();
+	if (!cachedAppKit) {
+		cachedAppKit = from(loadAppKit()).pipe(map((createAppKit) => createAppKit ? createConnector$(createAppKit({
+			projectId: walletConnect.projectId,
+			metadata: walletConnect.metadata,
+			networks: walletConnect.networks,
+			themeMode: walletConnect.themeMode,
+			themeVariables: walletConnect.themeVariables,
+			universalProviderConfigOverride: { methods: {
+				polkadot: ["polkadot_signTransaction", "polkadot_signMessage"],
+				solana: [
+					"solana_signTransaction",
+					"solana_signMessage",
+					"solana_signAndSendTransaction"
+				]
+			} },
+			allWallets: "HIDE",
+			debug,
+			allowUnsupportedChain: true
+		})) : null), shareReplay({
+			refCount: false,
+			bufferSize: 1
+		})).pipe(switchMap((wallet$) => wallet$ ?? of(null)), shareReplay({
+			refCount: true,
+			bufferSize: 1
+		}));
+		setCachedAppKit(cachedAppKit, walletConnect.projectId);
+	}
+	return cachedAppKit;
+};
+/**
+* The WalletConnect plugin for `config.walletConnect`. Importing this entry is
+* what brings Reown AppKit into a dapp's bundle; a dapp that never imports it
+* ships none of it.
+*
+* @example
+* ```ts
+* import { walletConnect } from "@kheopskit/core/walletconnect";
+*
+* getKheopskit$({
+*   platforms: [polkadot()],
+*   walletConnect: walletConnect({ projectId, metadata, networks }),
+* });
+* ```
+*/
+const walletConnect = (options) => ({
+	type: "walletconnect",
+	metadata: options.metadata,
+	getWallet$: ({ config }) => getWalletConnectWallet$(options, config.debug)
+});
+//#endregion
+export { isWalletConnectWallet, resetAppKitCache, walletConnect };
+
+//# sourceMappingURL=walletconnect.mjs.map

package/dist/walletconnect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletconnect.mjs","names":[],"sources":["../src/api/walletconnect/plugin.ts"],"sourcesContent":["import type { AppKit } from \"@reown/appkit/core\";\nimport {\n\tBehaviorSubject,\n\tdistinctUntilChanged,\n\tfrom,\n\tmap,\n\tObservable,\n\tof,\n\tshareReplay,\n\tswitchMap,\n\ttap,\n} from \"rxjs\";\nimport { clearCachedObservablesByPrefix } from \"../../utils/getCachedObservable\";\nimport { WALLET_CONNECT_WALLET_ID } from \"../../utils/WalletId\";\nimport { type KheopskitError, toConnectError } from \"../errors\";\nimport type {\n\tAppKitInstance,\n\tWalletConnectMetadata,\n\tWalletConnectPlugin,\n\tWalletConnectWallet,\n\tWalletPlatform,\n} from \"../types\";\n\nexport type WalletConnectOptions = {\n\tprojectId: string;\n\tmetadata: WalletConnectMetadata;\n\t/**\n\t * Networks AppKit should enable. Pass `AppKitNetwork[]` from\n\t * `@reown/appkit/networks` (see\n\t * https://docs.reown.com/advanced/multichain/polkadot/dapp-integration-guide#walletconnect-code%2Fcomponent-setup).\n\t * Loosely typed (`unknown`) so the declarations don't depend on\n\t * `@reown/appkit`'s types; the value is forwarded to AppKit as-is.\n\t */\n\tnetworks: [unknown, ...unknown[]];\n\tthemeMode?: \"light\" | \"dark\";\n\tthemeVariables?: Record<string, string | number>;\n};\n\n/**\n * Dynamically import @reown/appkit/core to avoid loading browser-only code\n * during SSR or in edge runtimes like Cloudflare Workers.\n * The AppKit library uses Lit for web components which requires document.\n */\nconst loadAppKit = async () => {\n\ttry {\n\t\tconst { createAppKit } = await import(\"@reown/appkit/core\");\n\t\treturn createAppKit;\n\t} catch (cause) {\n\t\tconsole.error(\n\t\t\t\"[kheopskit] WalletConnect is configured but @reown/appkit could not be loaded. \" +\n\t\t\t\t\"Install it with `pnpm add @reown/appkit` (or remove config.walletConnect). \" +\n\t\t\t\t\"WalletConnect wallets are disabled; injected wallets still work.\",\n\t\t\tcause,\n\t\t);\n\t\treturn null;\n\t}\n};\n\nconst WALLET_CONNECT_ICON =\n\t\"data:image/svg+xml;base64,PHN2ZyBmaWxsPSJub25lIiBoZWlnaHQ9IjQwMCIgdmlld0JveD0iMCAwIDQwMCA0MDAiIHdpZHRoPSI0MDAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiPjxjbGlwUGF0aCBpZD0iYSI+PHBhdGggZD0ibTAgMGg0MDB2NDAwaC00MDB6Ii8+PC9jbGlwUGF0aD48ZyBjbGlwLXBhdGg9InVybCgjYSkiPjxjaXJjbGUgY3g9IjIwMCIgY3k9IjIwMCIgZmlsbD0iIzMzOTZmZiIgcj0iMTk5LjUiIHN0cm9rZT0iIzY2YjFmZiIvPjxwYXRoIGQ9Im0xMjIuNTE5IDE0OC45NjVjNDIuNzkxLTQxLjcyOSAxMTIuMTcxLTQxLjcyOSAxNTQuOTYyIDBsNS4xNSA1LjAyMmMyLjE0IDIuMDg2IDIuMTQgNS40NjkgMCA3LjU1NWwtMTcuNjE3IDE3LjE4Yy0xLjA3IDEuMDQzLTIuODA0IDEuMDQzLTMuODc0IDBsLTcuMDg3LTYuOTExYy0yOS44NTMtMjkuMTExLTc4LjI1My0yOS4xMTEtMTA4LjEwNiAwbC03LjU5IDcuNDAxYy0xLjA3IDEuMDQzLTIuODA0IDEuMDQzLTMuODc0IDBsLTE3LjYxNy0xNy4xOGMtMi4xNC0yLjA4Ni0yLjE0LTUuNDY5IDAtNy41NTV6bTE5MS4zOTcgMzUuNTI5IDE1LjY3OSAxNS4yOWMyLjE0IDIuMDg2IDIuMTQgNS40NjkgMCA3LjU1NWwtNzAuNyA2OC45NDRjLTIuMTM5IDIuMDg3LTUuNjA4IDIuMDg3LTcuNzQ4IDBsLTUwLjE3OC00OC45MzFjLS41MzUtLjUyMi0xLjQwMi0uNTIyLTEuOTM3IDBsLTUwLjE3OCA0OC45MzFjLTIuMTM5IDIuMDg3LTUuNjA4IDIuMDg3LTcuNzQ4IDBsLTcwLjcwMTUtNjguOTQ1Yy0yLjEzOTYtMi4wODYtMi4xMzk2LTUuNDY5IDAtNy41NTVsMTUuNjc5NS0xNS4yOWMyLjEzOTYtMi4wODYgNS42MDg1LTIuMDg2IDcuNzQ4MSAwbDUwLjE3ODkgNDguOTMyYy41MzUuNTIyIDEuNDAyLjUyMiAxLjkzNyAwbDUwLjE3Ny00OC45MzJjMi4xMzktMi4wODcgNS42MDgtMi4wODcgNy43NDggMGw1MC4xNzkgNDguOTMyYy41MzUuNTIyIDEuNDAyLjUyMiAxLjkzNyAwbDUwLjE3OS00OC45MzFjMi4xMzktMi4wODcgNS42MDgtMi4wODcgNy43NDggMHoiIGZpbGw9IiNmZmYiLz48L2c+PC9zdmc+\";\n\n// Once it exists, the appKit object should never be recreated. Anchored on\n// globalThis so it stays a single instance even if this module is duplicated\n// across bundle chunks (e.g. CJS subpath entries).\nconst APPKIT_SYMBOL = Symbol.for(\"kheopskit.cachedAppKit\");\n// The projectId AppKit was first initialised with. AppKit is a process-wide\n// singleton, so a later call with a different WalletConnect config is silently\n// ignored — we keep this to warn loudly instead of letting it pass unnoticed.\nconst APPKIT_PROJECT_ID_SYMBOL = Symbol.for(\"kheopskit.cachedAppKitProjectId\");\ntype AppKitGlobal = Record<\n\tsymbol,\n\tObservable<WalletConnectWallet | null> | string | undefined\n>;\nconst getCachedAppKit = ():\n\t| Observable<WalletConnectWallet | null>\n\t| undefined =>\n\t(globalThis as unknown as AppKitGlobal)[APPKIT_SYMBOL] as\n\t\t| Observable<WalletConnectWallet | null>\n\t\t| undefined;\nconst getCachedAppKitProjectId = (): string | undefined =>\n\t(globalThis as unknown as AppKitGlobal)[APPKIT_PROJECT_ID_SYMBOL] as\n\t\t| string\n\t\t| undefined;\nconst setCachedAppKit = (\n\tvalue: Observable<WalletConnectWallet | null> | undefined,\n\tprojectId?: string,\n): void => {\n\t(globalThis as unknown as AppKitGlobal)[APPKIT_SYMBOL] = value;\n\t(globalThis as unknown as AppKitGlobal)[APPKIT_PROJECT_ID_SYMBOL] = projectId;\n};\n\n/**\n * Clears the cached AppKit observable.\n * Use when configuration changes or for testing purposes.\n * Note: This does NOT destroy the appKit instance created by Reown.\n */\nexport const resetAppKitCache = (): void => {\n\tsetCachedAppKit(undefined);\n};\n\n/**\n * Keys are `accounts:<walletId>:...`; the trailing colon scopes the prefix to\n * this wallet and avoids matching a sibling whose id is a string prefix.\n */\nconst dropAccountsCache = (platform: WalletPlatform): void => {\n\tclearCachedObservablesByPrefix(\n\t\t`accounts:${WALLET_CONNECT_WALLET_ID}:${platform}:`,\n\t);\n};\n\nconst namespaceOf: Record<WalletPlatform, string> = {\n\tpolkadot: \"polkadot\",\n\tethereum: \"eip155\",\n\tsolana: \"solana\",\n};\nconst allPlatforms: WalletPlatform[] = [\"polkadot\", \"ethereum\", \"solana\"];\n\nconst createConnector$ = (appKit: AppKit): Observable<WalletConnectWallet> => {\n\t// Exposed on the wallet as the (decoupled) AppKitInstance escape hatch.\n\tconst appKitInstance = appKit as unknown as AppKitInstance;\n\n\tconst status$ = new BehaviorSubject<{\n\t\tisPolkadotConnected: boolean;\n\t\tisEthereumConnected: boolean;\n\t\tisSolanaConnected: boolean;\n\t\topening: boolean;\n\t\terror: KheopskitError | undefined;\n\t}>({\n\t\tisPolkadotConnected: false,\n\t\tisEthereumConnected: false,\n\t\tisSolanaConnected: false,\n\t\topening: false,\n\t\terror: undefined,\n\t});\n\n\tconst syncProviders = (providers: Partial<Record<string, unknown>>) => {\n\t\tstatus$.next({\n\t\t\t...status$.value,\n\t\t\tisPolkadotConnected: !!providers.polkadot,\n\t\t\tisEthereumConnected: !!providers.eip155,\n\t\t\tisSolanaConnected: !!providers.solana,\n\t\t});\n\t};\n\n\tconst openModal = async () => {\n\t\tstatus$.next({ ...status$.value, opening: true, error: undefined });\n\t\ttry {\n\t\t\tawait appKit.open();\n\t\t} catch (cause) {\n\t\t\tconst error = toConnectError(\n\t\t\t\tcause,\n\t\t\t\tWALLET_CONNECT_WALLET_ID,\n\t\t\t\t() => false,\n\t\t\t);\n\t\t\tstatus$.next({ ...status$.value, opening: false, error });\n\t\t\tthrow error;\n\t\t}\n\t\tstatus$.next({ ...status$.value, opening: false });\n\t};\n\n\tconst enabledPlatforms = allPlatforms.filter((p) =>\n\t\t(appKit.chainNamespaces as string[]).includes(namespaceOf[p]),\n\t);\n\n\tlet prevConnected = {\n\t\tpolkadot: false,\n\t\tethereum: false,\n\t\tsolana: false,\n\t};\n\n\tconst wallet$ = status$.pipe(\n\t\tmap((s) => ({\n\t\t\tpolkadot: s.isPolkadotConnected,\n\t\t\tethereum: s.isEthereumConnected,\n\t\t\tsolana: s.isSolanaConnected,\n\t\t\topening: s.opening,\n\t\t\terror: s.error,\n\t\t})),\n\t\tdistinctUntilChanged(\n\t\t\t(a, b) =>\n\t\t\t\ta.polkadot === b.polkadot &&\n\t\t\t\ta.ethereum === b.ethereum &&\n\t\t\t\ta.solana === b.solana &&\n\t\t\t\ta.opening === b.opening &&\n\t\t\t\ta.error === b.error,\n\t\t),\n\t\ttap((connected) => {\n\t\t\t// Drop caches for namespaces that just went disconnected.\n\t\t\tfor (const platform of allPlatforms)\n\t\t\t\tif (prevConnected[platform] && !connected[platform])\n\t\t\t\t\tdropAccountsCache(platform);\n\t\t\tprevConnected = connected;\n\t\t}),\n\t\tmap(({ opening, error, ...connected }): WalletConnectWallet => {\n\t\t\tconst platforms = enabledPlatforms.filter((p) => connected[p]);\n\t\t\tconst isConnected = platforms.length > 0;\n\t\t\tconst walletInfo = appKit.getWalletInfo();\n\t\t\treturn {\n\t\t\t\tid: WALLET_CONNECT_WALLET_ID,\n\t\t\t\ttype: \"walletconnect\",\n\t\t\t\tplatforms,\n\t\t\t\tappKit: appKitInstance,\n\t\t\t\tname: walletInfo?.name ?? \"WalletConnect\",\n\t\t\t\ticon: walletInfo?.icon ?? WALLET_CONNECT_ICON,\n\t\t\t\t// One shared session: connecting opens the modal; the wallet\n\t\t\t\t// approves namespaces in that single pairing. Disconnect is\n\t\t\t\t// session-wide; re-pair to change the approved set.\n\t\t\t\tconnect: async () => {\n\t\t\t\t\tif (!isConnected) await openModal();\n\t\t\t\t},\n\t\t\t\tdisconnect: async () => {\n\t\t\t\t\tif (isConnected) await appKit.disconnect();\n\t\t\t\t},\n\t\t\t\tstatus: isConnected\n\t\t\t\t\t? \"connected\"\n\t\t\t\t\t: opening\n\t\t\t\t\t\t? \"connecting\"\n\t\t\t\t\t\t: \"disconnected\",\n\t\t\t\terror,\n\t\t\t\tisConnected,\n\t\t\t};\n\t\t}),\n\t);\n\n\treturn new Observable<WalletConnectWallet>((subscriber) => {\n\t\tfor (const platform of allPlatforms) dropAccountsCache(platform);\n\t\t// AppKit's subscribeProviders only reports later changes, so read the\n\t\t// state that may have changed while nobody observed.\n\t\tsyncProviders({\n\t\t\tpolkadot: appKit.getProvider(\"polkadot\"),\n\t\t\teip155: appKit.getProvider(\"eip155\"),\n\t\t\tsolana: appKit.getProvider(\"solana\"),\n\t\t});\n\t\tconst unsubProviders = appKit.subscribeProviders(syncProviders);\n\t\tconst sub = wallet$.subscribe(subscriber);\n\t\treturn () => {\n\t\t\tsub.unsubscribe();\n\t\t\tunsubProviders();\n\t\t};\n\t});\n};\n\n/**\n * @remarks\n * The AppKit instance is a process-wide singleton: a second instance would\n * share AppKit's module-level controller state with the first, so it is\n * created once. The **first** call with a `walletConnect` config wins;\n * later calls with a *different* `walletConnect` config reuse that first\n * instance. Call {@link resetAppKitCache} before re-initialising if the\n * WalletConnect config must change.\n *\n * One WalletConnect session is shared across every namespace, and a namespace\n * can only be established during the initial pairing — it can't be added to a\n * live session afterwards. So this exposes ONE connector (not one per platform):\n * `connect()` opens the modal; the wallet approves whichever namespaces it\n * supports in that single pairing, and `platforms` reflects what the live\n * session carries. Per-namespace accounts are derived by each platform plugin.\n */\nconst getWalletConnectWallet$ = (\n\twalletConnect: WalletConnectOptions,\n\tdebug: boolean,\n): Observable<WalletConnectWallet | null> => {\n\t// SSR guard - don't try to load AppKit on the server\n\tif (typeof window === \"undefined\") return of(null);\n\n\tconst cachedProjectId = getCachedAppKitProjectId();\n\tif (\n\t\tcachedProjectId !== undefined &&\n\t\tcachedProjectId !== walletConnect.projectId\n\t) {\n\t\tconsole.warn(\n\t\t\t\"[kheopskit] WalletConnect is already initialised with projectId %s; \" +\n\t\t\t\t\"AppKit is a process-wide singleton, so the first configuration wins and \" +\n\t\t\t\t\"projectId %s is ignored. Call resetAppKitCache() before re-initialising \" +\n\t\t\t\t\"if the WalletConnect config must change.\",\n\t\t\tcachedProjectId,\n\t\t\twalletConnect.projectId,\n\t\t);\n\t}\n\n\tlet cachedAppKit = getCachedAppKit();\n\tif (!cachedAppKit) {\n\t\t// Dynamic import avoids loading @reown/appkit at module-eval time (SSR /\n\t\t// edge runtimes like Cloudflare Workers).\n\t\tconst connectorOnce$ = from(loadAppKit()).pipe(\n\t\t\tmap((createAppKit) =>\n\t\t\t\t// @reown/appkit missing (optional peer dep) — degrade gracefully.\n\t\t\t\tcreateAppKit\n\t\t\t\t\t? createConnector$(\n\t\t\t\t\t\t\tcreateAppKit({\n\t\t\t\t\t\t\t\tprojectId: walletConnect.projectId,\n\t\t\t\t\t\t\t\tmetadata: walletConnect.metadata,\n\t\t\t\t\t\t\t\tnetworks: walletConnect.networks as never,\n\t\t\t\t\t\t\t\tthemeMode: walletConnect.themeMode,\n\t\t\t\t\t\t\t\tthemeVariables: walletConnect.themeVariables as never,\n\t\t\t\t\t\t\t\tuniversalProviderConfigOverride: {\n\t\t\t\t\t\t\t\t\tmethods: {\n\t\t\t\t\t\t\t\t\t\tpolkadot: [\n\t\t\t\t\t\t\t\t\t\t\t\"polkadot_signTransaction\",\n\t\t\t\t\t\t\t\t\t\t\t\"polkadot_signMessage\",\n\t\t\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t\t\t\tsolana: [\n\t\t\t\t\t\t\t\t\t\t\t\"solana_signTransaction\",\n\t\t\t\t\t\t\t\t\t\t\t\"solana_signMessage\",\n\t\t\t\t\t\t\t\t\t\t\t\"solana_signAndSendTransaction\",\n\t\t\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tallWallets: \"HIDE\",\n\t\t\t\t\t\t\t\tdebug,\n\t\t\t\t\t\t\t\tallowUnsupportedChain: true,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t)\n\t\t\t\t\t: null,\n\t\t\t),\n\t\t\tshareReplay({ refCount: false, bufferSize: 1 }),\n\t\t);\n\t\tcachedAppKit = connectorOnce$.pipe(\n\t\t\tswitchMap((wallet$) => wallet$ ?? of(null)),\n\t\t\tshareReplay({ refCount: true, bufferSize: 1 }),\n\t\t);\n\t\tsetCachedAppKit(cachedAppKit, walletConnect.projectId);\n\t}\n\n\treturn cachedAppKit;\n};\n\n/**\n * The WalletConnect plugin for `config.walletConnect`. Importing this entry is\n * what brings Reown AppKit into a dapp's bundle; a dapp that never imports it\n * ships none of it.\n *\n * @example\n * ```ts\n * import { walletConnect } from \"@kheopskit/core/walletconnect\";\n *\n * getKheopskit$({\n *   platforms: [polkadot()],\n *   walletConnect: walletConnect({ projectId, metadata, networks }),\n * });\n * ```\n */\nexport const walletConnect = (\n\toptions: WalletConnectOptions,\n): WalletConnectPlugin => ({\n\ttype: \"walletconnect\",\n\tmetadata: options.metadata,\n\tgetWallet$: ({ config }) => getWalletConnectWallet$(options, config.debug),\n});\n"],"mappings":"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"}

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@kheopskit/core",
-  "version": "5.3.0",
-  "description": "",
+  "version": "6.0.0-rc.0",
+  "description": "Framework-agnostic wallet and account discovery for Polkadot, Ethereum and Solana dapps. Upgrading from v5? Read MIGRATING_TO_V6.md, shipped in this package.",
   "private": false,
   "sideEffects": false,
   "files": [
     "dist",
     "README.md",
-    "MIGRATING_TO_V4.md"
+    "MIGRATING_TO_V4.md",
+    "MIGRATING_TO_V6.md",
+    "CHANGELOG.md"
   ],
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -53,6 +55,16 @@
         "default": "./dist/solana.js"
       }
     },
+    "./walletconnect": {
+      "import": {
+        "types": "./dist/walletconnect.d.mts",
+        "default": "./dist/walletconnect.mjs"
+      },
+      "require": {
+        "types": "./dist/walletconnect.d.ts",
+        "default": "./dist/walletconnect.js"
+      }
+    },
     "./internal": {
       "import": {
         "types": "./dist/internal.d.mts",
@@ -63,6 +75,16 @@
         "default": "./dist/internal.js"
       }
     },
+    "./testing": {
+      "import": {
+        "types": "./dist/testing.d.mts",
+        "default": "./dist/testing.mjs"
+      },
+      "require": {
+        "types": "./dist/testing.d.ts",
+        "default": "./dist/testing.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -122,9 +144,9 @@
     "@wallet-standard/base": "^1.1.1",
     "@wallet-standard/features": "^1.1.1",
     "mipd": "^0.0.7",
-    "polkadot-api": "^3.2.0",
+    "polkadot-api": "^3.2.1",
     "rxjs": "^7.8.2",
-    "viem": "^2.57.0"
+    "viem": "^2.57.3"
   },
   "tsdown": {
     "entry": [
@@ -132,7 +154,9 @@
       "src/polkadot.ts",
       "src/ethereum.ts",
       "src/solana.ts",
-      "src/internal.ts"
+      "src/walletconnect.ts",
+      "src/internal.ts",
+      "src/testing.ts"
     ],
     "tsconfig": "tsconfig.build.json",
     "fixedExtension": false,

package/dist/errors-BLFP1dQI.mjs

@@ -1,181 +0,0 @@
-import { keccak_256 } from "@noble/hashes/sha3.js";
-import { base58 } from "@scure/base";
-import { blake2b } from "@noble/hashes/blake2.js";
-//#region src/utils/isEthereumAddress.ts
-const HEX_ADDRESS = /^0x[0-9a-fA-F]{40}$/;
-const encoder = new TextEncoder();
-/**
-* Verifies the EIP-55 mixed-case checksum of an Ethereum address.
-* Dependency-free (keccak via @noble/hashes) so core stays decoupled from viem.
-*/
-const isChecksumValid = (address) => {
-	const hex = address.slice(2);
-	const hash = keccak_256(encoder.encode(hex.toLowerCase()));
-	for (let i = 0; i < 40; i++) {
-		const char = hex.charAt(i);
-		if (!(char >= "a" && char <= "f" || char >= "A" && char <= "F")) continue;
-		const byte = hash[i >> 1] ?? 0;
-		const nibble = i % 2 === 0 ? byte >> 4 : byte & 15;
-		if (char <= "F" !== nibble >= 8) return false;
-	}
-	return true;
-};
-/**
-* Returns true if `address` is a valid Ethereum address.
-*
-* Mirrors viem's `isAddress` (strict): the shape must be `0x` + 40 hex, and a
-* mixed-case address must pass the EIP-55 checksum. All-lowercase addresses are
-* accepted as non-checksummed.
-*/
-const isEthereumAddress = (address) => {
-	if (!HEX_ADDRESS.test(address)) return false;
-	if (address === address.toLowerCase()) return true;
-	return isChecksumValid(address);
-};
-//#endregion
-//#region src/utils/isSolanaAddress.ts
-/**
-* Returns true if the value is a valid Solana address: a base58-encoded
-* 32-byte ed25519 public key.
-*
-* Solana addresses carry no checksum, so this is a pure base58 + length check.
-* Dependency-free (base58 via @scure/base) so core stays decoupled from
-* @solana/kit.
-*/
-const isSolanaAddress = (address) => {
-	if (!address) return false;
-	try {
-		return base58.decode(address).length === 32;
-	} catch {
-		return false;
-	}
-};
-//#endregion
-//#region src/utils/isSs58Address.ts
-const SS58PRE = new Uint8Array([
-	83,
-	83,
-	53,
-	56,
-	80,
-	82,
-	69
-]);
-/**
-* Returns true if `address` is a valid SS58-encoded 32-byte account id (the
-* only form Substrate wallets inject), verifying the blake2b-512 checksum.
-*
-* Dependency-free (base58 via @scure/base, blake2b via @noble/hashes) so core
-* stays decoupled from polkadot-api.
-*/
-const isSs58Address = (address) => {
-	if (!address) return false;
-	let decoded;
-	try {
-		decoded = base58.decode(address);
-	} catch {
-		return false;
-	}
-	const firstByte = decoded[0];
-	if (firstByte === void 0 || firstByte & 128) return false;
-	const prefixLength = firstByte & 64 ? 2 : 1;
-	if (decoded.length !== prefixLength + 32 + 2) return false;
-	const body = decoded.subarray(0, decoded.length - 2);
-	const preimage = new Uint8Array(SS58PRE.length + body.length);
-	preimage.set(SS58PRE);
-	preimage.set(body, SS58PRE.length);
-	const hash = blake2b(preimage, { dkLen: 64 });
-	return decoded[decoded.length - 2] === hash[0] && decoded[decoded.length - 1] === hash[1];
-};
-//#endregion
-//#region src/utils/isValidAddress.ts
-const isValidAddress = (address) => {
-	if (address.startsWith("0x")) return isEthereumAddress(address);
-	return isSs58Address(address) || isSolanaAddress(address);
-};
-//#endregion
-//#region src/utils/WalletAccountId.ts
-const getWalletAccountId = (walletId, address) => {
-	if (!walletId) throw new Error("Missing walletId");
-	if (!isValidAddress(address)) throw new Error("Invalid address");
-	return `${walletId}::${address}`;
-};
-const parseWalletAccountId = (accountId) => {
-	if (!accountId) throw new Error("Invalid walletAccountId");
-	const [walletId, address] = accountId.split("::");
-	if (!walletId) throw new Error("Missing walletId");
-	if (!address || !isValidAddress(address)) throw new Error("Invalid address");
-	return {
-		walletId,
-		address
-	};
-};
-//#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/typeof.js
-function _typeof(o) {
-	"@babel/helpers - typeof";
-	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
-		return typeof o;
-	} : function(o) {
-		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
-	}, _typeof(o);
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/toPrimitive.js
-function toPrimitive(t, r) {
-	if ("object" != _typeof(t) || !t) return t;
-	var e = t[Symbol.toPrimitive];
-	if (void 0 !== e) {
-		var i = e.call(t, r || "default");
-		if ("object" != _typeof(i)) return i;
-		throw new TypeError("@@toPrimitive must return a primitive value.");
-	}
-	return ("string" === r ? String : Number)(t);
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/toPropertyKey.js
-function toPropertyKey(t) {
-	var i = toPrimitive(t, "string");
-	return "symbol" == _typeof(i) ? i : i + "";
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/defineProperty.js
-function _defineProperty(e, r, t) {
-	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
-		value: t,
-		enumerable: !0,
-		configurable: !0,
-		writable: !0
-	}) : e[r] = t, e;
-}
-//#endregion
-//#region src/api/errors.ts
-/**
-* Error thrown by kheopskit wallet/account operations. Carries a stable
-* {@link KheopskitErrorCode} and, when relevant, the offending wallet id.
-*
-* @example
-* ```ts
-* try {
-*   await wallet.connect();
-* } catch (error) {
-*   if (error instanceof KheopskitError && error.code === "WALLET_ALREADY_CONNECTED") {
-*     // ignore
-*   } else throw error;
-* }
-* ```
-*/
-var KheopskitError = class extends Error {
-	constructor(code, message, options) {
-		super(`[kheopskit] ${message}`, { cause: options?.cause });
-		_defineProperty(this, "code", void 0);
-		_defineProperty(this, "walletId", void 0);
-		this.name = "KheopskitError";
-		this.code = code;
-		this.walletId = options?.walletId;
-	}
-};
-//#endregion
-export { isSs58Address as a, isValidAddress as i, getWalletAccountId as n, isSolanaAddress as o, parseWalletAccountId as r, isEthereumAddress as s, KheopskitError as t };
-
-//# sourceMappingURL=errors-BLFP1dQI.mjs.map

package/dist/errors-BLFP1dQI.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors-BLFP1dQI.mjs","names":[],"sources":["../src/utils/isEthereumAddress.ts","../src/utils/isSolanaAddress.ts","../src/utils/isSs58Address.ts","../src/utils/isValidAddress.ts","../src/utils/WalletAccountId.ts","../src/api/errors.ts"],"sourcesContent":["import { keccak_256 } from \"@noble/hashes/sha3.js\";\n\nconst HEX_ADDRESS = /^0x[0-9a-fA-F]{40}$/;\nconst encoder = new TextEncoder();\n\n/**\n * Verifies the EIP-55 mixed-case checksum of an Ethereum address.\n * Dependency-free (keccak via @noble/hashes) so core stays decoupled from viem.\n */\nconst isChecksumValid = (address: string): boolean => {\n\tconst hex = address.slice(2);\n\tconst hash = keccak_256(encoder.encode(hex.toLowerCase()));\n\tfor (let i = 0; i < 40; i++) {\n\t\tconst char = hex.charAt(i);\n\t\tconst isLetter =\n\t\t\t(char >= \"a\" && char <= \"f\") || (char >= \"A\" && char <= \"F\");\n\t\tif (!isLetter) continue;\n\t\tconst byte = hash[i >> 1] ?? 0;\n\t\tconst nibble = i % 2 === 0 ? byte >> 4 : byte & 0x0f;\n\t\tconst isUpper = char <= \"F\";\n\t\tif (isUpper !== nibble >= 8) return false;\n\t}\n\treturn true;\n};\n\n/**\n * Returns true if `address` is a valid Ethereum address.\n *\n * Mirrors viem's `isAddress` (strict): the shape must be `0x` + 40 hex, and a\n * mixed-case address must pass the EIP-55 checksum. All-lowercase addresses are\n * accepted as non-checksummed.\n */\nexport const isEthereumAddress = (address: string): boolean => {\n\tif (!HEX_ADDRESS.test(address)) return false;\n\tif (address === address.toLowerCase()) return true;\n\treturn isChecksumValid(address);\n};\n","import { base58 } from \"@scure/base\";\n\n/**\n * Returns true if the value is a valid Solana address: a base58-encoded\n * 32-byte ed25519 public key.\n *\n * Solana addresses carry no checksum, so this is a pure base58 + length check.\n * Dependency-free (base58 via @scure/base) so core stays decoupled from\n * @solana/kit.\n */\nexport const isSolanaAddress = (address: string): boolean => {\n\tif (!address) return false;\n\ttry {\n\t\treturn base58.decode(address).length === 32;\n\t} catch {\n\t\treturn false;\n\t}\n};\n","import { blake2b } from \"@noble/hashes/blake2.js\";\nimport { base58 } from \"@scure/base\";\n\n// The \"SS58PRE\" prefix used in the SS58 checksum preimage.\nconst SS58PRE = new Uint8Array([0x53, 0x53, 0x35, 0x38, 0x50, 0x52, 0x45]);\n\n/**\n * Returns true if `address` is a valid SS58-encoded 32-byte account id (the\n * only form Substrate wallets inject), verifying the blake2b-512 checksum.\n *\n * Dependency-free (base58 via @scure/base, blake2b via @noble/hashes) so core\n * stays decoupled from polkadot-api.\n */\nexport const isSs58Address = (address: string): boolean => {\n\tif (!address) return false;\n\n\tlet decoded: Uint8Array;\n\ttry {\n\t\tdecoded = base58.decode(address);\n\t} catch {\n\t\treturn false;\n\t}\n\n\t// First byte encodes the network prefix; the high bit is reserved/invalid.\n\tconst firstByte = decoded[0];\n\tif (firstByte === undefined || firstByte & 0b1000_0000) return false;\n\t// The 0b0100_0000 bit marks a 2-byte prefix.\n\tconst prefixLength = firstByte & 0b0100_0000 ? 2 : 1;\n\n\t// AccountId32 layout: prefix + 32-byte pubkey + 2-byte checksum.\n\tif (decoded.length !== prefixLength + 32 + 2) return false;\n\n\tconst body = decoded.subarray(0, decoded.length - 2);\n\tconst preimage = new Uint8Array(SS58PRE.length + body.length);\n\tpreimage.set(SS58PRE);\n\tpreimage.set(body, SS58PRE.length);\n\tconst hash = blake2b(preimage, { dkLen: 64 });\n\n\treturn (\n\t\tdecoded[decoded.length - 2] === hash[0] &&\n\t\tdecoded[decoded.length - 1] === hash[1]\n\t);\n};\n","import { isEthereumAddress } from \"./isEthereumAddress\";\nimport { isSolanaAddress } from \"./isSolanaAddress\";\nimport { isSs58Address } from \"./isSs58Address\";\n\nexport const isValidAddress = (address: string): boolean => {\n\tif (address.startsWith(\"0x\")) return isEthereumAddress(address);\n\t// SS58 (checksummed) and Solana (base58, no checksum) are disjoint: a\n\t// 32-byte Solana pubkey fails SS58 decoding, and an SS58 address decodes to\n\t// more than 32 bytes so it fails the Solana length check.\n\treturn isSs58Address(address) || isSolanaAddress(address);\n};\n","import { isValidAddress } from \"./isValidAddress\";\n\nexport type WalletAccountId = string;\n\nexport const getWalletAccountId = (\n\twalletId: string,\n\taddress: string,\n): WalletAccountId => {\n\tif (!walletId) throw new Error(\"Missing walletId\");\n\tif (!isValidAddress(address)) throw new Error(\"Invalid address\");\n\treturn `${walletId}::${address}`;\n};\n\nexport const parseWalletAccountId = (accountId: string) => {\n\tif (!accountId) throw new Error(\"Invalid walletAccountId\");\n\tconst [walletId, address] = accountId.split(\"::\");\n\tif (!walletId) throw new Error(\"Missing walletId\");\n\tif (!address || !isValidAddress(address)) throw new Error(\"Invalid address\");\n\treturn { walletId, address };\n};\n","import type { WalletId } from \"../utils/WalletId\";\n\n/**\n * Stable error codes thrown by kheopskit. Catch a {@link KheopskitError} and\n * branch on `error.code` instead of matching message strings.\n */\nexport type KheopskitErrorCode =\n\t/** `connect()` called on a wallet that is already connected. */\n\t| \"WALLET_ALREADY_CONNECTED\"\n\t/** `disconnect()` called on a wallet that is not connected. */\n\t| \"WALLET_NOT_CONNECTED\"\n\t/** The wallet does not advertise a capability kheopskit needs to proceed. */\n\t| \"FEATURE_NOT_SUPPORTED\"\n\t/** No active WalletConnect session for the requested operation. */\n\t| \"NO_SESSION\"\n\t/** No provider available for the requested namespace. */\n\t| \"NO_PROVIDER\"\n\t/** The installed polkadot-api version exposes neither `getTxCreatorFromPjs` (v3) nor `getPolkadotSignerFromPjs` (v2). */\n\t| \"UNSUPPORTED_VERSION\"\n\t/** The requested chain cannot be used for this operation (e.g. a Solana cluster with no CAIP-2 id over WalletConnect). */\n\t| \"UNSUPPORTED_CHAIN\";\n\n/**\n * Error thrown by kheopskit wallet/account operations. Carries a stable\n * {@link KheopskitErrorCode} and, when relevant, the offending wallet id.\n *\n * @example\n * ```ts\n * try {\n *   await wallet.connect();\n * } catch (error) {\n *   if (error instanceof KheopskitError && error.code === \"WALLET_ALREADY_CONNECTED\") {\n *     // ignore\n *   } else throw error;\n * }\n * ```\n */\nexport class KheopskitError extends Error {\n\treadonly code: KheopskitErrorCode;\n\t/** The wallet id this error relates to, when applicable. */\n\treadonly walletId?: WalletId;\n\n\tconstructor(\n\t\tcode: KheopskitErrorCode,\n\t\tmessage: string,\n\t\toptions?: { walletId?: WalletId; cause?: unknown },\n\t) {\n\t\tsuper(`[kheopskit] ${message}`, { cause: options?.cause });\n\t\tthis.name = \"KheopskitError\";\n\t\tthis.code = code;\n\t\tthis.walletId = options?.walletId;\n\t}\n}\n"],"mappings":";;;;AAEA,MAAM,cAAc;AACpB,MAAM,UAAU,IAAI,YAAY;;;;;AAMhC,MAAM,mBAAmB,YAA6B;CACrD,MAAM,MAAM,QAAQ,MAAM,CAAC;CAC3B,MAAM,OAAO,WAAW,QAAQ,OAAO,IAAI,YAAY,CAAC,CAAC;CACzD,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;EAC5B,MAAM,OAAO,IAAI,OAAO,CAAC;EAGzB,IAAI,EADF,QAAQ,OAAO,QAAQ,OAAS,QAAQ,OAAO,QAAQ,MAC1C;EACf,MAAM,OAAO,KAAK,KAAK,MAAM;EAC7B,MAAM,SAAS,IAAI,MAAM,IAAI,QAAQ,IAAI,OAAO;EAEhD,IADgB,QAAQ,QACR,UAAU,GAAG,OAAO;CACrC;CACA,OAAO;AACR;;;;;;;;AASA,MAAa,qBAAqB,YAA6B;CAC9D,IAAI,CAAC,YAAY,KAAK,OAAO,GAAG,OAAO;CACvC,IAAI,YAAY,QAAQ,YAAY,GAAG,OAAO;CAC9C,OAAO,gBAAgB,OAAO;AAC/B;;;;;;;;;;;AC1BA,MAAa,mBAAmB,YAA6B;CAC5D,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI;EACH,OAAO,OAAO,OAAO,OAAO,CAAC,CAAC,WAAW;CAC1C,QAAQ;EACP,OAAO;CACR;AACD;;;ACbA,MAAM,UAAU,IAAI,WAAW;CAAC;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;AAAI,CAAC;;;;;;;;AASzE,MAAa,iBAAiB,YAA6B;CAC1D,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI;CACJ,IAAI;EACH,UAAU,OAAO,OAAO,OAAO;CAChC,QAAQ;EACP,OAAO;CACR;CAGA,MAAM,YAAY,QAAQ;CAC1B,IAAI,cAAc,KAAA,KAAa,YAAY,KAAa,OAAO;CAE/D,MAAM,eAAe,YAAY,KAAc,IAAI;CAGnD,IAAI,QAAQ,WAAW,eAAe,KAAK,GAAG,OAAO;CAErD,MAAM,OAAO,QAAQ,SAAS,GAAG,QAAQ,SAAS,CAAC;CACnD,MAAM,WAAW,IAAI,WAAW,QAAQ,SAAS,KAAK,MAAM;CAC5D,SAAS,IAAI,OAAO;CACpB,SAAS,IAAI,MAAM,QAAQ,MAAM;CACjC,MAAM,OAAO,QAAQ,UAAU,EAAE,OAAO,GAAG,CAAC;CAE5C,OACC,QAAQ,QAAQ,SAAS,OAAO,KAAK,MACrC,QAAQ,QAAQ,SAAS,OAAO,KAAK;AAEvC;;;ACtCA,MAAa,kBAAkB,YAA6B;CAC3D,IAAI,QAAQ,WAAW,IAAI,GAAG,OAAO,kBAAkB,OAAO;CAI9D,OAAO,cAAc,OAAO,KAAK,gBAAgB,OAAO;AACzD;;;ACNA,MAAa,sBACZ,UACA,YACqB;CACrB,IAAI,CAAC,UAAU,MAAM,IAAI,MAAM,kBAAkB;CACjD,IAAI,CAAC,eAAe,OAAO,GAAG,MAAM,IAAI,MAAM,iBAAiB;CAC/D,OAAO,GAAG,SAAS,IAAI;AACxB;AAEA,MAAa,wBAAwB,cAAsB;CAC1D,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,yBAAyB;CACzD,MAAM,CAAC,UAAU,WAAW,UAAU,MAAM,IAAI;CAChD,IAAI,CAAC,UAAU,MAAM,IAAI,MAAM,kBAAkB;CACjD,IAAI,CAAC,WAAW,CAAC,eAAe,OAAO,GAAG,MAAM,IAAI,MAAM,iBAAiB;CAC3E,OAAO;EAAE;EAAU;CAAQ;AAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACkBA,IAAa,iBAAb,cAAoC,MAAM;CAKzC,YACC,MACA,SACA,SACC;EACD,MAAM,eAAe,WAAW,EAAE,OAAO,SAAS,MAAM,CAAC;EATjD,gBAAA,MAAA,QAAA,KAAA,CAAA;EAEA,gBAAA,MAAA,YAAA,KAAA,CAAA;EAQR,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,WAAW,SAAS;CAC1B;AACD"}