@stableflow/pay-widgets 0.1.0 → 0.2.0-beta-90dffc3d2f-20261012

package/README.md

@@ -24,17 +24,21 @@ The host must use Tailwind v4 and scan both packages. Without the scan, the widg
 
 Import `@stableflow/pay-widgets/token-select`. Render `TokenSelectDialog` inside `PayWidgetsProvider`.
 
-`PayWidgetsProvider` requires `wallet` and `readBalances`. It loads pay config from `https://api.stableflow.ai` unless `apiHost` is set.
+`PayWidgetsProvider` requires `tokens` and `wallet`, plus either `readBalances` or `getBalance`. The host normalizes pay config and passes the flat token list in. The widget does not fetch.
 
 ```tsx
 import {
   PayWidgetsProvider,
   TokenSelectDialog,
+  mapPayConfigSource,
+  normalizePayConfig,
 } from "@stableflow/pay-widgets/token-select";
 
+const tokens = normalizePayConfig(mapPayConfigSource(payload));
+
 export function Picker() {
   return (
-    <PayWidgetsProvider wallet={wallet} readBalances={readBalances}>
+    <PayWidgetsProvider tokens={tokens} wallet={wallet} readBalances={readBalances}>
       <TokenSelectDialog open={open} onClose={onClose} onSelect={onSelect} />
     </PayWidgetsProvider>
   );

package/dist/token-select/index.d.ts

@@ -1,7 +1,8 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 
-type ChainKind = "evm" | "near" | "solana" | "tron" | "zec";
+type ChainKind = string;
+declare const KNOWN_CHAIN_KINDS: readonly ["evm", "near", "solana", "tron", "zec"];
 type PayChain = {
     blockchain: string;
     chainName: string;
@@ -78,17 +79,22 @@ type ReadBalances = (batch: {
     tokens: PayToken[];
 }) => Promise<BalanceReadResult[]>;
 type TokenSelectRole = "payer" | "receiver";
-type ChainOwners = Partial<Record<ChainKind, string>>;
+type ChainOwners = Partial<Record<string, string>>;
+/** Stable identity for the connected owners. Keys are sorted so order does not matter. */
+declare function ownerKey(owners: ChainOwners): string;
 type TokenBalanceStatus = "idle" | "loading" | "success" | "error";
 
 type PayWidgetsProviderProps = {
-    apiHost?: string;
-    popularTokens?: PopularTokenRef[];
+    tokens: PayToken[];
+    loading?: boolean;
     wallet: PayWallet;
-    readBalances: ReadBalances;
-    onConfig?: (config: PayConfigSource) => void;
+    readBalances?: ReadBalances;
+    getBalance?: (token: PayToken, owner: string) => string | null | undefined;
+    isBalanceLoading?: (token: PayToken, owner: string) => boolean;
+    popularTokens?: PopularTokenRef[];
+    stableSymbols?: string[];
+    chainKindLabels?: Record<string, string>;
     onCopyAddress?: (address: string) => void;
-    chainKinds?: Partial<Record<string, ChainKind>>;
     children: ReactNode;
 };
 declare function PayWidgetsProvider(props: PayWidgetsProviderProps): react.JSX.Element;
@@ -96,6 +102,19 @@ declare function PayWidgetsProvider(props: PayWidgetsProviderProps): react.JSX.E
 type TokenSelectSelection = {
     token: PayToken;
 };
+type PaneView = {
+    kind: "wallet";
+} | {
+    kind: "all";
+} | {
+    kind: "rail-chain";
+    blockchain: string;
+} | {
+    kind: "networks";
+} | {
+    kind: "network-chain";
+    blockchain: string;
+};
 type TokenSelectDialogProps = {
     open: boolean;
     onClose: () => void;
@@ -111,6 +130,7 @@ type TokenSelectDialogProps = {
     disabledReason?: string;
     className?: string;
     titleClassName?: string;
+    headerClassName?: string;
     closeClassName?: string;
     contentClassName?: string;
     searchClassName?: string;
@@ -119,33 +139,13 @@ type TokenSelectDialogProps = {
 };
 declare function TokenSelectDialog(props: TokenSelectDialogProps): react.JSX.Element;
 
-type PayConfigStatus = "idle" | "loading" | "success" | "error";
-type PayConfigSnapshot = {
-    apiHost: string;
-    chains: PayChain[];
-    tokens: PayToken[];
-    source: PayConfigSource | null;
-    status: PayConfigStatus;
-    error: string | null;
-    fetchedAt: number | null;
-};
 type ChainKindMap = Partial<Record<string, ChainKind>>;
-declare function mapPayConfigSource(raw: unknown): PayConfigSource;
-declare function normalizePayConfig(source: PayConfigSource, overrides?: ChainKindMap): {
-    chains: PayChain[];
-    tokens: PayToken[];
-};
-declare function usePayConfigSnapshot(): PayConfigSnapshot;
-declare function usePayConfig(options?: {
-    apiHost?: string;
-}): {
-    chains: PayChain[];
-    tokens: PayToken[];
-    source: PayConfigSource | null;
-    status: PayConfigStatus;
-    error: string | null;
-    refetch: () => void;
+type NormalizePayConfigOptions = {
+    chainKinds?: ChainKindMap;
 };
+declare function mapPayConfigSource(raw: unknown): PayConfigSource;
+declare function tokenAssetId(network: string, symbol: string, contractAddress: string | null | undefined): string;
+declare function normalizePayConfig(source: PayConfigSource, options?: NormalizePayConfigOptions): PayToken[];
 
 type TokenBalance = {
     raw: string | null;
@@ -158,8 +158,10 @@ declare function clearPayTokenBalances(): void;
 declare function usePayTokenBalance(owner: string | null | undefined, assetId: string | null | undefined): TokenBalance | undefined;
 declare function refreshPayTokenBalance(owner: string, token: PayToken): Promise<TokenBalance | null>;
 
+declare function chainsFromTokens(tokens: readonly {
+    blockchain: string;
+    chain: PayChain;
+}[]): PayChain[];
 declare function parsePopularTokens(raw: string | null | undefined): PopularTokenRef[];
 
-declare const DEFAULT_API_HOST = "https://api.stableflow.ai";
-
-export { type BalanceReadResult, type ChainKind, type ChainOwners, DEFAULT_API_HOST, type PayChain, type PayConfigSnapshot, type PayConfigSource, type PayConfigStatus, type PayToken, type PayWallet, PayWidgetsProvider, type PayWidgetsProviderProps, type PopularTokenRef, type ReadBalances, type TokenBalance, TokenSelectDialog, type TokenSelectDialogProps, type TokenSelectRole, type TokenSelectSelection, clearPayTokenBalances, mapPayConfigSource, normalizePayConfig, parsePopularTokens, refreshPayTokenBalance, usePayConfig, usePayConfigSnapshot, usePayTokenBalance };
+export { type BalanceReadResult, type ChainKind, type ChainOwners, KNOWN_CHAIN_KINDS, type NormalizePayConfigOptions, type PaneView, type PayChain, type PayConfigSource, type PayToken, type PayWallet, PayWidgetsProvider, type PayWidgetsProviderProps, type PopularTokenRef, type ReadBalances, type TokenBalance, TokenSelectDialog, type TokenSelectDialogProps, type TokenSelectRole, type TokenSelectSelection, chainsFromTokens, clearPayTokenBalances, mapPayConfigSource, normalizePayConfig, ownerKey, parsePopularTokens, refreshPayTokenBalance, tokenAssetId, usePayTokenBalance };