@chainberry/ui-components 1.0.24 → 1.0.26

package/dist/index.d.ts

@@ -30,6 +30,8 @@ export declare function ActionFooter({ actions, bleed, className, ...props }: {
     className?: string;
 } & Omit<ComponentProps<"div">, "className">): JSX.Element;
 
+declare type ActionKey = 'approve' | 'reject' | 'refund' | 'verify';
+
 /** Fields every activity row carries, regardless of kind. */
 declare type ActivityBase = {
     /** stable id + React key */
@@ -49,25 +51,11 @@ export declare namespace activityData {
     }
 }
 
-export declare function ActivityDetailPanel({ record, open, onOpenChange, show, onApprove, onReject, }: {
+export declare function ActivityDetailPanel({ record, open, onOpenChange, }: {
     record: TreasuryActivityRecord | null;
     open: boolean;
     onOpenChange: (open: boolean) => void;
-    /** per-section visibility — every section defaults to shown */
-    show?: ActivityDetailVisibility;
-    onApprove?: () => void;
-    onReject?: () => void;
-}): JSX.Element;
-
-/** Per-section visibility — every section defaults to shown. Lets a caller (or a
- story) trim sections without touching the panel. */
-declare type ActivityDetailVisibility = {
-    timeline?: boolean;
-    approvals?: boolean;
-    compliance?: boolean;
-    onchain?: boolean;
-    notes?: boolean;
-};
+}): JSX.Element;
 
 declare type ActivityFilter = {
     kinds: ActivityKind[];
@@ -280,10 +268,23 @@ export declare namespace balancesData {
     }
 }
 
+export declare namespace balancesDataV3 {
+    export {
+        vaultTotalFiat,
+        vaultsTotals,
+        VaultKind,
+        VaultRow,
+        Vault,
+        VAULTS
+    }
+}
+
 export declare function BalancesPage(): JSX.Element;
 
 export declare function BalancesPageV2(): JSX.Element;
 
