aegis-swap-widget 0.2.0 → 0.3.0

package/dist/components/icons.d.ts

@@ -1,6 +1,6 @@
 import type { AegisSwapMarket, AegisSwapToken } from '../config';
-import { type AegisSwapGlobalTokenMetadata } from '../metadata';
-export type TokenMetadataByAddress = Record<string, AegisSwapGlobalTokenMetadata>;
+import { type TokenMetadataByAddress } from '../metadata';
+export type { TokenMetadataByAddress } from '../metadata';
 export declare const TokenIconMark: import("react").NamedExoticComponent<{
     token: AegisSwapToken;
     metadataByAddress: TokenMetadataByAddress;
@@ -15,9 +15,16 @@ export declare function AegisLogoMark(): import("react").JSX.Element;
 export declare function EthereumDiamondMark({ className }: {
     className: string;
 }): import("react").JSX.Element;
+export declare function BaseChainMark({ className }: {
+    className: string;
+}): import("react").JSX.Element;
 export declare function SwapDirectionIcon(): import("react").JSX.Element;
 export declare function ExternalLinkIcon(): import("react").JSX.Element;
 export declare function CopyIcon(): import("react").JSX.Element;
 export declare function CheckIcon(): import("react").JSX.Element;
 export declare function ChevronDownIcon(): import("react").JSX.Element;
 export declare function SlidersIcon(): import("react").JSX.Element;
+export declare function SpinnerIcon(): import("react").JSX.Element;
+export declare function AlertCircleIcon(): import("react").JSX.Element;
+export declare function InfoIcon(): import("react").JSX.Element;
+export declare function CloseIcon(): import("react").JSX.Element;

package/dist/core.d.ts

@@ -0,0 +1,15 @@
+export { AEGIS_DYNAMIC_FEE_FLAG, AEGIS_SWAP_CHAINS, AEGIS_SWAP_CHAIN_ID, AEGIS_SWAP_DEFAULT_FEE_BPS, AEGIS_SWAP_DEFAULT_FEE_RECIPIENT, AEGIS_SWAP_DEFAULT_METADATA_ENDPOINT, AEGIS_SWAP_DEFAULT_POOL_IDS, AEGIS_SWAP_DEFAULT_RPC_URLS, AEGIS_SWAP_HOOK, AEGIS_SWAP_MAINNET_CHAIN, AEGIS_SWAP_MAINNET_UNISWAP_V4_CONTRACTS, AEGIS_SWAP_MARKETS, AEGIS_SWAP_PERMIT2, AEGIS_SWAP_ROUTER, AEGIS_SWAP_TOKENS, AEGIS_SWAP_V4_QUOTER, UNISWAP_V4_CONTRACTS_BY_CHAIN, createAegisSwapChainConfig, createAegisSwapChains, createAegisSwapMarketsFromPools, createAegisSwapPoolMarket, createAegisSwapUniswapV4Contracts, getExplorerUrl } from './config';
+export type { AegisPoolKey, AegisSwapBuiltInAssetSymbol, AegisSwapBuiltInMarketId, AegisSwapBuiltInTokenSymbol, AegisSwapChainConfig, AegisSwapChainConfigInput, AegisSwapFeeConfig, AegisSwapMarket, AegisSwapPoolConfig, AegisSwapToken, AegisSwapTokenSymbol, AegisSwapUniswapV4Contracts, AegisSwapUniswapV4ContractsInput } from './config';
+export { assertUint128, buildExactInSwapTransaction, buildExactOutSwapTransaction, computePoolId, MAX_UINT128 } from './encoding';
+export type { BuiltSwapTransaction, ExecutionBatch, PermitBatch, PermitDetails, SignedPermitBatch, SwapOutputFee } from './encoding';
+export { fetchDirectSwapQuote, getZeroForOne, outputFeeForQuote, quoteSpendAmount, reconcileSubmitQuote, sameQuote } from './quote';
+export type { DirectSwapQuote, ReconciledSubmitQuote, SwapQuoteMode } from './quote';
+export { approveErc20ToPermit2, approvePermit2ToRouter, buildSignedPermitBatch, DEFAULT_PERMIT_EXPIRATION_SECONDS, MAX_UINT160, MAX_UINT256, PERMIT2_FAR_FUTURE_EXPIRATION, readPermit2RouterAllowance, SWAP_TX_DEADLINE_SECONDS } from './permit';
+export { fetchGlobalTokenMetadata, getIchiIconGuess, resolveTokenIconUrl } from './metadata';
+export type { AegisSwapGlobalTokenMetadata, TokenMetadataByAddress } from './metadata';
+export { createSwapPublicClient, getInjectedProvider, getProviderAccount, getProviderChainId, isEip1193Provider, normalizeAccount, normalizeWalletConnection, requestProviderAccount, subscribeProvider, switchProviderChain } from './wallet';
+export type { AegisSwapProviderResolver, AegisSwapWalletConnection, Eip1193Provider, ProviderChainConfig } from './wallet';
+export { errorMessage, isUserRejectedError } from './errors';
+export { isBusy, transactionProgressView } from './transactionProgress';
+export type { AegisSwapStatusSnapshot, AegisSwapWalletPromptProgress, SubmitStatus, TransactionProgressState, TransactionProgressView } from './transactionProgress';
+export { isDocumentVisible, pollUntil, retryOnError } from './polling';

package/dist/core.js

@@ -0,0 +1,66 @@
+import { A as e, a as A, b as r, c as _, d as t, e as o, f as S, g as E, h as i, i as I, j as P, k as n, l as c, m as T, n as l, o as u, D as N, M as U, p, q as C, P as G, S as R, U as W, r as d, s as D, t as O, u as F, v as g, w as M, x as m, y as w, z as v, B as L, C as b, E as h, F as V, G as X, H, I as Q, J as f, K as k, L as x, N as B, O as K, Q as j, R as q, T as y, V as z, W as Y, X as Z, Y as J, Z as $, _ as aa, $ as sa, a0 as ea, a1 as Aa, a2 as ra, a3 as _a, a4 as ta, a5 as oa, a6 as Sa, a7 as Ea, a8 as ia } from "./polling-BI4pZg8Z.js";
+export {
+  e as AEGIS_DYNAMIC_FEE_FLAG,
+  A as AEGIS_SWAP_CHAINS,
+  r as AEGIS_SWAP_CHAIN_ID,
+  _ as AEGIS_SWAP_DEFAULT_FEE_BPS,
+  t as AEGIS_SWAP_DEFAULT_FEE_RECIPIENT,
+  o as AEGIS_SWAP_DEFAULT_METADATA_ENDPOINT,
+  S as AEGIS_SWAP_DEFAULT_POOL_IDS,
+  E as AEGIS_SWAP_DEFAULT_RPC_URLS,
+  i as AEGIS_SWAP_HOOK,
+  I as AEGIS_SWAP_MAINNET_CHAIN,
+  P as AEGIS_SWAP_MAINNET_UNISWAP_V4_CONTRACTS,
+  n as AEGIS_SWAP_MARKETS,
+  c as AEGIS_SWAP_PERMIT2,
+  T as AEGIS_SWAP_ROUTER,
+  l as AEGIS_SWAP_TOKENS,
+  u as AEGIS_SWAP_V4_QUOTER,
+  N as DEFAULT_PERMIT_EXPIRATION_SECONDS,
+  U as MAX_UINT128,
+  p as MAX_UINT160,
+  C as MAX_UINT256,
+  G as PERMIT2_FAR_FUTURE_EXPIRATION,
+  R as SWAP_TX_DEADLINE_SECONDS,
+  W as UNISWAP_V4_CONTRACTS_BY_CHAIN,
+  d as approveErc20ToPermit2,
+  D as approvePermit2ToRouter,
+  O as assertUint128,
+  F as buildExactInSwapTransaction,
+  g as buildExactOutSwapTransaction,
+  M as buildSignedPermitBatch,
+  m as computePoolId,
+  w as createAegisSwapChainConfig,
+  v as createAegisSwapChains,
+  L as createAegisSwapMarketsFromPools,
+  b as createAegisSwapPoolMarket,
+  h as createAegisSwapUniswapV4Contracts,
+  V as createSwapPublicClient,
+  X as errorMessage,
+  H as fetchDirectSwapQuote,
+  Q as fetchGlobalTokenMetadata,
+  f as getExplorerUrl,
+  k as getIchiIconGuess,
+  x as getInjectedProvider,
+  B as getProviderAccount,
+  K as getProviderChainId,
+  j as getZeroForOne,
+  q as isBusy,
+  y as isDocumentVisible,
+  z as isEip1193Provider,
+  Y as isUserRejectedError,
+  Z as normalizeAccount,
+  J as normalizeWalletConnection,
+  $ as outputFeeForQuote,
+  aa as pollUntil,
+  sa as quoteSpendAmount,
+  ea as readPermit2RouterAllowance,
+  Aa as reconcileSubmitQuote,
+  ra as requestProviderAccount,
+  _a as resolveTokenIconUrl,
+  ta as retryOnError,
+  oa as sameQuote,
+  Sa as subscribeProvider,
+  Ea as switchProviderChain,
+  ia as transactionProgressView
+};

package/dist/errors.d.ts

@@ -1,2 +1,3 @@
 export declare function isUserRejectedError(error: unknown): boolean;
+export declare const USER_REJECTED_MESSAGE = "Request rejected.";
 export declare function errorMessage(error: unknown, fallbackMessage: string): string;

package/dist/hooks/useChangeEmitter.d.ts

@@ -0,0 +1,25 @@
+type ChangeEmitterOptions<T> = {
+    /**
+     * The value the emitter starts at, so the first render emits nothing — hosts
+     * already know the initial value from their own props. Captured once on mount.
+     */
+    initial: T;
+    /** Callback name used in the contained-error warning. */
+    label: string;
+    /**
+     * Equality used to decide whether the value changed. Defaults to `Object.is`
+     * (right for primitives); pass `stableEquals` for snapshot objects rebuilt
+     * each render.
+     */
+    equals?: (a: T, b: T) => boolean;
+};
+/**
+ * Mirrors a derived value to a host callback, emitting only when it changes.
+ *
+ * Shared shape for the widget's "notify the host" effects: the callback lives
+ * in a ref so inline host arrows don't re-run the effect, the first render is
+ * skipped (the ref starts at `initial`), and a throwing host callback is
+ * contained so it can't take down the widget mid-swap.
+ */
+export declare function useChangeEmitter<T>(callback: ((value: T) => void) | undefined, value: T, { initial, label, equals }: ChangeEmitterOptions<T>): void;
+export {};

package/dist/hooks/useLifecycleToast.d.ts

@@ -0,0 +1,16 @@
+import type { Hex } from 'viem';
+import { type SubmitStatus, type TransactionProgressView } from '../transactionProgress';
+/**
+ * Drives ONE morphing toast per swap attempt off the same progress view the
+ * rail renders: loading while pending/mining (label updates morph in place),
+ * then success or error in the same card. A retry dismisses the previous
+ * attempt's toast and mints a fresh one.
+ */
+export declare function useLifecycleToast({ enabled, status, progress, txHash, explorerUrl, successDescription }: {
+    enabled: boolean;
+    status: SubmitStatus;
+    progress: TransactionProgressView | null;
+    txHash: Hex | null;
+    explorerUrl: string | null;
+    successDescription: string | null;
+}): void;

package/dist/hooks/usePoolChangeEmitter.d.ts

@@ -0,0 +1 @@
+export declare function usePoolChangeEmitter(onPoolChange: ((poolId: string) => void) | undefined, activePoolId: string | undefined): void;

package/dist/hooks/useResolvedTheme.d.ts

@@ -1,3 +1,4 @@
+/** Widget color theme. `'auto'` follows the OS `prefers-color-scheme`. */
 export type AegisSwapWidgetTheme = 'dark' | 'light' | 'auto';
 export type ResolvedThemeMode = 'dark' | 'light';
 export declare function useResolvedTheme(theme?: AegisSwapWidgetTheme): ResolvedThemeMode;

package/dist/hooks/useStatusChangeEmitter.d.ts

@@ -0,0 +1,2 @@
+import type { AegisSwapStatusSnapshot } from '../transactionProgress';
+export declare function useStatusChangeEmitter(onStatusChange: ((snapshot: AegisSwapStatusSnapshot) => void) | undefined, snapshot: AegisSwapStatusSnapshot): void;

package/dist/hooks/useSubmitSwap.d.ts

@@ -4,7 +4,15 @@ import { type DirectSwapQuote, type SwapQuoteMode } from '../quote';
 import { type SubmitStatus } from '../transactionProgress';
 import { type Eip1193Provider } from '../wallet';
 import type { ResolvedWalletConnection } from './useWalletConnection';
+/**
+ * ERC-20 → Permit2 approval sizing. `'exact'` approves only the current quote's
+ * spend; `'max'` approves an unlimited allowance so future swaps skip approval.
+ */
 export type AegisSwapApprovalMode = 'exact' | 'max';
+/**
+ * Swap context attached to `onSubmitted`/`onSuccess` so hosts get
+ * analytics-grade data without extra wiring. Amounts are raw base units.
+ */
 export type AegisSwapSubmitDetails = {
     mode: SwapQuoteMode;
     inputSymbol: string;
@@ -25,7 +33,7 @@ type ApprovalProgress = {
  * fee leg selection. A confirmed approval auto-continues into the swap, so a
  * single click covers approve -> permit -> swap.
  */
-export declare function useSubmitSwap({ publicClient, activeChain, market, inputToken, outputToken, quoteMode, activeAmount, slippageBps, feeConfig, quote, setQuote, owner, getActiveProvider, connectWallet, setWalletChainId, readAllowance, commitAllowance, approvalMode, refreshBalances, onSubmitted, onSuccess, onError }: {
+export declare function useSubmitSwap({ publicClient, activeChain, market, inputToken, outputToken, quoteMode, activeAmount, slippageBps, feeConfig, quote, setQuote, owner, getActiveProvider, connectWallet, setWalletChainId, readAllowance, commitAllowance, approvalMode, refreshBalances, refreshAllowances, onSubmitted, onSuccess, onError }: {
     publicClient: PublicClient;
     activeChain: AegisSwapChainConfig;
     market: AegisSwapMarket | null;
@@ -45,6 +53,7 @@ export declare function useSubmitSwap({ publicClient, activeChain, market, input
     commitAllowance: (owner: Address, market: AegisSwapMarket, amount: bigint) => void;
     approvalMode: AegisSwapApprovalMode;
     refreshBalances: (account: Address) => Promise<void>;
+    refreshAllowances: (owner: Address, market: AegisSwapMarket) => Promise<void>;
     onSubmitted?: (hash: Hex, swap?: AegisSwapSubmitDetails) => void;
     onSuccess?: (result: {
         hash: Hex;

package/dist/hooks/useTokenAllowance.d.ts

@@ -19,6 +19,9 @@ export declare function useTokenAllowance({ publicClient, owner, market, inputTo
     approvalRequired: boolean;
     authorizationCheckPending: boolean;
     authorizationRequired: boolean;
+    /** Whether the prompt plan includes a Permit2 authorization (ungated by the approval). */
+    authorizationPromptExpected: boolean;
     readAllowance: (owner: Address, market: AegisSwapMarket) => Promise<bigint>;
     commitAllowance: (owner: Address, market: AegisSwapMarket, amount: bigint) => void;
+    refreshAllowances: (owner: Address, market: AegisSwapMarket) => Promise<void>;
 };

package/dist/hooks/useValueRefresh.d.ts

@@ -0,0 +1 @@
+export declare function useValueRefresh(value: string, enabled: boolean): boolean;

package/dist/index.d.ts

@@ -1,11 +1,13 @@
 import './styles.css';
 export { AegisDirectSwapWidget, AegisSwapWidget, default } from './widget/AegisDirectSwapWidget';
-export type { AegisDirectSwapWidgetProps, AegisSwapWidgetDirection, AegisSwapWidgetProps, AegisSwapWidgetStyle } from './widget/types';
-export { AEGIS_SWAP_CHAINS, AEGIS_SWAP_CHAIN_ID, AEGIS_SWAP_DEFAULT_FEE_BPS, AEGIS_SWAP_DEFAULT_FEE_RECIPIENT, AEGIS_SWAP_DEFAULT_METADATA_ENDPOINT, AEGIS_SWAP_DEFAULT_POOL_IDS, AEGIS_SWAP_DEFAULT_RPC_URLS, AEGIS_DYNAMIC_FEE_FLAG, AEGIS_SWAP_HOOK, AEGIS_SWAP_MARKETS, AEGIS_SWAP_MAINNET_CHAIN, AEGIS_SWAP_MAINNET_UNISWAP_V4_CONTRACTS, AEGIS_SWAP_PERMIT2, AEGIS_SWAP_ROUTER, AEGIS_SWAP_TOKENS, AEGIS_SWAP_V4_QUOTER, UNISWAP_V4_CONTRACTS_BY_CHAIN, createAegisSwapChainConfig, createAegisSwapChains, createAegisSwapPoolMarket, createAegisSwapMarketsFromPools, createAegisSwapUniswapV4Contracts } from './config';
-export type { AegisPoolKey, AegisSwapBuiltInAssetSymbol, AegisSwapBuiltInMarketId, AegisSwapBuiltInTokenSymbol, AegisSwapChainConfig, AegisSwapChainConfigInput, AegisSwapMarket, AegisSwapPoolConfig, AegisSwapToken, AegisSwapTokenSymbol, AegisSwapUniswapV4Contracts, AegisSwapUniswapV4ContractsInput } from './config';
-export { fetchGlobalTokenMetadata, getIchiIconGuess } from './metadata';
-export type { AegisSwapGlobalTokenMetadata } from './metadata';
-export type { DirectSwapQuote, SwapQuoteMode } from './quote';
+export type { AegisDirectSwapWidgetProps, AegisSwapNetworkIcon, AegisSwapNetworkOption, AegisSwapStatusSurface, AegisSwapWidgetDirection, AegisSwapWidgetProps, AegisSwapWidgetStyle } from './widget/types';
+export { AegisSwapProgressRail } from './widget/ProgressRail';
+export type { AegisSwapProgressRailProps } from './widget/ProgressRail';
+export { AegisSwapToaster } from './toast/Toaster';
+export type { AegisSwapToasterProps } from './toast/Toaster';
+export { aegisToast } from './toast/toast';
+export type { AegisToastPromiseMessage, AegisToastPromiseMessages } from './toast/toast';
+export type { AegisToastAction, AegisToastOptions, AegisToastPosition, AegisToastType } from './toast/state';
 export type { AegisSwapWidgetTheme } from './hooks/useResolvedTheme';
 export type { AegisSwapApprovalMode, AegisSwapSubmitDetails } from './hooks/useSubmitSwap';
-export type { AegisSwapProviderResolver, AegisSwapWalletConnection, Eip1193Provider } from './wallet';
+export * from './core';

package/dist/metadata.d.ts

@@ -1,4 +1,5 @@
 import { type Address } from 'viem';
+import type { AegisSwapToken } from './config';
 export type AegisSwapGlobalTokenMetadata = {
     chainId: number | null;
     address: string | null;
@@ -9,6 +10,13 @@ export type AegisSwapGlobalTokenMetadata = {
     iconURL: string | null;
 };
 export declare function getIchiIconGuess(symbol: string | null | undefined): string | null;
+export type TokenMetadataByAddress = Record<string, AegisSwapGlobalTokenMetadata>;
+/**
+ * Canonical icon-source order for a token: explicit config URL, the metadata
+ * service, then the ichi naming guess. Public so hosts rendering their own
+ * token marks resolve identically to the widget.
+ */
+export declare function resolveTokenIconUrl(token: AegisSwapToken, metadataByAddress: TokenMetadataByAddress): string | null;
 export declare function fetchGlobalTokenMetadata(args: {
     endpoint: string;
     chainId: number;

package/dist/permit.d.ts

@@ -43,6 +43,13 @@ export declare function buildSignedPermitBatch(args: {
     router: Address;
     token: Address;
     amount: bigint;
+    /**
+     * 'max' signs a MAX_UINT160 permit (still expiring in 30 minutes) so quick
+     * follow-up swaps reuse it instead of prompting for a new signature each
+     * time — Permit2 decrements exact-sized permits to zero on transfer.
+     * Defaults to 'exact'.
+     */
+    sizing?: 'exact' | 'max';
     /** Pre-started readPermit2RouterAllowance result to overlap with other RPC work. */
     allowanceRead?: ReturnType<typeof readPermit2RouterAllowance>;
 }): Promise<SignedPermitBatch | null>;