@agg-build/ui 1.0.0 → 1.0.1

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

@@ -15,6 +15,26 @@ export type EventListItemVisibleOutcome = {
     title: string;
 };
 export declare const resolveVisibleOutcomes: (venueMarkets: VenueMarket[]) => EventListItemVisibleOutcome[];
+/**
+ * Dedupe venue markets while collapsing matched-cluster siblings to a single
+ * row. Walks left-to-right; for each market we see, mark its own id AND every
+ * `matchedVenueMarkets[].id` as "seen", and skip any later row whose own id
+ * already appears in the seen set.
+ *
+ * Why cluster-aware (not just id): the home card preview and the load-more
+ * (`/venue-markets`) endpoint can pick different cluster representatives for
+ * the same matched group (one keeps the highest-volume venue, the other keeps
+ * the canonical cluster target). When the EventItem component merges the two
+ * lists for cross-page rendering, a naive id-only dedup leaves both rows in
+ * place and the user sees the same logical market (e.g. "Bayern Munich")
+ * twice — once per representative. Tracking sibling ids closes that gap
+ * without needing the backend to expose `matchEntry.targetVenueMarketId` on
+ * every list shape.
+ *
+ * Order semantics: first occurrence wins per cluster. Callers should pass
+ * the more authoritative list first (e.g. `[...allVenueMarkets, ...lazyLoaded]`
+ * if the home-card row is preferred, swap if the lazy-loaded row is preferred).
+ */
 export declare const dedupeVenueMarketsById: (venueMarkets: VenueMarket[]) => VenueMarket[];
 /** Returns the outcome's display text. Prefers `title` (the descriptive
  *  human-readable text — e.g. "Trump Wins") when present and non-empty,
@@ -42,5 +62,42 @@ type DisplayVolumeMarket = {
         targetVenueMarket?: DisplayVolumeMarket | null;
     } | null | undefined;
 };
+export type BestMidpointResult = {
+    /** Raw midpoint value (0–1 range, not yet clamped). */
+    midpoint: number;
+    venueMarketId: string;
+    venue: string;
+};
+/**
+ * Builds a venue-market-id → spread lookup from the raw midpoint rows returned
+ * by `useVenueMarketMidpoints`. Matched sibling rows are included in the map;
+ * first-write wins to match the same priority as `midpointsByVenueMarketId`.
+ */
+export declare function buildSpreadByVenueMarketId(midpointRows: ReadonlyArray<{
+    venueMarketId: string;
+    spread: number | null;
+    matched: ReadonlyArray<{
+        venueMarketId: string;
+        spread: number | null;
+    }>;
+}>): Map<string, number | null>;
+/**
+ * Returns the best available midpoint across a market and its matched venue
+ * markets. Candidates are collected in declaration order (primary first, then
+ * matched in array order) and deduplicated by ID. Among valid (non-null)
+ * midpoints, the candidate with the **lowest** YES midpoint wins — this gives
+ * the buyer the best available price across venues.
+ *
+ * The `spreadByVenueMarketId` parameter is accepted for call-site compatibility
+ * but is no longer used in the selection logic.
+ */
+export declare function resolveBestMidpointForMarket(market: {
+    id: string;
+    venue: string;
+    matchedVenueMarkets?: ReadonlyArray<{
+        id: string;
+        venue: string;
+    }> | null;
+}, 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

@@ -108,8 +108,23 @@ export type EventListItemDetailsGraphSectionProps = {
     venueInfo?: EventListItemVenueInfoMap;
     /** Venue markets used to build the chart series. */
     venueMarkets: EventListItemDetailsContentProps["event"]["venueMarkets"];
-    /** Live outcome prices keyed by outcome ID. */
+    /**
+     * 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.
+     */
     livePrices: Map<string, number>;
+    /**
+     * WS-only prices keyed by outcome ID. Used for chart venue badges so each
+     * badge shows its own venue's price rather than the cross-venue best.
+     * Falls back to `outcome.price` when a venue has no WS data yet.
+     */
+    wsLivePrices: Map<string, number>;
+    /**
+     * REST cross-venue best prices keyed by outcome ID. Used for the outcome
+     * selector switch so it shows the lowest available price across venues rather
+     * than the WS price of a single venue.
+     */
+    restMidpoints: Map<string, number>;
     /** Override live WS subscriptions for the chart hook.
      *  Set to `false` when a parent manages subscriptions centrally. */
     live?: boolean;

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

@@ -108,8 +108,23 @@ export type EventListItemDetailsGraphSectionProps = {
     venueInfo?: EventListItemVenueInfoMap;
     /** Venue markets used to build the chart series. */
     venueMarkets: EventListItemDetailsContentProps["event"]["venueMarkets"];
-    /** Live outcome prices keyed by outcome ID. */
+    /**
+     * 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.
+     */
     livePrices: Map<string, number>;
+    /**
+     * WS-only prices keyed by outcome ID. Used for chart venue badges so each
+     * badge shows its own venue's price rather than the cross-venue best.
+     * Falls back to `outcome.price` when a venue has no WS data yet.
+     */
+    wsLivePrices: Map<string, number>;
+    /**
+     * REST cross-venue best prices keyed by outcome ID. Used for the outcome
+     * selector switch so it shows the lowest available price across venues rather
+     * than the WS price of a single venue.
+     */
+    restMidpoints: Map<string, number>;
     /** Override live WS subscriptions for the chart hook.
      *  Set to `false` when a parent manages subscriptions centrally. */
     live?: boolean;

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

@@ -71,6 +71,12 @@ export type MarketDetailsWithMarketsProps = MarketDetailsBaseProps & {
      * card is not the selected market and therefore isn't on the WS feed.
      */
     midpointsFallback?: Map<string, number>;
+    /**
+     * Venue name for each outcome id in `midpointsFallback`. When a matched venue
+     * offered a lower YES price, this records that venue so the outcome button
+     * shows the correct logo alongside the best price.
+     */
+    midpointsFallbackVenues?: Map<string, string>;
 };
 export type MarketDetailsProps = MarketDetailsLoadingProps | MarketDetailsWithMarketsProps;
 export type MarketDetailsContentProps = MarketDetailsBaseProps & {
@@ -78,6 +84,8 @@ export type MarketDetailsContentProps = MarketDetailsBaseProps & {
     venueMarkets: VenueMarket[];
     /** See MarketDetailsWithMarketsProps.midpointsFallback. */
     midpointsFallback?: Map<string, number>;
+    /** See MarketDetailsWithMarketsProps.midpointsFallbackVenues. */
+    midpointsFallbackVenues?: Map<string, string>;
 };
 export type MarketDetailsListClassNames = Partial<{
     root: string;

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

@@ -71,6 +71,12 @@ export type MarketDetailsWithMarketsProps = MarketDetailsBaseProps & {
      * card is not the selected market and therefore isn't on the WS feed.
      */
     midpointsFallback?: Map<string, number>;
+    /**
+     * Venue name for each outcome id in `midpointsFallback`. When a matched venue
+     * offered a lower YES price, this records that venue so the outcome button
+     * shows the correct logo alongside the best price.
+     */
+    midpointsFallbackVenues?: Map<string, string>;
 };
 export type MarketDetailsProps = MarketDetailsLoadingProps | MarketDetailsWithMarketsProps;
 export type MarketDetailsContentProps = MarketDetailsBaseProps & {
@@ -78,6 +84,8 @@ export type MarketDetailsContentProps = MarketDetailsBaseProps & {
     venueMarkets: VenueMarket[];
     /** See MarketDetailsWithMarketsProps.midpointsFallback. */
     midpointsFallback?: Map<string, number>;
+    /** See MarketDetailsWithMarketsProps.midpointsFallbackVenues. */
+    midpointsFallbackVenues?: Map<string, string>;
 };
 export type MarketDetailsListClassNames = Partial<{
     root: string;

package/dist/types/primitives/copy-button/index.d.mts

@@ -0,0 +1,25 @@
+export interface CopyButtonProps {
+    /** Value written to the clipboard when the button is clicked. */
+    value: string;
+    /** Optional text rendered next to the icon in idle state. */
+    label?: string;
+    /** Optional text rendered next to the icon while the copied feedback is showing. */
+    copiedLabel?: string;
+    /** ARIA label used when no visible text label is rendered. */
+    "aria-label"?: string;
+    /** Disables the button (e.g. while the value is loading). */
+    disabled?: boolean;
+    /** Wrapper class applied to the underlying button. */
+    className?: string;
+    /** Class applied to the icon (size and color). Defaults to `"h-4 w-4"`. */
+    iconClassName?: string;
+    /** Fires after the value is written to the clipboard. */
+    onCopy?: () => void;
+    /** How long the copied state is shown, in ms. Defaults to 2000. */
+    resetMs?: number;
+}
+/** Button that copies `value` to the clipboard and briefly swaps to a confirmation icon. */
+export declare const CopyButton: {
+    ({ value, label, copiedLabel, "aria-label": ariaLabel, disabled, className, iconClassName, onCopy, resetMs, }: CopyButtonProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/copy-button/index.d.ts

@@ -0,0 +1,25 @@
+export interface CopyButtonProps {
+    /** Value written to the clipboard when the button is clicked. */
+    value: string;
+    /** Optional text rendered next to the icon in idle state. */
+    label?: string;
+    /** Optional text rendered next to the icon while the copied feedback is showing. */
+    copiedLabel?: string;
+    /** ARIA label used when no visible text label is rendered. */
+    "aria-label"?: string;
+    /** Disables the button (e.g. while the value is loading). */
+    disabled?: boolean;
+    /** Wrapper class applied to the underlying button. */
+    className?: string;
+    /** Class applied to the icon (size and color). Defaults to `"h-4 w-4"`. */
+    iconClassName?: string;
+    /** Fires after the value is written to the clipboard. */
+    onCopy?: () => void;
+    /** How long the copied state is shown, in ms. Defaults to 2000. */
+    resetMs?: number;
+}
+/** Button that copies `value` to the clipboard and briefly swaps to a confirmation icon. */
+export declare const CopyButton: {
+    ({ value, label, copiedLabel, "aria-label": ariaLabel, disabled, className, iconClassName, onCopy, resetMs, }: CopyButtonProps): JSX.Element;
+    displayName: string;
+};

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

@@ -5,6 +5,7 @@ export * from "./badge";
 export * from "./button";
 export * from "./card";
 export * from "./chart";
+export * from "./copy-button";
 export * from "./currency-input";
 export * from "./footer";
 export * from "./header";
@@ -20,6 +21,7 @@ export * from "./skeleton";
 export * from "./state-message";
 export * from "./switch-button";
 export * from "./tabs";
+export * from "./toast";
 export * from "./tooltip";
 export * from "./typography";
 export * from "./venue-logo";

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

@@ -5,6 +5,7 @@ export * from "./badge";
 export * from "./button";
 export * from "./card";
 export * from "./chart";
+export * from "./copy-button";
 export * from "./currency-input";
 export * from "./footer";
 export * from "./header";
@@ -20,6 +21,7 @@ export * from "./skeleton";
 export * from "./state-message";
 export * from "./switch-button";
 export * from "./tabs";
+export * from "./toast";
 export * from "./tooltip";
 export * from "./typography";
 export * from "./venue-logo";

package/dist/types/primitives/toast/index.d.mts

@@ -0,0 +1,4 @@
+import type { ToastContextValue, ToastProviderProps } from "./toast.types";
+export type { ToastContextValue, ToastEntry, ToastOptions, ToastProviderProps, ToastSwipeDirection, ToastTone, } from "./toast.types";
+export declare function ToastProvider({ children, defaultDurationMs, swipeDirection, swipeThreshold, viewportClassName, }: ToastProviderProps): JSX.Element;
+export declare function useToast(): ToastContextValue;

package/dist/types/primitives/toast/index.d.ts

@@ -0,0 +1,4 @@
+import type { ToastContextValue, ToastProviderProps } from "./toast.types";
+export type { ToastContextValue, ToastEntry, ToastOptions, ToastProviderProps, ToastSwipeDirection, ToastTone, } from "./toast.types";
+export declare function ToastProvider({ children, defaultDurationMs, swipeDirection, swipeThreshold, viewportClassName, }: ToastProviderProps): JSX.Element;
+export declare function useToast(): ToastContextValue;

package/dist/types/primitives/toast/toast.types.d.mts

@@ -0,0 +1,31 @@
+import type { ReactNode } from "react";
+export type ToastTone = "info" | "success" | "warning" | "error";
+export interface ToastOptions {
+    tone?: ToastTone;
+    title?: string;
+    /** Auto-dismiss duration in ms. Pass `Infinity` (or `0`) to require manual dismissal. Defaults to 5000. */
+    durationMs?: number;
+}
+export interface ToastEntry {
+    id: number;
+    message: string;
+    tone: ToastTone;
+    title?: string;
+    durationMs: number;
+}
+export interface ToastContextValue {
+    toast: (message: string, options?: ToastOptions) => number;
+    dismiss: (id: number) => void;
+}
+export type ToastSwipeDirection = "right" | "left" | "up" | "down";
+export interface ToastProviderProps {
+    children: ReactNode;
+    /** Default auto-dismiss duration applied when a toast doesn't override it. Defaults to 5000ms. */
+    defaultDurationMs?: number;
+    /** Swipe gesture direction for dismissal. Defaults to "right". */
+    swipeDirection?: ToastSwipeDirection;
+    /** Distance in pixels the user must swipe to dismiss. Defaults to 50. */
+    swipeThreshold?: number;
+    /** Tailwind classes applied to the toast viewport (positioning container). */
+    viewportClassName?: string;
+}

package/dist/types/primitives/toast/toast.types.d.ts

@@ -0,0 +1,31 @@
+import type { ReactNode } from "react";
+export type ToastTone = "info" | "success" | "warning" | "error";
+export interface ToastOptions {
+    tone?: ToastTone;
+    title?: string;
+    /** Auto-dismiss duration in ms. Pass `Infinity` (or `0`) to require manual dismissal. Defaults to 5000. */
+    durationMs?: number;
+}
+export interface ToastEntry {
+    id: number;
+    message: string;
+    tone: ToastTone;
+    title?: string;
+    durationMs: number;
+}
+export interface ToastContextValue {
+    toast: (message: string, options?: ToastOptions) => number;
+    dismiss: (id: number) => void;
+}
+export type ToastSwipeDirection = "right" | "left" | "up" | "down";
+export interface ToastProviderProps {
+    children: ReactNode;
+    /** Default auto-dismiss duration applied when a toast doesn't override it. Defaults to 5000ms. */
+    defaultDurationMs?: number;
+    /** Swipe gesture direction for dismissal. Defaults to "right". */
+    swipeDirection?: ToastSwipeDirection;
+    /** Distance in pixels the user must swipe to dismiss. Defaults to 50. */
+    swipeThreshold?: number;
+    /** Tailwind classes applied to the toast viewport (positioning container). */
+    viewportClassName?: string;
+}

package/dist/types/trading/place-order/index.place-order.constants.d.mts

@@ -1,9 +1,17 @@
 import type { PlaceOrderResultTone } from "./index.place-order.types";
+/** Default amount pre-filled on mount so an initial quote is fetched immediately. */
+export declare const PLACE_ORDER_DEFAULT_AMOUNT = 20;
 /**
  * Order minimum is 1$ in all venues
  * This will prevent from retrying partially filled order
  */
 export declare const MIN_BUY_ORDER_AMOUNT = 1;
+/**
+ * Sell-side minimum: venues won't accept a sell smaller than 1 outcome-token
+ * share, so a partial-fill retry whose remainder is below this floor would be
+ * rejected. Used to gate the "Retry remaining" action on the sell flow.
+ */
+export declare const MIN_SELL_ORDER_SHARES = 1;
 export declare const DEFAULT_SLIPPAGE_VALUE = "0.5";
 export declare const DEFAULT_SLIPPAGE_MINIMUM = 0.5;
 export declare const HIGH_SLIPPAGE_THRESHOLD = 10;

package/dist/types/trading/place-order/index.place-order.constants.d.ts

@@ -1,9 +1,17 @@
 import type { PlaceOrderResultTone } from "./index.place-order.types";
+/** Default amount pre-filled on mount so an initial quote is fetched immediately. */
+export declare const PLACE_ORDER_DEFAULT_AMOUNT = 20;
 /**
  * Order minimum is 1$ in all venues
  * This will prevent from retrying partially filled order
  */
 export declare const MIN_BUY_ORDER_AMOUNT = 1;
+/**
+ * Sell-side minimum: venues won't accept a sell smaller than 1 outcome-token
+ * share, so a partial-fill retry whose remainder is below this floor would be
+ * rejected. Used to gate the "Retry remaining" action on the sell flow.
+ */
+export declare const MIN_SELL_ORDER_SHARES = 1;
 export declare const DEFAULT_SLIPPAGE_VALUE = "0.5";
 export declare const DEFAULT_SLIPPAGE_MINIMUM = 0.5;
 export declare const HIGH_SLIPPAGE_THRESHOLD = 10;

package/dist/types/trading/place-order/index.place-order.types.d.mts

@@ -151,6 +151,12 @@ export type ResolvePlaceOrderQuoteResultParams = {
     quoteData: SmartRouteResponse | null;
     tradeSide: PlaceOrderTab;
 };
+export type BuildLiveRouteCardsParams = {
+    labels: PlaceOrderTradingLabels;
+    quoteData: SmartRouteResponse;
+    tradeSide: PlaceOrderTab;
+    eventVenues?: TradingVenue[];
+};
 export type ResolvePlaceOrderQuoteStatusParams = {
     amount: number;
     labels: PlaceOrderTradingLabels;

package/dist/types/trading/place-order/index.place-order.types.d.ts

@@ -151,6 +151,12 @@ export type ResolvePlaceOrderQuoteResultParams = {
     quoteData: SmartRouteResponse | null;
     tradeSide: PlaceOrderTab;
 };
+export type BuildLiveRouteCardsParams = {
+    labels: PlaceOrderTradingLabels;
+    quoteData: SmartRouteResponse;
+    tradeSide: PlaceOrderTab;
+    eventVenues?: TradingVenue[];
+};
 export type ResolvePlaceOrderQuoteStatusParams = {
     amount: number;
     labels: PlaceOrderTradingLabels;

package/dist/types/trading/place-order/index.place-order.utils.d.mts

@@ -1,6 +1,6 @@
 import type { SmartRouteResponse, WsOrderSubmitted } from "@agg-build/sdk";
 import { type PlaceOrderOutcome, type PlaceOrderRoutingRow, type PlaceOrderTab, type TradingVenue } from "../types";
-import type { PlaceOrderOutcomeClassNameParams, PlaceOrderExecutionStepGroup, PlaceOrderFailureStep, PlaceOrderFailureSummary, PlaceOrderOutcomeLabelValue, PlaceOrderQuoteResult, PlaceOrderQuoteStatus, PlaceOrderResultTone, PlaceOrderRouteCard, PlaceOrderTerminalOrderEvent, PlaceOrderTradingLabels, PlaceOrderVenueOutcome, ResolvePlaceOrderQuoteResultParams, ResolvePlaceOrderQuoteStatusParams, ResolvePlaceOrderTabKeyParams } from "./index.place-order.types";
+import type { BuildLiveRouteCardsParams, PlaceOrderOutcomeClassNameParams, PlaceOrderExecutionStepGroup, PlaceOrderFailureStep, PlaceOrderFailureSummary, PlaceOrderOutcomeLabelValue, PlaceOrderQuoteResult, PlaceOrderQuoteStatus, PlaceOrderResultTone, PlaceOrderRouteCard, PlaceOrderTerminalOrderEvent, PlaceOrderTradingLabels, PlaceOrderVenueOutcome, ResolvePlaceOrderQuoteResultParams, ResolvePlaceOrderQuoteStatusParams, ResolvePlaceOrderTabKeyParams } from "./index.place-order.types";
 export declare const extractGeoBlockedVenues: (warnings: SmartRouteResponse["warnings"]) => Set<string>;
 /** Pure helpers for PlaceOrder view-model shaping, formatting, and keyboard logic. */
 export declare const getPlaceOrderContainerClassName: () => string;
@@ -34,11 +34,7 @@ export declare const resolvePlaceOrderQuoteResult: ({ labels, quoteData, tradeSi
 export declare const sanitizePlaceOrderAmount: (value: number) => number;
 export declare const getTradingRoutePriceLabel: (value: number) => string;
 export declare const resolvePlaceOrderQuoteStatus: ({ amount, labels, quoteData, selectedMarket, }: ResolvePlaceOrderQuoteStatusParams) => PlaceOrderQuoteStatus;
-export declare const buildLiveRouteCards: ({ labels, quoteData, tradeSide, }: {
-    labels: PlaceOrderTradingLabels;
-    quoteData: SmartRouteResponse;
-    tradeSide: PlaceOrderTab;
-}) => PlaceOrderRouteCard[];
+export declare const buildLiveRouteCards: ({ labels, quoteData, tradeSide, eventVenues, }: BuildLiveRouteCardsParams) => PlaceOrderRouteCard[];
 export declare const resolveExecutionVenueFromQuote: (quoteData: SmartRouteResponse | null) => TradingVenue | undefined;
 export declare const resolvePlaceOrderSuccessTone: ({ outcomeIndex, tab, }: {
     outcomeIndex: number;
@@ -52,9 +48,10 @@ export declare const buildPlaceOrderExecutionStepGroups: ({ labels, orderId, quo
     submittedOrders?: WsOrderSubmitted[];
 }) => PlaceOrderExecutionStepGroup[];
 export declare const groupPlaceOrderFailureSteps: (steps: PlaceOrderFailureStep[]) => PlaceOrderFailureStep[][];
-export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ labels, summary, }: {
+export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ labels, summary, treatPartialAsComplete, }: {
     labels: PlaceOrderTradingLabels;
     summary: PlaceOrderFailureSummary;
+    treatPartialAsComplete?: boolean;
 }) => PlaceOrderExecutionStepGroup[];
 export declare const normalizePlaceOrderErrorMessage: ({ errorMessage, fallbackMessage, }: {
     errorMessage?: string | null;

package/dist/types/trading/place-order/index.place-order.utils.d.ts

@@ -1,6 +1,6 @@
 import type { SmartRouteResponse, WsOrderSubmitted } from "@agg-build/sdk";
 import { type PlaceOrderOutcome, type PlaceOrderRoutingRow, type PlaceOrderTab, type TradingVenue } from "../types";
-import type { PlaceOrderOutcomeClassNameParams, PlaceOrderExecutionStepGroup, PlaceOrderFailureStep, PlaceOrderFailureSummary, PlaceOrderOutcomeLabelValue, PlaceOrderQuoteResult, PlaceOrderQuoteStatus, PlaceOrderResultTone, PlaceOrderRouteCard, PlaceOrderTerminalOrderEvent, PlaceOrderTradingLabels, PlaceOrderVenueOutcome, ResolvePlaceOrderQuoteResultParams, ResolvePlaceOrderQuoteStatusParams, ResolvePlaceOrderTabKeyParams } from "./index.place-order.types";
+import type { BuildLiveRouteCardsParams, PlaceOrderOutcomeClassNameParams, PlaceOrderExecutionStepGroup, PlaceOrderFailureStep, PlaceOrderFailureSummary, PlaceOrderOutcomeLabelValue, PlaceOrderQuoteResult, PlaceOrderQuoteStatus, PlaceOrderResultTone, PlaceOrderRouteCard, PlaceOrderTerminalOrderEvent, PlaceOrderTradingLabels, PlaceOrderVenueOutcome, ResolvePlaceOrderQuoteResultParams, ResolvePlaceOrderQuoteStatusParams, ResolvePlaceOrderTabKeyParams } from "./index.place-order.types";
 export declare const extractGeoBlockedVenues: (warnings: SmartRouteResponse["warnings"]) => Set<string>;
 /** Pure helpers for PlaceOrder view-model shaping, formatting, and keyboard logic. */
 export declare const getPlaceOrderContainerClassName: () => string;
@@ -34,11 +34,7 @@ export declare const resolvePlaceOrderQuoteResult: ({ labels, quoteData, tradeSi
 export declare const sanitizePlaceOrderAmount: (value: number) => number;
 export declare const getTradingRoutePriceLabel: (value: number) => string;
 export declare const resolvePlaceOrderQuoteStatus: ({ amount, labels, quoteData, selectedMarket, }: ResolvePlaceOrderQuoteStatusParams) => PlaceOrderQuoteStatus;
-export declare const buildLiveRouteCards: ({ labels, quoteData, tradeSide, }: {
-    labels: PlaceOrderTradingLabels;
-    quoteData: SmartRouteResponse;
-    tradeSide: PlaceOrderTab;
-}) => PlaceOrderRouteCard[];
+export declare const buildLiveRouteCards: ({ labels, quoteData, tradeSide, eventVenues, }: BuildLiveRouteCardsParams) => PlaceOrderRouteCard[];
 export declare const resolveExecutionVenueFromQuote: (quoteData: SmartRouteResponse | null) => TradingVenue | undefined;
 export declare const resolvePlaceOrderSuccessTone: ({ outcomeIndex, tab, }: {
     outcomeIndex: number;
@@ -52,9 +48,10 @@ export declare const buildPlaceOrderExecutionStepGroups: ({ labels, orderId, quo
     submittedOrders?: WsOrderSubmitted[];
 }) => PlaceOrderExecutionStepGroup[];
 export declare const groupPlaceOrderFailureSteps: (steps: PlaceOrderFailureStep[]) => PlaceOrderFailureStep[][];
-export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ labels, summary, }: {
+export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ labels, summary, treatPartialAsComplete, }: {
     labels: PlaceOrderTradingLabels;
     summary: PlaceOrderFailureSummary;
+    treatPartialAsComplete?: boolean;
 }) => PlaceOrderExecutionStepGroup[];
 export declare const normalizePlaceOrderErrorMessage: ({ errorMessage, fallbackMessage, }: {
     errorMessage?: string | null;

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

@@ -1,6 +1,6 @@
 import type { WithdrawModalProps } from "./withdraw-modal.types";
-export type { WithdrawMethod, WithdrawModalProps, WithdrawFlowData } from "./withdraw-modal.types";
+export type { WithdrawMethod, WithdrawModalControlledProps, WithdrawModalProps, WithdrawModalSelfDrivenProps, WithdrawFlowData, WithdrawSummary, } from "./withdraw-modal.types";
 export declare const WithdrawModal: {
-    ({ open, onOpenChange, withdrawFlow, onSelectWithdrawMethod, onWithdrawAmountChange, onWithdrawCurrencyChange, onWithdrawTokenChange, onWithdrawNetworkChange, onGetWithdrawQuotes, onSelectWithdrawProvider, onDoneWithdraw, }: WithdrawModalProps): JSX.Element;
+    (props: WithdrawModalProps): JSX.Element;
     displayName: string;
 };

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

@@ -1,6 +1,6 @@
 import type { WithdrawModalProps } from "./withdraw-modal.types";
-export type { WithdrawMethod, WithdrawModalProps, WithdrawFlowData } from "./withdraw-modal.types";
+export type { WithdrawMethod, WithdrawModalControlledProps, WithdrawModalProps, WithdrawModalSelfDrivenProps, WithdrawFlowData, WithdrawSummary, } from "./withdraw-modal.types";
 export declare const WithdrawModal: {
-    ({ open, onOpenChange, withdrawFlow, onSelectWithdrawMethod, onWithdrawAmountChange, onWithdrawCurrencyChange, onWithdrawTokenChange, onWithdrawNetworkChange, onGetWithdrawQuotes, onSelectWithdrawProvider, onDoneWithdraw, }: WithdrawModalProps): JSX.Element;
+    (props: WithdrawModalProps): JSX.Element;
     displayName: string;
 };

package/dist/types/withdraw/steps/withdraw-amount.d.mts

@@ -1,17 +1,20 @@
 import type { WithdrawSelectOption } from "../withdraw-modal.types";
 export interface WithdrawAmountStepProps {
     amount: string;
-    currency: string;
     destinationWallet: string;
+    balanceDisplay: string;
     tokenOptions: WithdrawSelectOption[];
     networkOptions: WithdrawSelectOption[];
     selectedToken: string;
     selectedNetwork: string;
+    isConfirming?: boolean;
+    error?: string | null;
     onBack: () => void;
     onAmountChange: (amount: string) => void;
-    onCurrencyChange: (currency: string) => void;
+    onDestinationChange: (address: string) => void;
     onTokenChange: (token: string) => void;
     onNetworkChange: (network: string) => void;
+    onMaxClick?: () => void;
     onContinue: () => void;
 }
-export declare const WithdrawAmountStep: ({ amount, currency, destinationWallet, tokenOptions, networkOptions, selectedToken, selectedNetwork, onBack, onAmountChange, onCurrencyChange, onTokenChange, onNetworkChange, onContinue, }: WithdrawAmountStepProps) => JSX.Element;
+export declare const WithdrawAmountStep: ({ amount, destinationWallet, balanceDisplay, tokenOptions, networkOptions, selectedToken, selectedNetwork, isConfirming, error, onBack, onAmountChange, onDestinationChange, onTokenChange, onNetworkChange, onMaxClick, onContinue, }: WithdrawAmountStepProps) => JSX.Element;

package/dist/types/withdraw/steps/withdraw-amount.d.ts

@@ -1,17 +1,20 @@
 import type { WithdrawSelectOption } from "../withdraw-modal.types";
 export interface WithdrawAmountStepProps {
     amount: string;
-    currency: string;
     destinationWallet: string;
+    balanceDisplay: string;
     tokenOptions: WithdrawSelectOption[];
     networkOptions: WithdrawSelectOption[];
     selectedToken: string;
     selectedNetwork: string;
+    isConfirming?: boolean;
+    error?: string | null;
     onBack: () => void;
     onAmountChange: (amount: string) => void;
-    onCurrencyChange: (currency: string) => void;
+    onDestinationChange: (address: string) => void;
     onTokenChange: (token: string) => void;
     onNetworkChange: (network: string) => void;
+    onMaxClick?: () => void;
     onContinue: () => void;
 }
-export declare const WithdrawAmountStep: ({ amount, currency, destinationWallet, tokenOptions, networkOptions, selectedToken, selectedNetwork, onBack, onAmountChange, onCurrencyChange, onTokenChange, onNetworkChange, onContinue, }: WithdrawAmountStepProps) => JSX.Element;
+export declare const WithdrawAmountStep: ({ amount, destinationWallet, balanceDisplay, tokenOptions, networkOptions, selectedToken, selectedNetwork, isConfirming, error, onBack, onAmountChange, onDestinationChange, onTokenChange, onNetworkChange, onMaxClick, onContinue, }: WithdrawAmountStepProps) => JSX.Element;

package/dist/types/withdraw/steps/withdraw-success.d.mts

@@ -1,7 +1,14 @@
 import type { WithdrawSummary } from "../withdraw-modal.types";
 export interface WithdrawSuccessStepProps {
     summary: WithdrawSummary;
+    tokenSymbol: string;
+    /**
+     * The submitted withdrawal id. When non-null the success step subscribes to
+     * `withdrawal_lifecycle` WS events and renders live progress; when null it
+     * falls back to the static "submitted" copy.
+     */
+    withdrawalId: string | null;
     onDone: () => void;
     onClose: () => void;
 }
-export declare const WithdrawSuccessStep: ({ summary, onDone, onClose, }: WithdrawSuccessStepProps) => JSX.Element;
+export declare const WithdrawSuccessStep: ({ summary, tokenSymbol, withdrawalId, onDone, onClose, }: WithdrawSuccessStepProps) => JSX.Element;

package/dist/types/withdraw/steps/withdraw-success.d.ts

@@ -1,7 +1,14 @@
 import type { WithdrawSummary } from "../withdraw-modal.types";
 export interface WithdrawSuccessStepProps {
     summary: WithdrawSummary;
+    tokenSymbol: string;
+    /**
+     * The submitted withdrawal id. When non-null the success step subscribes to
+     * `withdrawal_lifecycle` WS events and renders live progress; when null it
+     * falls back to the static "submitted" copy.
+     */
+    withdrawalId: string | null;
     onDone: () => void;
     onClose: () => void;
 }
-export declare const WithdrawSuccessStep: ({ summary, onDone, onClose, }: WithdrawSuccessStepProps) => JSX.Element;
+export declare const WithdrawSuccessStep: ({ summary, tokenSymbol, withdrawalId, onDone, onClose, }: WithdrawSuccessStepProps) => JSX.Element;

package/dist/types/withdraw/steps/withdraw-success.utils.d.mts

@@ -0,0 +1,36 @@
+import type { WsWithdrawalLifecycleLeg, WsWithdrawalLifecycleStatus } from "@agg-build/sdk";
+import type { AggUiLabels } from "@agg-build/hooks";
+/**
+ * Visual tone for a single lifecycle step row. Mirrors the place-order
+ * success/in-flight timeline so the two flows feel identical to users.
+ */
+export type WithdrawalLifecycleStepStatus = "pending" | "complete" | "warning" | "error";
+export interface WithdrawalLifecycleStep {
+    id: string;
+    label: string;
+    status: WithdrawalLifecycleStepStatus;
+}
+export type WithdrawalLifecycleStepGroup = WithdrawalLifecycleStep[];
+export declare const resolveChainLabel: (chainId: number) => string;
+export interface BuildLifecycleStepsParams {
+    pending: boolean;
+    status: WsWithdrawalLifecycleStatus | null;
+    legs: WsWithdrawalLifecycleLeg[];
+    walletFlowLabels: AggUiLabels["withdraw"]["walletFlow"];
+}
+export interface BuildLifecycleStepsResult {
+    groups: WithdrawalLifecycleStepGroup[];
+    finalStep: WithdrawalLifecycleStep;
+    hasDetails: boolean;
+}
+/**
+ * Builds the timeline groups + final summary row consumed by the success
+ * step's collapsible execution timeline. Returns the same shape the
+ * place-order flow produces, so the two share visual structure verbatim.
+ *
+ * - Each leg becomes one row in the first (and only) group.
+ * - The final row (always rendered, optionally collapsing the group above)
+ *   reflects the *top-level* lifecycle status — "Bridging funds across
+ *   chains…", "Withdrawal complete.", etc.
+ */
+export declare const buildWithdrawalLifecycleSteps: ({ pending, status, legs, walletFlowLabels, }: BuildLifecycleStepsParams) => BuildLifecycleStepsResult;

package/dist/types/withdraw/steps/withdraw-success.utils.d.ts

@@ -0,0 +1,36 @@
+import type { WsWithdrawalLifecycleLeg, WsWithdrawalLifecycleStatus } from "@agg-build/sdk";
+import type { AggUiLabels } from "@agg-build/hooks";
+/**
+ * Visual tone for a single lifecycle step row. Mirrors the place-order
+ * success/in-flight timeline so the two flows feel identical to users.
+ */
+export type WithdrawalLifecycleStepStatus = "pending" | "complete" | "warning" | "error";
+export interface WithdrawalLifecycleStep {
+    id: string;
+    label: string;
+    status: WithdrawalLifecycleStepStatus;
+}
+export type WithdrawalLifecycleStepGroup = WithdrawalLifecycleStep[];
+export declare const resolveChainLabel: (chainId: number) => string;
+export interface BuildLifecycleStepsParams {
+    pending: boolean;
+    status: WsWithdrawalLifecycleStatus | null;
+    legs: WsWithdrawalLifecycleLeg[];
+    walletFlowLabels: AggUiLabels["withdraw"]["walletFlow"];
+}
+export interface BuildLifecycleStepsResult {
+    groups: WithdrawalLifecycleStepGroup[];
+    finalStep: WithdrawalLifecycleStep;
+    hasDetails: boolean;
+}
+/**
+ * Builds the timeline groups + final summary row consumed by the success
+ * step's collapsible execution timeline. Returns the same shape the
+ * place-order flow produces, so the two share visual structure verbatim.
+ *
+ * - Each leg becomes one row in the first (and only) group.
+ * - The final row (always rendered, optionally collapsing the group above)
+ *   reflects the *top-level* lifecycle status — "Bridging funds across
+ *   chains…", "Withdrawal complete.", etc.
+ */
+export declare const buildWithdrawalLifecycleSteps: ({ pending, status, legs, walletFlowLabels, }: BuildLifecycleStepsParams) => BuildLifecycleStepsResult;