+export declare function BalancesPageV3(): JSX.Element;
+
 export declare namespace balancesRecentTransactions {
     export {
         RecentTxDirection,
@@ -683,6 +684,12 @@ declare type DateField = 'createdAt' | 'confirmedAt';
 /** Default (English) tier column headers; override via the `tierLabels` prop. */
 export declare const DEFAULT_TIER_LABELS: Record<WalletTier, string>;
 
+/** Default (English) copy; override any subset via the `labels` prop. */
+export declare const DEFAULT_V3_LABELS: WalletBalancesTableV3Labels;
+
+/** Default (English) action labels; override via the `labels` prop. */
+export declare const DEFAULT_WALLET_ACTION_LABELS: Record<WalletActionId, string>;
+
 /** Past incoming deposits — the audit trail of received funds. Mixed senders,
  receiving wallets, chains and statuses (confirmed / processing / pending). */
 declare const DEPOSIT_HISTORY: DepositRecord[];
@@ -892,8 +899,11 @@ declare const EXPORT_HISTORY: ExportEntry[];
 declare type ExportEntry = {
     id: string;
     file: string;
+    /** human period label shown in the row, e.g. "Jun 2026" */
     period: string;
     generatedBy: string;
+    /** the period this export covered — lets a re-download regenerate its data */
+    selection?: PeriodSelection;
 };
 
 export declare function ExportHistoryList({ entries, onDownload, }: {
@@ -1400,7 +1410,9 @@ export declare function NavSection({ label, icon, expanded, onToggle, controls,
     controls?: string;
 }): JSX.Element;
 
-/** A row "needs action" — awaiting approval or flagged for a currency mismatch. */
+/** A row "needs action" — the operator review queue. Exactly three cases:
+ *  Deposit · Pending Approval, Withdrawal · Pending Approval, and
+ *  Deposit · Currency Mismatch. Nothing else enters the queue. */
 declare function needsAction(tx: Transaction): boolean;
 
 /** A blockchain a coin can arrive over, e.g. { code: "ETH", name: "Ethereum" }. */
@@ -2060,21 +2072,17 @@ declare type TransactionDetail = {
     blockchainDetails: BlockchainDetails_2[];
 };
 
-export declare function TransactionDetailPanel({ detail, open, actionRequired, onOpenChange, show, onApprove, onReject, approveActionTitle, rejectActionTitle, approveActionDescription, rejectActionDescription, }: {
+export declare function TransactionDetailPanel({ detail, open, actionRequired, onOpenChange, show, onApprove, onReject, }: {
     detail: TransactionDetail | undefined;
     open: boolean;
     actionRequired?: boolean;
     onOpenChange: (open: boolean) => void;
     /** per-section, per-field visibility — every value defaults to shown */
     show?: TransactionDetailVisibility;
-    /** Risk Assessment approve/reject handlers (Pending Approval / Currency Mismatch) */
-    onApprove?: (id: string) => void;
-    onReject?: (id: string) => void;
-    /** Custom titles and descriptions for approve/reject actions */
-    approveActionTitle?: string;
-    rejectActionTitle?: string;
-    approveActionDescription?: string;
-    rejectActionDescription?: string;
+    /** fired when an approve/verify flow is confirmed (after 2FA) */
+    onApprove?: (key: ActionKey) => void;
+    /** fired when a reject/refund flow is confirmed (after 2FA) */
+    onReject?: (key: ActionKey) => void;
 }): JSX.Element;
 
 export declare type TransactionDetailVisibility = {
@@ -2104,7 +2112,8 @@ export declare function TransactionReference({ detail, show, className, }: {
 
 export declare type TransactionReferenceField = 'transactionUid' | 'partnerPaymentId';
 
-/** Full ledger — the hand-written sample plus 243 generated test rows. */
+/** Full ledger — the curated Action-Required seed, the hand-written sample and
+ 243 generated test rows. */
 declare const TRANSACTIONS: Transaction[];
 
 export declare namespace transactionsData {
@@ -2310,6 +2319,49 @@ export declare function UserMenu({ name, avatarSrc, navMode, onNavModeChange, he
     fullWidth?: boolean;
 }): JSX.Element;
 
+/** A vault and the currency/network rows it holds. */
+declare type Vault = {
+    kind: VaultKind;
+    label: string;
+    /** Short description under the vault name. */
+    description: string;
+    rows: VaultRow[];
+};
+
+/** The two treasury vaults. */
+declare type VaultKind = "operation" | "treasury";
+
+/** One currency/network holding inside a vault — a single table row. */
+declare type VaultRow = {
+    id: string;
+    /** Asset ticker, e.g. "USDT". */
+    code: string;
+    /** Full currency name, e.g. "Tether". */
+    name: string;
+    /** Network code for the badge (resolved via coinSrc), e.g. "TRON". */
+    network: string;
+    /** Network label shown under the code, e.g. "Tron". */
+    networkName: string;
+    amount: string;
+    amountFiat: string;
+    /** Pending crypto figure; omit when the row holds no pending funds. */
+    pending?: string;
+    pendingFiat?: string;
+};
+
+declare const VAULTS: Vault[];
+
+/** Roll-up shown in the summary card at the top of the Balances V3 screen. */
+declare function vaultsTotals(vaults: Vault[]): {
+    totalAssets: string;
+    totalPending: string;
+    activeWallets: number;
+    totalWallets: number;
+};
+
+/** Fiat subtotal for a single vault. */
+declare function vaultTotalFiat(vault: Vault): string;
+
 /** A named wallet within a currency, on a specific network. */
 declare type Wallet = {
     id: string;
@@ -2357,6 +2409,35 @@ export declare function WalletBalancesTableV2({ balances, actionsVariant, tierLa
     className?: string;
 }): JSX.Element;
 
+export declare function WalletBalancesTableV3({ vaults, actionsVariant, onRowAction, rowActions, labels, className, }: {
+    vaults: Vault[];
+    actionsVariant?: "icons" | "menu";
+    /** Fired when a row's action is chosen. Without it the menu still renders
+     but does nothing — pass `rowActions={[]}` to drop it entirely. */
+    onRowAction?: (action: WalletActionId, row: VaultRow, vault: Vault) => void;
+    /** Which actions each row offers, in order. Defaults to all three; `[]`
+     renders no actions column content (read-only view). */
+    rowActions?: WalletActionId[];
+    /** Translated copy; unset keys fall back to English. */
+    labels?: Partial<WalletBalancesTableV3Labels>;
+    className?: string;
+}): JSX.Element;
+
+/** Translatable strings the table renders itself. Everything else — vault
+ labels and descriptions, the figures — comes in through `vaults`. */
+export declare type WalletBalancesTableV3Labels = {
+    /** Left column header. */
+    currencyNetwork: string;
+    /** Right column header. */
+    balance: string;
+    /** Trailing word on a row's amber pending line, e.g. "+1,500.00 pending". */
+    pending: string;
+    /** A vault's asset count, e.g. (3) => "3 assets". */
+    assets: (count: number) => string;
+    /** Row action menu items. */
+    actions: Partial<Record<WalletActionId, string>>;
+};
+
 export declare function WalletField({ id, label, placeholder, value, onChange, wallets, emptyMessage, variant, disabled, className, }: {
     id?: string;
     label?: ReactNode;
@@ -2397,11 +2478,15 @@ declare type WalletRef = {
 
 export declare function WalletRowActions({ variant, 
     /** context for accessible labels, e.g. the wallet name */
-    label, onAction, }: {
+    label, onAction, actions, labels, }: {
     variant?: "icons" | "menu";
     label?: string;
     onAction?: (id: WalletActionId) => void;
-}): JSX.Element;
+    /** Which actions to offer, in order. Defaults to all three. */
+    actions?: WalletActionId[];
+    /** Translated action labels; unset keys fall back to English. */
+    labels?: Partial<Record<WalletActionId, string>>;
+}): JSX.Element | null;
 
 /** The risk tier a wallet belongs to in the V2 (four-tier) treasury split.
  Machine-readable and locale-independent — `name` is display text and must