@agg-build/ui 1.2.10 → 1.2.12

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

@@ -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/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

@@ -20,25 +20,45 @@ export type AggregatedOrderbookRows = {
  * Pick the eligible outcome on each venue-market that corresponds to the
  * user's selected side.
  *
- * MVMO-first: when one of the input markets is the "parent" (the queried
- * market whose selected outcome carries `matchedVenueMarketOutcomes`
- * refs), we walk those refs to align sibling outcomes by id — robust to
- * inversely-framed binaries (e.g. UFC: Polymarket-No (Chimaev) maps via
- * MVMO to Kalshi-Chimaev-Yes, NOT to Kalshi-Chimaev-No despite the
- * matching label) and to multi-outcome markets that don't carry
- * Yes/No labels at all.
+ * 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 so we don't regress on the historically-correct cases.
+ * label matching with anchor-set guard so we don't regress on the
+ * historically-correct cases.
  */
-export declare const collectEligibleVenueOutcomes: ({ venueMarkets, selectedOutcomeLabel, }: {
+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

@@ -20,25 +20,45 @@ export type AggregatedOrderbookRows = {
  * Pick the eligible outcome on each venue-market that corresponds to the
  * user's selected side.
  *
- * MVMO-first: when one of the input markets is the "parent" (the queried
- * market whose selected outcome carries `matchedVenueMarketOutcomes`
- * refs), we walk those refs to align sibling outcomes by id — robust to
- * inversely-framed binaries (e.g. UFC: Polymarket-No (Chimaev) maps via
- * MVMO to Kalshi-Chimaev-Yes, NOT to Kalshi-Chimaev-No despite the
- * matching label) and to multi-outcome markets that don't carry
- * Yes/No labels at all.
+ * 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 so we don't regress on the historically-correct cases.
+ * label matching with anchor-set guard so we don't regress on the
+ * historically-correct cases.
  */
-export declare const collectEligibleVenueOutcomes: ({ venueMarkets, selectedOutcomeLabel, }: {
+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/index.d.mts

@@ -1,4 +1,6 @@
 export * from "./primitives";
+export * from "./notifications";
+export { AggProvider, type AggProviderProps } from "./agg-provider";
 export * from "./auth/connect-button-view";
 export * from "./events";
 export * from "./pages";

package/dist/types/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./primitives";
+export * from "./notifications";
+export { AggProvider, type AggProviderProps } from "./agg-provider";
 export * from "./auth/connect-button-view";
 export * from "./events";
 export * from "./pages";

package/dist/types/notifications/agg-notification-events-provider.d.mts

@@ -0,0 +1,35 @@
+import { type ReactNode } from "react";
+import { type ToastContextValue } from "../primitives/toast";
+interface AggNotificationEventsProviderProps {
+    children?: ReactNode;
+    /**
+     * Toggle off without unmounting (e.g. partner is rendering a marketing page
+     * where toasts would be noise). Defaults to `true`. The
+     * `features.enableNotifications` flag on `<AggProvider config>` also gates
+     * the bridge — if either is `false`, no toasts fire.
+     */
+    enabled?: boolean;
+    /**
+     * How many recent deposit rows the bridge keeps in its observation window.
+     * The bridge mounts its own lightweight `useUserActivity({ type: "deposit" })`
+     * query so it can catch lifecycle transitions even when no other page is
+     * rendering the activity feed. Defaults to 25.
+     */
+    depositActivityLimit?: number;
+}
+/**
+ * Global notification bridge. Subscribes to order WS events, withdrawal
+ * lifecycle WS events, and the deposit activity feed; turns terminal
+ * transitions into toasts via the existing `ToastProvider`. Auto-mounted by
+ * `<ToastProvider>` — partners don't need to wire it manually.
+ *
+ * Bails to a transparent passthrough when no `<AggProvider>` is above it, so
+ * a partner using `<ToastProvider>` standalone (e.g. a marketing page) keeps
+ * working without hooking into the SDK.
+ *
+ * Toasts dedupe per `${kind}:${id}:${status}` so reconnect storms and polling
+ * overlap don't double-fire, and the dedupe table is cleared on user-id change
+ * so signing out / in cannot leak toasts from a prior session.
+ */
+export declare function AggNotificationEventsProvider({ children, enabled, depositActivityLimit, }: AggNotificationEventsProviderProps): JSX.Element;
+export type { ToastContextValue };

package/dist/types/notifications/agg-notification-events-provider.d.ts

@@ -0,0 +1,35 @@
+import { type ReactNode } from "react";
+import { type ToastContextValue } from "../primitives/toast";
+interface AggNotificationEventsProviderProps {
+    children?: ReactNode;
+    /**
+     * Toggle off without unmounting (e.g. partner is rendering a marketing page
+     * where toasts would be noise). Defaults to `true`. The
+     * `features.enableNotifications` flag on `<AggProvider config>` also gates
+     * the bridge — if either is `false`, no toasts fire.
+     */
+    enabled?: boolean;
+    /**
+     * How many recent deposit rows the bridge keeps in its observation window.
+     * The bridge mounts its own lightweight `useUserActivity({ type: "deposit" })`
+     * query so it can catch lifecycle transitions even when no other page is
+     * rendering the activity feed. Defaults to 25.
+     */
+    depositActivityLimit?: number;
+}
+/**
+ * Global notification bridge. Subscribes to order WS events, withdrawal
+ * lifecycle WS events, and the deposit activity feed; turns terminal
+ * transitions into toasts via the existing `ToastProvider`. Auto-mounted by
+ * `<ToastProvider>` — partners don't need to wire it manually.
+ *
+ * Bails to a transparent passthrough when no `<AggProvider>` is above it, so
+ * a partner using `<ToastProvider>` standalone (e.g. a marketing page) keeps
+ * working without hooking into the SDK.
+ *
+ * Toasts dedupe per `${kind}:${id}:${status}` so reconnect storms and polling
+ * overlap don't double-fire, and the dedupe table is cleared on user-id change
+ * so signing out / in cannot leak toasts from a prior session.
+ */
+export declare function AggNotificationEventsProvider({ children, enabled, depositActivityLimit, }: AggNotificationEventsProviderProps): JSX.Element;
+export type { ToastContextValue };

package/dist/types/notifications/agg-toast-provider.d.mts

@@ -0,0 +1,27 @@
+import type { ReactNode } from "react";
+import { type ToastProviderProps } from "../primitives/toast";
+export interface AggToastProviderProps extends Omit<ToastProviderProps, "children"> {
+    children?: ReactNode;
+    /**
+     * Disable the global notification bridge mounted under the toast viewport.
+     * When `true`, `AggToastProvider` behaves like the bare `ToastProvider` —
+     * no order/deposit/withdrawal toasts are emitted automatically. Defaults
+     * to `false`.
+     */
+    disableAggNotifications?: boolean;
+    /**
+     * Forwarded to `AggNotificationEventsProvider`. See its prop docs.
+     * Defaults to 25.
+     */
+    notificationDepositActivityLimit?: number;
+}
+/**
+ * Drop-in replacement for `ToastProvider` that also mounts the global Agg
+ * notification bridge. Partners using `@agg-build/ui` should prefer this
+ * over the raw `ToastProvider` so order/deposit/withdrawal lifecycle events
+ * become toasts automatically with no extra wiring.
+ *
+ * The bridge gracefully no-ops when no `<AggProvider>` is mounted above it,
+ * so this provider remains safe to use even on routes that don't run the SDK.
+ */
+export declare function AggToastProvider({ children, disableAggNotifications, notificationDepositActivityLimit, ...toastProps }: AggToastProviderProps): JSX.Element;

package/dist/types/notifications/agg-toast-provider.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from "react";
+import { type ToastProviderProps } from "../primitives/toast";
+export interface AggToastProviderProps extends Omit<ToastProviderProps, "children"> {
+    children?: ReactNode;
+    /**
+     * Disable the global notification bridge mounted under the toast viewport.
+     * When `true`, `AggToastProvider` behaves like the bare `ToastProvider` —
+     * no order/deposit/withdrawal toasts are emitted automatically. Defaults
+     * to `false`.
+     */
+    disableAggNotifications?: boolean;
+    /**
+     * Forwarded to `AggNotificationEventsProvider`. See its prop docs.
+     * Defaults to 25.
+     */
+    notificationDepositActivityLimit?: number;
+}
+/**
+ * Drop-in replacement for `ToastProvider` that also mounts the global Agg
+ * notification bridge. Partners using `@agg-build/ui` should prefer this
+ * over the raw `ToastProvider` so order/deposit/withdrawal lifecycle events
+ * become toasts automatically with no extra wiring.
+ *
+ * The bridge gracefully no-ops when no `<AggProvider>` is mounted above it,
+ * so this provider remains safe to use even on routes that don't run the SDK.
+ */
+export declare function AggToastProvider({ children, disableAggNotifications, notificationDepositActivityLimit, ...toastProps }: AggToastProviderProps): JSX.Element;

package/dist/types/notifications/deposit-notification-events.d.mts

@@ -0,0 +1,10 @@
+export type AggDepositNotificationStatus = "completed" | "failed";
+export interface AggDepositNotificationDetail {
+    id?: string;
+    status: AggDepositNotificationStatus;
+    amount?: string;
+    tokenSymbol?: string;
+    errorMessage?: string;
+}
+export declare const dispatchAggDepositNotification: (detail: AggDepositNotificationDetail) => void;
+export declare const subscribeAggDepositNotification: (handler: (detail: AggDepositNotificationDetail) => void) => (() => void);

package/dist/types/notifications/deposit-notification-events.d.ts

@@ -0,0 +1,10 @@
+export type AggDepositNotificationStatus = "completed" | "failed";
+export interface AggDepositNotificationDetail {
+    id?: string;
+    status: AggDepositNotificationStatus;
+    amount?: string;
+    tokenSymbol?: string;
+    errorMessage?: string;
+}
+export declare const dispatchAggDepositNotification: (detail: AggDepositNotificationDetail) => void;
+export declare const subscribeAggDepositNotification: (handler: (detail: AggDepositNotificationDetail) => void) => (() => void);

package/dist/types/notifications/index.d.mts

@@ -0,0 +1,2 @@
+export { AggNotificationEventsProvider } from "./agg-notification-events-provider";
+export { AggToastProvider, type AggToastProviderProps } from "./agg-toast-provider";

package/dist/types/notifications/index.d.ts

@@ -0,0 +1,2 @@
+export { AggNotificationEventsProvider } from "./agg-notification-events-provider";
+export { AggToastProvider, type AggToastProviderProps } from "./agg-toast-provider";