@liberfi.io/ui-tokens 1.0.0 → 2.0.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType } from 'react';
 import * as _liberfi_io_types from '@liberfi.io/types';
-import { Token, Chain, TraderTag, HolderTag, TokenSocialMedias, API, TokenHolder, Activity, TokenStats, TokenSecurity as TokenSecurity$1, TokenLiquidity, TokenProtocol } from '@liberfi.io/types';
+import { Token, Chain, TraderTag, HolderTag, TokenSocialMedias, API, TokenHolder, Activity, TokenStats, TokenSecurity as TokenSecurity$1, TokenLiquidity, PortfolioPnl, LimitOrderState, LimitOrder, TokenProtocol } from '@liberfi.io/types';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { PopoverProps } from '@liberfi.io/ui';
 export { formatAmount } from '@liberfi.io/utils';
@@ -13,7 +13,7 @@ declare global {
         };
     }
 }
-declare const _default: "1.0.0";
+declare const _default: "2.0.0";
 
 interface PulseListProps {
     /** list title */
@@ -613,10 +613,24 @@ interface TokenHoldersListProps {
     /** Phase 3 sortBy */
     sortBy: TokenHoldersListSortBy;
     onSortByChange: (sortBy: TokenHoldersListSortBy) => void;
+    /**
+     * Axiom-style `Only Tracked` filter. Narrows the visible rows to holders
+     * that carry at least one classification tag. Client-side; parent owns
+     * state.
+     */
+    onlyTracked?: boolean;
+    onOnlyTrackedChange?: (value: boolean) => void;
     onLoadMore?: () => void;
     hasMore?: boolean;
     /** reference time for age display; defaults to `Date.now()` */
     now?: number;
+    /**
+     * Optional map of known wallet addresses → human-readable label (e.g.
+     * `{ [poolAddress]: "LIQUIDITY POOL" }`). When the holder's address is
+     * in this map, the Wallet cell renders the label instead of a truncated
+     * address.
+     */
+    wellKnownAddresses?: Record<string, string>;
     className?: string;
     /** render a wallet cell — useful to wire app-level links / tooltips */
     renderAddress?: (address: string) => React.ReactNode;
@@ -627,7 +641,7 @@ interface TokenHoldersListProps {
  * age. The caller owns the sort state to preserve cursor semantics (changing
  * `sortBy` invalidates cursors).
  */
-declare function TokenHoldersList({ holders, isLoading, sortBy, onSortByChange, onLoadMore, hasMore, now, className, renderAddress, }: TokenHoldersListProps): react_jsx_runtime.JSX.Element;
+declare function TokenHoldersList({ holders, isLoading, sortBy, onSortByChange, onlyTracked, onOnlyTrackedChange, onLoadMore, hasMore, now, wellKnownAddresses, className, renderAddress, }: TokenHoldersListProps): react_jsx_runtime.JSX.Element;
 
 interface UseTokenHoldersListScriptParams {
     chain: Chain;
@@ -663,17 +677,30 @@ interface TokenHoldersListWidgetProps {
     address: string;
     limit?: number;
     initialSortBy?: TokenHoldersListSortBy;
+    /** Initial `Only Tracked` toggle state. */
+    initialOnlyTracked?: boolean;
+    /** Map of known-wallet addresses → human-readable labels. */
+    wellKnownAddresses?: Record<string, string>;
     className?: string;
     renderAddress?: (address: string) => React.ReactNode;
 }
 /**
  * Live-paginated, sortable token holders list consuming the Phase 3
- * `/v2/token/{chain}/{address}/holders` endpoint. Tags + last-active-at are
- * rendered when present (sparse).
+ * `/v2/token/{chain}/{address}/holders` endpoint. Axiom-parity upgrades:
+ * adds a client-side `Only Tracked` filter and supports a
+ * `wellKnownAddresses` map that replaces known pool / named-wallet
+ * addresses with a human-readable badge (e.g. `LIQUIDITY POOL`).
  */
-declare function TokenHoldersListWidget({ chain, address, limit, initialSortBy, className, renderAddress, }: TokenHoldersListWidgetProps): react_jsx_runtime.JSX.Element;
+declare function TokenHoldersListWidget({ chain, address, limit, initialSortBy, initialOnlyTracked, wellKnownAddresses, className, renderAddress, }: TokenHoldersListWidgetProps): react_jsx_runtime.JSX.Element;
 
 type TokenActivitiesListSortBy = API.ActivitiesSortBy;
+/**
+ * Axiom-style trader-tag filter applied client-side on top of the paged
+ * result. `all` is the default; `dev` / `tracked` / `you` narrow the view.
+ */
+type TokenActivitiesListTraderFilter = "all" | "dev" | "tracked" | "you";
+/** Amount column currency toggle (USD vs native). */
+type TokenActivitiesListCurrency = "usd" | "native";
 interface TokenActivitiesListProps {
     activities: Array<Activity>;
     isLoading?: boolean;
@@ -682,6 +709,17 @@ interface TokenActivitiesListProps {
     /** filter by activity type; "all" shows everything including liquidity / red packets */
     typeFilter?: "all" | "buy" | "sell";
     onTypeFilterChange?: (t: "all" | "buy" | "sell") => void;
+    /**
+     * Axiom-style DEV / TRACKED / YOU filter. Purely client-side; narrows
+     * the visible rows without refetching.
+     */
+    traderFilter?: TokenActivitiesListTraderFilter;
+    onTraderFilterChange?: (t: TokenActivitiesListTraderFilter) => void;
+    /** Your wallet address — required for the `you` filter to work. */
+    youWalletAddress?: string;
+    /** USD / native currency toggle. Defaults to `usd`. */
+    currency?: TokenActivitiesListCurrency;
+    onCurrencyChange?: (c: TokenActivitiesListCurrency) => void;
     onLoadMore?: () => void;
     hasMore?: boolean;
     /** reference time for age display; defaults to `Date.now()` */
@@ -693,16 +731,7 @@ interface TokenActivitiesListProps {
     className?: string;
     onRowClick?: (activity: Activity) => void;
 }
-/**
- * Presentational token activities list (Phase 3). Shows per-activity:
- * - side (buy/sell/liquidity/red packet)
- * - trader address + trader tags
- * - amount (native + usd)
- * - price
- * - gas fee (native denominated)
- * - age
- */
-declare function TokenActivitiesList({ activities, isLoading, sortBy, onSortByChange, typeFilter, onTypeFilterChange, onLoadMore, hasMore, now, nativeDecimals, nativeSymbol, className, onRowClick, }: TokenActivitiesListProps): react_jsx_runtime.JSX.Element;
+declare function TokenActivitiesList({ activities, isLoading, sortBy, onSortByChange, typeFilter, onTypeFilterChange, traderFilter, onTraderFilterChange, youWalletAddress, currency, onCurrencyChange, onLoadMore, hasMore, now, nativeDecimals, nativeSymbol, className, onRowClick, }: TokenActivitiesListProps): react_jsx_runtime.JSX.Element;
 
 interface UseTokenActivitiesListScriptParams {
     chain: Chain;
@@ -741,6 +770,12 @@ interface TokenActivitiesListWidgetProps {
     limit?: number;
     initialSortBy?: TokenActivitiesListSortBy;
     initialTypeFilter?: "all" | "buy" | "sell";
+    /** Axiom-style DEV / TRACKED / YOU filter. Defaults to `all`. */
+    initialTraderFilter?: TokenActivitiesListTraderFilter;
+    /** Initial USD / native toggle state. Defaults to `usd`. */
+    initialCurrency?: TokenActivitiesListCurrency;
+    /** Your wallet address — required for the `you` filter option to light up. */
+    youWalletAddress?: string;
     /** native token decimals for gas-fee formatting, default 9 (lamports on SOL) */
     nativeDecimals?: number;
     /** native token symbol, default "SOL" */
@@ -749,10 +784,14 @@ interface TokenActivitiesListWidgetProps {
     onRowClick?: (activity: Activity) => void;
 }
 /**
- * Phase 3 token-activities list widget. Replaces the legacy `getTokenTrades`
- * call with `getTokenActivities` and renders `traderTags` + `gasFee`.
+ * Phase 3 token-activities list widget, upgraded to Axiom parity.
+ *
+ * Replaces the legacy `getTokenTrades` call with `getTokenActivities` and
+ * renders `traderTags` + `gasFee`, plus the Axiom-style `DEV / TRACKED /
+ * YOU` trader filter and a USD / native currency toggle. The trader
+ * filter is applied client-side on top of the paged results.
  */
-declare function TokenActivitiesListWidget({ chain, address, limit, initialSortBy, initialTypeFilter, nativeDecimals, nativeSymbol, className, onRowClick, }: TokenActivitiesListWidgetProps): react_jsx_runtime.JSX.Element;
+declare function TokenActivitiesListWidget({ chain, address, limit, initialSortBy, initialTypeFilter, initialTraderFilter, initialCurrency, youWalletAddress, nativeDecimals, nativeSymbol, className, onRowClick, }: TokenActivitiesListWidgetProps): react_jsx_runtime.JSX.Element;
 
 type OverviewResolution = keyof TokenStats;
 interface TokenTradersOverviewProps {
@@ -983,6 +1022,574 @@ interface TokenCategoriesWidgetProps {
 }
 declare function TokenCategoriesWidget({ chain, address, collapseAt, className, onCategoryClick, }: TokenCategoriesWidgetProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Resolution used by the base stat cells. Axiom uses the chart's active
+ * resolution here (defaults to `5m`).
+ */
+type TokenStatsFlipBaseResolution = "1m" | "5m" | "15m" | "30m" | "1h" | "4h" | "24h";
+/**
+ * Time windows displayed in the hover overlay (price change % per window).
+ *
+ * NOTE: Axiom shows `5m / 1h / 6h / 24h`. Our server schema exposes
+ * `5m / 1h / 4h / 24h` (no native 6h window), so we default to that set
+ * and document the delta. Consumers can override via
+ * {@link TokenStatsFlipProps.hoverResolutions}.
+ */
+type TokenStatsFlipHoverResolution = TokenStatsFlipBaseResolution;
+declare const DEFAULT_FLIP_HOVER_RESOLUTIONS: ReadonlyArray<TokenStatsFlipHoverResolution>;
+interface TokenStatsFlipBaseProps {
+    stats: TokenStats | undefined;
+    resolution: TokenStatsFlipBaseResolution;
+    className?: string;
+}
+/**
+ * Base layer — 4-cell grid showing `Volume / Buys / Sells / Net Volume` for
+ * the active resolution, plus a 2px buy-share bar at the bottom.
+ */
+declare function TokenStatsFlipBase({ stats, resolution, className, }: TokenStatsFlipBaseProps): react_jsx_runtime.JSX.Element;
+interface TokenStatsFlipHoverProps {
+    stats: TokenStats | undefined;
+    resolutions: ReadonlyArray<TokenStatsFlipHoverResolution>;
+    className?: string;
+}
+/**
+ * Hover overlay — 4-cell grid showing `priceChange %` per window with
+ * bullish/bearish tint.
+ */
+declare function TokenStatsFlipHover({ stats, resolutions, className, }: TokenStatsFlipHoverProps): react_jsx_runtime.JSX.Element;
+interface TokenStatsFlipProps {
+    stats: TokenStats | undefined;
+    /** Resolution displayed in the base layer. Defaults to `5m`. */
+    baseResolution?: TokenStatsFlipBaseResolution;
+    /** Time windows displayed in the hover overlay. Defaults to `5m/1h/4h/24h`. */
+    hoverResolutions?: ReadonlyArray<TokenStatsFlipHoverResolution>;
+    /** Height override (panel height). Defaults to 64. */
+    height?: number;
+    className?: string;
+}
+
+interface UseTokenStatsFlipScriptParams {
+    chain: Chain;
+    address: string;
+}
+/**
+ * Thin query wrapper for {@link TokenStatsFlipWidget}.
+ *
+ * Fetches the full `TokenStats` object — both base and hover layers read
+ * different resolution slices off the same response, so a single query is
+ * enough; no subscription wiring needed here (the hover resolutions are
+ * refreshed with normal React Query stale/refetch semantics).
+ */
+declare function useTokenStatsFlipScript({ chain, address, }: UseTokenStatsFlipScriptParams): {
+    stats: TokenStats | undefined;
+    isLoading: boolean;
+};
+
+interface TokenStatsFlipWidgetProps {
+    chain: Chain;
+    address: string;
+    /** Resolution for the base layer. Defaults to `5m`. */
+    baseResolution?: TokenStatsFlipBaseResolution;
+    /** Hover overlay resolutions. Defaults to `5m / 1h / 4h / 24h`. */
+    hoverResolutions?: ReadonlyArray<TokenStatsFlipHoverResolution>;
+    /** Panel height. Defaults to 64. */
+    height?: number;
+    /** Extra className on the panel wrapper. */
+    className?: string;
+}
+/**
+ * TokenStatsFlipWidget — Axiom-style volume/price-change panel above the
+ * Buy / Sell form.
+ *
+ * At rest shows `{res} Vol / Buys / Sells / Net Vol` for the active
+ * resolution; on hover a blurred overlay cross-fades in with
+ * `priceChange %` per window. A cursor-following radial glow adds the
+ * signature Axiom interaction.
+ */
+declare function TokenStatsFlipWidget({ chain, address, baseResolution, hoverResolutions, height, className, }: TokenStatsFlipWidgetProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Amount display mode. Axiom offers a USD / SOL toggle; we generalise that
+ * to `usd | native` so the same widget works on any chain. When unset, the
+ * widget defaults to `usd`.
+ */
+type TokenPositionsListCurrency = "usd" | "native";
+interface TokenPositionsListProps {
+    positions: Array<PortfolioPnl>;
+    isLoading?: boolean;
+    hasMore?: boolean;
+    onLoadMore?: () => void;
+    /** Currency toggle. Defaults to `usd`. */
+    currency?: TokenPositionsListCurrency;
+    onCurrencyChange?: (currency: TokenPositionsListCurrency) => void;
+    /** Show-hidden positions filter (UI hook only; parent owns state). */
+    showHidden?: boolean;
+    onShowHiddenChange?: (value: boolean) => void;
+    /** Native token symbol shown in the toggle (e.g. `SOL`, `ETH`). Defaults to `Native`. */
+    nativeSymbol?: string;
+    /** Per-row action slot (buy / sell / hide). Parent owns which actions to render. */
+    renderActions?: (position: PortfolioPnl) => ReactNode;
+    className?: string;
+}
+/**
+ * Presentational list of a wallet's open positions in a token context —
+ * columns: `Token / Bought / Sold / Remaining / PnL / Actions`.
+ *
+ * The parent owns data and pagination; this component is purely visual.
+ */
+declare function TokenPositionsList({ positions, isLoading, hasMore, onLoadMore, currency, onCurrencyChange, showHidden, onShowHiddenChange, nativeSymbol, renderActions, className, }: TokenPositionsListProps): react_jsx_runtime.JSX.Element;
+
+interface UseTokenPositionsListScriptParams {
+    chain: Chain;
+    /** Wallet address. When empty, the hook remains disabled. */
+    wallet?: string;
+    /** Page size; defaults to 50. */
+    limit?: number;
+    /** Initial show-hidden toggle value. */
+    initialShowHidden?: boolean;
+}
+interface UseTokenPositionsListScriptResult {
+    positions: Array<PortfolioPnl>;
+    isLoading: boolean;
+    hasMore: boolean;
+    loadMore: () => void;
+    showHidden: boolean;
+    setShowHidden: (value: boolean) => void;
+}
+/**
+ * Script for the positions list widget.
+ *
+ * Uses {@link useWalletTokenPositionsQuery} (bridge over
+ * `getWalletPortfolioPnls` with `positionState=open`) and accumulates pages
+ * in local state. Hidden-filter is a purely client-side toggle; the server
+ * does not expose a `hidden` flag on positions so the widget always keeps
+ * the full list and the parent can filter / persist as desired.
+ *
+ * Query stays disabled when `wallet` is empty so the positions tab
+ * renders gracefully for logged-out users.
+ */
+declare function useTokenPositionsListScript({ chain, wallet, limit, initialShowHidden, }: UseTokenPositionsListScriptParams): UseTokenPositionsListScriptResult;
+
+interface TokenPositionsListWidgetProps {
+    chain: Chain;
+    /** Wallet address. When empty, the list is empty and the query is disabled. */
+    wallet?: string;
+    limit?: number;
+    /** Initial currency. Defaults to `usd`. */
+    initialCurrency?: TokenPositionsListCurrency;
+    /** Native chain symbol used in the currency toggle (e.g. `SOL`). */
+    nativeSymbol?: string;
+    /** Optional per-row action slot. */
+    renderActions?: (position: PortfolioPnl) => ReactNode;
+    className?: string;
+}
+/**
+ * Positions tab widget.
+ *
+ * Fetches the caller wallet's open positions via
+ * `getWalletPortfolioPnls({ positionState: 'open' })` and renders the
+ * Axiom-style columns. Currency (USD / native) and show-hidden toggles
+ * are kept in local state; consumers wanting persistence should wrap
+ * the widget and lift these up.
+ */
+declare function TokenPositionsListWidget({ chain, wallet, limit, initialCurrency, nativeSymbol, renderActions, className, }: TokenPositionsListWidgetProps): react_jsx_runtime.JSX.Element;
+
+type TokenOrdersListState = Extract<LimitOrderState, "active" | "filled" | "cancelled" | "expired">;
+/**
+ * Segmented state filter. Axiom exposes `Active Orders / Order History`; we
+ * mirror that with `active` vs `history` (any non-active).
+ */
+type TokenOrdersListStateFilter = "active" | "history";
+type TokenOrdersListCurrency = "usd" | "native";
+interface TokenOrdersListProps {
+    orders: Array<LimitOrder>;
+    isLoading?: boolean;
+    /** If true, render a "coming soon" empty state. Used when the backend endpoint is missing. */
+    unavailable?: boolean;
+    hasMore?: boolean;
+    onLoadMore?: () => void;
+    stateFilter: TokenOrdersListStateFilter;
+    onStateFilterChange: (filter: TokenOrdersListStateFilter) => void;
+    /** Token-scope filter ("Only {SYMBOL}"). Parent owns state. */
+    onlyThisToken?: boolean;
+    onOnlyThisTokenChange?: (value: boolean) => void;
+    tokenSymbol?: string;
+    /** Currency toggle. */
+    currency?: TokenOrdersListCurrency;
+    onCurrencyChange?: (currency: TokenOrdersListCurrency) => void;
+    nativeSymbol?: string;
+    /** Cancel-all button click handler; hidden when unset. */
+    onCancelAll?: () => void;
+    /** Per-row action slot. */
+    renderActions?: (order: LimitOrder) => ReactNode;
+    className?: string;
+}
+/**
+ * Presentational list of a wallet's limit orders — columns `Token / Type /
+ * Amount / Current MC / Target MC / Settings / Action`.
+ *
+ * Gracefully renders a "coming soon" empty state when the server endpoint
+ * is not yet implemented (pass `unavailable`).
+ */
+declare function TokenOrdersList({ orders, isLoading, unavailable, hasMore, onLoadMore, stateFilter, onStateFilterChange, onlyThisToken, onOnlyThisTokenChange, tokenSymbol, currency, onCurrencyChange, nativeSymbol, onCancelAll, renderActions, className, }: TokenOrdersListProps): react_jsx_runtime.JSX.Element;
+
+interface UseTokenOrdersListScriptParams {
+    chain: Chain;
+    wallet?: string;
+    /** Token address to use when `onlyThisToken` is true. */
+    tokenAddress: string;
+    limit?: number;
+    initialStateFilter?: TokenOrdersListStateFilter;
+    initialOnlyThisToken?: boolean;
+}
+interface UseTokenOrdersListScriptResult {
+    orders: Array<LimitOrder>;
+    isLoading: boolean;
+    /** true when the backend endpoint is not implemented yet. */
+    unavailable: boolean;
+    hasMore: boolean;
+    loadMore: () => void;
+    stateFilter: TokenOrdersListStateFilter;
+    setStateFilter: (filter: TokenOrdersListStateFilter) => void;
+    onlyThisToken: boolean;
+    setOnlyThisToken: (value: boolean) => void;
+}
+/**
+ * Script for the orders list widget.
+ *
+ * Because `getWalletLimitOrders` throws `NotImplementedError`, this script
+ * catches that specific error and reports `unavailable: true` so the UI can
+ * render a "coming soon" state instead of a generic error.
+ */
+declare function useTokenOrdersListScript({ chain, wallet, tokenAddress, limit, initialStateFilter, initialOnlyThisToken, }: UseTokenOrdersListScriptParams): UseTokenOrdersListScriptResult;
+
+interface TokenOrdersListWidgetProps {
+    chain: Chain;
+    /** Wallet address. Empty → widget is rendered with a disabled data query. */
+    wallet?: string;
+    /** Token address used by the `Only <symbol>` filter when enabled. */
+    tokenAddress: string;
+    /** Optional token symbol used in the `Only <symbol>` checkbox label. */
+    tokenSymbol?: string;
+    limit?: number;
+    initialStateFilter?: TokenOrdersListStateFilter;
+    initialCurrency?: TokenOrdersListCurrency;
+    nativeSymbol?: string;
+    onCancelAll?: () => void;
+    renderActions?: (order: LimitOrder) => ReactNode;
+    className?: string;
+}
+/**
+ * Orders tab widget.
+ *
+ * The backend limit-orders endpoint is not shipped yet, so the underlying
+ * client method throws `NotImplementedError`. The script catches that
+ * specific error and reports `unavailable` so the widget renders a
+ * friendly "coming soon" state instead of a generic error.
+ */
+declare function TokenOrdersListWidget({ chain, wallet, tokenAddress, tokenSymbol, limit, initialStateFilter, initialCurrency, nativeSymbol, onCancelAll, renderActions, className, }: TokenOrdersListWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface TokenTopTradersListProps {
+    traders: Array<TokenHolder>;
+    isLoading?: boolean;
+    hasMore?: boolean;
+    onLoadMore?: () => void;
+    /** Only Tracked filter (client-side flag; parent owns state). */
+    onlyTracked?: boolean;
+    onOnlyTrackedChange?: (value: boolean) => void;
+    now?: number;
+    renderAddress?: (address: string) => React.ReactNode;
+    className?: string;
+}
+/**
+ * Presentational Top Traders list — visually parallel to
+ * {@link TokenHoldersList} but with its own header + filters.
+ *
+ * The server currently returns the same row shape as holders, ranked by
+ * realised PnL; the Realized PnL column stays blank (`—`) until the API
+ * adds per-holder PnL fields. When that lands, extend
+ * `TokenHolder` with the new fields and wire them into the cells here.
+ */
+declare function TokenTopTradersList({ traders, isLoading, hasMore, onLoadMore, onlyTracked, onOnlyTrackedChange, now, renderAddress, className, }: TokenTopTradersListProps): react_jsx_runtime.JSX.Element;
+
+interface UseTokenTopTradersListScriptParams {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    initialOnlyTracked?: boolean;
+}
+interface UseTokenTopTradersListScriptResult {
+    traders: Array<TokenHolder>;
+    isLoading: boolean;
+    hasMore: boolean;
+    loadMore: () => void;
+    onlyTracked: boolean;
+    setOnlyTracked: (value: boolean) => void;
+}
+/**
+ * Script for the top-traders list widget.
+ *
+ * Builds on {@link useTokenTopTradersQuery} (bridge over the holders
+ * endpoint with `sortBy=realizedPnl`). `onlyTracked` is a client-side
+ * filter retained for UI parity with Axiom — until the server flags
+ * tracked wallets, the toggle narrows visible rows to those whose `tags`
+ * list is non-empty (a reasonable proxy for "tracked by someone").
+ */
+declare function useTokenTopTradersListScript({ chain, address, limit, initialOnlyTracked, }: UseTokenTopTradersListScriptParams): UseTokenTopTradersListScriptResult;
+
+interface TokenTopTradersListWidgetProps {
+    chain: Chain;
+    address: string;
+    limit?: number;
+    className?: string;
+    renderAddress?: (address: string) => React.ReactNode;
+}
+/**
+ * Top Traders list widget.
+ *
+ * Bridges the holders endpoint (ranked by realized PnL) into the Axiom-style
+ * Top Traders view; client-side `Only Tracked` toggle narrows to wallets
+ * that carry at least one classification tag.
+ */
+declare function TokenTopTradersListWidget({ chain, address, limit, className, renderAddress, }: TokenTopTradersListWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface TokenDevTokensListProps {
+    tokens: Array<Token>;
+    isLoading?: boolean;
+    /** Server endpoint not yet shipped — renders a coming-soon state. */
+    unavailable?: boolean;
+    hasMore?: boolean;
+    onLoadMore?: () => void;
+    /** Optional per-row link — pass to render token as a clickable element. */
+    renderTokenLink?: (token: Token) => React.ReactNode;
+    className?: string;
+}
+/**
+ * Dev Tokens list — columns `Token / Migrated / Market Cap / ATH /
+ * Liquidity / 1h Volume`. The "Migrated" column surfaces whether the
+ * token has exited a bonding curve launchpad (renders `✓` when
+ * `launchpad.migrated` is true).
+ */
+declare function TokenDevTokensList({ tokens, isLoading, unavailable, hasMore, onLoadMore, renderTokenLink, className, }: TokenDevTokensListProps): react_jsx_runtime.JSX.Element;
+/** Summary block rendered next to the Dev Tokens list on desktop. */
+interface TokenDevTokensSummaryProps {
+    tokens: Array<Token>;
+    className?: string;
+}
+/**
+ * Aggregated dev summary — total tokens, migrated count (with % donut-like
+ * progress), total 1h volume. Pure presentational; caller supplies data.
+ */
+declare function TokenDevTokensSummary({ tokens, className, }: TokenDevTokensSummaryProps): react_jsx_runtime.JSX.Element;
+
+interface UseTokenDevTokensListScriptParams {
+    chain: Chain;
+    /** Creator wallet address. Empty → query disabled. */
+    creator?: string;
+    limit?: number;
+}
+interface UseTokenDevTokensListScriptResult {
+    tokens: Array<Token>;
+    isLoading: boolean;
+    unavailable: boolean;
+    hasMore: boolean;
+    loadMore: () => void;
+}
+/**
+ * Script for the dev-tokens list widget.
+ *
+ * The backend endpoint for "tokens created by wallet" has not shipped; the
+ * client method throws `NotImplementedError`. This script detects the
+ * unavailable state so the UI can render a coming-soon message while the
+ * endpoint is being built.
+ */
+declare function useTokenDevTokensListScript({ chain, creator, limit, }: UseTokenDevTokensListScriptParams): UseTokenDevTokensListScriptResult;
+
+interface TokenDevTokensListWidgetProps {
+    chain: Chain;
+    /** Creator wallet address (token's launch wallet). Empty → query disabled. */
+    creator?: string;
+    limit?: number;
+    /** When true, also render the summary sub-widget beside the list. */
+    showSummary?: boolean;
+    renderTokenLink?: (token: Token) => React.ReactNode;
+    className?: string;
+}
+/**
+ * Dev Tokens tab widget.
+ *
+ * Backend endpoint not yet shipped → surfaces a friendly "coming soon"
+ * empty state courtesy of `NotImplementedError` detection. When the
+ * endpoint lands, no widget changes are required.
+ */
+declare function TokenDevTokensListWidget({ chain, creator, limit, showSummary, renderTokenLink, className, }: TokenDevTokensListWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface TokenChartBannerProps {
+    token?: Token;
+    /**
+     * Optional `ATH` market cap (USD). Not part of the current `TokenMarketData`
+     * schema; consumers can plumb it from a separate source when available.
+     */
+    athInUsd?: string;
+    /** Optional all-time-high timestamp for the ATH tooltip. */
+    athAt?: Date;
+    /** Optional global-fees-paid (USD) — renders when provided, skipped otherwise. */
+    globalFeesPaidInUsd?: string;
+    /** Optional rank within the chain (e.g. `42`). */
+    rank?: number;
+    /** Handler for the pin button. Passing nothing hides the button. */
+    onTogglePin?: () => void;
+    /** Whether the token is currently pinned (controls the icon state). */
+    pinned?: boolean;
+    className?: string;
+}
+/**
+ * Compact horizontal banner mirroring Axiom's chart-top stats strip.
+ * Presentational only — consumers (or `TokenChartBannerWidget`) provide
+ * the data and wrap in a `CollapsibleSection` if they want Axiom's
+ * expand/collapse affordance.
+ */
+declare function TokenChartBanner({ token, athInUsd, athAt, globalFeesPaidInUsd, rank, onTogglePin, pinned, className, }: TokenChartBannerProps): react_jsx_runtime.JSX.Element;
+
+interface UseTokenChartBannerScriptParams {
+    chain: Chain;
+    address: string;
+}
+interface UseTokenChartBannerScriptResult {
+    token: Token | undefined;
+    isLoading: boolean;
+}
+/**
+ * Script for {@link TokenChartBannerWidget}. Reuses the shared
+ * {@link useLiveToken} hook so the banner picks up WebSocket deltas
+ * without an extra subscription registration.
+ */
+declare function useTokenChartBannerScript({ chain, address, }: UseTokenChartBannerScriptParams): UseTokenChartBannerScriptResult;
+
+interface TokenChartBannerWidgetProps {
+    chain: Chain;
+    address: string;
+    /** Optional ATH market cap; see the UI props for details. */
+    athInUsd?: string;
+    athAt?: Date;
+    globalFeesPaidInUsd?: string;
+    rank?: number;
+    pinned?: boolean;
+    onTogglePin?: () => void;
+    className?: string;
+}
+/**
+ * Live, presentational banner mirroring Axiom's chart-top stats strip.
+ * Wraps {@link TokenChartBanner} with {@link useTokenChartBannerScript}
+ * so the banner stays in sync with WebSocket pushes.
+ */
+declare function TokenChartBannerWidget({ chain, address, athInUsd, athAt, globalFeesPaidInUsd, rank, pinned, onTogglePin, className, }: TokenChartBannerWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface TokenSimilarTokensProps {
+    tokens: Array<Token>;
+    isLoading?: boolean;
+    /** When the backend doesn't yet expose similarity, renders an empty-state hint. */
+    unavailable?: boolean;
+    /** Optional per-row click handler (open detail page, etc.). */
+    onTokenClick?: (token: Token) => void;
+    className?: string;
+}
+/**
+ * Similar Tokens list — a lightweight preview list (image / symbol /
+ * market-cap). Consumers compose this inside a `CollapsibleSection` on
+ * the right column of the desktop token-detail page.
+ */
+declare function TokenSimilarTokens({ tokens, isLoading, unavailable, onTokenClick, className, }: TokenSimilarTokensProps): react_jsx_runtime.JSX.Element;
+
+interface UseTokenSimilarTokensScriptParams {
+    chain: Chain;
+    address: string;
+    /** Search keyword used to surface similar tokens. Usually the token symbol or a category. */
+    keyword?: string;
+    limit?: number;
+}
+interface UseTokenSimilarTokensScriptResult {
+    tokens: Array<Token>;
+    isLoading: boolean;
+    unavailable: boolean;
+}
+/**
+ * Script for {@link TokenSimilarTokensWidget}.
+ *
+ * There is no dedicated "similar tokens" endpoint yet, so we fall back to
+ * a keyword search on the token's symbol, filter out the current token,
+ * and cap the result count. When no keyword is given the script reports
+ * `unavailable: true` so the UI surfaces a coming-soon state.
+ */
+declare function useTokenSimilarTokensScript({ chain, address, keyword, limit, }: UseTokenSimilarTokensScriptParams): UseTokenSimilarTokensScriptResult;
+
+interface TokenSimilarTokensWidgetProps {
+    chain: Chain;
+    address: string;
+    /** Keyword used by the fallback similarity search (typically the token symbol). */
+    keyword?: string;
+    limit?: number;
+    onTokenClick?: (token: Token) => void;
+    className?: string;
+}
+/**
+ * Similar Tokens widget. Uses a keyword-search fallback until a dedicated
+ * similarity endpoint is exposed; renders a coming-soon state otherwise.
+ */
+declare function TokenSimilarTokensWidget({ chain, address, keyword, limit, onTokenClick, className, }: TokenSimilarTokensWidgetProps): react_jsx_runtime.JSX.Element;
+
+interface TokenReusedImageListProps {
+    /**
+     * List of tokens sharing the same image as the subject token. When
+     * empty and {@link unavailable} is true, the component renders a
+     * coming-soon empty state.
+     */
+    tokens?: Array<Token>;
+    /** Whether the backend endpoint is unavailable. Defaults to true for now. */
+    unavailable?: boolean;
+    onTokenClick?: (token: Token) => void;
+    className?: string;
+}
+/**
+ * Reused Image Tokens — Axiom shows other tokens that reuse the same
+ * image as this token. The backend endpoint has not shipped; the widget
+ * exposes the surface shape so consumers can drop it into layouts
+ * immediately and the implementation can fill in later.
+ */
+declare function TokenReusedImageList({ tokens, unavailable, onTokenClick, className, }: TokenReusedImageListProps): react_jsx_runtime.JSX.Element;
+
+interface UseTokenReusedImageListScriptParams {
+    chain: Chain;
+    address: string;
+}
+interface UseTokenReusedImageListScriptResult {
+    tokens: Array<Token>;
+    isLoading: boolean;
+    unavailable: boolean;
+}
+/**
+ * Script for {@link TokenReusedImageListWidget}.
+ *
+ * The backend has no image-similarity endpoint yet, so this script
+ * returns `unavailable: true` to surface a friendly coming-soon state.
+ * Wire in the real implementation here once the API lands; no widget
+ * changes will be required.
+ */
+declare function useTokenReusedImageListScript(_params: UseTokenReusedImageListScriptParams): UseTokenReusedImageListScriptResult;
+
+interface TokenReusedImageListWidgetProps {
+    chain: Chain;
+    address: string;
+    onTokenClick?: (token: Token) => void;
+    className?: string;
+}
+/**
+ * Reused Image Tokens widget. Currently renders a coming-soon state; the
+ * surface is in place so the consuming shell can compose it unchanged
+ * once the backend endpoint ships.
+ */
+declare function TokenReusedImageListWidget({ chain, address, onTokenClick, className, }: TokenReusedImageListWidgetProps): react_jsx_runtime.JSX.Element;
+
 type TokenListResolution = "1m" | "5m" | "1h" | "4h" | "24h";
 interface TokenListResolutionSelectorProps {
     /** current resolution */
@@ -1217,4 +1824,4 @@ declare function useTokens({ chain, addresses, pollMs, }: UseTokensParams): {
     refetch: () => Promise<void>;
 };
 
-export { type CexListingEntry, HolderTagBadge, HolderTagBadgeList, type HolderTagBadgeListProps, type HolderTagBadgeProps, NewTokenListWidget, type NewTokenListWidgetProps, type OverviewResolution, PulseFinalStretchListWidget, type PulseFinalStretchListWidgetProps, PulseList, PulseListHeader, type PulseListHeaderProps, PulseListItem, type PulseListItemActionComponent, type PulseListItemActionProps, type PulseListItemProps, PulseListItemSkeleton, type PulseListItemSkeletonProps, type PulseListProps, type PulseListType, PulseMigratedListWidget, type PulseMigratedListWidgetProps, PulseNewListWidget, type PulseNewListWidgetProps, SEARCH_MODAL_ID, SearchHistoryUI, type SearchHistoryUIProps, SearchHistoryWidget, type SearchHistoryWidgetProps, SearchInputUI, type SearchInputUIProps, SearchModal, type SearchModalParams, type SearchModalResult, SearchResultItemUI, type SearchResultItemUIProps, SearchResultListHeader, type SearchResultListHeaderProps, SearchResultListSkeleton, type SearchResultListSkeletonProps, SearchResultListWidget, type SearchResultListWidgetProps, SearchTokensButton, type SearchTokensButtonProps, SearchWidget, type SearchWidgetProps, StockTokenListWidget, type StockTokenListWidgetProps, TRADER_TAG_META, TokenAbout, type TokenAboutProps, TokenAboutWidget, type TokenAboutWidgetProps, TokenActivitiesList, type TokenActivitiesListProps, type TokenActivitiesListSortBy, TokenActivitiesListWidget, type TokenActivitiesListWidgetProps, TokenAvatar, type TokenAvatarProps, TokenBasicInfo, type TokenBasicInfoProps, TokenBasicInfoWidget, type TokenBasicInfoWidgetProps, TokenCategories, type TokenCategoriesProps, TokenCategoriesWidget, type TokenCategoriesWidgetProps, TokenCexListing, type TokenCexListingProps, TokenCexListingWidget, type TokenCexListingWidgetProps, TokenDetailHeader, type TokenDetailHeaderProps, TokenDetailHeaderWidget, type TokenDetailHeaderWidgetProps, TokenHoldersCount, type TokenHoldersCountProps, TokenHoldersCountWidget, type TokenHoldersCountWidgetProps, TokenHoldersList, type TokenHoldersListProps, type TokenHoldersListSortBy, TokenHoldersListWidget, type TokenHoldersListWidgetProps, TokenLiquidities, type TokenLiquiditiesProps, TokenLiquiditiesWidget, type TokenLiquiditiesWidgetProps, TokenList, type TokenListActionsComponent, type TokenListActionsProps, TokenListFilter, TokenListFilterModal, type TokenListFilterModalProps, TokenListFilterPopover, type TokenListFilterPopoverProps, type TokenListFilterProps, TokenListFilterWidget, type TokenListFilterWidgetProps, type TokenListFiltersType, type TokenListProps, type TokenListResolution, TokenListResolutionSelectorDesktop, TokenListResolutionSelectorMobile, type TokenListResolutionSelectorProps, TokenListResolutionSelectorWidget, type TokenListSortDirections, TokenMarketCap, type TokenMarketCapProps, TokenMarketCapWidget, type TokenMarketCapWidgetProps, TokenPrice, type TokenPriceProps, TokenPriceWidget, type TokenPriceWidgetProps, TokenSecurity, type TokenSecurityProps, TokenSecurityWidget, type TokenSecurityWidgetProps, TokenSocialMedia, type TokenSocialMediaProps, TokenSocialMediaWidget, type TokenSocialMediaWidgetProps, TokenTradersOverview, type TokenTradersOverviewProps, TokenTradersOverviewWidget, type TokenTradersOverviewWidgetProps, TokenTransactionsOverview, type TokenTransactionsOverviewProps, TokenTransactionsOverviewWidget, type TokenTransactionsOverviewWidgetProps, TokenVolume, type TokenVolumeProps, TokenVolumeWidget, type TokenVolumeWidgetProps, TokenVolumesOverview, type TokenVolumesOverviewProps, TokenVolumesOverviewWidget, type TokenVolumesOverviewWidgetProps, TraderTagBadge, TraderTagBadgeList, type TraderTagBadgeListProps, type TraderTagBadgeProps, TrendingTokenListWidget, type TrendingTokenListWidgetProps, type UseNewTokensScriptParams, type UseNewTokensScriptResult, type UsePulseFinalStretchListScriptParams, type UsePulseFinalStretchListScriptResult, type UsePulseMigratedListScriptParams, type UsePulseMigratedListScriptResult, type UsePulseNewListScriptParams, type UsePulseNewListScriptResult, type UseSearchResultListScriptParams, type UseSearchScriptParams, type UseStockTokensScriptParams, type UseStockTokensScriptResult, type UseTokenActivitiesListScriptParams, type UseTokenActivitiesListScriptResult, type UseTokenHoldersListScriptParams, type UseTokenHoldersListScriptResult, type UseTokensParams, type UseTrendingTokensScriptParams, type UseTrendingTokensScriptResult, useNewTokensScript, usePulseFinalStretchListScript, usePulseMigratedListScript, usePulseNewListScript, useSearchHistory, useSearchResultListScript, useSearchScript, useStockTokensScript, useTokenAboutScript, useTokenActivitiesListScript, useTokenBasicInfoScript, useTokenCategoriesScript, useTokenCexListingScript, useTokenDetailHeaderScript, useTokenHoldersCountScript, useTokenHoldersListScript, useTokenLiquiditiesScript, useTokenMarketCapScript, useTokenPriceScript, useTokenSecurityScript, useTokenSocialMediaScript, useTokenTradersOverviewScript, useTokenTransactionsOverviewScript, useTokenVolumeScript, useTokenVolumesOverviewScript, useTokens, useTrendingTokensScript, _default as version };
+export { type CexListingEntry, DEFAULT_FLIP_HOVER_RESOLUTIONS, HolderTagBadge, HolderTagBadgeList, type HolderTagBadgeListProps, type HolderTagBadgeProps, NewTokenListWidget, type NewTokenListWidgetProps, type OverviewResolution, PulseFinalStretchListWidget, type PulseFinalStretchListWidgetProps, PulseList, PulseListHeader, type PulseListHeaderProps, PulseListItem, type PulseListItemActionComponent, type PulseListItemActionProps, type PulseListItemProps, PulseListItemSkeleton, type PulseListItemSkeletonProps, type PulseListProps, type PulseListType, PulseMigratedListWidget, type PulseMigratedListWidgetProps, PulseNewListWidget, type PulseNewListWidgetProps, SEARCH_MODAL_ID, SearchHistoryUI, type SearchHistoryUIProps, SearchHistoryWidget, type SearchHistoryWidgetProps, SearchInputUI, type SearchInputUIProps, SearchModal, type SearchModalParams, type SearchModalResult, SearchResultItemUI, type SearchResultItemUIProps, SearchResultListHeader, type SearchResultListHeaderProps, SearchResultListSkeleton, type SearchResultListSkeletonProps, SearchResultListWidget, type SearchResultListWidgetProps, SearchTokensButton, type SearchTokensButtonProps, SearchWidget, type SearchWidgetProps, StockTokenListWidget, type StockTokenListWidgetProps, TRADER_TAG_META, TokenAbout, type TokenAboutProps, TokenAboutWidget, type TokenAboutWidgetProps, TokenActivitiesList, type TokenActivitiesListCurrency, type TokenActivitiesListProps, type TokenActivitiesListSortBy, type TokenActivitiesListTraderFilter, TokenActivitiesListWidget, type TokenActivitiesListWidgetProps, TokenAvatar, type TokenAvatarProps, TokenBasicInfo, type TokenBasicInfoProps, TokenBasicInfoWidget, type TokenBasicInfoWidgetProps, TokenCategories, type TokenCategoriesProps, TokenCategoriesWidget, type TokenCategoriesWidgetProps, TokenCexListing, type TokenCexListingProps, TokenCexListingWidget, type TokenCexListingWidgetProps, TokenChartBanner, type TokenChartBannerProps, TokenChartBannerWidget, type TokenChartBannerWidgetProps, TokenDetailHeader, type TokenDetailHeaderProps, TokenDetailHeaderWidget, type TokenDetailHeaderWidgetProps, TokenDevTokensList, type TokenDevTokensListProps, TokenDevTokensListWidget, type TokenDevTokensListWidgetProps, TokenDevTokensSummary, type TokenDevTokensSummaryProps, TokenHoldersCount, type TokenHoldersCountProps, TokenHoldersCountWidget, type TokenHoldersCountWidgetProps, TokenHoldersList, type TokenHoldersListProps, type TokenHoldersListSortBy, TokenHoldersListWidget, type TokenHoldersListWidgetProps, TokenLiquidities, type TokenLiquiditiesProps, TokenLiquiditiesWidget, type TokenLiquiditiesWidgetProps, TokenList, type TokenListActionsComponent, type TokenListActionsProps, TokenListFilter, TokenListFilterModal, type TokenListFilterModalProps, TokenListFilterPopover, type TokenListFilterPopoverProps, type TokenListFilterProps, TokenListFilterWidget, type TokenListFilterWidgetProps, type TokenListFiltersType, type TokenListProps, type TokenListResolution, TokenListResolutionSelectorDesktop, TokenListResolutionSelectorMobile, type TokenListResolutionSelectorProps, TokenListResolutionSelectorWidget, type TokenListSortDirections, TokenMarketCap, type TokenMarketCapProps, TokenMarketCapWidget, type TokenMarketCapWidgetProps, TokenOrdersList, type TokenOrdersListCurrency, type TokenOrdersListProps, type TokenOrdersListState, type TokenOrdersListStateFilter, TokenOrdersListWidget, type TokenOrdersListWidgetProps, TokenPositionsList, type TokenPositionsListCurrency, type TokenPositionsListProps, TokenPositionsListWidget, type TokenPositionsListWidgetProps, TokenPrice, type TokenPriceProps, TokenPriceWidget, type TokenPriceWidgetProps, TokenReusedImageList, type TokenReusedImageListProps, TokenReusedImageListWidget, type TokenReusedImageListWidgetProps, TokenSecurity, type TokenSecurityProps, TokenSecurityWidget, type TokenSecurityWidgetProps, TokenSimilarTokens, type TokenSimilarTokensProps, TokenSimilarTokensWidget, type TokenSimilarTokensWidgetProps, TokenSocialMedia, type TokenSocialMediaProps, TokenSocialMediaWidget, type TokenSocialMediaWidgetProps, TokenStatsFlipBase, type TokenStatsFlipBaseProps, type TokenStatsFlipBaseResolution, TokenStatsFlipHover, type TokenStatsFlipHoverProps, type TokenStatsFlipHoverResolution, type TokenStatsFlipProps, TokenStatsFlipWidget, type TokenStatsFlipWidgetProps, TokenTopTradersList, type TokenTopTradersListProps, TokenTopTradersListWidget, type TokenTopTradersListWidgetProps, TokenTradersOverview, type TokenTradersOverviewProps, TokenTradersOverviewWidget, type TokenTradersOverviewWidgetProps, TokenTransactionsOverview, type TokenTransactionsOverviewProps, TokenTransactionsOverviewWidget, type TokenTransactionsOverviewWidgetProps, TokenVolume, type TokenVolumeProps, TokenVolumeWidget, type TokenVolumeWidgetProps, TokenVolumesOverview, type TokenVolumesOverviewProps, TokenVolumesOverviewWidget, type TokenVolumesOverviewWidgetProps, TraderTagBadge, TraderTagBadgeList, type TraderTagBadgeListProps, type TraderTagBadgeProps, TrendingTokenListWidget, type TrendingTokenListWidgetProps, type UseNewTokensScriptParams, type UseNewTokensScriptResult, type UsePulseFinalStretchListScriptParams, type UsePulseFinalStretchListScriptResult, type UsePulseMigratedListScriptParams, type UsePulseMigratedListScriptResult, type UsePulseNewListScriptParams, type UsePulseNewListScriptResult, type UseSearchResultListScriptParams, type UseSearchScriptParams, type UseStockTokensScriptParams, type UseStockTokensScriptResult, type UseTokenActivitiesListScriptParams, type UseTokenActivitiesListScriptResult, type UseTokenChartBannerScriptParams, type UseTokenChartBannerScriptResult, type UseTokenDevTokensListScriptParams, type UseTokenDevTokensListScriptResult, type UseTokenHoldersListScriptParams, type UseTokenHoldersListScriptResult, type UseTokenOrdersListScriptParams, type UseTokenOrdersListScriptResult, type UseTokenPositionsListScriptParams, type UseTokenPositionsListScriptResult, type UseTokenReusedImageListScriptParams, type UseTokenReusedImageListScriptResult, type UseTokenSimilarTokensScriptParams, type UseTokenSimilarTokensScriptResult, type UseTokenStatsFlipScriptParams, type UseTokenTopTradersListScriptParams, type UseTokenTopTradersListScriptResult, type UseTokensParams, type UseTrendingTokensScriptParams, type UseTrendingTokensScriptResult, useNewTokensScript, usePulseFinalStretchListScript, usePulseMigratedListScript, usePulseNewListScript, useSearchHistory, useSearchResultListScript, useSearchScript, useStockTokensScript, useTokenAboutScript, useTokenActivitiesListScript, useTokenBasicInfoScript, useTokenCategoriesScript, useTokenCexListingScript, useTokenChartBannerScript, useTokenDetailHeaderScript, useTokenDevTokensListScript, useTokenHoldersCountScript, useTokenHoldersListScript, useTokenLiquiditiesScript, useTokenMarketCapScript, useTokenOrdersListScript, useTokenPositionsListScript, useTokenPriceScript, useTokenReusedImageListScript, useTokenSecurityScript, useTokenSimilarTokensScript, useTokenSocialMediaScript, useTokenStatsFlipScript, useTokenTopTradersListScript, useTokenTradersOverviewScript, useTokenTransactionsOverviewScript, useTokenVolumeScript, useTokenVolumesOverviewScript, useTokens, useTrendingTokensScript, _default as version };