@agg-build/ui 1.2.9 → 1.2.11

package/dist/trading.mjs

@@ -6,7 +6,7 @@ import {
   SettlementDetails,
   parseAmount,
   parseVenue
-} from "./chunk-K23CJ5UP.mjs";
+} from "./chunk-J7K2U44E.mjs";
 import {
   SETTLEMENT_SECTION_ID,
   Settlement,
@@ -21,9 +21,9 @@ import {
   getTradingValueLabel,
   getTradingVenueLabel,
   useEventTradingContext
-} from "./chunk-5PSAIGOT.mjs";
-import "./chunk-5MDFM2MX.mjs";
-import "./chunk-QFW5NDJ6.mjs";
+} from "./chunk-54PCEK6G.mjs";
+import "./chunk-NWJHFGBZ.mjs";
+import "./chunk-SJLHOAKK.mjs";
 export {
   PlaceOrder,
   PlaceOrderFailureView,

package/dist/types/deposit/deposit-modal.types.d.mts

@@ -77,9 +77,10 @@ export interface WalletDepositFlowData {
      */
     successSummary?: Partial<WalletDepositSummary>;
 }
-/** Optional config for the "Send crypto" tab. All fields have sensible defaults. */
+/** Optional config for the "Send crypto" tab. Fee estimates are derived from the shared estimator. */
 export interface SendCryptoConfig {
     minDeposit?: string;
+    /** @deprecated Send crypto now derives fees from the shared transfer estimator. */
     feeEstimate?: string;
     eta?: string;
 }
@@ -129,6 +130,14 @@ export interface DepositModalControlledProps {
     onConfirmWalletDeposit?: (params: WalletDepositConfirmParams) => Promise<void> | void;
     /** Called after the wallet deposit flow reaches its completion state. */
     onDoneWalletDeposit?: () => void;
+    /**
+     * Called when the user backs out of the wallet processing screen — e.g.
+     * after a wallet popup was dismissed silently or an in-flight tx was
+     * canceled/replaced from the wallet UI without a clean error. The hook
+     * implementation should clear any pending transaction state so a retry
+     * starts fresh. The modal handles returning to the wallet form on its own.
+     */
+    onCancelWalletDeposit?: () => void;
     /**
      * Fired whenever the wallet-flow network dropdown changes (including the
      * initial auto-select). The parent can use this to read the on-chain

package/dist/types/deposit/deposit-modal.types.d.ts

@@ -77,9 +77,10 @@ export interface WalletDepositFlowData {
      */
     successSummary?: Partial<WalletDepositSummary>;
 }
-/** Optional config for the "Send crypto" tab. All fields have sensible defaults. */
+/** Optional config for the "Send crypto" tab. Fee estimates are derived from the shared estimator. */
 export interface SendCryptoConfig {
     minDeposit?: string;
+    /** @deprecated Send crypto now derives fees from the shared transfer estimator. */
     feeEstimate?: string;
     eta?: string;
 }
@@ -129,6 +130,14 @@ export interface DepositModalControlledProps {
     onConfirmWalletDeposit?: (params: WalletDepositConfirmParams) => Promise<void> | void;
     /** Called after the wallet deposit flow reaches its completion state. */
     onDoneWalletDeposit?: () => void;
+    /**
+     * Called when the user backs out of the wallet processing screen — e.g.
+     * after a wallet popup was dismissed silently or an in-flight tx was
+     * canceled/replaced from the wallet UI without a clean error. The hook
+     * implementation should clear any pending transaction state so a retry
+     * starts fresh. The modal handles returning to the wallet form on its own.
+     */
+    onCancelWalletDeposit?: () => void;
     /**
      * Fired whenever the wallet-flow network dropdown changes (including the
      * initial auto-select). The parent can use this to read the on-chain

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

@@ -1,5 +1,5 @@
 import type { DepositModalProps } from "./deposit-modal.types";
-export type { CardFlowData, CardProviderOption, CardTransactionStatus, DepositMethod, DepositModalControlledProps, DepositModalProps, DepositSelectOption, SendCryptoConfig, VenueBalance, DepositModalSelfDrivenProps, WalletDepositConfirmParams, WalletDepositFlowData, WalletTransactionStatus, } from "./deposit-modal.types";
+export type { CardFlowData, CardProviderOption, CardTransactionStatus, DepositMethod, DepositModalControlledProps, DepositModalProps, DepositModalSelfDrivenProps, DepositSelectOption, SendCryptoConfig, VenueBalance, WalletDepositConfirmParams, WalletDepositFlowData, WalletTransactionStatus, } from "./deposit-modal.types";
 export { CARD_NETWORK_OPTIONS } from "./deposit-modal.constants";
 interface PendingCardSession {
     sessionId: string;

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

@@ -1,5 +1,5 @@
 import type { DepositModalProps } from "./deposit-modal.types";
-export type { CardFlowData, CardProviderOption, CardTransactionStatus, DepositMethod, DepositModalControlledProps, DepositModalProps, DepositSelectOption, SendCryptoConfig, VenueBalance, DepositModalSelfDrivenProps, WalletDepositConfirmParams, WalletDepositFlowData, WalletTransactionStatus, } from "./deposit-modal.types";
+export type { CardFlowData, CardProviderOption, CardTransactionStatus, DepositMethod, DepositModalControlledProps, DepositModalProps, DepositModalSelfDrivenProps, DepositSelectOption, SendCryptoConfig, VenueBalance, WalletDepositConfirmParams, WalletDepositFlowData, WalletTransactionStatus, } from "./deposit-modal.types";
 export { CARD_NETWORK_OPTIONS } from "./deposit-modal.constants";
 interface PendingCardSession {
     sessionId: string;

package/dist/types/deposit/steps/crypto-transfer.d.mts

@@ -6,7 +6,6 @@ export interface CryptoTransferStepProps {
     selectedNetwork: string;
     depositAddress: string;
     minDeposit: string;
-    feeEstimate: string;
     eta: string;
     isLoadingAddress?: boolean;
     addressError?: string;
@@ -16,4 +15,4 @@ export interface CryptoTransferStepProps {
     onCopyAddress?: () => void;
     onDone: () => void;
 }
-export declare const CryptoTransferStep: ({ tokenOptions, networkOptions, selectedToken, selectedNetwork, depositAddress, minDeposit, feeEstimate, eta, isLoadingAddress, addressError, onBack, onTokenChange, onNetworkChange, onCopyAddress, onDone, }: CryptoTransferStepProps) => JSX.Element;
+export declare const CryptoTransferStep: ({ tokenOptions, networkOptions, selectedToken, selectedNetwork, depositAddress, minDeposit, eta, isLoadingAddress, addressError, onBack, onTokenChange, onNetworkChange, onCopyAddress, onDone, }: CryptoTransferStepProps) => JSX.Element;

package/dist/types/deposit/steps/crypto-transfer.d.ts

@@ -6,7 +6,6 @@ export interface CryptoTransferStepProps {
     selectedNetwork: string;
     depositAddress: string;
     minDeposit: string;
-    feeEstimate: string;
     eta: string;
     isLoadingAddress?: boolean;
     addressError?: string;
@@ -16,4 +15,4 @@ export interface CryptoTransferStepProps {
     onCopyAddress?: () => void;
     onDone: () => void;
 }
-export declare const CryptoTransferStep: ({ tokenOptions, networkOptions, selectedToken, selectedNetwork, depositAddress, minDeposit, feeEstimate, eta, isLoadingAddress, addressError, onBack, onTokenChange, onNetworkChange, onCopyAddress, onDone, }: CryptoTransferStepProps) => JSX.Element;
+export declare const CryptoTransferStep: ({ tokenOptions, networkOptions, selectedToken, selectedNetwork, depositAddress, minDeposit, eta, isLoadingAddress, addressError, onBack, onTokenChange, onNetworkChange, onCopyAddress, onDone, }: CryptoTransferStepProps) => JSX.Element;

package/dist/types/deposit/steps/deposit-method.d.mts

@@ -3,10 +3,11 @@ export interface DepositMethodStepProps {
     balance: number;
     walletLabel: string;
     walletBalance: number;
+    walletToken: string;
     isWalletBalanceLoading?: boolean;
     showWalletMethod?: boolean;
     highlightedMethod?: DepositMethod;
     depositAddressesReady?: boolean;
     onSelectMethod: (method: DepositMethod) => void;
 }
-export declare const DepositMethodStep: ({ balance, walletLabel, walletBalance, isWalletBalanceLoading, showWalletMethod, highlightedMethod, depositAddressesReady, onSelectMethod, }: DepositMethodStepProps) => JSX.Element;
+export declare const DepositMethodStep: ({ balance, walletLabel, walletBalance, walletToken, isWalletBalanceLoading, showWalletMethod, highlightedMethod, depositAddressesReady, onSelectMethod, }: DepositMethodStepProps) => JSX.Element;

package/dist/types/deposit/steps/deposit-method.d.ts

@@ -3,10 +3,11 @@ export interface DepositMethodStepProps {
     balance: number;
     walletLabel: string;
     walletBalance: number;
+    walletToken: string;
     isWalletBalanceLoading?: boolean;
     showWalletMethod?: boolean;
     highlightedMethod?: DepositMethod;
     depositAddressesReady?: boolean;
     onSelectMethod: (method: DepositMethod) => void;
 }
-export declare const DepositMethodStep: ({ balance, walletLabel, walletBalance, isWalletBalanceLoading, showWalletMethod, highlightedMethod, depositAddressesReady, onSelectMethod, }: DepositMethodStepProps) => JSX.Element;
+export declare const DepositMethodStep: ({ balance, walletLabel, walletBalance, walletToken, isWalletBalanceLoading, showWalletMethod, highlightedMethod, depositAddressesReady, onSelectMethod, }: DepositMethodStepProps) => JSX.Element;

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

@@ -1,4 +1,4 @@
-import type { VenueEventWithMarkets, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
+import type { MarketStatus, VenueEventWithMarkets, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
 export type { VenueEventWithMarkets, VenueMarket, VenueMarketOutcome };
 export type EventListItemEvent = VenueEventWithMarkets;
 export type EventListItemVenueInfo = {
@@ -37,6 +37,8 @@ export type EventListItemBaseProps = {
     href?: string;
     /** Accessible label applied to the clickable card element. */
     ariaLabel?: string;
+    /** When set, scopes the lazy market fetch (used to expand the card chips beyond the inline set) to markets matching this status. The parent list passes its own status filter so the expanded chips stay consistent with the listing. */
+    marketStatus?: MarketStatus;
 };
 export type EventListItemLoadingProps = EventListItemBaseProps & {
     /** Forces the component into its loading state. */

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

@@ -1,4 +1,4 @@
-import type { VenueEventWithMarkets, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
+import type { MarketStatus, VenueEventWithMarkets, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
 export type { VenueEventWithMarkets, VenueMarket, VenueMarketOutcome };
 export type EventListItemEvent = VenueEventWithMarkets;
 export type EventListItemVenueInfo = {
@@ -37,6 +37,8 @@ export type EventListItemBaseProps = {
     href?: string;
     /** Accessible label applied to the clickable card element. */
     ariaLabel?: string;
+    /** When set, scopes the lazy market fetch (used to expand the card chips beyond the inline set) to markets matching this status. The parent list passes its own status filter so the expanded chips stay consistent with the listing. */
+    marketStatus?: MarketStatus;
 };
 export type EventListItemLoadingProps = EventListItemBaseProps & {
     /** Forces the component into its loading state. */

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

@@ -1,5 +1,18 @@
 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;
@@ -46,7 +59,18 @@ 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[]) => {
+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;
+}) => {
     marketCount: number;
     venueCount: number;
     singleVenue: import("@agg-build/hooks").Venue | undefined;
@@ -98,6 +122,6 @@ export declare function resolveBestMidpointForMarket(market: {
         id: string;
         venue: string;
     }> | null;
-}, midpointsByVenueMarketId: Map<string, number | null>, spreadByVenueMarketId?: Map<string, number | null>): BestMidpointResult | undefined;
+}, midpointsByVenueMarketId: Map<string, number | null>, _spreadByVenueMarketId?: Map<string, number | null>): BestMidpointResult | undefined;
 export declare const resolveDisplayVolume: (eventVolume: number | null | undefined, venueMarkets: ReadonlyArray<DisplayVolumeMarket>) => number | undefined;
 export {};

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

@@ -1,5 +1,18 @@
 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;
@@ -46,7 +59,18 @@ 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[]) => {
+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;
+}) => {
     marketCount: number;
     venueCount: number;
     singleVenue: import("@agg-build/hooks").Venue | undefined;
@@ -98,6 +122,6 @@ export declare function resolveBestMidpointForMarket(market: {
         id: string;
         venue: string;
     }> | null;
-}, midpointsByVenueMarketId: Map<string, number | null>, spreadByVenueMarketId?: Map<string, number | null>): BestMidpointResult | undefined;
+}, midpointsByVenueMarketId: Map<string, number | null>, _spreadByVenueMarketId?: Map<string, number | null>): BestMidpointResult | undefined;
 export declare const resolveDisplayVolume: (eventVolume: number | null | undefined, venueMarkets: ReadonlyArray<DisplayVolumeMarket>) => number | undefined;
 export {};

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

