@agg-build/ui 2.1.1 → 2.1.3

package/dist/trading.mjs

@@ -5,8 +5,10 @@ import {
   PlaceOrderSuccessView,
   SettlementDetails,
   parseAmount,
-  parseVenue
-} from "./chunk-XHDGSRG7.mjs";
+  parseVenue,
+  useClaimWinnings,
+  useResolvedMarketClaim
+} from "./chunk-BW7S2YR3.mjs";
 import {
   SETTLEMENT_SECTION_ID,
   Settlement,
@@ -21,9 +23,9 @@ import {
   getTradingValueLabel,
   getTradingVenueLabel,
   useEventTradingContext
-} from "./chunk-TERG43WW.mjs";
-import "./chunk-RPXRTXCY.mjs";
-import "./chunk-YJO6LMRT.mjs";
+} from "./chunk-R2YNZJZ3.mjs";
+import "./chunk-T4YZGAYS.mjs";
+import "./chunk-VP76G6PN.mjs";
 export {
   PlaceOrder,
   PlaceOrderFailureView,
@@ -43,5 +45,7 @@ export {
   getTradingVenueLabel,
   parseAmount,
   parseVenue,
-  useEventTradingContext
+  useClaimWinnings,
+  useEventTradingContext,
+  useResolvedMarketClaim
 };

package/dist/types/events/item/event-list-item.utils.d.mts

@@ -1,18 +1,5 @@
 import type { AggUiLabels, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
 import type { EventListItemEvent, EventListItemVenueInfoMap, VenueEventWithMarkets } from "./event-list-item.types";
-/**
- * Filter a list of venue strings against a runtime-derived set of
- * tradeable venues. When `tradableVenues` is null (loading / unknown)
- * the input is returned unchanged so callers can optimistically show
- * all venues until the orderbook signal arrives. When `tradableVenues`
- * is a Set, only venues present in it are kept.
- *
- * The Set is typically produced by `useTradableVenues(venueMarkets)`
- * from `@agg-build/hooks`, which observes per-outcome midpoints from the
- * engine and treats a venue as tradeable iff at least one of its
- * outcomes has a non-null midpoint.
- */
-export declare const filterVenuesByTradable: <T extends string>(venues: readonly T[], tradableVenues: ReadonlySet<string> | null | undefined) => T[];
 export declare const resolveEventListItemEvent: (fetchedEvent: VenueEventWithMarkets | undefined) => EventListItemEvent | undefined;
 export declare const normalizeProbability: (value: number | null | undefined) => number | undefined;
 export declare const isYesLabel: (label: string) => boolean;
@@ -59,18 +46,7 @@ export declare const selectPrimaryVenueMarket: (venueMarkets: VenueMarket[]) =>
 export declare const resolveTileTitle: (event: VenueEventWithMarkets, primaryVenueMarket: VenueMarket | undefined, titleOverride: string | undefined) => string;
 export declare const resolveTileImage: (event: VenueEventWithMarkets, primaryVenueMarket: VenueMarket | undefined, imageOverride: string | null | undefined) => string | undefined;
 export declare const formatCountLabel: (count: number, singular: string, plural: string) => string;
-export declare const getVenueSummary: (venueMarkets: VenueMarket[], options?: {
-    /**
-     * Runtime-derived set of venues that have a live orderbook (typically
-     * sourced from `useTradableVenues`). When provided as a Set, only
-     * venues in the set count toward `venueCount` and `singleVenue`.
-     * When `null` (loading) or `undefined` (caller doesn't have the
-     * signal), no filter is applied and all venues count — callers
-     * showing a "X venues" badge accept that the count may briefly
-     * include non-tradeable venues until midpoints resolve.
-     */
-    tradableVenues?: ReadonlySet<string> | null;
-}) => {
+export declare const getVenueSummary: (venueMarkets: VenueMarket[]) => {
     marketCount: number;
     venueCount: number;
     singleVenue: import("@agg-build/hooks").Venue | undefined;

package/dist/types/events/item/event-list-item.utils.d.ts

@@ -1,18 +1,5 @@
 import type { AggUiLabels, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
 import type { EventListItemEvent, EventListItemVenueInfoMap, VenueEventWithMarkets } from "./event-list-item.types";
-/**
- * Filter a list of venue strings against a runtime-derived set of
- * tradeable venues. When `tradableVenues` is null (loading / unknown)
- * the input is returned unchanged so callers can optimistically show
- * all venues until the orderbook signal arrives. When `tradableVenues`
- * is a Set, only venues present in it are kept.
- *
- * The Set is typically produced by `useTradableVenues(venueMarkets)`
- * from `@agg-build/hooks`, which observes per-outcome midpoints from the
- * engine and treats a venue as tradeable iff at least one of its
- * outcomes has a non-null midpoint.
- */
-export declare const filterVenuesByTradable: <T extends string>(venues: readonly T[], tradableVenues: ReadonlySet<string> | null | undefined) => T[];
 export declare const resolveEventListItemEvent: (fetchedEvent: VenueEventWithMarkets | undefined) => EventListItemEvent | undefined;
 export declare const normalizeProbability: (value: number | null | undefined) => number | undefined;
 export declare const isYesLabel: (label: string) => boolean;
@@ -59,18 +46,7 @@ export declare const selectPrimaryVenueMarket: (venueMarkets: VenueMarket[]) =>
 export declare const resolveTileTitle: (event: VenueEventWithMarkets, primaryVenueMarket: VenueMarket | undefined, titleOverride: string | undefined) => string;
 export declare const resolveTileImage: (event: VenueEventWithMarkets, primaryVenueMarket: VenueMarket | undefined, imageOverride: string | null | undefined) => string | undefined;
 export declare const formatCountLabel: (count: number, singular: string, plural: string) => string;
-export declare const getVenueSummary: (venueMarkets: VenueMarket[], options?: {
-    /**
-     * Runtime-derived set of venues that have a live orderbook (typically
-     * sourced from `useTradableVenues`). When provided as a Set, only
-     * venues in the set count toward `venueCount` and `singleVenue`.
-     * When `null` (loading) or `undefined` (caller doesn't have the
-     * signal), no filter is applied and all venues count — callers
-     * showing a "X venues" badge accept that the count may briefly
-     * include non-tradeable venues until midpoints resolve.
-     */
-    tradableVenues?: ReadonlySet<string> | null;
-}) => {
+export declare const getVenueSummary: (venueMarkets: VenueMarket[]) => {
     marketCount: number;
     venueCount: number;
     singleVenue: import("@agg-build/hooks").Venue | undefined;

package/dist/types/events/item-details/index.d.mts

@@ -1,7 +1,8 @@
-import type { EventListItemDetailsProps } from "./event-list-item-details.types";
+import type { EventListItemDetailsContentProps, EventListItemDetailsProps } from "./event-list-item-details.types";
 export type { EventListItemDetailsClassNames, EventListItemDetailsEvent, EventListItemDetailsProps, EventListItemDetailsStat, EventListItemDetailsTimeRange, EventListItemDetailsWithEventIdProps, } from "./event-list-item-details.types";
 export { SettlementSummary } from "./settlement-summary";
 export type { SettlementSummaryProps } from "./settlement-summary";
+export declare const resolveEventDetailsSyncKey: (event: EventListItemDetailsContentProps["event"]) => string;
 export declare const EventListItemDetails: {
     (props: EventListItemDetailsProps): JSX.Element;
     displayName: string;

package/dist/types/events/item-details/index.d.ts

@@ -1,7 +1,8 @@
-import type { EventListItemDetailsProps } from "./event-list-item-details.types";
+import type { EventListItemDetailsContentProps, EventListItemDetailsProps } from "./event-list-item-details.types";
 export type { EventListItemDetailsClassNames, EventListItemDetailsEvent, EventListItemDetailsProps, EventListItemDetailsStat, EventListItemDetailsTimeRange, EventListItemDetailsWithEventIdProps, } from "./event-list-item-details.types";
 export { SettlementSummary } from "./settlement-summary";
 export type { SettlementSummaryProps } from "./settlement-summary";
+export declare const resolveEventDetailsSyncKey: (event: EventListItemDetailsContentProps["event"]) => string;
 export declare const EventListItemDetails: {
     (props: EventListItemDetailsProps): JSX.Element;
     displayName: string;

package/dist/types/events/market-details/market-details-graph-panel.d.mts

@@ -0,0 +1,39 @@
+import type { VenueMarket } from "@agg-build/hooks";
+import type { MarketDetailsHeaderOutcomeItem } from "./market-details.types";
+export interface MarketDetailsGraphPanelProps {
+    /**
+     * The card's own cross-venue cluster (`model.market.venueMarkets`), NOT the
+     * full event market set. Scoping here keeps the chart's outcome resolution +
+     * WS subscription limited to this market.
+     */
+    venueMarkets: VenueMarket[];
+    selectedOutcomeLabel: string | null;
+    selectedOutcomeId: string | null;
+    /** Merged REST+WS live prices, used to rank/scope chart venue outcomes. */
+    livePrices: Map<string, number>;
+    /** WS-only per-outcome midpoints, used for the per-venue chart badges. */
+    wsLivePrices: Map<string, number>;
+    headerOutcomeItems: MarketDetailsHeaderOutcomeItem[];
+    isResolvedMarket: boolean;
+    isOutcomeSelectionLocked: boolean;
+    volume: number | null | undefined;
+    live?: boolean;
+    classNames?: {
+        graph?: string;
+        footer?: string;
+    };
+}
+/**
+ * Self-contained chart panel for an expanded market card.
+ *
+ * IMPORTANT: every chart data hook (`useMarketChart`, `useRollingChartWindow`)
+ * and all chart-local state live HERE, not in the parent `MarketDetails`. The
+ * parent renders this component only while the card is open AND the Graph tab
+ * is active, so inactive/closed cards never mount these hooks — no `/charts/bars`
+ * request, no chart query-cache entries, and no 1s rolling-window timer are
+ * created for markets the user isn't actively charting.
+ */
+export declare const MarketDetailsGraphPanel: {
+    ({ venueMarkets, selectedOutcomeLabel, selectedOutcomeId, livePrices, wsLivePrices, headerOutcomeItems, isResolvedMarket, isOutcomeSelectionLocked, volume, live, classNames, }: MarketDetailsGraphPanelProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/events/market-details/market-details-graph-panel.d.ts

@@ -0,0 +1,39 @@
+import type { VenueMarket } from "@agg-build/hooks";
+import type { MarketDetailsHeaderOutcomeItem } from "./market-details.types";
+export interface MarketDetailsGraphPanelProps {
+    /**
+     * The card's own cross-venue cluster (`model.market.venueMarkets`), NOT the
+     * full event market set. Scoping here keeps the chart's outcome resolution +
+     * WS subscription limited to this market.
+     */
+    venueMarkets: VenueMarket[];
+    selectedOutcomeLabel: string | null;
+    selectedOutcomeId: string | null;
+    /** Merged REST+WS live prices, used to rank/scope chart venue outcomes. */
+    livePrices: Map<string, number>;
+    /** WS-only per-outcome midpoints, used for the per-venue chart badges. */
+    wsLivePrices: Map<string, number>;
+    headerOutcomeItems: MarketDetailsHeaderOutcomeItem[];
+    isResolvedMarket: boolean;
+    isOutcomeSelectionLocked: boolean;
+    volume: number | null | undefined;
+    live?: boolean;
+    classNames?: {
+        graph?: string;
+        footer?: string;
+    };
+}
+/**
+ * Self-contained chart panel for an expanded market card.
+ *
+ * IMPORTANT: every chart data hook (`useMarketChart`, `useRollingChartWindow`)
+ * and all chart-local state live HERE, not in the parent `MarketDetails`. The
+ * parent renders this component only while the card is open AND the Graph tab
+ * is active, so inactive/closed cards never mount these hooks — no `/charts/bars`
+ * request, no chart query-cache entries, and no 1s rolling-window timer are
+ * created for markets the user isn't actively charting.
+ */
+export declare const MarketDetailsGraphPanel: {
+    ({ venueMarkets, selectedOutcomeLabel, selectedOutcomeId, livePrices, wsLivePrices, headerOutcomeItems, isResolvedMarket, isOutcomeSelectionLocked, volume, live, classNames, }: MarketDetailsGraphPanelProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/events/market-details/market-details-outcome-button.d.mts

@@ -2,12 +2,13 @@ import type { MarketDetailsHeaderOutcomeItem } from "./market-details.types";
 type MarketDetailsOutcomeButtonProps = {
     ariaControls?: string;
     enableAnimations: boolean;
+    enforceFixedWidth?: boolean;
     isSelected: boolean;
     item: MarketDetailsHeaderOutcomeItem;
     onSelect: (label: string) => void;
 };
 export declare const MarketDetailsOutcomeButton: {
-    ({ ariaControls, enableAnimations, isSelected, item, onSelect, }: MarketDetailsOutcomeButtonProps): JSX.Element;
+    ({ ariaControls, enableAnimations, enforceFixedWidth, isSelected, item, onSelect, }: MarketDetailsOutcomeButtonProps): JSX.Element;
     displayName: string;
 };
 export {};

package/dist/types/events/market-details/market-details-outcome-button.d.ts

@@ -2,12 +2,13 @@ import type { MarketDetailsHeaderOutcomeItem } from "./market-details.types";
 type MarketDetailsOutcomeButtonProps = {
     ariaControls?: string;
     enableAnimations: boolean;
+    enforceFixedWidth?: boolean;
     isSelected: boolean;
     item: MarketDetailsHeaderOutcomeItem;
     onSelect: (label: string) => void;
 };
 export declare const MarketDetailsOutcomeButton: {
-    ({ ariaControls, enableAnimations, isSelected, item, onSelect, }: MarketDetailsOutcomeButtonProps): JSX.Element;
+    ({ ariaControls, enableAnimations, enforceFixedWidth, isSelected, item, onSelect, }: MarketDetailsOutcomeButtonProps): JSX.Element;
     displayName: string;
 };
 export {};

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

@@ -43,6 +43,35 @@ export type MarketDetailsBaseProps = {
     classNames?: MarketDetailsClassNames;
     /** Custom content rendered in the "other" tab. */
     otherContent?: React.ReactNode;
+    /**
+     * Optional content rendered between the card header (title + outcome pills)
+     * and the collapsible details body — visible whether or not the card is
+     * expanded. Used by the sports view to mount a spread/total line-selector
+     * rail on the same card that drives the order book / graph. Regular event
+     * markets omit it, so their layout is unchanged.
+     */
+    headerAccessory?: React.ReactNode;
+    /**
+     * Compact header treatment used by the sports view: hides the leading market
+     * thumbnail and the headline probability so the card reads as
+     * "{title} · {meta}" + outcome pills (matching the sports design). Defaults
+     * to `false`, so regular event markets keep the image + headline.
+     */
+    compactHeader?: boolean;
+    /**
+     * Optional subtitle override for custom surfaces (for example the sports
+     * compact header, which needs selected-option venue / volume metadata).
+     */
+    subtitleOverride?: string;
+    /**
+     * Optional header pill layout override. Sports cards use this to keep the
+     * market-specific sizing and line-label treatment isolated from the default
+     * market details header.
+     */
+    headerOutcomeVariant?: "outcome" | "line" | "yes_no";
+    /** Optional prebuilt header pills used when the card should render a custom
+     * market selection surface while keeping the regular details body. */
+    headerOutcomeItemsOverride?: MarketDetailsHeaderOutcomeItem[];
     /** Whether the market details should render a loading state. */
     isLoading?: boolean;
     /**
@@ -154,6 +183,8 @@ export type MarketDetailsHeaderOutcomeItem = {
     probability: number | undefined;
     tone: MarketDetailsOutcomeTone;
     venue: VenueLogoName;
+    variant?: "outcome" | "line" | "yes_no";
+    lineLabel?: string | null;
 };
 export type MarketDetailsOrderBookRow = {
     id: string;

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

@@ -43,6 +43,35 @@ export type MarketDetailsBaseProps = {
     classNames?: MarketDetailsClassNames;
     /** Custom content rendered in the "other" tab. */
     otherContent?: React.ReactNode;
+    /**
+     * Optional content rendered between the card header (title + outcome pills)
+     * and the collapsible details body — visible whether or not the card is
+     * expanded. Used by the sports view to mount a spread/total line-selector
+     * rail on the same card that drives the order book / graph. Regular event
+     * markets omit it, so their layout is unchanged.
+     */
+    headerAccessory?: React.ReactNode;
+    /**
+     * Compact header treatment used by the sports view: hides the leading market
+     * thumbnail and the headline probability so the card reads as
+     * "{title} · {meta}" + outcome pills (matching the sports design). Defaults
+     * to `false`, so regular event markets keep the image + headline.
+     */
+    compactHeader?: boolean;
+    /**
+     * Optional subtitle override for custom surfaces (for example the sports
+     * compact header, which needs selected-option venue / volume metadata).
+     */
+    subtitleOverride?: string;
+    /**
+     * Optional header pill layout override. Sports cards use this to keep the
+     * market-specific sizing and line-label treatment isolated from the default
+     * market details header.
+     */
+    headerOutcomeVariant?: "outcome" | "line" | "yes_no";
+    /** Optional prebuilt header pills used when the card should render a custom
+     * market selection surface while keeping the regular details body. */
+    headerOutcomeItemsOverride?: MarketDetailsHeaderOutcomeItem[];
     /** Whether the market details should render a loading state. */
     isLoading?: boolean;
     /**
@@ -154,6 +183,8 @@ export type MarketDetailsHeaderOutcomeItem = {
     probability: number | undefined;
     tone: MarketDetailsOutcomeTone;
     venue: VenueLogoName;
+    variant?: "outcome" | "line" | "yes_no";
+    lineLabel?: string | null;
 };
 export type MarketDetailsOrderBookRow = {
     id: string;

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

@@ -46,34 +46,21 @@ 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[], scopedMarket?: VenueMarket | null) => MarketDetailsHeaderOutcomeItem[];
-export declare const resolveSubtitle: ({ venueMarkets, volume, formatCompactCurrency, labels, tradableVenues, }: {
+export declare const resolveHeaderOutcomeItems: (venueMarkets: VenueMarket[], scopedMarket?: VenueMarket | null, variant?: MarketDetailsHeaderOutcomeItem["variant"]) => MarketDetailsHeaderOutcomeItem[];
+export declare const resolveSubtitle: ({ venueMarkets, volume, formatCompactCurrency, labels, }: {
     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, tradableVenues, }: {
+export declare const buildMarketDetailsModel: ({ venueMarkets, marketId, title, image, formatCompactCurrency, labels, }: {
     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

@@ -46,34 +46,21 @@ 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[], scopedMarket?: VenueMarket | null) => MarketDetailsHeaderOutcomeItem[];
-export declare const resolveSubtitle: ({ venueMarkets, volume, formatCompactCurrency, labels, tradableVenues, }: {
+export declare const resolveHeaderOutcomeItems: (venueMarkets: VenueMarket[], scopedMarket?: VenueMarket | null, variant?: MarketDetailsHeaderOutcomeItem["variant"]) => MarketDetailsHeaderOutcomeItem[];
+export declare const resolveSubtitle: ({ venueMarkets, volume, formatCompactCurrency, labels, }: {
     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, tradableVenues, }: {
+export declare const buildMarketDetailsModel: ({ venueMarkets, marketId, title, image, formatCompactCurrency, labels, }: {
     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/shared/format-event-title.d.mts

@@ -0,0 +1,24 @@
+type EventCategoryLike = {
+    id?: string | null;
+    category?: {
+        id?: string | null;
+        name?: string | null;
+        displayName?: string | null;
+        parentId?: string | null;
+    } | null;
+};
+type FormatEventTitleWithDateSuffixParams = {
+    title: string;
+    categories?: readonly EventCategoryLike[] | null;
+    structureType?: string | null;
+    /**
+     * Scheduled kickoff of the underlying game. Preferred over `endDate` for
+     * the date suffix because `endDate` is the market close/expiration, which
+     * can sit well after the game (e.g. Kalshi World Cup markets expire weeks
+     * later — a June 22 game would otherwise read "- July 6").
+     */
+    gameStartTime?: string | null;
+    endDate?: string | null;
+};
+export declare const formatEventTitleWithDateSuffix: ({ title, categories, structureType, gameStartTime, endDate, }: FormatEventTitleWithDateSuffixParams) => string;
+export {};

package/dist/types/events/shared/format-event-title.d.ts

@@ -0,0 +1,24 @@
+type EventCategoryLike = {
+    id?: string | null;
+    category?: {
+        id?: string | null;
+        name?: string | null;
+        displayName?: string | null;
+        parentId?: string | null;
+    } | null;
+};
+type FormatEventTitleWithDateSuffixParams = {
+    title: string;
+    categories?: readonly EventCategoryLike[] | null;
+    structureType?: string | null;
+    /**
+     * Scheduled kickoff of the underlying game. Preferred over `endDate` for
+     * the date suffix because `endDate` is the market close/expiration, which
+     * can sit well after the game (e.g. Kalshi World Cup markets expire weeks
+     * later — a June 22 game would otherwise read "- July 6").
+     */
+    gameStartTime?: string | null;
+    endDate?: string | null;
+};
+export declare const formatEventTitleWithDateSuffix: ({ title, categories, structureType, gameStartTime, endDate, }: FormatEventTitleWithDateSuffixParams) => string;
+export {};

package/dist/types/events/shared/format-sports-event-time.d.mts

@@ -0,0 +1,2 @@
+export declare const SPORTS_EVENT_TIMEZONE = "America/New_York";
+export declare const formatSportsEventTimeEt: (value: string) => string | null;

package/dist/types/events/shared/format-sports-event-time.d.ts

@@ -0,0 +1,2 @@
+export declare const SPORTS_EVENT_TIMEZONE = "America/New_York";
+export declare const formatSportsEventTimeEt: (value: string) => string | null;

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

@@ -0,0 +1,88 @@
+import type { LiveBestPriceCandidate } from "@agg-build/hooks";
+/** Which data tier produced the winning price + venue. */
+export type BestOutcomeSource = "ws" | "rest-best" | "rest-midpoint" | "static";
+/**
+ * The single, unified result for an outcome pill: price and venue resolved
+ * together from the *same* tier, so the displayed price and the venue logo can
+ * never disagree. `venueMarketId`, `source` and `updatedAt` are carried for
+ * telemetry/debugging and to let callers reason about freshness.
+ */
+export interface BestOutcomeCandidate {
+    price: number;
+    venue: string | undefined;
+    venueMarketId: string | undefined;
+    outcomeId: string;
+    source: BestOutcomeSource;
+    updatedAt: number | undefined;
+}
+export interface SelectBestOutcomeArgs {
+    outcomeId: string | null | undefined;
+    outcomeLabel?: string | null | undefined;
+    /** Active trade side. When set, the best ask (buy) / best bid (sell) wins. */
+    selection?: "buy" | "sell" | undefined;
+    /**
+     * Live WS candidate for this outcome — already folded across all venues for
+     * the outcome's MVMO group (see `buildLiveBestPriceCandidates`). Carries the
+     * venue that owns each side, so when a different venue takes the best live
+     * price the logo follows the price.
+     */
+    live?: LiveBestPriceCandidate | null | undefined;
+    /** REST cross-venue best bid/ask (fallback when WS hasn't landed). */
+    restBest?: {
+        bestBid?: number;
+        bestAsk?: number;
+    } | null | undefined;
+    /** REST venue that produced each side of `restBest`. */
+    restBestVenues?: {
+        bestBidVenue?: string;
+        bestAskVenue?: string;
+    } | null | undefined;
+    /** REST per-outcome midpoint (display-path fallback). */
+    restMidpoint?: number | null | undefined;
+    /** Venue that produced `restMidpoint`. */
+    restMidpointVenue?: string | null | undefined;
+    /** Cluster-wide "Yes" reference midpoint (display path, "yes" labels only). */
+    bestMidpoint?: number | null | undefined;
+    /** Venue that produced `bestMidpoint`. */
+    bestMidpointVenue?: string | null | undefined;
+    /** Final static fallback — the outcome's payload price. */
+    staticPrice?: number | null | undefined;
+    /** Venue for the static fallback (typically the local market's own venue). */
+    staticVenue?: string | null | undefined;
+    /** Resolves a venue name → its venueMarketId within the cluster (best effort). */
+    venueMarketIdByVenue?: ReadonlyMap<string, string> | null | undefined;
+}
+/**
+ * Resolve the single best price + venue for an outcome across all venues.
+ *
+ * Candidate priority (price and venue are always taken from the SAME tier):
+ *   With a trade selection (buy/sell):
+ *     1. fresh WS best ask/bid for that side  → source "ws"
+ *     2. REST best ask/bid for that side       → source "rest-best"
+ *     3. fresh WS midpoint                      → source "ws"
+ *     4. REST per-outcome midpoint              → source "rest-midpoint"
+ *     5. static outcome price                   → source "static"
+ *   Display path (no selection):
+ *     1. fresh WS midpoint                      → source "ws"
+ *     2. cluster "Yes" reference (yes labels)   → source "rest-midpoint"
+ *     3. REST per-outcome midpoint              → source "rest-midpoint"
+ *     4. static outcome price                   → source "static"
+ *
+ * Because WS is preferred per side over REST, a stale REST snapshot can never
+ * override newer live data — and because the venue is read from whichever tier
+ * supplied the price, the logo and the price switch together.
+ */
+export declare const selectBestOutcomeCandidate: (args: SelectBestOutcomeArgs) => BestOutcomeCandidate | undefined;
+/**
+ * Build a venue-name → venueMarketId lookup across a cluster (including matched
+ * siblings). First occurrence wins. Used to resolve the winning venue's market
+ * id for {@link selectBestOutcomeCandidate}.
+ */
+export declare const buildVenueMarketIdByVenue: (venueMarkets: ReadonlyArray<{
+    id?: string;
+    venue?: string | null;
+    matchedVenueMarkets?: ReadonlyArray<{
+        id?: string;
+        venue?: string | null;
+    }> | null;
+}> | null | undefined) => Map<string, string>;

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

@@ -0,0 +1,88 @@
+import type { LiveBestPriceCandidate } from "@agg-build/hooks";
+/** Which data tier produced the winning price + venue. */
+export type BestOutcomeSource = "ws" | "rest-best" | "rest-midpoint" | "static";
+/**
+ * The single, unified result for an outcome pill: price and venue resolved
+ * together from the *same* tier, so the displayed price and the venue logo can
+ * never disagree. `venueMarketId`, `source` and `updatedAt` are carried for
+ * telemetry/debugging and to let callers reason about freshness.
+ */
+export interface BestOutcomeCandidate {
+    price: number;
+    venue: string | undefined;
+    venueMarketId: string | undefined;
+    outcomeId: string;
+    source: BestOutcomeSource;
+    updatedAt: number | undefined;
+}
+export interface SelectBestOutcomeArgs {
+    outcomeId: string | null | undefined;
+    outcomeLabel?: string | null | undefined;
+    /** Active trade side. When set, the best ask (buy) / best bid (sell) wins. */
+    selection?: "buy" | "sell" | undefined;
+    /**
+     * Live WS candidate for this outcome — already folded across all venues for
+     * the outcome's MVMO group (see `buildLiveBestPriceCandidates`). Carries the
+     * venue that owns each side, so when a different venue takes the best live
+     * price the logo follows the price.
+     */
+    live?: LiveBestPriceCandidate | null | undefined;
+    /** REST cross-venue best bid/ask (fallback when WS hasn't landed). */
+    restBest?: {
+        bestBid?: number;
+        bestAsk?: number;
+    } | null | undefined;
+    /** REST venue that produced each side of `restBest`. */
+    restBestVenues?: {
+        bestBidVenue?: string;
+        bestAskVenue?: string;
+    } | null | undefined;
+    /** REST per-outcome midpoint (display-path fallback). */
+    restMidpoint?: number | null | undefined;
+    /** Venue that produced `restMidpoint`. */
+    restMidpointVenue?: string | null | undefined;
+    /** Cluster-wide "Yes" reference midpoint (display path, "yes" labels only). */
+    bestMidpoint?: number | null | undefined;
+    /** Venue that produced `bestMidpoint`. */
+    bestMidpointVenue?: string | null | undefined;
+    /** Final static fallback — the outcome's payload price. */
+    staticPrice?: number | null | undefined;
+    /** Venue for the static fallback (typically the local market's own venue). */
+    staticVenue?: string | null | undefined;
+    /** Resolves a venue name → its venueMarketId within the cluster (best effort). */
+    venueMarketIdByVenue?: ReadonlyMap<string, string> | null | undefined;
+}
+/**
+ * Resolve the single best price + venue for an outcome across all venues.
+ *
+ * Candidate priority (price and venue are always taken from the SAME tier):
+ *   With a trade selection (buy/sell):
+ *     1. fresh WS best ask/bid for that side  → source "ws"
+ *     2. REST best ask/bid for that side       → source "rest-best"
+ *     3. fresh WS midpoint                      → source "ws"
+ *     4. REST per-outcome midpoint              → source "rest-midpoint"
+ *     5. static outcome price                   → source "static"
+ *   Display path (no selection):
+ *     1. fresh WS midpoint                      → source "ws"
+ *     2. cluster "Yes" reference (yes labels)   → source "rest-midpoint"
+ *     3. REST per-outcome midpoint              → source "rest-midpoint"
+ *     4. static outcome price                   → source "static"
+ *
+ * Because WS is preferred per side over REST, a stale REST snapshot can never
+ * override newer live data — and because the venue is read from whichever tier
+ * supplied the price, the logo and the price switch together.
+ */
+export declare const selectBestOutcomeCandidate: (args: SelectBestOutcomeArgs) => BestOutcomeCandidate | undefined;
+/**
+ * Build a venue-name → venueMarketId lookup across a cluster (including matched
+ * siblings). First occurrence wins. Used to resolve the winning venue's market
+ * id for {@link selectBestOutcomeCandidate}.
+ */
+export declare const buildVenueMarketIdByVenue: (venueMarkets: ReadonlyArray<{
+    id?: string;
+    venue?: string | null;
+    matchedVenueMarkets?: ReadonlyArray<{
+        id?: string;
+        venue?: string | null;
+    }> | null;
+}> | null | undefined) => Map<string, string>;