@bufinance/web3-signin 0.1.1 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bufinance/web3-signin",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Headless cross-app Web3 wallet sign-in for BUFI: EIP-6963 wallet discovery + Supabase signInWithWeb3 (EIP-4361) + Turnstile captcha. Shared by desk-v1 and defi-web-app. Source of truth lives here; both apps consume it.",
   "type": "module",
   "main": "./src/index.ts",

package/src/react/wallet-dropdown.tsx

@@ -1,4 +1,4 @@
-import { type ReactNode, useMemo, useState } from "react";
+import { type ReactNode, useEffect, useMemo, useRef, useState } from "react";
 import type { TokenBalance, WalletAccount, WalletScope } from "../types";
 
 /**
@@ -32,8 +32,29 @@ export interface WalletDropdownProps {
   scope?: WalletScope | "all";
   /** Currency formatter for the USD total; defaults to en-US $. */
   formatUsd?: (n: number) => string;
-  /** Extra content inside the open panel — desk injects gateway/hinkal/multisig. */
+  /**
+   * Custom trigger (pill) renderer. When provided, replaces the built-in
+   * text-only pill so a host can render its own rich trigger (icon, animated
+   * total, chevron) while the shell still owns open-state, the auth gate, and
+   * click-outside. The host renders its own button and calls `toggle` on click.
+   * Omit for the default pill (desk).
+   */
+  trigger?: (state: {
+    open: boolean;
+    total: number;
+    toggle: () => void;
+    formatUsd: (n: number) => string;
+  }) => ReactNode;
+  /** Extra content inside the open panel — desk injects gateway/hinkal/multisig;
+   *  defi-web injects its full per-chain balance body (net toggle, ghost, APY). */
   children?: ReactNode;
+  /**
+   * Render the built-in flat balance rows for the active account. Default true
+   * (desk). Set false when the host renders its own richer balance body via
+   * `children` (defi-web's per-chain grouped list) — the `accounts` balances
+   * are then used only for the pill total, not drawn as rows.
+   */
+  renderBalances?: boolean;
   /** Shown when authed but no accounts yet (provisioning). */
   emptyState?: ReactNode;
   onSelectAccount?: (account: WalletAccount) => void;
@@ -53,7 +74,9 @@ export function WalletDropdown(props: WalletDropdownProps): ReactNode {
     accounts,
     scope = "all",
     formatUsd = defaultFormatUsd,
+    trigger,
     children,
+    renderBalances = true,
     emptyState,
     onSelectAccount,
     classNames = {},
@@ -66,6 +89,27 @@ export function WalletDropdown(props: WalletDropdownProps): ReactNode {
 
   const [open, setOpen] = useState(false);
   const [activeId, setActiveId] = useState<string | null>(null);
+  const rootRef = useRef<HTMLDivElement>(null);
+
+  // Dependency-light popover ergonomics (no radix): click-outside + Escape close.
+  // Both consuming apps get this for free, so neither has to re-implement it.
+  useEffect(() => {
+    if (!open) return;
+    const onPointerDown = (e: MouseEvent): void => {
+      if (rootRef.current && !rootRef.current.contains(e.target as Node)) {
+        setOpen(false);
+      }
+    };
+    const onKeyDown = (e: KeyboardEvent): void => {
+      if (e.key === "Escape") setOpen(false);
+    };
+    document.addEventListener("mousedown", onPointerDown);
+    document.addEventListener("keydown", onKeyDown);
+    return () => {
+      document.removeEventListener("mousedown", onPointerDown);
+      document.removeEventListener("keydown", onKeyDown);
+    };
+  }, [open]);
 
   // Auth gate — the whole surface is hidden until sign-in passes.
   if (!authed) return null;
@@ -73,17 +117,23 @@ export function WalletDropdown(props: WalletDropdownProps): ReactNode {
   const active = visible.find((a) => a.id === activeId) ?? visible[0];
   const pillTotal = active ? totalUsd(active.balances) : 0;
 
+  const toggle = (): void => setOpen((v) => !v);
+
   return (
-    <div className={classNames.root} data-bufi-wallet>
-      <button
-        type="button"
-        aria-label="Open Stablecoin FX Wallet"
-        aria-expanded={open}
-        className={classNames.pill ?? "acct-mini"}
-        onClick={() => setOpen((v) => !v)}
-      >
-        {formatUsd(pillTotal)}
-      </button>
+    <div ref={rootRef} className={classNames.root} data-bufi-wallet>
+      {trigger ? (
+        trigger({ open, total: pillTotal, toggle, formatUsd })
+      ) : (
+        <button
+          type="button"
+          aria-label="Open Stablecoin FX Wallet"
+          aria-expanded={open}
+          className={classNames.pill ?? "acct-mini"}
+          onClick={toggle}
+        >
+          {formatUsd(pillTotal)}
+        </button>
+      )}
 
       {open && (
         <div role="menu" className={classNames.panel} data-bufi-wallet-panel>
@@ -114,7 +164,7 @@ export function WalletDropdown(props: WalletDropdownProps): ReactNode {
                   </div>
                 )}
 
-                {active && (
+                {renderBalances && active && (
                   <div className={classNames.accountRow}>
                     {active.balances.length === 0
                       ? (emptyState ?? null)