@agg-build/ui 4.0.0 → 4.4.0

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

@@ -1,81 +1,46 @@
-import type { DagStepProgress } from "@agg-build/hooks";
-import type { TradingVenue } from "../types";
-import type { PlaceOrderSubmissionProgressPhase, PlaceOrderTradingLabels } from "./index.place-order.types";
-/**
- * Stable, user-facing phases for the in-flight Place Order submission UI.
- *
- * The DAG executor emits many granular step types (`bridge-fetch-quote`,
- * `polymarket-setup-resolve-need`, `submit-verify-order-status`, etc.) that
- * are an implementation detail of how a route is fulfilled. Surfacing them
- * directly produces noisy, confusing progress and leaks internal architecture
- * to partners. We collapse every raw step into one of a small, fixed set of
- * normalized phases here, then drive rendering off the normalized model.
- *
- * Anything not in this list (bridge, ata, approve, swap, transfer, position,
- * polymarket-setup, hl-fund, wait sentinels) maps to either `checking-balance`
- * (read-only probes) or `submitting`.
- */
-export type NormalizedExecutionPhaseKind = "finding-route" | "checking-balance" | "submitting" | "wallet-confirm" | "executing-venue" | "filled" | "failed";
-export type NormalizedExecutionPhase = {
-    kind: NormalizedExecutionPhaseKind;
-    /** Set when the phase is venue-scoped — `executing-venue` and finalize legs. */
-    venue?: TradingVenue;
+import type { ExecutionRawStepProgress, ExecutionTerminalOrderEvent } from "@agg-build/hooks";
+import type { ExecutionStatusOrder, ExecutionStatusStep, SmartRouteResponse } from "@agg-build/sdk";
+import { type PlaceOrderTab, type TradingVenue } from "../types";
+import type { PlaceOrderTradingLabels } from "./index.place-order.types";
+export type ExecutionStepStatus = "not-started" | "loading" | "done" | "warning" | "failed";
+export type ExecutionStepKind = "submit" | "setup" | "bridge" | "fill";
+export type ExecutionStep = {
+    id: string;
+    kind: ExecutionStepKind;
+    pendingLabel: string;
+    completedLabel: string;
+    status: ExecutionStepStatus;
 };
-export type SubmissionDisplayRow = {
+export type ExecutionOrderGroup = {
     id: string;
-    label: string;
-    status: "pending" | "complete";
     venue?: TradingVenue;
+    venueLabel: string;
+    priceLabel: string;
+    amountLabel: string;
+    steps: ExecutionStep[];
 };
-/**
- * Classify a raw DAG step type into the normalized phase it represents.
- *
- * Returns `null` for wait sentinels and unrecognized step types — the caller
- * should skip these so they don't introduce a fake "Wait" or `Step N of M`
- * row in the UI.
- */
-export declare const classifyExecutionStepType: (stepType: string) => NormalizedExecutionPhase | null;
-type PhaseTimelineEntry = NormalizedExecutionPhase & {
-    firstSeq: number;
-    lastSeq: number;
-    allCompleted: boolean;
-};
-/**
- * Walk the DAG sequences in order, classify each, and merge consecutive
- * entries that share the same kind+venue. The result is the
- * presentation-layer timeline of high-level phases.
- *
- * A merged entry is `allCompleted` only when every underlying sequence has
- * finished — so a single in-flight `bridge-submit` keeps the merged
- * "submitting" row pending even if `bridge-fetch-quote` already completed.
- *
- * Post-pass: the DAG only emits `step_completed` for a subset of sequences
- * (record-state steps, position-reserve, etc.) — sub-steps like
- * `polymarket-deposit-wallet-submit` and `wait` never report completion
- * individually. That means a merged "submitting" block can stay
- * `allCompleted=false` forever even after the executor has moved on to a
- * later block. To preserve the "only the last visible row is pending"
- * invariant, force-complete any block that has any later block with at
- * least one completed sequence.
- */
-export declare const buildPhaseTimeline: (dag: DagStepProgress) => PhaseTimelineEntry[];
-export type BuildSubmissionDisplayRowsArgs = {
-    phase: PlaceOrderSubmissionProgressPhase;
-    dagProgress: DagStepProgress | null | undefined;
-    executionVenue?: TradingVenue;
-    /** Whether the active submitting beat is waiting on a wallet signature. */
-    isAwaitingWalletConfirmation?: boolean;
+export type DeriveExecutionOrderGroupsArgs = {
+    quoteData: SmartRouteResponse;
     labels: PlaceOrderTradingLabels;
+    tradeSide: PlaceOrderTab;
+    hasSubmissionResponse: boolean;
+    executionSteps?: ExecutionStatusStep[];
+    executionOrders?: ExecutionStatusOrder[];
+    rawExecutionSteps?: ExecutionRawStepProgress[];
+    terminalOrderEvents?: ExecutionTerminalOrderEvent[];
+    forceCompleted?: boolean;
+};
+export declare const deriveExecutionOrderGroups: ({ quoteData, labels, tradeSide, hasSubmissionResponse, executionSteps, executionOrders, rawExecutionSteps, terminalOrderEvents, forceCompleted, }: DeriveExecutionOrderGroupsArgs) => ExecutionOrderGroup[];
+export declare const flattenExecutionSteps: (groups: ExecutionOrderGroup[]) => ExecutionStep[];
+export type CalculateExecutionProgressArgs = {
+    orderIds: string[];
+    submittedOrderIds?: string[];
+    executionSteps?: ExecutionStatusStep[];
+    executionOrders?: ExecutionStatusOrder[];
+    minimumProgress?: number;
 };
 /**
- * Produce the rows the in-flight Place Order surface should render.
- *
- * Invariants:
- *   - At most one row has status `pending`.
- *   - Completed rows are kept only when they correspond to a meaningful
- *     user-facing milestone (the normalized phases above).
- *   - The same kind+venue never appears twice — repeated `step_started` /
- *     `step_waiting` events on the same phase don't duplicate rows.
+ * Fixed-weight execution progress from canonical backend milestones.
+ * Display-only substeps can grow without changing the 20/20/20/40 denominator.
  */
-export declare const buildSubmissionDisplayRows: ({ phase, dagProgress, executionVenue, isAwaitingWalletConfirmation, labels, }: BuildSubmissionDisplayRowsArgs) => SubmissionDisplayRow[];
-export {};
+export declare const calculateExecutionProgress: ({ orderIds, submittedOrderIds, executionSteps, executionOrders, minimumProgress, }: CalculateExecutionProgressArgs) => number;

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

@@ -1,81 +1,46 @@
-import type { DagStepProgress } from "@agg-build/hooks";
-import type { TradingVenue } from "../types";
-import type { PlaceOrderSubmissionProgressPhase, PlaceOrderTradingLabels } from "./index.place-order.types";
-/**
- * Stable, user-facing phases for the in-flight Place Order submission UI.
- *
- * The DAG executor emits many granular step types (`bridge-fetch-quote`,
- * `polymarket-setup-resolve-need`, `submit-verify-order-status`, etc.) that
- * are an implementation detail of how a route is fulfilled. Surfacing them
- * directly produces noisy, confusing progress and leaks internal architecture
- * to partners. We collapse every raw step into one of a small, fixed set of
- * normalized phases here, then drive rendering off the normalized model.
- *
- * Anything not in this list (bridge, ata, approve, swap, transfer, position,
- * polymarket-setup, hl-fund, wait sentinels) maps to either `checking-balance`
- * (read-only probes) or `submitting`.
- */
-export type NormalizedExecutionPhaseKind = "finding-route" | "checking-balance" | "submitting" | "wallet-confirm" | "executing-venue" | "filled" | "failed";
-export type NormalizedExecutionPhase = {
-    kind: NormalizedExecutionPhaseKind;
-    /** Set when the phase is venue-scoped — `executing-venue` and finalize legs. */
-    venue?: TradingVenue;
+import type { ExecutionRawStepProgress, ExecutionTerminalOrderEvent } from "@agg-build/hooks";
+import type { ExecutionStatusOrder, ExecutionStatusStep, SmartRouteResponse } from "@agg-build/sdk";
+import { type PlaceOrderTab, type TradingVenue } from "../types";
+import type { PlaceOrderTradingLabels } from "./index.place-order.types";
+export type ExecutionStepStatus = "not-started" | "loading" | "done" | "warning" | "failed";
+export type ExecutionStepKind = "submit" | "setup" | "bridge" | "fill";
+export type ExecutionStep = {
+    id: string;
+    kind: ExecutionStepKind;
+    pendingLabel: string;
+    completedLabel: string;
+    status: ExecutionStepStatus;
 };
-export type SubmissionDisplayRow = {
+export type ExecutionOrderGroup = {
     id: string;
-    label: string;
-    status: "pending" | "complete";
     venue?: TradingVenue;
+    venueLabel: string;
+    priceLabel: string;
+    amountLabel: string;
+    steps: ExecutionStep[];
 };
-/**
- * Classify a raw DAG step type into the normalized phase it represents.
- *
- * Returns `null` for wait sentinels and unrecognized step types — the caller
- * should skip these so they don't introduce a fake "Wait" or `Step N of M`
- * row in the UI.
- */
-export declare const classifyExecutionStepType: (stepType: string) => NormalizedExecutionPhase | null;
-type PhaseTimelineEntry = NormalizedExecutionPhase & {
-    firstSeq: number;
-    lastSeq: number;
-    allCompleted: boolean;
-};
-/**
- * Walk the DAG sequences in order, classify each, and merge consecutive
- * entries that share the same kind+venue. The result is the
- * presentation-layer timeline of high-level phases.
- *
- * A merged entry is `allCompleted` only when every underlying sequence has
- * finished — so a single in-flight `bridge-submit` keeps the merged
- * "submitting" row pending even if `bridge-fetch-quote` already completed.
- *
- * Post-pass: the DAG only emits `step_completed` for a subset of sequences
- * (record-state steps, position-reserve, etc.) — sub-steps like
- * `polymarket-deposit-wallet-submit` and `wait` never report completion
- * individually. That means a merged "submitting" block can stay
- * `allCompleted=false` forever even after the executor has moved on to a
- * later block. To preserve the "only the last visible row is pending"
- * invariant, force-complete any block that has any later block with at
- * least one completed sequence.
- */
-export declare const buildPhaseTimeline: (dag: DagStepProgress) => PhaseTimelineEntry[];
-export type BuildSubmissionDisplayRowsArgs = {
-    phase: PlaceOrderSubmissionProgressPhase;
-    dagProgress: DagStepProgress | null | undefined;
-    executionVenue?: TradingVenue;
-    /** Whether the active submitting beat is waiting on a wallet signature. */
-    isAwaitingWalletConfirmation?: boolean;
+export type DeriveExecutionOrderGroupsArgs = {
+    quoteData: SmartRouteResponse;
     labels: PlaceOrderTradingLabels;
+    tradeSide: PlaceOrderTab;
+    hasSubmissionResponse: boolean;
+    executionSteps?: ExecutionStatusStep[];
+    executionOrders?: ExecutionStatusOrder[];
+    rawExecutionSteps?: ExecutionRawStepProgress[];
+    terminalOrderEvents?: ExecutionTerminalOrderEvent[];
+    forceCompleted?: boolean;
+};
+export declare const deriveExecutionOrderGroups: ({ quoteData, labels, tradeSide, hasSubmissionResponse, executionSteps, executionOrders, rawExecutionSteps, terminalOrderEvents, forceCompleted, }: DeriveExecutionOrderGroupsArgs) => ExecutionOrderGroup[];
+export declare const flattenExecutionSteps: (groups: ExecutionOrderGroup[]) => ExecutionStep[];
+export type CalculateExecutionProgressArgs = {
+    orderIds: string[];
+    submittedOrderIds?: string[];
+    executionSteps?: ExecutionStatusStep[];
+    executionOrders?: ExecutionStatusOrder[];
+    minimumProgress?: number;
 };
 /**
- * Produce the rows the in-flight Place Order surface should render.
- *
- * Invariants:
- *   - At most one row has status `pending`.
- *   - Completed rows are kept only when they correspond to a meaningful
- *     user-facing milestone (the normalized phases above).
- *   - The same kind+venue never appears twice — repeated `step_started` /
- *     `step_waiting` events on the same phase don't duplicate rows.
+ * Fixed-weight execution progress from canonical backend milestones.
+ * Display-only substeps can grow without changing the 20/20/20/40 denominator.
  */
-export declare const buildSubmissionDisplayRows: ({ phase, dagProgress, executionVenue, isAwaitingWalletConfirmation, labels, }: BuildSubmissionDisplayRowsArgs) => SubmissionDisplayRow[];
-export {};
+export declare const calculateExecutionProgress: ({ orderIds, submittedOrderIds, executionSteps, executionOrders, minimumProgress, }: CalculateExecutionProgressArgs) => number;

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

@@ -0,0 +1,26 @@
+import type { ExecutionOrderGroup } from "./index.place-order.execution-steps";
+import type { PlaceOrderClassNames, PlaceOrderTradingLabels } from "./index.place-order.types";
+export type PlaceOrderExecutionHeaderProps = {
+    className?: string;
+    eventDateLabel?: string | null;
+    eventImage?: string | null;
+    eventTitle: string;
+};
+export declare const PlaceOrderExecutionHeader: ({ className, eventDateLabel, eventImage, eventTitle, }: PlaceOrderExecutionHeaderProps) => JSX.Element;
+export declare const PlaceOrderExecutionGroups: ({ enableAnimations, groups, labels, }: {
+    enableAnimations: boolean;
+    groups: ExecutionOrderGroup[];
+    labels: PlaceOrderTradingLabels;
+}) => JSX.Element;
+export type PlaceOrderExecutionViewProps = PlaceOrderExecutionHeaderProps & {
+    className?: string;
+    classNames?: PlaceOrderClassNames;
+    enableAnimations: boolean;
+    groups: ExecutionOrderGroup[];
+    labels: PlaceOrderTradingLabels;
+    progress: number;
+};
+export declare const PlaceOrderExecutionView: {
+    ({ className, classNames, enableAnimations, eventDateLabel, eventImage, eventTitle, groups, labels, progress, }: PlaceOrderExecutionViewProps): JSX.Element;
+    displayName: string;
+};

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

@@ -0,0 +1,26 @@
+import type { ExecutionOrderGroup } from "./index.place-order.execution-steps";
+import type { PlaceOrderClassNames, PlaceOrderTradingLabels } from "./index.place-order.types";
+export type PlaceOrderExecutionHeaderProps = {
+    className?: string;
+    eventDateLabel?: string | null;
+    eventImage?: string | null;
+    eventTitle: string;
+};
+export declare const PlaceOrderExecutionHeader: ({ className, eventDateLabel, eventImage, eventTitle, }: PlaceOrderExecutionHeaderProps) => JSX.Element;
+export declare const PlaceOrderExecutionGroups: ({ enableAnimations, groups, labels, }: {
+    enableAnimations: boolean;
+    groups: ExecutionOrderGroup[];
+    labels: PlaceOrderTradingLabels;
+}) => JSX.Element;
+export type PlaceOrderExecutionViewProps = PlaceOrderExecutionHeaderProps & {
+    className?: string;
+    classNames?: PlaceOrderClassNames;
+    enableAnimations: boolean;
+    groups: ExecutionOrderGroup[];
+    labels: PlaceOrderTradingLabels;
+    progress: number;
+};
+export declare const PlaceOrderExecutionView: {
+    ({ className, classNames, enableAnimations, eventDateLabel, eventImage, eventTitle, groups, labels, progress, }: PlaceOrderExecutionViewProps): JSX.Element;
+    displayName: string;
+};

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

@@ -2,6 +2,7 @@ import type { AggUiLabels, DagStepProgress, EventTradingState, UseMidpointsResul
 import type { ExecutionMode, PlaceLimitOrderParams, SmartRouteResponse } from "@agg-build/sdk";
 import type { KalshiCredentials } from "../../onboarding/onboarding-modal.types";
 import type { PlaceOrderRoutingRow, PlaceOrderStatus, PlaceOrderTab, TradingVenue } from "../types";
+import type { ExecutionOrderGroup } from "./index.place-order.execution-steps";
 export type PlaceOrderProps = {
     /** Custom class name applied to the place-order root. */
     className?: string;
@@ -80,6 +81,8 @@ export type PlaceOrderProps = {
     onExecutionStateChange?: (state: PlaceOrderSubmissionProgressState) => void;
     /** Optional resolved-event claim summary shown in read-only state. */
     resolvedClaim?: PlaceOrderResolvedClaimSummary;
+    /** Render the settlement-pending state for a closed recurring market. */
+    showResolvingState?: boolean;
     /** Pre-fetched midpoint data (best price included) passed from parent. Optional for backward compatibility. */
     midpointsResult?: UseMidpointsResult;
 };
@@ -209,6 +212,14 @@ export type PlaceOrderFailureSummary = {
     eventSubtitle?: string;
     eventTitle: string;
     kind: PlaceOrderFailureKind;
+    /** Failed venue to pin when retrying the unfilled remainder of a split route. */
+    retryVenue?: TradingVenue;
+    executionGroups?: ExecutionOrderGroup[];
+    result?: {
+        averagePriceLabel: string;
+        filledAmountLabel: string;
+        payoutLabel: string;
+    };
     steps: PlaceOrderFailureStep[];
 };
 export type ResolvePlaceOrderQuoteResultParams = {
@@ -236,6 +247,7 @@ export type ResolvePlaceOrderTabKeyParams = {
 export type PlaceOrderQuoteStatus = PlaceOrderStatus | undefined;
 export type PlaceOrderSubmissionProgressPhase = "finding-route" | "submitting" | "executing" | "success" | "failed";
 export type PlaceOrderExecutionSummary = {
+    resultState?: "success" | "partial";
     tradeSide?: PlaceOrderTab;
     shares: string;
     avgPrice: string;
@@ -248,6 +260,8 @@ export type PlaceOrderExecutionSummary = {
     amountLabel?: string;
     toWinLabel?: string;
     potentialReturnLabel?: string;
+    requestedAmountLabel?: string;
+    executionGroups?: ExecutionOrderGroup[];
     executionStepGroups?: PlaceOrderExecutionStepGroup[];
     shareText?: string;
 };
@@ -258,6 +272,7 @@ export type PlaceOrderSubmissionProgressState = {
     orderId?: string;
     orderIds?: string[];
     quoteId?: string;
+    quoteData?: SmartRouteResponse;
     phase: PlaceOrderSubmissionProgressPhase;
     summary?: PlaceOrderExecutionSummary;
     dagProgress?: DagStepProgress | null;

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

@@ -2,6 +2,7 @@ import type { AggUiLabels, DagStepProgress, EventTradingState, UseMidpointsResul
 import type { ExecutionMode, PlaceLimitOrderParams, SmartRouteResponse } from "@agg-build/sdk";
 import type { KalshiCredentials } from "../../onboarding/onboarding-modal.types";
 import type { PlaceOrderRoutingRow, PlaceOrderStatus, PlaceOrderTab, TradingVenue } from "../types";
+import type { ExecutionOrderGroup } from "./index.place-order.execution-steps";
 export type PlaceOrderProps = {
     /** Custom class name applied to the place-order root. */
     className?: string;
@@ -80,6 +81,8 @@ export type PlaceOrderProps = {
     onExecutionStateChange?: (state: PlaceOrderSubmissionProgressState) => void;
     /** Optional resolved-event claim summary shown in read-only state. */
     resolvedClaim?: PlaceOrderResolvedClaimSummary;
+    /** Render the settlement-pending state for a closed recurring market. */
+    showResolvingState?: boolean;
     /** Pre-fetched midpoint data (best price included) passed from parent. Optional for backward compatibility. */
     midpointsResult?: UseMidpointsResult;
 };
@@ -209,6 +212,14 @@ export type PlaceOrderFailureSummary = {
     eventSubtitle?: string;
     eventTitle: string;
     kind: PlaceOrderFailureKind;
+    /** Failed venue to pin when retrying the unfilled remainder of a split route. */
+    retryVenue?: TradingVenue;
+    executionGroups?: ExecutionOrderGroup[];
+    result?: {
+        averagePriceLabel: string;
+        filledAmountLabel: string;
+        payoutLabel: string;
+    };
     steps: PlaceOrderFailureStep[];
 };
 export type ResolvePlaceOrderQuoteResultParams = {
@@ -236,6 +247,7 @@ export type ResolvePlaceOrderTabKeyParams = {
 export type PlaceOrderQuoteStatus = PlaceOrderStatus | undefined;
 export type PlaceOrderSubmissionProgressPhase = "finding-route" | "submitting" | "executing" | "success" | "failed";
 export type PlaceOrderExecutionSummary = {
+    resultState?: "success" | "partial";
     tradeSide?: PlaceOrderTab;
     shares: string;
     avgPrice: string;
@@ -248,6 +260,8 @@ export type PlaceOrderExecutionSummary = {
     amountLabel?: string;
     toWinLabel?: string;
     potentialReturnLabel?: string;
+    requestedAmountLabel?: string;
+    executionGroups?: ExecutionOrderGroup[];
     executionStepGroups?: PlaceOrderExecutionStepGroup[];
     shareText?: string;
 };
@@ -258,6 +272,7 @@ export type PlaceOrderSubmissionProgressState = {
     orderId?: string;
     orderIds?: string[];
     quoteId?: string;
+    quoteData?: SmartRouteResponse;
     phase: PlaceOrderSubmissionProgressPhase;
     summary?: PlaceOrderExecutionSummary;
     dagProgress?: DagStepProgress | null;

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

@@ -2,6 +2,12 @@ import type { VenueMarket, VenueSellQuoteRequest } from "@agg-build/hooks";
 import type { SmartRouteResponse, WsOrderSubmitted } from "@agg-build/sdk";
 import { type PlaceOrderOutcome, type PlaceOrderRoutingRow, type PlaceOrderTab, type TradingVenue } from "../types";
 import type { BuildLiveRouteCardsParams, PlaceOrderOutcomeClassNameParams, PlaceOrderExecutionStepGroup, PlaceOrderFailureStep, PlaceOrderFailureSummary, PlaceOrderOutcomeLabelValue, PlaceOrderLimitVenueOption, PlaceOrderQuoteResult, PlaceOrderQuoteStatus, PlaceOrderResultTone, PlaceOrderRouteCard, PlaceOrderTerminalOrderEvent, PlaceOrderTradingLabels, PlaceOrderVenueOutcome, ResolvePlaceOrderQuoteResultParams, ResolvePlaceOrderQuoteStatusParams, ResolvePlaceOrderTabKeyParams } from "./index.place-order.types";
+export declare const getPlaceOrderAverageExecutionPrice: (quoteData: SmartRouteResponse | null | undefined) => number | null;
+export declare const isPlaceOrderAveragePriceWorse: ({ averageExecutionPrice, displayedMarketPrice, tradeSide, }: {
+    averageExecutionPrice: number | null | undefined;
+    displayedMarketPrice: number | null | undefined;
+    tradeSide: PlaceOrderTab;
+}) => boolean;
 export declare const floorToDecimals: (value: number, decimals: number) => number;
 export declare const formatFlooredShareAmount: (value: number, decimals: number) => string;
 export declare const buildLimitOrderVenueOptions: ({ currentPrices, livePrices, market, selectedOutcomeId, }: {
@@ -13,7 +19,6 @@ export declare const buildLimitOrderVenueOptions: ({ currentPrices, livePrices,
 export declare const resolveAutomaticLimitOrderVenueOption: (options: PlaceOrderLimitVenueOption[], side: PlaceOrderTab) => PlaceOrderLimitVenueOption | null;
 export declare const extractGeoBlockedVenues: (warnings: SmartRouteResponse["warnings"]) => Set<string>;
 export declare const getSmartRouteTotalFees: (feeBreakdown: SmartRouteResponse["feeBreakdown"]) => number | null;
-export declare const hasLowLiquidityWarning: (warnings: SmartRouteResponse["warnings"]) => boolean;
 /** Pure helpers for PlaceOrder view-model shaping, formatting, and keyboard logic. */
 export declare const getPlaceOrderContainerClassName: () => string;
 export declare const getResultValueClassName: (tone: PlaceOrderResultTone) => string;
@@ -57,6 +62,8 @@ export declare const buildLiveRouteCards: ({ labels, quoteData, tradeSide, event
  * Kalshi-funded user with no on-chain balance lands on a submittable route.
  */
 export declare const resolveDefaultRouteCardId: (routeCards: PlaceOrderRouteCard[], primaryStatus?: SmartRouteResponse["status"]) => string | null;
+/** Stable identity for preserving only an explicit venue choice across quote-ID refreshes. */
+export declare const getPlaceOrderRouteCardIdentity: (card: PlaceOrderRouteCard) => string;
 export declare const clampSellSharesToAvailability: (requestedSellShares: number, availableShares: number) => number;
 export declare const hasInsufficientVenueInventory: (requestedSellShares: number, availableShares: number) => boolean;
 export declare const getRemainingVenueSellShares: (availableShares: number, filledShares: number) => number;
@@ -147,6 +154,12 @@ export declare const getPlaceOrderUnfilledRemaining: ({ originalAmount, tradeSid
     tradeSide: PlaceOrderTab;
     terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
 }) => number;
+/** Returns null when successful legs omit the canonical units needed for a safe retry. */
+export declare const getCanonicalPlaceOrderUnfilledRemaining: ({ originalAmount, tradeSide, terminalOrderEvents, }: {
+    originalAmount: number;
+    tradeSide: PlaceOrderTab;
+    terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
+}) => number | null;
 export declare const buildPlaceOrderFailureSummary: ({ actionLabel, canRetryRemaining, errorMessage, eventImage, eventSubtitle, eventTitle, labels, orderId, quoteData, submittedOrders, terminalOrderEvents, }: {
     actionLabel: string;
     canRetryRemaining?: boolean;

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

@@ -2,6 +2,12 @@ import type { VenueMarket, VenueSellQuoteRequest } from "@agg-build/hooks";
 import type { SmartRouteResponse, WsOrderSubmitted } from "@agg-build/sdk";
 import { type PlaceOrderOutcome, type PlaceOrderRoutingRow, type PlaceOrderTab, type TradingVenue } from "../types";
 import type { BuildLiveRouteCardsParams, PlaceOrderOutcomeClassNameParams, PlaceOrderExecutionStepGroup, PlaceOrderFailureStep, PlaceOrderFailureSummary, PlaceOrderOutcomeLabelValue, PlaceOrderLimitVenueOption, PlaceOrderQuoteResult, PlaceOrderQuoteStatus, PlaceOrderResultTone, PlaceOrderRouteCard, PlaceOrderTerminalOrderEvent, PlaceOrderTradingLabels, PlaceOrderVenueOutcome, ResolvePlaceOrderQuoteResultParams, ResolvePlaceOrderQuoteStatusParams, ResolvePlaceOrderTabKeyParams } from "./index.place-order.types";
+export declare const getPlaceOrderAverageExecutionPrice: (quoteData: SmartRouteResponse | null | undefined) => number | null;
+export declare const isPlaceOrderAveragePriceWorse: ({ averageExecutionPrice, displayedMarketPrice, tradeSide, }: {
+    averageExecutionPrice: number | null | undefined;
+    displayedMarketPrice: number | null | undefined;
+    tradeSide: PlaceOrderTab;
+}) => boolean;
 export declare const floorToDecimals: (value: number, decimals: number) => number;
 export declare const formatFlooredShareAmount: (value: number, decimals: number) => string;
 export declare const buildLimitOrderVenueOptions: ({ currentPrices, livePrices, market, selectedOutcomeId, }: {
@@ -13,7 +19,6 @@ export declare const buildLimitOrderVenueOptions: ({ currentPrices, livePrices,
 export declare const resolveAutomaticLimitOrderVenueOption: (options: PlaceOrderLimitVenueOption[], side: PlaceOrderTab) => PlaceOrderLimitVenueOption | null;
 export declare const extractGeoBlockedVenues: (warnings: SmartRouteResponse["warnings"]) => Set<string>;
 export declare const getSmartRouteTotalFees: (feeBreakdown: SmartRouteResponse["feeBreakdown"]) => number | null;
-export declare const hasLowLiquidityWarning: (warnings: SmartRouteResponse["warnings"]) => boolean;
 /** Pure helpers for PlaceOrder view-model shaping, formatting, and keyboard logic. */
 export declare const getPlaceOrderContainerClassName: () => string;
 export declare const getResultValueClassName: (tone: PlaceOrderResultTone) => string;
@@ -57,6 +62,8 @@ export declare const buildLiveRouteCards: ({ labels, quoteData, tradeSide, event
  * Kalshi-funded user with no on-chain balance lands on a submittable route.
  */
 export declare const resolveDefaultRouteCardId: (routeCards: PlaceOrderRouteCard[], primaryStatus?: SmartRouteResponse["status"]) => string | null;
+/** Stable identity for preserving only an explicit venue choice across quote-ID refreshes. */
+export declare const getPlaceOrderRouteCardIdentity: (card: PlaceOrderRouteCard) => string;
 export declare const clampSellSharesToAvailability: (requestedSellShares: number, availableShares: number) => number;
 export declare const hasInsufficientVenueInventory: (requestedSellShares: number, availableShares: number) => boolean;
 export declare const getRemainingVenueSellShares: (availableShares: number, filledShares: number) => number;
@@ -147,6 +154,12 @@ export declare const getPlaceOrderUnfilledRemaining: ({ originalAmount, tradeSid
     tradeSide: PlaceOrderTab;
     terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
 }) => number;
+/** Returns null when successful legs omit the canonical units needed for a safe retry. */
+export declare const getCanonicalPlaceOrderUnfilledRemaining: ({ originalAmount, tradeSide, terminalOrderEvents, }: {
+    originalAmount: number;
+    tradeSide: PlaceOrderTab;
+    terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
+}) => number | null;
 export declare const buildPlaceOrderFailureSummary: ({ actionLabel, canRetryRemaining, errorMessage, eventImage, eventSubtitle, eventTitle, labels, orderId, quoteData, submittedOrders, terminalOrderEvents, }: {
     actionLabel: string;
     canRetryRemaining?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/ui",
-  "version": "4.0.0",
+  "version": "4.4.0",
   "description": "Pre-built React component library for the AGG prediction market aggregator. Tailwind-based, themeable, with primitives, event surfaces, trading flows, full pages, and modals.",
   "sideEffects": false,
   "license": "MIT",
@@ -100,8 +100,8 @@
     "liveline": "^0.0.7",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
-    "@agg-build/hooks": "^4.0.0",
-    "@agg-build/sdk": "^4.0.0"
+    "@agg-build/hooks": "^4.4.0",
+    "@agg-build/sdk": "^4.3.0"
   },
   "dependencies": {
     "@number-flow/react": "^0.6.0",