@liberfi.io/ui-predict 4.0.44 → 4.0.46

package/dist/index.d.mts

@@ -298,6 +298,7 @@ type TradeSide = "buy" | "sell";
 type OrderType = "market" | "limit";
 type ExpirationPreset = "5m" | "1h" | "12h" | "24h" | "eod" | "custom";
 type DurationUnit = "minutes" | "hours" | "days";
+type OddsFormatter = (price: number) => string;
 interface TradeFormValidation {
     isValid: boolean;
     errors: string[];
@@ -311,6 +312,49 @@ declare function roundToTickSize(price: number, tickSize: string): number;
  * Floor a number to the given number of decimal places (never rounds up).
  */
 declare function floorToDecimals(value: number, decimals: number): number;
+/**
+ * Price-dependent factor in Polymarket's taker-fee formula:
+ * `min(1, (1 − price) / price)` (equivalently `min(price, 1−price) / price`).
+ * Capped at 1 (the worst case, reached when `price ≤ 0.5`). Falls back to the
+ * worst case (1) when the price is unknown/degenerate.
+ */
+declare function polymarketFeeFactor(pricePerShare: number): number;
+interface ComputeMaxBuyAmountParams {
+    source: string;
+    usdcBalance: number | null | undefined;
+    safetyBufferUsd?: number;
+    /**
+     * Polymarket base fee in basis points (from `GET /fee-rate/{token_id}`).
+     * Polymarket reserves a taker fee on top of the order amount, so the largest
+     * spendable amount must leave room for it. Defaults to 0 (fee-free markets).
+     */
+    feeRateBps?: number;
+    /**
+     * Per-share price (0–1) used to price the fee precisely. Omit to reserve the
+     * worst-case fee (factor = 1). Safe for buys: adverse fills push the price up,
+     * which only lowers the fee factor.
+     */
+    pricePerShare?: number;
+}
+declare function computeMaxBuyAmount({ source, usdcBalance, safetyBufferUsd, feeRateBps, pricePerShare, }: ComputeMaxBuyAmountParams): number;
+interface EstimatePolymarketBuyFeeParams {
+    /** USDC amount the user intends to spend. */
+    usdcAmount: number;
+    /** Per-share execution price (0–1). */
+    pricePerShare: number;
+    /** Base fee in basis points (from `GET /fee-rate/{token_id}`). */
+    feeRateBps: number;
+}
+/**
+ * Estimate the Polymarket taker fee (USDC) for a buy, mirroring Polymarket's
+ * fee formula:
+ *
+ *   fee = baseFeeRate × min(price, 1 − price) × shares,  shares = amount / price
+ *
+ * which simplifies to `amount × r × min(1, (1 − price) / price)`. When the
+ * price is unknown/degenerate we fall back to the worst case (`amount × r`).
+ */
+declare function estimatePolymarketBuyFee({ usdcAmount, pricePerShare, feeRateBps, }: EstimatePolymarketBuyFeeParams): number;
 /**
  * Parse a Polymarket CLOB API error message into a user-friendly string.
  * Falls back to the raw message (with order-hash stripped) if no pattern matches.
@@ -355,6 +399,11 @@ interface UseTradeFormResult {
     limitPrice: number;
     shares: number;
     estimatedCost: number;
+    /**
+     * Estimated Polymarket taker fee (USDC) reserved on top of the order amount.
+     * 0 for fee-free markets and for non-Polymarket sources.
+     */
+    estimatedFee: number;
     potentialPayout: number;
     potentialProfit: number;
     /**
@@ -363,6 +412,8 @@ interface UseTradeFormResult {
      */
     pricePerShare: number;
     usdcBalance: number | null;
+    maxBuyAmount: number;
+    spendableUsdcBalance: number | null;
     isBalanceLoading: boolean;
     isMarketDataLoading: boolean;
     isSubmitting: boolean;
@@ -529,8 +580,10 @@ interface EventMarketDetailWidgetProps {
      * `h-[262px]` so the widget can fill a flexible parent (e.g. `h-full`).
      */
     className?: string;
+    /** Optional formatter for display-only orderbook price labels. */
+    oddsFormatter?: OddsFormatter;
 }
-declare function EventMarketDetailWidget({ market, outcome, onTradeAction, initialViewMode, className, }: EventMarketDetailWidgetProps): react_jsx_runtime.JSX.Element;
+declare function EventMarketDetailWidget({ market, outcome, onTradeAction, initialViewMode, className, oddsFormatter, }: EventMarketDetailWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface EventPriceChartProps {
     event: PredictEvent;
@@ -688,6 +741,8 @@ interface TradeFormUIProps {
     limitPrice: number;
     shares: number;
     estimatedCost: number;
+    /** Estimated Polymarket taker fee (USDC). 0 hides the fee row. */
+    estimatedFee?: number;
     potentialPayout: number;
     potentialProfit: number;
     isMarketDataLoading: boolean;
@@ -703,6 +758,7 @@ interface TradeFormUIProps {
     /** Invoked when the user presses submit while balance is insufficient. */
     onInsufficientBalance?: () => void;
     supportsLimitOrder: boolean;
+    maxBuyAmount?: number;
     kycRequired: boolean;
     /** True when the user must complete KYC before the deposit flow is allowed. */
     needsKyc: boolean;
@@ -713,6 +769,8 @@ interface TradeFormUIProps {
     expirationPreset: ExpirationPreset;
     customDuration: number;
     customDurationUnit: DurationUnit;
+    /** Optional formatter for display-only odds/price labels. Defaults to cents/probability text. */
+    oddsFormatter?: OddsFormatter;
     onOutcomeChange: (outcome: TradeOutcome) => void;
     onOrderTypeChange: (type: OrderType) => void;
     onQuantityChange: (quantity: number) => void;
@@ -723,7 +781,7 @@ interface TradeFormUIProps {
     onCustomDurationUnitChange: (u: DurationUnit) => void;
     onSubmit: () => void;
 }
-declare function TradeFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, shares, potentialProfit, potentialPayout, estimatedCost, usdcBalance, isBalanceLoading, isMarketDataLoading, isSubmitting, authStatus, isValid, validationErrors, isInsufficientBalance, onInsufficientBalance, supportsLimitOrder, kycRequired, needsKyc, needsSetup, kycUrl, expirationEnabled, expirationPreset, customDuration, customDurationUnit, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: TradeFormUIProps): react_jsx_runtime.JSX.Element;
+declare function TradeFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, shares, potentialProfit, potentialPayout, estimatedCost, estimatedFee, usdcBalance, isBalanceLoading, isMarketDataLoading, isSubmitting, authStatus, isValid, validationErrors, isInsufficientBalance, onInsufficientBalance, supportsLimitOrder, maxBuyAmount, kycRequired, needsKyc, needsSetup, kycUrl, expirationEnabled, expirationPreset, customDuration, customDurationUnit, oddsFormatter, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: TradeFormUIProps): react_jsx_runtime.JSX.Element;
 
 interface TradeFormWidgetProps {
     event?: PredictEvent;
@@ -744,8 +802,10 @@ interface TradeFormWidgetProps {
     onInsufficientBalance?: (source: ProviderSource) => void;
     /** Called whenever the user switches between YES and NO. */
     onOutcomeChange?: (outcome: TradeOutcome) => void;
+    /** Optional formatter for display-only odds/price labels. */
+    oddsFormatter?: OddsFormatter;
 }
-declare function TradeFormWidget({ event, market, variant, initialOutcome, chain, slippageBps, onInsufficientBalance, onOutcomeChange, }: TradeFormWidgetProps): react_jsx_runtime.JSX.Element;
+declare function TradeFormWidget({ event, market, variant, initialOutcome, chain, slippageBps, onInsufficientBalance, onOutcomeChange, oddsFormatter, }: TradeFormWidgetProps): react_jsx_runtime.JSX.Element;
 
 type PredictSellModalParams = {
     event: PredictEvent;
@@ -862,6 +922,8 @@ interface SellFormUIProps {
     expirationPreset: ExpirationPreset;
     customDuration: number;
     customDurationUnit: DurationUnit;
+    /** Optional formatter for display-only odds/price labels. Defaults to cents/probability text. */
+    oddsFormatter?: OddsFormatter;
     onOutcomeChange: (outcome: TradeOutcome) => void;
     onOrderTypeChange: (type: OrderType) => void;
     onQuantityChange: (quantity: number) => void;
@@ -873,7 +935,7 @@ interface SellFormUIProps {
     onCustomDurationUnitChange: (u: DurationUnit) => void;
     onSubmit: () => void;
 }
-declare function SellFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, estimatedReturn, isMarketDataLoading, isSubmitting, authStatus, isValid, validationErrors, supportsLimitOrder, kycRequired, needsKyc, needsSetup, onSetupRequired, kycUrl, totalShares, activeOrderShares, availableShares, isAvailableLoading, precision, expirationEnabled, expirationPreset, customDuration, customDurationUnit, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onSellAll, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: SellFormUIProps): react_jsx_runtime.JSX.Element;
+declare function SellFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, estimatedReturn, isMarketDataLoading, isSubmitting, authStatus, isValid, validationErrors, supportsLimitOrder, kycRequired, needsKyc, needsSetup, onSetupRequired, kycUrl, totalShares, activeOrderShares, availableShares, isAvailableLoading, precision, expirationEnabled, expirationPreset, customDuration, customDurationUnit, oddsFormatter, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onSellAll, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: SellFormUIProps): react_jsx_runtime.JSX.Element;
 
 interface SellFormWidgetProps {
     event?: PredictEvent;
@@ -896,8 +958,10 @@ interface SellFormWidgetProps {
     onSetupRequired?: () => void;
     /** Called after a sell order completes successfully (e.g. to close a modal). */
     onSuccess?: () => void;
+    /** Optional formatter for display-only odds/price labels. */
+    oddsFormatter?: OddsFormatter;
 }
-declare function SellFormWidget({ event, market, variant, initialOutcome, chain, slippageBps, onOutcomeChange, onSetupRequired, onSuccess, }: SellFormWidgetProps): react_jsx_runtime.JSX.Element;
+declare function SellFormWidget({ event, market, variant, initialOutcome, chain, slippageBps, onOutcomeChange, onSetupRequired, onSuccess, oddsFormatter, }: SellFormWidgetProps): react_jsx_runtime.JSX.Element;
 
 type PredictRedeemModalParams = {
     event: PredictEvent;
@@ -1366,4 +1430,4 @@ type PredictWalletProviderProps = PropsWithChildren<{
 }>;
 declare function PredictWalletProvider({ pollingInterval, enabled, enableKalshi, children, }: PredictWalletProviderProps): react_jsx_runtime.JSX.Element;
 
-export { CHART_RANGE_DURATION, CHART_RANGE_PERIOD, CHART_RANGE_SAMPLE_INTERVAL, CandlestickPeriod, type CandlestickPeriodType, CategoriesSkeleton, CategoriesUI, type CategoriesUIProps, CategoriesWidget, type CategoriesWidgetProps, type CategoryItem, type CategoryListItem, type CategoryTagItem, ChartRange, type ChartRangeType, CommentItemUI, type CommentItemUIProps, DEFAULT_CHART_RANGE, DEFAULT_FILTER_STATE, DEFAULT_PAGE_SIZE, DEFAULT_PRICE_HISTORY_INTERVAL, type DepthLevel, type DepthSlot, type DurationUnit, EventCommentsWidget, type EventCommentsWidgetProps, EventDetailPage, type EventDetailPageProps, EventDetailSkeleton, type EventDetailSkeletonProps, EventDetailUI, type EventDetailUIProps, EventDetailWidget, type EventDetailWidgetProps, EventItem, type EventItemProps, EventMarketDepthChartUI, type EventMarketDepthChartUIProps, EventMarketDetailWidget, type EventMarketDetailWidgetProps, EventPriceChart, type EventPriceChartProps, type EventsFilterState, EventsFilterUI, type EventsFilterUIProps, EventsHero, type EventsHeroProps, EventsPage, type EventsPageProps, EventsPageSkeleton, type EventsPageSkeletonProps, EventsSkeleton, type EventsSkeletonProps, EventsToolbarUI, type EventsToolbarUIProps, EventsUI, type EventsUIProps, EventsWidget, type EventsWidgetProps, type ExpirationPreset, KycModal, type KycModalProps, MAX_PRICE_HISTORY_MARKETS, MatchGroupCard, type MatchGroupCardProps, MatchMarketCard, type MatchMarketCardProps, MatchesFilterBar, type MatchesFilterBarProps, MatchesHero, type MatchesHeroProps, type MatchesHeroStats, MatchesPage, type MatchesPageProps, MatchesStatsBar, type MatchesStatsBarProps, MatchesWidget, type MatchesWidgetProps, type MatchesWidgetRef, ORDER_MAX_PRICE, ORDER_MIN_PRICE, ORDER_MIN_QUANTITY, ORDER_MIN_USDC, ORDER_PRICE_STEP, type OrderType, PREDICT_REDEEM_MODAL_ID, PREDICT_SEARCH_MODAL_ID, PREDICT_SELL_MODAL_ID, PREDICT_TRADE_MODAL_ID, PRICE_HISTORY_SAMPLE_INTERVAL, PredictRedeemModal, type PredictRedeemModalParams, type PredictRedeemModalResult, PredictSearchModal, type PredictSearchModalParams, type PredictSearchModalResult, PredictSellModal, type PredictSellModalParams, type PredictSellModalResult, PredictTradeModal, type PredictTradeModalParams, type PredictTradeModalResult, type PredictWalletContextValue, PredictWalletProvider, type PredictWalletProviderProps, PriceHistoryInterval, type PriceHistoryIntervalType, ProfilePage, type ProfilePageProps, RedeemFormWidget, type RedeemFormWidgetProps, SORT_PRESETS, STATIC_CATEGORIES, SearchEventsButton, type SearchEventsButtonProps, SearchHistoryUI, type SearchHistoryUIProps, SearchHistoryWidget, type SearchHistoryWidgetProps, SearchInputUI, type SearchInputUIProps, SearchResultItemUI, type SearchResultItemUIProps, SearchResultListWidget, type SearchResultListWidgetProps, SearchWidget, type SearchWidgetProps, SellFormUI, type SellFormUIProps, SellFormWidget, type SellFormWidgetProps, SetupModal, type SetupModalProps, SimilarEventCard, type SimilarEventCardProps, SimilarEventsSection, type SimilarEventsSectionProps, type SortPreset, SourceBadge, type SourceBadgeProps, SpreadIndicator, type SpreadIndicatorProps, type TagItem, type TagSlugSelection, TradeFormSkeleton, TradeFormUI, type TradeFormUIProps, type TradeFormValidation, TradeFormWidget, type TradeFormWidgetProps, type TradeOutcome, type TradeSide, type UseEventDetailParams, type UseEventsInfiniteParams, type UseEventsInfiniteResult, type UseSearchResultListScriptParams, type UseSearchScriptParams, type UseSellFormParams, type UseSellFormResult, type UseTradeFormParams, type UseTradeFormResult, UserActivitySection, type UserActivitySectionProps, countActiveFilters, fireCelebration, floorToDecimals, formatKMB, formatShares, getSourceMeta, parsePolymarketError, resolveExpiration, roundToTickSize, useEventDetail, useEventsInfinite, usePredictSearchHistory, usePredictWallet, useSearchResultListScript, useSearchScript, useSellForm, useTradeForm };
+export { CHART_RANGE_DURATION, CHART_RANGE_PERIOD, CHART_RANGE_SAMPLE_INTERVAL, CandlestickPeriod, type CandlestickPeriodType, CategoriesSkeleton, CategoriesUI, type CategoriesUIProps, CategoriesWidget, type CategoriesWidgetProps, type CategoryItem, type CategoryListItem, type CategoryTagItem, ChartRange, type ChartRangeType, CommentItemUI, type CommentItemUIProps, type ComputeMaxBuyAmountParams, DEFAULT_CHART_RANGE, DEFAULT_FILTER_STATE, DEFAULT_PAGE_SIZE, DEFAULT_PRICE_HISTORY_INTERVAL, type DepthLevel, type DepthSlot, type DurationUnit, type EstimatePolymarketBuyFeeParams, EventCommentsWidget, type EventCommentsWidgetProps, EventDetailPage, type EventDetailPageProps, EventDetailSkeleton, type EventDetailSkeletonProps, EventDetailUI, type EventDetailUIProps, EventDetailWidget, type EventDetailWidgetProps, EventItem, type EventItemProps, EventMarketDepthChartUI, type EventMarketDepthChartUIProps, EventMarketDetailWidget, type EventMarketDetailWidgetProps, EventPriceChart, type EventPriceChartProps, type EventsFilterState, EventsFilterUI, type EventsFilterUIProps, EventsHero, type EventsHeroProps, EventsPage, type EventsPageProps, EventsPageSkeleton, type EventsPageSkeletonProps, EventsSkeleton, type EventsSkeletonProps, EventsToolbarUI, type EventsToolbarUIProps, EventsUI, type EventsUIProps, EventsWidget, type EventsWidgetProps, type ExpirationPreset, KycModal, type KycModalProps, MAX_PRICE_HISTORY_MARKETS, MatchGroupCard, type MatchGroupCardProps, MatchMarketCard, type MatchMarketCardProps, MatchesFilterBar, type MatchesFilterBarProps, MatchesHero, type MatchesHeroProps, type MatchesHeroStats, MatchesPage, type MatchesPageProps, MatchesStatsBar, type MatchesStatsBarProps, MatchesWidget, type MatchesWidgetProps, type MatchesWidgetRef, ORDER_MAX_PRICE, ORDER_MIN_PRICE, ORDER_MIN_QUANTITY, ORDER_MIN_USDC, ORDER_PRICE_STEP, type OddsFormatter, type OrderType, PREDICT_REDEEM_MODAL_ID, PREDICT_SEARCH_MODAL_ID, PREDICT_SELL_MODAL_ID, PREDICT_TRADE_MODAL_ID, PRICE_HISTORY_SAMPLE_INTERVAL, PredictRedeemModal, type PredictRedeemModalParams, type PredictRedeemModalResult, PredictSearchModal, type PredictSearchModalParams, type PredictSearchModalResult, PredictSellModal, type PredictSellModalParams, type PredictSellModalResult, PredictTradeModal, type PredictTradeModalParams, type PredictTradeModalResult, type PredictWalletContextValue, PredictWalletProvider, type PredictWalletProviderProps, PriceHistoryInterval, type PriceHistoryIntervalType, ProfilePage, type ProfilePageProps, RedeemFormWidget, type RedeemFormWidgetProps, SORT_PRESETS, STATIC_CATEGORIES, SearchEventsButton, type SearchEventsButtonProps, SearchHistoryUI, type SearchHistoryUIProps, SearchHistoryWidget, type SearchHistoryWidgetProps, SearchInputUI, type SearchInputUIProps, SearchResultItemUI, type SearchResultItemUIProps, SearchResultListWidget, type SearchResultListWidgetProps, SearchWidget, type SearchWidgetProps, SellFormUI, type SellFormUIProps, SellFormWidget, type SellFormWidgetProps, SetupModal, type SetupModalProps, SimilarEventCard, type SimilarEventCardProps, SimilarEventsSection, type SimilarEventsSectionProps, type SortPreset, SourceBadge, type SourceBadgeProps, SpreadIndicator, type SpreadIndicatorProps, type TagItem, type TagSlugSelection, TradeFormSkeleton, TradeFormUI, type TradeFormUIProps, type TradeFormValidation, TradeFormWidget, type TradeFormWidgetProps, type TradeOutcome, type TradeSide, type UseEventDetailParams, type UseEventsInfiniteParams, type UseEventsInfiniteResult, type UseSearchResultListScriptParams, type UseSearchScriptParams, type UseSellFormParams, type UseSellFormResult, type UseTradeFormParams, type UseTradeFormResult, UserActivitySection, type UserActivitySectionProps, computeMaxBuyAmount, countActiveFilters, estimatePolymarketBuyFee, fireCelebration, floorToDecimals, formatKMB, formatShares, getSourceMeta, parsePolymarketError, polymarketFeeFactor, resolveExpiration, roundToTickSize, useEventDetail, useEventsInfinite, usePredictSearchHistory, usePredictWallet, useSearchResultListScript, useSearchScript, useSellForm, useTradeForm };

package/dist/index.d.ts

@@ -298,6 +298,7 @@ type TradeSide = "buy" | "sell";
 type OrderType = "market" | "limit";
 type ExpirationPreset = "5m" | "1h" | "12h" | "24h" | "eod" | "custom";
 type DurationUnit = "minutes" | "hours" | "days";
+type OddsFormatter = (price: number) => string;
 interface TradeFormValidation {
     isValid: boolean;
     errors: string[];
@@ -311,6 +312,49 @@ declare function roundToTickSize(price: number, tickSize: string): number;
  * Floor a number to the given number of decimal places (never rounds up).
  */
 declare function floorToDecimals(value: number, decimals: number): number;
+/**
+ * Price-dependent factor in Polymarket's taker-fee formula:
+ * `min(1, (1 − price) / price)` (equivalently `min(price, 1−price) / price`).
+ * Capped at 1 (the worst case, reached when `price ≤ 0.5`). Falls back to the
+ * worst case (1) when the price is unknown/degenerate.
+ */
+declare function polymarketFeeFactor(pricePerShare: number): number;
+interface ComputeMaxBuyAmountParams {
+    source: string;
+    usdcBalance: number | null | undefined;
+    safetyBufferUsd?: number;
+    /**
+     * Polymarket base fee in basis points (from `GET /fee-rate/{token_id}`).
+     * Polymarket reserves a taker fee on top of the order amount, so the largest
+     * spendable amount must leave room for it. Defaults to 0 (fee-free markets).
+     */
+    feeRateBps?: number;
+    /**
+     * Per-share price (0–1) used to price the fee precisely. Omit to reserve the
+     * worst-case fee (factor = 1). Safe for buys: adverse fills push the price up,
+     * which only lowers the fee factor.
+     */
+    pricePerShare?: number;
+}
+declare function computeMaxBuyAmount({ source, usdcBalance, safetyBufferUsd, feeRateBps, pricePerShare, }: ComputeMaxBuyAmountParams): number;
+interface EstimatePolymarketBuyFeeParams {
+    /** USDC amount the user intends to spend. */
+    usdcAmount: number;
+    /** Per-share execution price (0–1). */
+    pricePerShare: number;
+    /** Base fee in basis points (from `GET /fee-rate/{token_id}`). */
+    feeRateBps: number;
+}
+/**
+ * Estimate the Polymarket taker fee (USDC) for a buy, mirroring Polymarket's
+ * fee formula:
+ *
+ *   fee = baseFeeRate × min(price, 1 − price) × shares,  shares = amount / price
+ *
+ * which simplifies to `amount × r × min(1, (1 − price) / price)`. When the
+ * price is unknown/degenerate we fall back to the worst case (`amount × r`).
+ */
+declare function estimatePolymarketBuyFee({ usdcAmount, pricePerShare, feeRateBps, }: EstimatePolymarketBuyFeeParams): number;
 /**
  * Parse a Polymarket CLOB API error message into a user-friendly string.
  * Falls back to the raw message (with order-hash stripped) if no pattern matches.
@@ -355,6 +399,11 @@ interface UseTradeFormResult {
     limitPrice: number;
     shares: number;
     estimatedCost: number;
+    /**
+     * Estimated Polymarket taker fee (USDC) reserved on top of the order amount.
+     * 0 for fee-free markets and for non-Polymarket sources.
+     */
+    estimatedFee: number;
     potentialPayout: number;
     potentialProfit: number;
     /**
@@ -363,6 +412,8 @@ interface UseTradeFormResult {
      */
     pricePerShare: number;
     usdcBalance: number | null;
+    maxBuyAmount: number;
+    spendableUsdcBalance: number | null;
     isBalanceLoading: boolean;
     isMarketDataLoading: boolean;
     isSubmitting: boolean;
@@ -529,8 +580,10 @@ interface EventMarketDetailWidgetProps {
      * `h-[262px]` so the widget can fill a flexible parent (e.g. `h-full`).
      */
     className?: string;
+    /** Optional formatter for display-only orderbook price labels. */
+    oddsFormatter?: OddsFormatter;
 }
-declare function EventMarketDetailWidget({ market, outcome, onTradeAction, initialViewMode, className, }: EventMarketDetailWidgetProps): react_jsx_runtime.JSX.Element;
+declare function EventMarketDetailWidget({ market, outcome, onTradeAction, initialViewMode, className, oddsFormatter, }: EventMarketDetailWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface EventPriceChartProps {
     event: PredictEvent;
@@ -688,6 +741,8 @@ interface TradeFormUIProps {
     limitPrice: number;
     shares: number;
     estimatedCost: number;
+    /** Estimated Polymarket taker fee (USDC). 0 hides the fee row. */
+    estimatedFee?: number;
     potentialPayout: number;
     potentialProfit: number;
     isMarketDataLoading: boolean;
@@ -703,6 +758,7 @@ interface TradeFormUIProps {
     /** Invoked when the user presses submit while balance is insufficient. */
     onInsufficientBalance?: () => void;
     supportsLimitOrder: boolean;
+    maxBuyAmount?: number;
     kycRequired: boolean;
     /** True when the user must complete KYC before the deposit flow is allowed. */
     needsKyc: boolean;
@@ -713,6 +769,8 @@ interface TradeFormUIProps {
     expirationPreset: ExpirationPreset;
     customDuration: number;
     customDurationUnit: DurationUnit;
+    /** Optional formatter for display-only odds/price labels. Defaults to cents/probability text. */
+    oddsFormatter?: OddsFormatter;
     onOutcomeChange: (outcome: TradeOutcome) => void;
     onOrderTypeChange: (type: OrderType) => void;
     onQuantityChange: (quantity: number) => void;
@@ -723,7 +781,7 @@ interface TradeFormUIProps {
     onCustomDurationUnitChange: (u: DurationUnit) => void;
     onSubmit: () => void;
 }
-declare function TradeFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, shares, potentialProfit, potentialPayout, estimatedCost, usdcBalance, isBalanceLoading, isMarketDataLoading, isSubmitting, authStatus, isValid, validationErrors, isInsufficientBalance, onInsufficientBalance, supportsLimitOrder, kycRequired, needsKyc, needsSetup, kycUrl, expirationEnabled, expirationPreset, customDuration, customDurationUnit, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: TradeFormUIProps): react_jsx_runtime.JSX.Element;
+declare function TradeFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, shares, potentialProfit, potentialPayout, estimatedCost, estimatedFee, usdcBalance, isBalanceLoading, isMarketDataLoading, isSubmitting, authStatus, isValid, validationErrors, isInsufficientBalance, onInsufficientBalance, supportsLimitOrder, maxBuyAmount, kycRequired, needsKyc, needsSetup, kycUrl, expirationEnabled, expirationPreset, customDuration, customDurationUnit, oddsFormatter, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: TradeFormUIProps): react_jsx_runtime.JSX.Element;
 
 interface TradeFormWidgetProps {
     event?: PredictEvent;
@@ -744,8 +802,10 @@ interface TradeFormWidgetProps {
     onInsufficientBalance?: (source: ProviderSource) => void;
     /** Called whenever the user switches between YES and NO. */
     onOutcomeChange?: (outcome: TradeOutcome) => void;
+    /** Optional formatter for display-only odds/price labels. */
+    oddsFormatter?: OddsFormatter;
 }
-declare function TradeFormWidget({ event, market, variant, initialOutcome, chain, slippageBps, onInsufficientBalance, onOutcomeChange, }: TradeFormWidgetProps): react_jsx_runtime.JSX.Element;
+declare function TradeFormWidget({ event, market, variant, initialOutcome, chain, slippageBps, onInsufficientBalance, onOutcomeChange, oddsFormatter, }: TradeFormWidgetProps): react_jsx_runtime.JSX.Element;
 
 type PredictSellModalParams = {
     event: PredictEvent;
@@ -862,6 +922,8 @@ interface SellFormUIProps {
     expirationPreset: ExpirationPreset;
     customDuration: number;
     customDurationUnit: DurationUnit;
+    /** Optional formatter for display-only odds/price labels. Defaults to cents/probability text. */
+    oddsFormatter?: OddsFormatter;
     onOutcomeChange: (outcome: TradeOutcome) => void;
     onOrderTypeChange: (type: OrderType) => void;
     onQuantityChange: (quantity: number) => void;
@@ -873,7 +935,7 @@ interface SellFormUIProps {
     onCustomDurationUnitChange: (u: DurationUnit) => void;
     onSubmit: () => void;
 }
-declare function SellFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, estimatedReturn, isMarketDataLoading, isSubmitting, authStatus, isValid, validationErrors, supportsLimitOrder, kycRequired, needsKyc, needsSetup, onSetupRequired, kycUrl, totalShares, activeOrderShares, availableShares, isAvailableLoading, precision, expirationEnabled, expirationPreset, customDuration, customDurationUnit, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onSellAll, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: SellFormUIProps): react_jsx_runtime.JSX.Element;
+declare function SellFormUI({ event, market, variant, outcome, orderType, quantity, limitPrice, estimatedReturn, isMarketDataLoading, isSubmitting, authStatus, isValid, validationErrors, supportsLimitOrder, kycRequired, needsKyc, needsSetup, onSetupRequired, kycUrl, totalShares, activeOrderShares, availableShares, isAvailableLoading, precision, expirationEnabled, expirationPreset, customDuration, customDurationUnit, oddsFormatter, onOutcomeChange, onOrderTypeChange, onQuantityChange, onLimitPriceChange, onSellAll, onExpirationEnabledChange, onExpirationPresetChange, onCustomDurationChange, onCustomDurationUnitChange, onSubmit, }: SellFormUIProps): react_jsx_runtime.JSX.Element;
 
 interface SellFormWidgetProps {
     event?: PredictEvent;
@@ -896,8 +958,10 @@ interface SellFormWidgetProps {
     onSetupRequired?: () => void;
     /** Called after a sell order completes successfully (e.g. to close a modal). */
     onSuccess?: () => void;
+    /** Optional formatter for display-only odds/price labels. */
+    oddsFormatter?: OddsFormatter;
 }
-declare function SellFormWidget({ event, market, variant, initialOutcome, chain, slippageBps, onOutcomeChange, onSetupRequired, onSuccess, }: SellFormWidgetProps): react_jsx_runtime.JSX.Element;
+declare function SellFormWidget({ event, market, variant, initialOutcome, chain, slippageBps, onOutcomeChange, onSetupRequired, onSuccess, oddsFormatter, }: SellFormWidgetProps): react_jsx_runtime.JSX.Element;
 
 type PredictRedeemModalParams = {
     event: PredictEvent;
@@ -1366,4 +1430,4 @@ type PredictWalletProviderProps = PropsWithChildren<{
 }>;
 declare function PredictWalletProvider({ pollingInterval, enabled, enableKalshi, children, }: PredictWalletProviderProps): react_jsx_runtime.JSX.Element;
 
-export { CHART_RANGE_DURATION, CHART_RANGE_PERIOD, CHART_RANGE_SAMPLE_INTERVAL, CandlestickPeriod, type CandlestickPeriodType, CategoriesSkeleton, CategoriesUI, type CategoriesUIProps, CategoriesWidget, type CategoriesWidgetProps, type CategoryItem, type CategoryListItem, type CategoryTagItem, ChartRange, type ChartRangeType, CommentItemUI, type CommentItemUIProps, DEFAULT_CHART_RANGE, DEFAULT_FILTER_STATE, DEFAULT_PAGE_SIZE, DEFAULT_PRICE_HISTORY_INTERVAL, type DepthLevel, type DepthSlot, type DurationUnit, EventCommentsWidget, type EventCommentsWidgetProps, EventDetailPage, type EventDetailPageProps, EventDetailSkeleton, type EventDetailSkeletonProps, EventDetailUI, type EventDetailUIProps, EventDetailWidget, type EventDetailWidgetProps, EventItem, type EventItemProps, EventMarketDepthChartUI, type EventMarketDepthChartUIProps, EventMarketDetailWidget, type EventMarketDetailWidgetProps, EventPriceChart, type EventPriceChartProps, type EventsFilterState, EventsFilterUI, type EventsFilterUIProps, EventsHero, type EventsHeroProps, EventsPage, type EventsPageProps, EventsPageSkeleton, type EventsPageSkeletonProps, EventsSkeleton, type EventsSkeletonProps, EventsToolbarUI, type EventsToolbarUIProps, EventsUI, type EventsUIProps, EventsWidget, type EventsWidgetProps, type ExpirationPreset, KycModal, type KycModalProps, MAX_PRICE_HISTORY_MARKETS, MatchGroupCard, type MatchGroupCardProps, MatchMarketCard, type MatchMarketCardProps, MatchesFilterBar, type MatchesFilterBarProps, MatchesHero, type MatchesHeroProps, type MatchesHeroStats, MatchesPage, type MatchesPageProps, MatchesStatsBar, type MatchesStatsBarProps, MatchesWidget, type MatchesWidgetProps, type MatchesWidgetRef, ORDER_MAX_PRICE, ORDER_MIN_PRICE, ORDER_MIN_QUANTITY, ORDER_MIN_USDC, ORDER_PRICE_STEP, type OrderType, PREDICT_REDEEM_MODAL_ID, PREDICT_SEARCH_MODAL_ID, PREDICT_SELL_MODAL_ID, PREDICT_TRADE_MODAL_ID, PRICE_HISTORY_SAMPLE_INTERVAL, PredictRedeemModal, type PredictRedeemModalParams, type PredictRedeemModalResult, PredictSearchModal, type PredictSearchModalParams, type PredictSearchModalResult, PredictSellModal, type PredictSellModalParams, type PredictSellModalResult, PredictTradeModal, type PredictTradeModalParams, type PredictTradeModalResult, type PredictWalletContextValue, PredictWalletProvider, type PredictWalletProviderProps, PriceHistoryInterval, type PriceHistoryIntervalType, ProfilePage, type ProfilePageProps, RedeemFormWidget, type RedeemFormWidgetProps, SORT_PRESETS, STATIC_CATEGORIES, SearchEventsButton, type SearchEventsButtonProps, SearchHistoryUI, type SearchHistoryUIProps, SearchHistoryWidget, type SearchHistoryWidgetProps, SearchInputUI, type SearchInputUIProps, SearchResultItemUI, type SearchResultItemUIProps, SearchResultListWidget, type SearchResultListWidgetProps, SearchWidget, type SearchWidgetProps, SellFormUI, type SellFormUIProps, SellFormWidget, type SellFormWidgetProps, SetupModal, type SetupModalProps, SimilarEventCard, type SimilarEventCardProps, SimilarEventsSection, type SimilarEventsSectionProps, type SortPreset, SourceBadge, type SourceBadgeProps, SpreadIndicator, type SpreadIndicatorProps, type TagItem, type TagSlugSelection, TradeFormSkeleton, TradeFormUI, type TradeFormUIProps, type TradeFormValidation, TradeFormWidget, type TradeFormWidgetProps, type TradeOutcome, type TradeSide, type UseEventDetailParams, type UseEventsInfiniteParams, type UseEventsInfiniteResult, type UseSearchResultListScriptParams, type UseSearchScriptParams, type UseSellFormParams, type UseSellFormResult, type UseTradeFormParams, type UseTradeFormResult, UserActivitySection, type UserActivitySectionProps, countActiveFilters, fireCelebration, floorToDecimals, formatKMB, formatShares, getSourceMeta, parsePolymarketError, resolveExpiration, roundToTickSize, useEventDetail, useEventsInfinite, usePredictSearchHistory, usePredictWallet, useSearchResultListScript, useSearchScript, useSellForm, useTradeForm };
+export { CHART_RANGE_DURATION, CHART_RANGE_PERIOD, CHART_RANGE_SAMPLE_INTERVAL, CandlestickPeriod, type CandlestickPeriodType, CategoriesSkeleton, CategoriesUI, type CategoriesUIProps, CategoriesWidget, type CategoriesWidgetProps, type CategoryItem, type CategoryListItem, type CategoryTagItem, ChartRange, type ChartRangeType, CommentItemUI, type CommentItemUIProps, type ComputeMaxBuyAmountParams, DEFAULT_CHART_RANGE, DEFAULT_FILTER_STATE, DEFAULT_PAGE_SIZE, DEFAULT_PRICE_HISTORY_INTERVAL, type DepthLevel, type DepthSlot, type DurationUnit, type EstimatePolymarketBuyFeeParams, EventCommentsWidget, type EventCommentsWidgetProps, EventDetailPage, type EventDetailPageProps, EventDetailSkeleton, type EventDetailSkeletonProps, EventDetailUI, type EventDetailUIProps, EventDetailWidget, type EventDetailWidgetProps, EventItem, type EventItemProps, EventMarketDepthChartUI, type EventMarketDepthChartUIProps, EventMarketDetailWidget, type EventMarketDetailWidgetProps, EventPriceChart, type EventPriceChartProps, type EventsFilterState, EventsFilterUI, type EventsFilterUIProps, EventsHero, type EventsHeroProps, EventsPage, type EventsPageProps, EventsPageSkeleton, type EventsPageSkeletonProps, EventsSkeleton, type EventsSkeletonProps, EventsToolbarUI, type EventsToolbarUIProps, EventsUI, type EventsUIProps, EventsWidget, type EventsWidgetProps, type ExpirationPreset, KycModal, type KycModalProps, MAX_PRICE_HISTORY_MARKETS, MatchGroupCard, type MatchGroupCardProps, MatchMarketCard, type MatchMarketCardProps, MatchesFilterBar, type MatchesFilterBarProps, MatchesHero, type MatchesHeroProps, type MatchesHeroStats, MatchesPage, type MatchesPageProps, MatchesStatsBar, type MatchesStatsBarProps, MatchesWidget, type MatchesWidgetProps, type MatchesWidgetRef, ORDER_MAX_PRICE, ORDER_MIN_PRICE, ORDER_MIN_QUANTITY, ORDER_MIN_USDC, ORDER_PRICE_STEP, type OddsFormatter, type OrderType, PREDICT_REDEEM_MODAL_ID, PREDICT_SEARCH_MODAL_ID, PREDICT_SELL_MODAL_ID, PREDICT_TRADE_MODAL_ID, PRICE_HISTORY_SAMPLE_INTERVAL, PredictRedeemModal, type PredictRedeemModalParams, type PredictRedeemModalResult, PredictSearchModal, type PredictSearchModalParams, type PredictSearchModalResult, PredictSellModal, type PredictSellModalParams, type PredictSellModalResult, PredictTradeModal, type PredictTradeModalParams, type PredictTradeModalResult, type PredictWalletContextValue, PredictWalletProvider, type PredictWalletProviderProps, PriceHistoryInterval, type PriceHistoryIntervalType, ProfilePage, type ProfilePageProps, RedeemFormWidget, type RedeemFormWidgetProps, SORT_PRESETS, STATIC_CATEGORIES, SearchEventsButton, type SearchEventsButtonProps, SearchHistoryUI, type SearchHistoryUIProps, SearchHistoryWidget, type SearchHistoryWidgetProps, SearchInputUI, type SearchInputUIProps, SearchResultItemUI, type SearchResultItemUIProps, SearchResultListWidget, type SearchResultListWidgetProps, SearchWidget, type SearchWidgetProps, SellFormUI, type SellFormUIProps, SellFormWidget, type SellFormWidgetProps, SetupModal, type SetupModalProps, SimilarEventCard, type SimilarEventCardProps, SimilarEventsSection, type SimilarEventsSectionProps, type SortPreset, SourceBadge, type SourceBadgeProps, SpreadIndicator, type SpreadIndicatorProps, type TagItem, type TagSlugSelection, TradeFormSkeleton, TradeFormUI, type TradeFormUIProps, type TradeFormValidation, TradeFormWidget, type TradeFormWidgetProps, type TradeOutcome, type TradeSide, type UseEventDetailParams, type UseEventsInfiniteParams, type UseEventsInfiniteResult, type UseSearchResultListScriptParams, type UseSearchScriptParams, type UseSellFormParams, type UseSellFormResult, type UseTradeFormParams, type UseTradeFormResult, UserActivitySection, type UserActivitySectionProps, computeMaxBuyAmount, countActiveFilters, estimatePolymarketBuyFee, fireCelebration, floorToDecimals, formatKMB, formatShares, getSourceMeta, parsePolymarketError, polymarketFeeFactor, resolveExpiration, roundToTickSize, useEventDetail, useEventsInfinite, usePredictSearchHistory, usePredictWallet, useSearchResultListScript, useSearchScript, useSellForm, useTradeForm };