@agg-build/ui 1.2.9 → 1.2.11

package/dist/types/events/market-details/market-details.utils.d.ts

@@ -34,10 +34,11 @@ export type ResolvedMarket = {
 export declare const resolveMarketFromVenueMarkets: (venueMarkets: VenueMarket[], marketId: string | undefined) => ResolvedMarket | undefined;
 export declare const resolveDisplayOutcomeLabels: (labels: string[]) => string[];
 export declare const resolveInitialOutcomeLabel: (labels: string[], defaultOutcomeLabel: string | undefined) => string | undefined;
-export declare const resolveScopedSelectedOutcome: ({ venueMarkets, selectedOutcomeId, defaultOutcomeLabel, }: {
+export declare const resolveScopedSelectedOutcome: ({ venueMarkets, selectedOutcomeId, defaultOutcomeLabel, suppressFallbackWhenSelectedOutcomeOutOfScope, }: {
     venueMarkets: VenueMarket[];
     selectedOutcomeId: string | null | undefined;
     defaultOutcomeLabel: string | undefined;
+    suppressFallbackWhenSelectedOutcomeOutOfScope?: boolean;
 }) => {
     outcomeId: string | null;
     outcomeLabel: string | undefined;
@@ -45,21 +46,34 @@ export declare const resolveScopedSelectedOutcome: ({ venueMarkets, selectedOutc
 export declare const resolveAverageProbabilityByLabel: (venueMarkets: VenueMarket[], labels: string[]) => Map<string, number | undefined>;
 export declare const formatProbabilityPercent: (value: number | null | undefined, formatPercent?: (value: number) => string) => string;
 export declare const resolveOutcomeTone: (label: string, index: number) => MarketDetailsOrderBookTone;
-export declare const resolveHeaderOutcomeItems: (venueMarkets: VenueMarket[]) => MarketDetailsHeaderOutcomeItem[];
-export declare const resolveSubtitle: ({ venueMarkets, volume, formatCompactCurrency, labels, }: {
+export declare const resolveHeaderOutcomeItems: (venueMarkets: VenueMarket[], scopedMarket?: VenueMarket | null) => MarketDetailsHeaderOutcomeItem[];
+export declare const resolveSubtitle: ({ venueMarkets, volume, formatCompactCurrency, labels, tradableVenues, }: {
     venueMarkets: VenueMarket[];
     volume: number | undefined;
     formatCompactCurrency: (value: number) => string;
     labels: AggUiLabels;
+    /**
+     * Optional runtime-derived set of venues that have a live orderbook.
+     * Forwarded to `getVenueSummary` to filter `venueCount` to only
+     * tradeable venues. When omitted the count includes all venues
+     * regardless of orderbook availability.
+     */
+    tradableVenues?: ReadonlySet<string> | null;
 }) => string;
 export declare const resolveOtherTabRows: (market: ResolvedMarket, labels: AggUiLabels) => MarketDetailsMetaRow[];
-export declare const buildMarketDetailsModel: ({ venueMarkets, marketId, title, image, formatCompactCurrency, labels, }: {
+export declare const buildMarketDetailsModel: ({ venueMarkets, marketId, title, image, formatCompactCurrency, labels, tradableVenues, }: {
     venueMarkets: VenueMarket[];
     marketId: string | undefined;
     title: string | undefined;
     image: string | null | undefined;
     formatCompactCurrency: (value: number) => string;
     labels: AggUiLabels;
+    /**
+     * Forwarded to `resolveSubtitle` → `getVenueSummary` so the "X venues"
+     * subtitle reflects only venues with a live orderbook. Optional;
+     * subtitle counts all cluster venues when omitted.
+     */
+    tradableVenues?: ReadonlySet<string> | null;
 }) => {
     market: ResolvedMarket;
     primaryVenueMarket: VenueMarket;

package/dist/types/events/market-details/orderbook-aggregation.d.mts

@@ -16,13 +16,49 @@ export type AggregatedOrderbookRows = {
     includedOutcomeIds: string[];
     missingOutcomeIds: string[];
 };
-export declare const collectEligibleVenueOutcomes: ({ venueMarkets, selectedOutcomeLabel, }: {
+/**
+ * Pick the eligible outcome on each venue-market that corresponds to the
+ * user's selected side.
+ *
+ * Selected-outcome-first (when `selectedOutcomeId` is provided): find
+ * that exact outcome in the cluster, emit it, walk its `matchedVenueMarketOutcomes`
+ * refs to align siblings by id. **Return immediately** — no fallback to
+ * other markets via label. This matches the server-side smart-route CTE
+ * which keys off the specific outcome id and does not fall through to
+ * label-based discovery. Critical for inversely-framed per-team kalshi
+ * binaries where the user's "No" outcome has no MVMO refs (matcher only
+ * emits Yes-side rows), but a different market's "No" outcome (e.g.
+ * polymarket-No with title "Khamzat Chimaev") DOES have refs pointing
+ * to the OPPOSITE semantic side. Falling through to that parent in the
+ * label loop emits cross-side outcomes — observed in the orderbook
+ * showing 80¢ Chimaev-wins prices when the user clicked the 19¢
+ * Strickland-wins side. The selected-outcome short-circuit prevents it.
+ *
+ * MVMO-first label loop (when `selectedOutcomeId` is null): scan the
+ * cluster for any market whose selected-outcome carries MVMO refs and
+ * use it as the parent. Walk the refs to align siblings.
+ *
+ * Label-fallback: for any sibling not covered by an MVMO ref (unmatched
+ * markets, or older API responses that pre-date the refs), fall back to
+ * label matching with anchor-set guard so we don't regress on the
+ * historically-correct cases.
+ */
+export declare const collectEligibleVenueOutcomes: ({ venueMarkets, selectedOutcomeLabel, selectedOutcomeId, }: {
     venueMarkets: VenueMarket[];
     selectedOutcomeLabel: string | null | undefined;
+    /**
+     * The exact outcome id the user clicked. When provided AND found in the
+     * cluster, the function emits that outcome + only its MVMO siblings, then
+     * returns — bypassing the label-based parent-discovery loop. Required to
+     * keep inversely-framed-binary surfaces (chart/orderbook) on the same
+     * semantic side as the user's selection.
+     */
+    selectedOutcomeId?: string | null;
 }) => EligibleVenueOutcome[];
-export declare const collectEligibleVenueOutcomeIds: ({ venueMarkets, selectedOutcomeLabel, }: {
+export declare const collectEligibleVenueOutcomeIds: ({ venueMarkets, selectedOutcomeLabel, selectedOutcomeId, }: {
     venueMarkets: VenueMarket[];
     selectedOutcomeLabel: string | null | undefined;
+    selectedOutcomeId?: string | null;
 }) => string[];
 export declare const mergeVenueOutcomeOrderbooks: ({ eligibleOutcomes, orderbooksByOutcomeId, }: {
     eligibleOutcomes: EligibleVenueOutcome[];

package/dist/types/events/market-details/orderbook-aggregation.d.ts

@@ -16,13 +16,49 @@ export type AggregatedOrderbookRows = {
     includedOutcomeIds: string[];
     missingOutcomeIds: string[];
 };
-export declare const collectEligibleVenueOutcomes: ({ venueMarkets, selectedOutcomeLabel, }: {
+/**
+ * Pick the eligible outcome on each venue-market that corresponds to the
+ * user's selected side.
+ *
+ * Selected-outcome-first (when `selectedOutcomeId` is provided): find
+ * that exact outcome in the cluster, emit it, walk its `matchedVenueMarketOutcomes`
+ * refs to align siblings by id. **Return immediately** — no fallback to
+ * other markets via label. This matches the server-side smart-route CTE
+ * which keys off the specific outcome id and does not fall through to
+ * label-based discovery. Critical for inversely-framed per-team kalshi
+ * binaries where the user's "No" outcome has no MVMO refs (matcher only
+ * emits Yes-side rows), but a different market's "No" outcome (e.g.
+ * polymarket-No with title "Khamzat Chimaev") DOES have refs pointing
+ * to the OPPOSITE semantic side. Falling through to that parent in the
+ * label loop emits cross-side outcomes — observed in the orderbook
+ * showing 80¢ Chimaev-wins prices when the user clicked the 19¢
+ * Strickland-wins side. The selected-outcome short-circuit prevents it.
+ *
+ * MVMO-first label loop (when `selectedOutcomeId` is null): scan the
+ * cluster for any market whose selected-outcome carries MVMO refs and
+ * use it as the parent. Walk the refs to align siblings.
+ *
+ * Label-fallback: for any sibling not covered by an MVMO ref (unmatched
+ * markets, or older API responses that pre-date the refs), fall back to
+ * label matching with anchor-set guard so we don't regress on the
+ * historically-correct cases.
+ */
+export declare const collectEligibleVenueOutcomes: ({ venueMarkets, selectedOutcomeLabel, selectedOutcomeId, }: {
     venueMarkets: VenueMarket[];
     selectedOutcomeLabel: string | null | undefined;
+    /**
+     * The exact outcome id the user clicked. When provided AND found in the
+     * cluster, the function emits that outcome + only its MVMO siblings, then
+     * returns — bypassing the label-based parent-discovery loop. Required to
+     * keep inversely-framed-binary surfaces (chart/orderbook) on the same
+     * semantic side as the user's selection.
+     */
+    selectedOutcomeId?: string | null;
 }) => EligibleVenueOutcome[];
-export declare const collectEligibleVenueOutcomeIds: ({ venueMarkets, selectedOutcomeLabel, }: {
+export declare const collectEligibleVenueOutcomeIds: ({ venueMarkets, selectedOutcomeLabel, selectedOutcomeId, }: {
     venueMarkets: VenueMarket[];
     selectedOutcomeLabel: string | null | undefined;
+    selectedOutcomeId?: string | null;
 }) => string[];
 export declare const mergeVenueOutcomeOrderbooks: ({ eligibleOutcomes, orderbooksByOutcomeId, }: {
     eligibleOutcomes: EligibleVenueOutcome[];

package/dist/types/events/shared/chart-auto-fallback.d.mts

@@ -0,0 +1,43 @@
+import type { ChartTimeRange, MarketChartData } from "@agg-build/hooks";
+/**
+ * True when the chart payload has no usable bars *inside the visible domain*
+ * — i.e. the selected range yielded nothing to plot. A `null`/`undefined`
+ * payload (query not yet resolved) is also treated as "no data here" because
+ * the fallback decision uses this together with an `isLoading` guard.
+ *
+ * `liveCandle` counts as data: a market that just started trading inside the
+ * current bucket has a single forming candle and no closed bars; the chart
+ * should still render that.
+ *
+ * **Domain filtering**: pass `minTimeSec` (the rolling window's `startTs`) to
+ * ignore stale "courtesy" bars the API returns outside the requested window.
+ * Without this, a market that last traded 11h ago would surface a single
+ * out-of-window bar in `candles`, the chart would filter it out visually,
+ * but the emptiness check would think the chart has data — auto-fallback
+ * never fires and the user sees an empty plot.
+ */
+export declare const isMarketChartEmpty: (data: MarketChartData | null | undefined, options?: {
+    minTimeSec?: number;
+}) => boolean;
+/**
+ * Decide whether the chart should auto-switch to the `ALL` range. We do this
+ * exactly once per chart subject (the caller's ref guard) so a user who later
+ * manually re-picks the empty range isn't fought by a second auto-switch.
+ *
+ * Bail conditions, in order:
+ *   - we've already fallen back for this subject
+ *   - we're already on `ALL` (nothing wider to fall back to)
+ *   - the query errored — leave the failure surface to the error UI
+ *   - the query is still loading — wait for a real answer
+ *   - we have no payload yet — same reasoning
+ * Otherwise: fall back iff the payload is empty within the rolling domain.
+ */
+export declare const shouldAutoFallbackToAllRange: ({ chartData, isLoading, error, currentRange, hasAlreadyFallenBack, domainStartTs, }: {
+    chartData: MarketChartData | null | undefined;
+    isLoading: boolean;
+    error: unknown;
+    currentRange: ChartTimeRange;
+    hasAlreadyFallenBack: boolean;
+    /** Rolling-window startTs in seconds. Bars older than this are ignored. */
+    domainStartTs?: number;
+}) => boolean;

package/dist/types/events/shared/chart-auto-fallback.d.ts

@@ -0,0 +1,43 @@
+import type { ChartTimeRange, MarketChartData } from "@agg-build/hooks";
+/**
+ * True when the chart payload has no usable bars *inside the visible domain*
+ * — i.e. the selected range yielded nothing to plot. A `null`/`undefined`
+ * payload (query not yet resolved) is also treated as "no data here" because
+ * the fallback decision uses this together with an `isLoading` guard.
+ *
+ * `liveCandle` counts as data: a market that just started trading inside the
+ * current bucket has a single forming candle and no closed bars; the chart
+ * should still render that.
+ *
+ * **Domain filtering**: pass `minTimeSec` (the rolling window's `startTs`) to
+ * ignore stale "courtesy" bars the API returns outside the requested window.
+ * Without this, a market that last traded 11h ago would surface a single
+ * out-of-window bar in `candles`, the chart would filter it out visually,
+ * but the emptiness check would think the chart has data — auto-fallback
+ * never fires and the user sees an empty plot.
+ */
+export declare const isMarketChartEmpty: (data: MarketChartData | null | undefined, options?: {
+    minTimeSec?: number;
+}) => boolean;
+/**
+ * Decide whether the chart should auto-switch to the `ALL` range. We do this
+ * exactly once per chart subject (the caller's ref guard) so a user who later
+ * manually re-picks the empty range isn't fought by a second auto-switch.
+ *
+ * Bail conditions, in order:
+ *   - we've already fallen back for this subject
+ *   - we're already on `ALL` (nothing wider to fall back to)
+ *   - the query errored — leave the failure surface to the error UI
+ *   - the query is still loading — wait for a real answer
+ *   - we have no payload yet — same reasoning
+ * Otherwise: fall back iff the payload is empty within the rolling domain.
+ */
+export declare const shouldAutoFallbackToAllRange: ({ chartData, isLoading, error, currentRange, hasAlreadyFallenBack, domainStartTs, }: {
+    chartData: MarketChartData | null | undefined;
+    isLoading: boolean;
+    error: unknown;
+    currentRange: ChartTimeRange;
+    hasAlreadyFallenBack: boolean;
+    /** Rolling-window startTs in seconds. Bars older than this are ignored. */
+    domainStartTs?: number;
+}) => boolean;

package/dist/types/events/shared/display-outcome-price.d.mts

@@ -0,0 +1,14 @@
+import { type PriceSelection } from "./select-outcome-price";
+export declare const getDisplayOutcomePrice: ({ outcomeId, outcomeLabel, selection, bestPrices, bestMidpoint, bestMidpointsByOutcomeId, livePrices, fallbackPrice, }: {
+    outcomeId: string | null | undefined;
+    outcomeLabel?: string | null | undefined;
+    selection?: PriceSelection;
+    bestPrices?: ReadonlyMap<string, {
+        bestBid?: number;
+        bestAsk?: number;
+    }> | null | undefined;
+    bestMidpoint?: number | null | undefined;
+    bestMidpointsByOutcomeId?: ReadonlyMap<string, number> | null | undefined;
+    livePrices?: ReadonlyMap<string, number> | null | undefined;
+    fallbackPrice?: number | null | undefined;
+}) => number | undefined;

package/dist/types/events/shared/display-outcome-price.d.ts

@@ -0,0 +1,14 @@
+import { type PriceSelection } from "./select-outcome-price";
+export declare const getDisplayOutcomePrice: ({ outcomeId, outcomeLabel, selection, bestPrices, bestMidpoint, bestMidpointsByOutcomeId, livePrices, fallbackPrice, }: {
+    outcomeId: string | null | undefined;
+    outcomeLabel?: string | null | undefined;
+    selection?: PriceSelection;
+    bestPrices?: ReadonlyMap<string, {
+        bestBid?: number;
+        bestAsk?: number;
+    }> | null | undefined;
+    bestMidpoint?: number | null | undefined;
+    bestMidpointsByOutcomeId?: ReadonlyMap<string, number> | null | undefined;
+    livePrices?: ReadonlyMap<string, number> | null | undefined;
+    fallbackPrice?: number | null | undefined;
+}) => number | undefined;

package/dist/types/events/shared/display-outcome-venue.d.mts

@@ -0,0 +1,30 @@
+export declare const getDisplayOutcomeVenue: ({ outcomeId, outcomeLabel, selection, bestMidpointVenue, bestVenueByOutcomeId, bestPriceVenuesByOutcomeId, fallbackVenue, }: {
+    outcomeId: string | null | undefined;
+    outcomeLabel?: string | null | undefined;
+    /**
+     * Active trade side. When provided, the venue is sourced from
+     * `bestPriceVenuesByOutcomeId` (top-of-book side) to mirror the price the
+     * UI is showing. Falls through to the midpoint-driven logic only when no
+     * side-specific venue is available.
+     */
+    selection?: "buy" | "sell" | undefined;
+    /**
+     * Venue that produced the cluster-wide `bestMidpoint`. Mirrors the
+     * "yes" branch of `getDisplayOutcomePrice`: when the price comes from a
+     * cluster-level aggregate, the logo must come from the same aggregate.
+     * Required to keep logo + price in sync when the matched-sibling map
+     * doesn't know which market won.
+     */
+    bestMidpointVenue?: string | null | undefined;
+    bestVenueByOutcomeId?: ReadonlyMap<string, string> | null | undefined;
+    /**
+     * Per-outcome venue for the winning side of the top-of-book. Required so
+     * the logo follows the price when the cheapest `bestAsk` (buy) or richest
+     * `bestBid` (sell) lives on a matched sibling venue.
+     */
+    bestPriceVenuesByOutcomeId?: ReadonlyMap<string, {
+        bestBidVenue?: string;
+        bestAskVenue?: string;
+    }> | null | undefined;
+    fallbackVenue?: string | null | undefined;
+}) => string | undefined;

package/dist/types/events/shared/display-outcome-venue.d.ts

@@ -0,0 +1,30 @@
+export declare const getDisplayOutcomeVenue: ({ outcomeId, outcomeLabel, selection, bestMidpointVenue, bestVenueByOutcomeId, bestPriceVenuesByOutcomeId, fallbackVenue, }: {
+    outcomeId: string | null | undefined;
+    outcomeLabel?: string | null | undefined;
+    /**
+     * Active trade side. When provided, the venue is sourced from
+     * `bestPriceVenuesByOutcomeId` (top-of-book side) to mirror the price the
+     * UI is showing. Falls through to the midpoint-driven logic only when no
+     * side-specific venue is available.
+     */
+    selection?: "buy" | "sell" | undefined;
+    /**
+     * Venue that produced the cluster-wide `bestMidpoint`. Mirrors the
+     * "yes" branch of `getDisplayOutcomePrice`: when the price comes from a
+     * cluster-level aggregate, the logo must come from the same aggregate.
+     * Required to keep logo + price in sync when the matched-sibling map
+     * doesn't know which market won.
+     */
+    bestMidpointVenue?: string | null | undefined;
+    bestVenueByOutcomeId?: ReadonlyMap<string, string> | null | undefined;
+    /**
+     * Per-outcome venue for the winning side of the top-of-book. Required so
+     * the logo follows the price when the cheapest `bestAsk` (buy) or richest
+     * `bestBid` (sell) lives on a matched sibling venue.
+     */
+    bestPriceVenuesByOutcomeId?: ReadonlyMap<string, {
+        bestBidVenue?: string;
+        bestAskVenue?: string;
+    }> | null | undefined;
+    fallbackVenue?: string | null | undefined;
+}) => string | undefined;

package/dist/types/events/shared/display-reference-price.d.mts

@@ -0,0 +1,4 @@
+export declare const getDisplayReferencePrice: ({ bestMidpoint, fallbackPrice, }: {
+    bestMidpoint: number | null | undefined;
+    fallbackPrice: number | null | undefined;
+}) => number | undefined;

package/dist/types/events/shared/display-reference-price.d.ts

@@ -0,0 +1,4 @@
+export declare const getDisplayReferencePrice: ({ bestMidpoint, fallbackPrice, }: {
+    bestMidpoint: number | null | undefined;
+    fallbackPrice: number | null | undefined;
+}) => number | undefined;

package/dist/types/events/shared/select-outcome-price.d.mts

@@ -0,0 +1,21 @@
+/**
+ * Select the most relevant price for an outcome based on buy/sell intent.
+ *
+ * Precedence:
+ * 1. Best bid/ask (if selection intent is provided)
+ * 2. Live (WebSocket) price
+ * 3. Midpoint from REST
+ * 4. Fallback price
+ */
+export type PriceSelection = "buy" | "sell" | undefined;
+export declare const selectOutcomePrice: ({ outcomeId, selection, bestPrices, bestMidpointsByOutcomeId, livePrices, fallbackPrice, }: {
+    outcomeId: string | null | undefined;
+    selection?: PriceSelection;
+    bestPrices?: ReadonlyMap<string, {
+        bestBid?: number;
+        bestAsk?: number;
+    }> | null;
+    bestMidpointsByOutcomeId?: ReadonlyMap<string, number> | null;
+    livePrices?: ReadonlyMap<string, number> | null;
+    fallbackPrice?: number | null;
+}) => number | undefined;

package/dist/types/events/shared/select-outcome-price.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Select the most relevant price for an outcome based on buy/sell intent.
+ *
+ * Precedence:
+ * 1. Best bid/ask (if selection intent is provided)
+ * 2. Live (WebSocket) price
+ * 3. Midpoint from REST
+ * 4. Fallback price
+ */
+export type PriceSelection = "buy" | "sell" | undefined;
+export declare const selectOutcomePrice: ({ outcomeId, selection, bestPrices, bestMidpointsByOutcomeId, livePrices, fallbackPrice, }: {
+    outcomeId: string | null | undefined;
+    selection?: PriceSelection;
+    bestPrices?: ReadonlyMap<string, {
+        bestBid?: number;
+        bestAsk?: number;
+    }> | null;
+    bestMidpointsByOutcomeId?: ReadonlyMap<string, number> | null;
+    livePrices?: ReadonlyMap<string, number> | null;
+    fallbackPrice?: number | null;
+}) => number | undefined;

package/dist/types/pages/user-profile/components/available-balance-card.d.mts

@@ -8,10 +8,11 @@ type AvailableBalanceCardProps = {
     label?: string;
     valueLabel: string;
     chains: ChainRow[];
+    isLoading?: boolean;
     className?: string;
 };
 export declare const AvailableBalanceCard: {
-    ({ label, valueLabel, chains, className, }: AvailableBalanceCardProps): JSX.Element;
+    ({ label, valueLabel, chains, isLoading, className, }: AvailableBalanceCardProps): JSX.Element;
     displayName: string;
 };
 export {};

package/dist/types/pages/user-profile/components/available-balance-card.d.ts

@@ -8,10 +8,11 @@ type AvailableBalanceCardProps = {
     label?: string;
     valueLabel: string;
     chains: ChainRow[];
+    isLoading?: boolean;
     className?: string;
 };
 export declare const AvailableBalanceCard: {
-    ({ label, valueLabel, chains, className, }: AvailableBalanceCardProps): JSX.Element;
+    ({ label, valueLabel, chains, isLoading, className, }: AvailableBalanceCardProps): JSX.Element;
     displayName: string;
 };
 export {};

package/dist/types/pages/user-profile/components/positions-value-card.d.mts

@@ -1,10 +1,11 @@
 type PositionsValueCardProps = {
     label?: string;
     valueLabel: string;
+    isLoading?: boolean;
     className?: string;
 };
 export declare const PositionsValueCard: {
-    ({ label, valueLabel, className, }: PositionsValueCardProps): JSX.Element;
+    ({ label, valueLabel, isLoading, className, }: PositionsValueCardProps): JSX.Element;
     displayName: string;
 };
 export {};

package/dist/types/pages/user-profile/components/positions-value-card.d.ts

@@ -1,10 +1,11 @@
 type PositionsValueCardProps = {
     label?: string;
     valueLabel: string;
+    isLoading?: boolean;
     className?: string;
 };
 export declare const PositionsValueCard: {
-    ({ label, valueLabel, className, }: PositionsValueCardProps): JSX.Element;
+    ({ label, valueLabel, isLoading, className, }: PositionsValueCardProps): JSX.Element;
     displayName: string;
 };
 export {};

package/dist/types/pages/user-profile/index.d.mts

@@ -1,9 +1,9 @@
 import type { UserProfilePageProps } from "./user-profile.types";
-export type { UserProfileActivity, UserProfileBalance, UserProfileConnectedExchange, UserProfileConnectedWallet, UserProfileInfo, UserProfilePageClassNames, UserProfilePageProps, UserProfilePosition, UserProfilePositionFilter, UserProfilePositionVenueShare, UserProfileSocialLink, UserProfileVenueBalance, } from "./user-profile.types";
+export type { UserProfileActivity, UserProfileActivityStatus, UserProfileBalance, UserProfileConnectedExchange, UserProfileConnectedWallet, UserProfileInfo, UserProfilePageClassNames, UserProfilePageProps, UserProfilePosition, UserProfilePositionFilter, UserProfilePositionVenueShare, UserProfileSocialLink, UserProfileTransferStatus, UserProfileVenueBalance, } from "./user-profile.types";
 export { USER_PROFILE_TAB_ACTIVITY, USER_PROFILE_TAB_OPEN_ORDERS, USER_PROFILE_TAB_POSITIONS, } from "./user-profile.constants";
 export type { UserProfileTabValue } from "./user-profile.constants";
 export declare const UserProfilePage: {
-    ({ user, balanceChainsOverride, venueBalances: _venueBalances, balance, activePositions, closedPositions, activities, onEditProfile, onDeposit, onWithdraw, openOrders, initialPositionFilter, tab, onTabChange, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onActivityClick, getActivityHref, onOpenOrderClick, onCancelOrder, cancellingOrderIds, isLoadingPositions, isLoadingActivities, isLoadingOpenOrders, positionsError, activitiesError, openOrdersError, hasMoreActivePositions, isLoadingMoreActivePositions, onLoadMoreActivePositions, hasMoreClosedPositions, isLoadingMoreClosedPositions, onLoadMoreClosedPositions, onPositionFilterChange: onPositionFilterChangeProp, hasMoreActivities, isLoadingMoreActivities, onLoadMoreActivities, hasMoreOpenOrders, isLoadingMoreOpenOrders, onLoadMoreOpenOrders, classNames, onError, }: UserProfilePageProps & {
+    ({ user, balanceChainsOverride, venueBalances: _venueBalances, balance, activePositions, closedPositions, activities, onEditProfile, onDeposit, onWithdraw, openOrders, initialPositionFilter, tab, onTabChange, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onClaimResult, onClaimSubmitError, onActivityClick, getActivityHref, onOpenOrderClick, onCancelOrder, cancellingOrderIds, isLoadingPositions, isLoadingActivities, isLoadingOpenOrders, positionsError, activitiesError, openOrdersError, hasMoreActivePositions, isLoadingMoreActivePositions, onLoadMoreActivePositions, hasMoreClosedPositions, isLoadingMoreClosedPositions, onLoadMoreClosedPositions, onPositionFilterChange: onPositionFilterChangeProp, hasMoreActivities, isLoadingMoreActivities, onLoadMoreActivities, hasMoreOpenOrders, isLoadingMoreOpenOrders, onLoadMoreOpenOrders, classNames, onError, }: UserProfilePageProps & {
         onError?: (error: Error) => void;
     }): JSX.Element;
     displayName: string;

package/dist/types/pages/user-profile/index.d.ts

@@ -1,9 +1,9 @@
 import type { UserProfilePageProps } from "./user-profile.types";
-export type { UserProfileActivity, UserProfileBalance, UserProfileConnectedExchange, UserProfileConnectedWallet, UserProfileInfo, UserProfilePageClassNames, UserProfilePageProps, UserProfilePosition, UserProfilePositionFilter, UserProfilePositionVenueShare, UserProfileSocialLink, UserProfileVenueBalance, } from "./user-profile.types";
+export type { UserProfileActivity, UserProfileActivityStatus, UserProfileBalance, UserProfileConnectedExchange, UserProfileConnectedWallet, UserProfileInfo, UserProfilePageClassNames, UserProfilePageProps, UserProfilePosition, UserProfilePositionFilter, UserProfilePositionVenueShare, UserProfileSocialLink, UserProfileTransferStatus, UserProfileVenueBalance, } from "./user-profile.types";
 export { USER_PROFILE_TAB_ACTIVITY, USER_PROFILE_TAB_OPEN_ORDERS, USER_PROFILE_TAB_POSITIONS, } from "./user-profile.constants";
 export type { UserProfileTabValue } from "./user-profile.constants";
 export declare const UserProfilePage: {
-    ({ user, balanceChainsOverride, venueBalances: _venueBalances, balance, activePositions, closedPositions, activities, onEditProfile, onDeposit, onWithdraw, openOrders, initialPositionFilter, tab, onTabChange, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onActivityClick, getActivityHref, onOpenOrderClick, onCancelOrder, cancellingOrderIds, isLoadingPositions, isLoadingActivities, isLoadingOpenOrders, positionsError, activitiesError, openOrdersError, hasMoreActivePositions, isLoadingMoreActivePositions, onLoadMoreActivePositions, hasMoreClosedPositions, isLoadingMoreClosedPositions, onLoadMoreClosedPositions, onPositionFilterChange: onPositionFilterChangeProp, hasMoreActivities, isLoadingMoreActivities, onLoadMoreActivities, hasMoreOpenOrders, isLoadingMoreOpenOrders, onLoadMoreOpenOrders, classNames, onError, }: UserProfilePageProps & {
+    ({ user, balanceChainsOverride, venueBalances: _venueBalances, balance, activePositions, closedPositions, activities, onEditProfile, onDeposit, onWithdraw, openOrders, initialPositionFilter, tab, onTabChange, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onClaimResult, onClaimSubmitError, onActivityClick, getActivityHref, onOpenOrderClick, onCancelOrder, cancellingOrderIds, isLoadingPositions, isLoadingActivities, isLoadingOpenOrders, positionsError, activitiesError, openOrdersError, hasMoreActivePositions, isLoadingMoreActivePositions, onLoadMoreActivePositions, hasMoreClosedPositions, isLoadingMoreClosedPositions, onLoadMoreClosedPositions, onPositionFilterChange: onPositionFilterChangeProp, hasMoreActivities, isLoadingMoreActivities, onLoadMoreActivities, hasMoreOpenOrders, isLoadingMoreOpenOrders, onLoadMoreOpenOrders, classNames, onError, }: UserProfilePageProps & {
         onError?: (error: Error) => void;
     }): JSX.Element;
     displayName: string;

package/dist/types/pages/user-profile/user-profile.types.d.mts

@@ -65,6 +65,8 @@ export interface UserProfilePosition {
     title: string;
     /** Outcome name for the pill only, e.g. "Yes" (no price). */
     outcomeLabel: string;
+    /** Resolved winning outcome name shown in closed position rows, e.g. "No". */
+    resolutionLabel?: string | null;
     /** Per-venue position sizes with logos below the pill. */
     venueShareBreakdown: UserProfilePositionVenueShare[];
     /** Total shares/contracts represented by this row. */
@@ -130,6 +132,10 @@ export interface UserProfileTradeActivity {
     isFailed?: boolean;
     /** Whether the row should use error-colored text because the activity has an error. */
     hasError?: boolean;
+    /** Error message for the activity. */
+    errorMessage?: string;
+    /** Normalized lifecycle status driving row tone. Defaults to "completed". */
+    status?: UserProfileActivityStatus;
     /** Activity type, e.g. "Buy", "Sell" */
     type: string;
     /** Market thumbnail image URL */
@@ -147,6 +153,14 @@ export interface UserProfileTradeActivity {
     /** Time label, e.g. "3d ago" */
     timeLabel: string;
 }
+/**
+ * Normalized UI state for activity rows. Backend statuses collapse into
+ * one of four buckets so row tone, status icons, titles, and amounts stay
+ * aligned. Unknown statuses fall back to "completed" — a stale row at rest
+ * is the safer default than a sticky spinner.
+ */
+export type UserProfileActivityStatus = "completed" | "pending" | "failed" | "canceled";
+export type UserProfileTransferStatus = UserProfileActivityStatus;
 /** Non-trade activity row: withdrawal / deposit / bridge / user_op. */
 export interface UserProfileTransferActivity {
     kind: "withdrawal" | "deposit" | "bridge" | "user_op";
@@ -155,6 +169,10 @@ export interface UserProfileTransferActivity {
     isFailed?: boolean;
     /** Whether the row should use error-colored text because the activity has an error. */
     hasError?: boolean;
+    /** Error message for the activity. */
+    errorMessage?: string;
+    /** Normalized status driving icon, title, and amount rendering. Defaults to "completed". */
+    status?: UserProfileTransferStatus;
     /** Header label, e.g. "Withdraw", "Deposit", "Bridge", "Wallet op". */
     type: string;
     /** Title, e.g. "Withdraw USDC". */
@@ -254,8 +272,43 @@ export interface UserProfilePageProps {
     getPositionHref?: (position: UserProfilePosition) => string | undefined;
     /** Called when the user claims a closed winning position. */
     onClaim?: (position: UserProfilePosition) => Promise<void> | void;
-    /** Map of claim key (marketId or position id) to loading state while claim is in-flight. */
+    /**
+     * Map of claim key (marketId or position id) to loading state while claim is in-flight.
+     *
+     * Passing this prop overrides the internal lifecycle-driven spinner (the page derives
+     * spinner state from the in-flight redeem's WS lifecycle when this prop is omitted).
+     * Partners who own the claim flow via `onClaim` typically pass their own state here;
+     * partners who let the page own the flow should omit this prop.
+     */
     claimingPositionKeys?: Record<string, boolean>;
+    /**
+     * Called once per redeem when its lifecycle reaches terminal (every expected leg
+     * confirmed or failed on chain). Receives the same `claimKey` that
+     * `claimingPositionKeys` uses (i.e. `position.marketId ?? position.id`) plus a
+     * summary of the terminal lifecycle state. Use this to fire one-shot success/failure
+     * toasts.
+     *
+     * NOT fired for synchronous submit failures (network errors, `RedeemRejectedError`)
+     * — those go through `onClaimSubmitError`.
+     *
+     * Only fired when the internal claim path is used (i.e. when the caller does NOT
+     * pass an `onClaim` prop). Callers that own the claim flow via `onClaim` are
+     * responsible for their own toasting.
+     */
+    onClaimResult?: (claimKey: string, lifecycle: {
+        allConfirmed: boolean;
+        anyFailed: boolean;
+        errorMessage: string | null;
+    }) => void;
+    /**
+     * Called when the redeem mutation itself rejects — i.e. transport error, validation
+     * error, or `RedeemRejectedError` (all legs ineligible/rejected at submit time). The
+     * redeem never enters the WS lifecycle in these cases, so `onClaimResult` does NOT
+     * fire.
+     *
+     * Only fired when the internal claim path is used.
+     */
+    onClaimSubmitError?: (claimKey: string, error: Error) => void;
     /** Called when an activity row is clicked */
     onActivityClick?: (activity: UserProfileActivity) => void;
     /** Optional href for an activity row (enables ctrl/cmd/middle-click to open in a new tab). */