@liberfi.io/ui-tokens 3.0.23 → 3.0.24

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, GetTokenListOptions, TokenProtocol, Chain, WalletTag, TokenSocialMedias, TokenHoldersSortBy, TokenHolder, ActivitiesSortBy, Activity, TokenStats, TokenSecurity as TokenSecurity$1, TokenLiquidity, PortfolioPnl, LimitOrderState, LimitOrder, TokenFieldOption } from '@liberfi.io/types';
+import { Token, GetTokenListOptions, TokenProtocol, Chain, WalletTag, TokenSocialMedias, TokenHoldersSortBy, TokenHolder, ActivitiesSortBy, Activity, TokenStats, TokenSecurity as TokenSecurity$1, TokenLiquidity, PortfolioPnl, LimitOrderState, LimitOrder, TokenTopTrader, TokenTopTradersSortBy, TokenFieldOption } 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';
@@ -1335,7 +1335,7 @@ interface TokenOrdersListWidgetProps {
 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>;
+    traders: Array<TokenTopTrader>;
     isLoading?: boolean;
     hasMore?: boolean;
     onLoadMore?: () => void;
@@ -1350,10 +1350,7 @@ interface TokenTopTradersListProps {
  * 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.
+ * Uses the token top-traders endpoint and its trader-specific PnL fields.
  */
 declare function TokenTopTradersList({ traders, isLoading, hasMore, onLoadMore, onlyTracked, onOnlyTrackedChange, now, renderAddress, className, }: TokenTopTradersListProps): react_jsx_runtime.JSX.Element;
 
@@ -1361,11 +1358,15 @@ interface UseTokenTopTradersListScriptParams {
     chain: Chain;
     address: string;
     limit?: number;
+    /** initial sortBy; undefined means the first request uses server default ordering. */
+    initialSortBy?: TokenTopTradersSortBy;
     initialOnlyTracked?: boolean;
 }
 interface UseTokenTopTradersListScriptResult {
-    traders: Array<TokenHolder>;
+    traders: Array<TokenTopTrader>;
     isLoading: boolean;
+    sortBy: TokenTopTradersSortBy | undefined;
+    setSortBy: (s: TokenTopTradersSortBy) => void;
     hasMore: boolean;
     loadMore: () => void;
     onlyTracked: boolean;
@@ -1374,13 +1375,12 @@ interface UseTokenTopTradersListScriptResult {
 /**
  * Script for the top-traders list widget.
  *
- * Builds on {@link useTokenTopTradersQuery} (bridge over the holders
- * endpoint with `sortBy=realizedPnl`). `onlyTracked` is a client-side
+ * Builds on {@link useTokenTopTradersQuery}. `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;
+declare function useTokenTopTradersListScript({ chain, address, limit, initialSortBy, initialOnlyTracked, }: UseTokenTopTradersListScriptParams): UseTokenTopTradersListScriptResult;
 
 interface TokenTopTradersListWidgetProps {
     chain: Chain;

package/dist/index.d.ts

@@ -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, GetTokenListOptions, TokenProtocol, Chain, WalletTag, TokenSocialMedias, TokenHoldersSortBy, TokenHolder, ActivitiesSortBy, Activity, TokenStats, TokenSecurity as TokenSecurity$1, TokenLiquidity, PortfolioPnl, LimitOrderState, LimitOrder, TokenFieldOption } from '@liberfi.io/types';
+import { Token, GetTokenListOptions, TokenProtocol, Chain, WalletTag, TokenSocialMedias, TokenHoldersSortBy, TokenHolder, ActivitiesSortBy, Activity, TokenStats, TokenSecurity as TokenSecurity$1, TokenLiquidity, PortfolioPnl, LimitOrderState, LimitOrder, TokenTopTrader, TokenTopTradersSortBy, TokenFieldOption } 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';
@@ -1335,7 +1335,7 @@ interface TokenOrdersListWidgetProps {
 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>;
+    traders: Array<TokenTopTrader>;
     isLoading?: boolean;
     hasMore?: boolean;
     onLoadMore?: () => void;
@@ -1350,10 +1350,7 @@ interface TokenTopTradersListProps {
  * 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.
+ * Uses the token top-traders endpoint and its trader-specific PnL fields.
  */
 declare function TokenTopTradersList({ traders, isLoading, hasMore, onLoadMore, onlyTracked, onOnlyTrackedChange, now, renderAddress, className, }: TokenTopTradersListProps): react_jsx_runtime.JSX.Element;
 
@@ -1361,11 +1358,15 @@ interface UseTokenTopTradersListScriptParams {
     chain: Chain;
     address: string;
     limit?: number;
+    /** initial sortBy; undefined means the first request uses server default ordering. */
+    initialSortBy?: TokenTopTradersSortBy;
     initialOnlyTracked?: boolean;
 }
 interface UseTokenTopTradersListScriptResult {
-    traders: Array<TokenHolder>;
+    traders: Array<TokenTopTrader>;
     isLoading: boolean;
+    sortBy: TokenTopTradersSortBy | undefined;
+    setSortBy: (s: TokenTopTradersSortBy) => void;
     hasMore: boolean;
     loadMore: () => void;
     onlyTracked: boolean;
@@ -1374,13 +1375,12 @@ interface UseTokenTopTradersListScriptResult {
 /**
  * Script for the top-traders list widget.
  *
- * Builds on {@link useTokenTopTradersQuery} (bridge over the holders
- * endpoint with `sortBy=realizedPnl`). `onlyTracked` is a client-side
+ * Builds on {@link useTokenTopTradersQuery}. `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;
+declare function useTokenTopTradersListScript({ chain, address, limit, initialSortBy, initialOnlyTracked, }: UseTokenTopTradersListScriptParams): UseTokenTopTradersListScriptResult;
 
 interface TokenTopTradersListWidgetProps {
     chain: Chain;