@@ -1,4 +1,4 @@
-import type { ChartTimeRange, EventTradingState } from "@agg-build/hooks";
+import type { ChartTimeRange, EventTradingState, UseMidpointsResult } from "@agg-build/hooks";
 import type { LineChartPoint, LineChartType } from "../../primitives/chart";
 import type { EventListItemVenueInfoMap, VenueEventWithMarkets } from "../item/event-list-item.types";
 import type { OutcomeByVenue } from "./event-list-item-details.utils";
@@ -45,6 +45,8 @@ export type EventListItemDetailsBaseProps = {
     defaultTimeRange?: EventListItemDetailsTimeRange;
     /** Called when the details card is clicked. */
     onClick?: (event?: EventListItemDetailsEvent) => void;
+    /** Pre-fetched midpoint data (best price included) passed from parent. Optional for backward compatibility. */
+    midpointsResult?: UseMidpointsResult;
 };
 export type EventListItemDetailsLoadingProps = EventListItemDetailsBaseProps & {
     /** Forces the details component into its loading state. */
@@ -108,6 +110,8 @@ export type EventListItemDetailsGraphSectionProps = {
     venueInfo?: EventListItemVenueInfoMap;
     /** Venue markets used to build the chart series. */
     venueMarkets: EventListItemDetailsContentProps["event"]["venueMarkets"];
+    /** Market id used to scope the chart to the active market cluster. */
+    selectedMarketId?: string | null;
     /**
      * WS+REST merged prices (WS wins) keyed by outcome ID. General-purpose live
      * prices for contexts where per-venue accuracy or availability doesn't matter.
@@ -125,7 +129,32 @@ export type EventListItemDetailsGraphSectionProps = {
      * than the WS price of a single venue.
      */
     restMidpoints: Map<string, number>;
+    /** Canonical yes-side midpoint/reference price for the active cluster. */
+    bestMidpoint?: number;
+    /**
+     * Trusted top-of-book per-outcome prices keyed by outcome ID. Drives the
+     * outcome selector switch when present so the displayed price is the live
+     * bestAsk rather than a stale midpoint.
+     */
+    bestPrices?: ReadonlyMap<string, {
+        bestBid?: number;
+        bestAsk?: number;
+    }>;
     /** Override live WS subscriptions for the chart hook.
      *  Set to `false` when a parent manages subscriptions centrally. */
     live?: boolean;
+    /**
+     * Per-chart range override that takes precedence over the user's global
+     * `selectedChartTimeRange`. The auto-fallback effect sets this to `"ALL"`
+     * when the user-selected range is empty for the current subject, so the
+     * chart displays usable data without mutating the user's preference.
+     * `null` means "use the user's selection".
+     */
+    rangeOverride: import("@agg-build/hooks").ChartTimeRange | null;
+    /**
+     * Called by the graph section's auto-fallback effect to set a local
+     * override. Passing `null` clears the override (used by the parent on
+     * subject change / explicit user range pick).
+     */
+    onRangeOverrideChange: (range: import("@agg-build/hooks").ChartTimeRange | null) => void;
 };

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

@@ -1,4 +1,4 @@
-import type { ChartTimeRange, EventTradingState } from "@agg-build/hooks";
+import type { ChartTimeRange, EventTradingState, UseMidpointsResult } from "@agg-build/hooks";
 import type { LineChartPoint, LineChartType } from "../../primitives/chart";
 import type { EventListItemVenueInfoMap, VenueEventWithMarkets } from "../item/event-list-item.types";
 import type { OutcomeByVenue } from "./event-list-item-details.utils";
@@ -45,6 +45,8 @@ export type EventListItemDetailsBaseProps = {
     defaultTimeRange?: EventListItemDetailsTimeRange;
     /** Called when the details card is clicked. */
     onClick?: (event?: EventListItemDetailsEvent) => void;
+    /** Pre-fetched midpoint data (best price included) passed from parent. Optional for backward compatibility. */
+    midpointsResult?: UseMidpointsResult;
 };
 export type EventListItemDetailsLoadingProps = EventListItemDetailsBaseProps & {
     /** Forces the details component into its loading state. */
@@ -108,6 +110,8 @@ export type EventListItemDetailsGraphSectionProps = {
     venueInfo?: EventListItemVenueInfoMap;
     /** Venue markets used to build the chart series. */
     venueMarkets: EventListItemDetailsContentProps["event"]["venueMarkets"];
+    /** Market id used to scope the chart to the active market cluster. */
+    selectedMarketId?: string | null;
     /**
      * WS+REST merged prices (WS wins) keyed by outcome ID. General-purpose live
      * prices for contexts where per-venue accuracy or availability doesn't matter.
@@ -125,7 +129,32 @@ export type EventListItemDetailsGraphSectionProps = {
      * than the WS price of a single venue.
      */
     restMidpoints: Map<string, number>;
+    /** Canonical yes-side midpoint/reference price for the active cluster. */
+    bestMidpoint?: number;
+    /**
+     * Trusted top-of-book per-outcome prices keyed by outcome ID. Drives the
+     * outcome selector switch when present so the displayed price is the live
+     * bestAsk rather than a stale midpoint.
+     */
+    bestPrices?: ReadonlyMap<string, {
+        bestBid?: number;
+        bestAsk?: number;
+    }>;
     /** Override live WS subscriptions for the chart hook.
      *  Set to `false` when a parent manages subscriptions centrally. */
     live?: boolean;
+    /**
+     * Per-chart range override that takes precedence over the user's global
+     * `selectedChartTimeRange`. The auto-fallback effect sets this to `"ALL"`
+     * when the user-selected range is empty for the current subject, so the
+     * chart displays usable data without mutating the user's preference.
+     * `null` means "use the user's selection".
+     */
+    rangeOverride: import("@agg-build/hooks").ChartTimeRange | null;
+    /**
+     * Called by the graph section's auto-fallback effect to set a local
+     * override. Passing `null` clears the override (used by the parent on
+     * subject change / explicit user range pick).
+     */
+    onRangeOverrideChange: (range: import("@agg-build/hooks").ChartTimeRange | null) => void;
 };

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

@@ -7,6 +7,6 @@ export declare const MarketDetails: {
     displayName: string;
 };
 export declare const MarketDetailsList: {
-    ({ eventId, markets: providedMarkets, eventTradingState, onClick, onOutcomeSelect, onExpandedMarketChange, defaultTab, classNames, live, }: MarketDetailsListProps): JSX.Element;
+    ({ eventId, markets: providedMarkets, eventTradingState, onClick, onOutcomeSelect, onExpandedMarketChange, autoSelectFallbackMarket, defaultTab, classNames, live, midpointsResult, }: MarketDetailsListProps): JSX.Element;
     displayName: string;
 };

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

@@ -7,6 +7,6 @@ export declare const MarketDetails: {
     displayName: string;
 };
 export declare const MarketDetailsList: {
-    ({ eventId, markets: providedMarkets, eventTradingState, onClick, onOutcomeSelect, onExpandedMarketChange, defaultTab, classNames, live, }: MarketDetailsListProps): JSX.Element;
+    ({ eventId, markets: providedMarkets, eventTradingState, onClick, onOutcomeSelect, onExpandedMarketChange, autoSelectFallbackMarket, defaultTab, classNames, live, midpointsResult, }: MarketDetailsListProps): JSX.Element;
     displayName: string;
 };

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

@@ -1,4 +1,4 @@
-import type { EventTradingState, VenueMarket } from "@agg-build/hooks";
+import type { EventTradingState, UseMidpointsResult, VenueMarket } from "@agg-build/hooks";
 import type React from "react";
 import type { VenueLogoName } from "../../primitives/venue-logo/venue-logo.types";
 export type MarketDetailsTab = "order-book" | "graph" | "other";
@@ -45,6 +45,11 @@ export type MarketDetailsBaseProps = {
     otherContent?: React.ReactNode;
     /** Whether the market details should render a loading state. */
     isLoading?: boolean;
+    /**
+     * When true, if a global selected outcome does not belong to this card,
+     * do not fall back to a local default outcome for selected-state rendering.
+     */
+    suppressOutcomeFallbackSelection?: boolean;
     /** Override live WS subscriptions for chart and orderbook hooks.
      *  Set to `false` when a parent component already manages subscriptions
      *  (e.g. useEventOrderbookData on the event page).
@@ -82,6 +87,12 @@ export type MarketDetailsWithMarketsProps = MarketDetailsBaseProps & {
      * shows the correct logo alongside the best price.
      */
     midpointsFallbackVenues?: Map<string, string>;
+    /**
+     * Pre-fetched midpoint data (best price included) passed from parent.
+     * Optional for backward compatibility. When provided, reduces unnecessary
+     * redundant API calls for midpoint data.
+     */
+    midpointsResult?: UseMidpointsResult;
 };
 export type MarketDetailsProps = MarketDetailsLoadingProps | MarketDetailsWithMarketsProps;
 export type MarketDetailsContentProps = MarketDetailsBaseProps & {
@@ -91,6 +102,8 @@ export type MarketDetailsContentProps = MarketDetailsBaseProps & {
     midpointsFallback?: Map<string, number>;
     /** See MarketDetailsWithMarketsProps.midpointsFallbackVenues. */
     midpointsFallbackVenues?: Map<string, string>;
+    /** See MarketDetailsWithMarketsProps.midpointsResult. */
+    midpointsResult?: UseMidpointsResult;
 };
 export type MarketDetailsListClassNames = Partial<{
     root: string;
@@ -112,6 +125,12 @@ export type MarketDetailsListProps = {
         marketId: string;
         outcomeId: string;
     }) => void;
+    /** Whether selected market changes should expand the matching accordion item. */
+    expandSelectedMarketOnChange?: boolean;
+    /** Whether fallback market selection should expand a card when none is expanded. */
+    autoExpandFallbackMarket?: boolean;
+    /** Whether the list should auto-select a fallback market when none is selected. */
+    autoSelectFallbackMarket?: boolean;
     /** Default tab to display. */
     defaultTab?: MarketDetailsTab;
     /** Class names for the market details list. */
@@ -119,13 +138,19 @@ export type MarketDetailsListProps = {
     /** Override live WS subscriptions for child MarketDetails.
      *  Set to `false` when a parent manages subscriptions centrally. */
     live?: boolean;
+    /**
+     * Pre-fetched midpoint data (best price included) passed from parent.
+     * Optional for backward compatibility. When provided, reduces unnecessary
+     * redundant API calls for midpoint data.
+     */
+    midpointsResult?: UseMidpointsResult;
 };
 export type MarketDetailsOrderBookTone = "positive" | "negative";
 export type MarketDetailsOutcomeTone = MarketDetailsOrderBookTone;
 export type MarketDetailsHeaderOutcomeItem = {
     id: string;
     label: string;
-    title: string;
+    title?: string | null;
     probability: number | undefined;
     tone: MarketDetailsOutcomeTone;
     venue: VenueLogoName;

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

@@ -1,4 +1,4 @@
-import type { EventTradingState, VenueMarket } from "@agg-build/hooks";
+import type { EventTradingState, UseMidpointsResult, VenueMarket } from "@agg-build/hooks";
 import type React from "react";
 import type { VenueLogoName } from "../../primitives/venue-logo/venue-logo.types";
 export type MarketDetailsTab = "order-book" | "graph" | "other";
@@ -45,6 +45,11 @@ export type MarketDetailsBaseProps = {
     otherContent?: React.ReactNode;
     /** Whether the market details should render a loading state. */
     isLoading?: boolean;
+    /**
+     * When true, if a global selected outcome does not belong to this card,
+     * do not fall back to a local default outcome for selected-state rendering.
+     */
+    suppressOutcomeFallbackSelection?: boolean;
     /** Override live WS subscriptions for chart and orderbook hooks.
      *  Set to `false` when a parent component already manages subscriptions
      *  (e.g. useEventOrderbookData on the event page).
@@ -82,6 +87,12 @@ export type MarketDetailsWithMarketsProps = MarketDetailsBaseProps & {
      * shows the correct logo alongside the best price.
      */
     midpointsFallbackVenues?: Map<string, string>;
+    /**
+     * Pre-fetched midpoint data (best price included) passed from parent.
+     * Optional for backward compatibility. When provided, reduces unnecessary
+     * redundant API calls for midpoint data.
+     */
+    midpointsResult?: UseMidpointsResult;
 };
 export type MarketDetailsProps = MarketDetailsLoadingProps | MarketDetailsWithMarketsProps;
 export type MarketDetailsContentProps = MarketDetailsBaseProps & {
@@ -91,6 +102,8 @@ export type MarketDetailsContentProps = MarketDetailsBaseProps & {
     midpointsFallback?: Map<string, number>;
     /** See MarketDetailsWithMarketsProps.midpointsFallbackVenues. */
     midpointsFallbackVenues?: Map<string, string>;
+    /** See MarketDetailsWithMarketsProps.midpointsResult. */
+    midpointsResult?: UseMidpointsResult;
 };
 export type MarketDetailsListClassNames = Partial<{
     root: string;
@@ -112,6 +125,12 @@ export type MarketDetailsListProps = {
         marketId: string;
         outcomeId: string;
     }) => void;
+    /** Whether selected market changes should expand the matching accordion item. */
+    expandSelectedMarketOnChange?: boolean;
+    /** Whether fallback market selection should expand a card when none is expanded. */
+    autoExpandFallbackMarket?: boolean;
+    /** Whether the list should auto-select a fallback market when none is selected. */
+    autoSelectFallbackMarket?: boolean;
     /** Default tab to display. */
     defaultTab?: MarketDetailsTab;
     /** Class names for the market details list. */
@@ -119,13 +138,19 @@ export type MarketDetailsListProps = {
     /** Override live WS subscriptions for child MarketDetails.
      *  Set to `false` when a parent manages subscriptions centrally. */
     live?: boolean;
+    /**
+     * Pre-fetched midpoint data (best price included) passed from parent.
+     * Optional for backward compatibility. When provided, reduces unnecessary
+     * redundant API calls for midpoint data.
+     */
+    midpointsResult?: UseMidpointsResult;
 };
 export type MarketDetailsOrderBookTone = "positive" | "negative";
 export type MarketDetailsOutcomeTone = MarketDetailsOrderBookTone;
 export type MarketDetailsHeaderOutcomeItem = {
     id: string;
     label: string;
-    title: string;
+    title?: string | null;
     probability: number | undefined;
     tone: MarketDetailsOutcomeTone;
     venue: VenueLogoName;

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;