@agg-build/ui 4.0.0 → 4.2.0

package/dist/trading.mjs

@@ -2,6 +2,9 @@
 import {
   FundKalshiModal,
   PlaceOrder,
+  PlaceOrderExecutionGroups,
+  PlaceOrderExecutionHeader,
+  PlaceOrderExecutionView,
   PlaceOrderFailureView,
   PlaceOrderSuccessView,
   SettlementDetails,
@@ -9,7 +12,7 @@ import {
   parseVenue,
   useClaimWinnings,
   useResolvedMarketClaim
-} from "./chunk-XIDQ2A6W.mjs";
+} from "./chunk-DNPDXL2D.mjs";
 import {
   SETTLEMENT_SECTION_ID,
   Settlement,
@@ -27,12 +30,15 @@ import {
   prepareSettlementDifferences,
   resolveDifferenceIconClassName,
   useEventTradingContext
-} from "./chunk-VR5ZRDQT.mjs";
-import "./chunk-KX3TQ7WC.mjs";
-import "./chunk-KO6VTRV6.mjs";
+} from "./chunk-WDCH4RRS.mjs";
+import "./chunk-FTL25XKE.mjs";
+import "./chunk-QW7VFURU.mjs";
 export {
   FundKalshiModal,
   PlaceOrder,
+  PlaceOrderExecutionGroups,
+  PlaceOrderExecutionHeader,
+  PlaceOrderExecutionView,
   PlaceOrderFailureView,
   PlaceOrderSuccessView,
   SETTLEMENT_SECTION_ID,

package/dist/types/pages/user-profile/index.d.mts

@@ -4,6 +4,7 @@ export { USER_PROFILE_TAB_ACTIVITY, USER_PROFILE_TAB_OPEN_ORDERS, USER_PROFILE_T
 export type { UserProfileTabValue } from "./user-profile.constants";
 export { buildAggTxExplorerHref } from "./transaction-explorer";
 export { ManageBalancesModal } from "./components/manage-balances-modal";
+export declare const formatShareAmount: (value: number) => string;
 export declare const UserProfilePage: {
     ({ user, balanceChainsOverride, venueBalances: _venueBalances, balance, activePositions, closedPositions, activities, executionMode, onEditProfile, onDeposit, onWithdraw, openOrders, initialPositionFilter, tab, onTabChange, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onClaimResult, onClaimSubmitError, onActivityClick, getActivityHref, onOpenOrderClick, getOpenOrderHref, onCancelOrder, cancellingOrderIds, isLoadingPositions, isLoadingActivities, isLoadingOpenOrders, positionsError, activitiesError, openOrdersError, hasMoreActivePositions, isLoadingMoreActivePositions, onLoadMoreActivePositions, hasMoreClosedPositions, isLoadingMoreClosedPositions, onLoadMoreClosedPositions, onPositionFilterChange: onPositionFilterChangeProp, hasMoreActivities, isLoadingMoreActivities, onLoadMoreActivities, hasMoreOpenOrders, isLoadingMoreOpenOrders, onLoadMoreOpenOrders, classNames, onError, }: UserProfilePageProps & {
         onError?: (error: Error) => void;

package/dist/types/pages/user-profile/index.d.ts

@@ -4,6 +4,7 @@ export { USER_PROFILE_TAB_ACTIVITY, USER_PROFILE_TAB_OPEN_ORDERS, USER_PROFILE_T
 export type { UserProfileTabValue } from "./user-profile.constants";
 export { buildAggTxExplorerHref } from "./transaction-explorer";
 export { ManageBalancesModal } from "./components/manage-balances-modal";
+export declare const formatShareAmount: (value: number) => string;
 export declare const UserProfilePage: {
     ({ user, balanceChainsOverride, venueBalances: _venueBalances, balance, activePositions, closedPositions, activities, executionMode, onEditProfile, onDeposit, onWithdraw, openOrders, initialPositionFilter, tab, onTabChange, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onClaimResult, onClaimSubmitError, onActivityClick, getActivityHref, onOpenOrderClick, getOpenOrderHref, onCancelOrder, cancellingOrderIds, isLoadingPositions, isLoadingActivities, isLoadingOpenOrders, positionsError, activitiesError, openOrdersError, hasMoreActivePositions, isLoadingMoreActivePositions, onLoadMoreActivePositions, hasMoreClosedPositions, isLoadingMoreClosedPositions, onLoadMoreClosedPositions, onPositionFilterChange: onPositionFilterChangeProp, hasMoreActivities, isLoadingMoreActivities, onLoadMoreActivities, hasMoreOpenOrders, isLoadingMoreOpenOrders, onLoadMoreOpenOrders, classNames, onError, }: UserProfilePageProps & {
         onError?: (error: Error) => void;

package/dist/types/primitives/venue-logo/svg/logo-novig.d.mts

@@ -0,0 +1,24 @@
+import type { LogoIconProps } from "../logo-props";
+/**
+ * Novig's mark: a stylised "N" whose left stem is replaced by a dot — a
+ * diagonal stroke running top-left to bottom-right, a vertical stem on the
+ * right, and a round dot at lower-left. All three share one stroke weight and
+ * round caps.
+ *
+ * Geometry is MEASURED, not eyeballed. Blob bounds off the official 1024px
+ * asset put the N at x245..757 / y256..769 and the dot at x231..429 /
+ * y574..769; the dot's diameter (198px) equals the stroke weight, which the
+ * 192px favicon independently confirms (dot r16, stroke 32). Scaled to this
+ * 100-unit viewBox that gives stroke 19.3, cap centres at 34.7 and 65.4, and
+ * the dot at (32.2, 65.5) r9.65.
+ *
+ * Rendered as strokes rather than filled outlines so the shape stays editable
+ * and stays exactly one colour — the registry contract here is monochrome
+ * (see `logo-probable.tsx`), with `primaryColor` driven by `isColor`/`color`.
+ * The two-tone version (cream on #050505) is the CDN PNG used by the
+ * `variant="logo"` image path, not this component.
+ */
+export declare const LogoNovigIcon: {
+    ({ title, className, isColor, color, ...props }: LogoIconProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/venue-logo/svg/logo-novig.d.ts

@@ -0,0 +1,24 @@
+import type { LogoIconProps } from "../logo-props";
+/**
+ * Novig's mark: a stylised "N" whose left stem is replaced by a dot — a
+ * diagonal stroke running top-left to bottom-right, a vertical stem on the
+ * right, and a round dot at lower-left. All three share one stroke weight and
+ * round caps.
+ *
+ * Geometry is MEASURED, not eyeballed. Blob bounds off the official 1024px
+ * asset put the N at x245..757 / y256..769 and the dot at x231..429 /
+ * y574..769; the dot's diameter (198px) equals the stroke weight, which the
+ * 192px favicon independently confirms (dot r16, stroke 32). Scaled to this
+ * 100-unit viewBox that gives stroke 19.3, cap centres at 34.7 and 65.4, and
+ * the dot at (32.2, 65.5) r9.65.
+ *
+ * Rendered as strokes rather than filled outlines so the shape stays editable
+ * and stays exactly one colour — the registry contract here is monochrome
+ * (see `logo-probable.tsx`), with `primaryColor` driven by `isColor`/`color`.
+ * The two-tone version (cream on #050505) is the CDN PNG used by the
+ * `variant="logo"` image path, not this component.
+ */
+export declare const LogoNovigIcon: {
+    ({ title, className, isColor, color, ...props }: LogoIconProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/venue-logo/venue-logo.constants.d.mts

@@ -4,10 +4,10 @@ import type { VenueLogoName, VenueLogoProps } from "./venue-logo.types";
 type VenueLogoComponent = (props: LogoIconProps) => JSX.Element;
 export declare const venueLogoRegistry: Record<VenueLogoName, VenueLogoComponent>;
 export { DefaultVenueIcon };
+export declare const DEFAULT_VENUE_LOGO_URL = "https://assets.snagsolutions.io/public/prediction-markets/logos/default.png";
 export declare const venueLogoUrlRegistry: Record<VenueLogoName, string>;
 export declare const venueLogoLabels: Record<VenueLogoName, string>;
 export declare const DEFAULT_VENUE_LABEL = "Market";
-export declare const DEFAULT_VENUE_LOGO_URL = "https://assets.snagsolutions.io/public/prediction-markets/logos/default.png";
 export declare const venueLogoNames: VenueLogoName[];
 export declare const sizeClasses: Record<NonNullable<VenueLogoProps["size"]>, string>;
 type VenueLineColorTheme = "light" | "dark";

package/dist/types/primitives/venue-logo/venue-logo.constants.d.ts

@@ -4,10 +4,10 @@ import type { VenueLogoName, VenueLogoProps } from "./venue-logo.types";
 type VenueLogoComponent = (props: LogoIconProps) => JSX.Element;
 export declare const venueLogoRegistry: Record<VenueLogoName, VenueLogoComponent>;
 export { DefaultVenueIcon };
+export declare const DEFAULT_VENUE_LOGO_URL = "https://assets.snagsolutions.io/public/prediction-markets/logos/default.png";
 export declare const venueLogoUrlRegistry: Record<VenueLogoName, string>;
 export declare const venueLogoLabels: Record<VenueLogoName, string>;
 export declare const DEFAULT_VENUE_LABEL = "Market";
-export declare const DEFAULT_VENUE_LOGO_URL = "https://assets.snagsolutions.io/public/prediction-markets/logos/default.png";
 export declare const venueLogoNames: VenueLogoName[];
 export declare const sizeClasses: Record<NonNullable<VenueLogoProps["size"]>, string>;
 type VenueLineColorTheme = "light" | "dark";

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

@@ -3,6 +3,9 @@ export { PlaceOrderFailureView } from "./index.place-order.failure";
 export type { PlaceOrderFailureViewProps } from "./index.place-order.failure";
 export { PlaceOrderSuccessView } from "./index.place-order.success";
 export type { PlaceOrderSuccessViewProps } from "./index.place-order.success";
+export { PlaceOrderExecutionGroups, PlaceOrderExecutionHeader, PlaceOrderExecutionView, } from "./index.place-order.execution-view";
+export type { PlaceOrderExecutionViewProps } from "./index.place-order.execution-view";
+export type { ExecutionOrderGroup, ExecutionStep, ExecutionStepKind, ExecutionStepStatus, } from "./index.place-order.execution-steps";
 export type { PlaceOrderClassNames, PlaceOrderExecutionSummary, PlaceOrderResolvedClaimSummary, PlaceOrderTradingLabels, } from "./index.place-order.types";
 export declare const PlaceOrder: {
     ({ className, classNames, eventTradingState, executionMode, isLoading, isPrimaryActionDisabled, isPrimaryActionLoading, isQuotePanelActive, chainBalancesOverride, onAmountChange, onClose, onConnectKalshi, onOutcomeChange, onPrimaryAction, onBeforePrimaryAction, onTabChange, onSuccess, onError, onExecutionStateChange, resolvedClaim, midpointsResult, }: PlaceOrderProps): JSX.Element;

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

@@ -3,6 +3,9 @@ export { PlaceOrderFailureView } from "./index.place-order.failure";
 export type { PlaceOrderFailureViewProps } from "./index.place-order.failure";
 export { PlaceOrderSuccessView } from "./index.place-order.success";
 export type { PlaceOrderSuccessViewProps } from "./index.place-order.success";
+export { PlaceOrderExecutionGroups, PlaceOrderExecutionHeader, PlaceOrderExecutionView, } from "./index.place-order.execution-view";
+export type { PlaceOrderExecutionViewProps } from "./index.place-order.execution-view";
+export type { ExecutionOrderGroup, ExecutionStep, ExecutionStepKind, ExecutionStepStatus, } from "./index.place-order.execution-steps";
 export type { PlaceOrderClassNames, PlaceOrderExecutionSummary, PlaceOrderResolvedClaimSummary, PlaceOrderTradingLabels, } from "./index.place-order.types";
 export declare const PlaceOrder: {
     ({ className, classNames, eventTradingState, executionMode, isLoading, isPrimaryActionDisabled, isPrimaryActionLoading, isQuotePanelActive, chainBalancesOverride, onAmountChange, onClose, onConnectKalshi, onOutcomeChange, onPrimaryAction, onBeforePrimaryAction, onTabChange, onSuccess, onError, onExecutionStateChange, resolvedClaim, midpointsResult, }: PlaceOrderProps): JSX.Element;

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

@@ -1,81 +1,34 @@
-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";
+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;
 };
-/**
- * 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.
- */
-export declare const buildSubmissionDisplayRows: ({ phase, dagProgress, executionVenue, isAwaitingWalletConfirmation, labels, }: BuildSubmissionDisplayRowsArgs) => SubmissionDisplayRow[];
-export {};
+export declare const deriveExecutionOrderGroups: ({ quoteData, labels, tradeSide, hasSubmissionResponse, executionSteps, executionOrders, rawExecutionSteps, terminalOrderEvents, forceCompleted, }: DeriveExecutionOrderGroupsArgs) => ExecutionOrderGroup[];
+export declare const flattenExecutionSteps: (groups: ExecutionOrderGroup[]) => ExecutionStep[];

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

@@ -1,81 +1,34 @@
-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";
+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;
 };
-/**
- * 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.
- */
-export declare const buildSubmissionDisplayRows: ({ phase, dagProgress, executionVenue, isAwaitingWalletConfirmation, labels, }: BuildSubmissionDisplayRowsArgs) => SubmissionDisplayRow[];
-export {};
+export declare const deriveExecutionOrderGroups: ({ quoteData, labels, tradeSide, hasSubmissionResponse, executionSteps, executionOrders, rawExecutionSteps, terminalOrderEvents, forceCompleted, }: DeriveExecutionOrderGroupsArgs) => ExecutionOrderGroup[];
+export declare const flattenExecutionSteps: (groups: ExecutionOrderGroup[]) => ExecutionStep[];

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

@@ -0,0 +1,25 @@
+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;
+};
+export declare const PlaceOrderExecutionView: {
+    ({ className, classNames, enableAnimations, eventDateLabel, eventImage, eventTitle, groups, labels, }: PlaceOrderExecutionViewProps): JSX.Element;
+    displayName: string;
+};

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

@@ -0,0 +1,25 @@
+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;
+};
+export declare const PlaceOrderExecutionView: {
+    ({ className, classNames, enableAnimations, eventDateLabel, eventImage, eventTitle, groups, labels, }: 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;
@@ -209,6 +210,8 @@ export type PlaceOrderFailureSummary = {
     eventSubtitle?: string;
     eventTitle: string;
     kind: PlaceOrderFailureKind;
+    /** Failed venue to pin when retrying the unfilled remainder of a split route. */
+    retryVenue?: TradingVenue;
     steps: PlaceOrderFailureStep[];
 };
 export type ResolvePlaceOrderQuoteResultParams = {
@@ -248,6 +251,8 @@ export type PlaceOrderExecutionSummary = {
     amountLabel?: string;
     toWinLabel?: string;
     potentialReturnLabel?: string;
+    requestedAmountLabel?: string;
+    executionGroups?: ExecutionOrderGroup[];
     executionStepGroups?: PlaceOrderExecutionStepGroup[];
     shareText?: string;
 };
@@ -258,6 +263,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;
@@ -209,6 +210,8 @@ export type PlaceOrderFailureSummary = {
     eventSubtitle?: string;
     eventTitle: string;
     kind: PlaceOrderFailureKind;
+    /** Failed venue to pin when retrying the unfilled remainder of a split route. */
+    retryVenue?: TradingVenue;
     steps: PlaceOrderFailureStep[];
 };
 export type ResolvePlaceOrderQuoteResultParams = {
@@ -248,6 +251,8 @@ export type PlaceOrderExecutionSummary = {
     amountLabel?: string;
     toWinLabel?: string;
     potentialReturnLabel?: string;
+    requestedAmountLabel?: string;
+    executionGroups?: ExecutionOrderGroup[];
     executionStepGroups?: PlaceOrderExecutionStepGroup[];
     shareText?: string;
 };
@@ -258,6 +263,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;

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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/ui",
-  "version": "4.0.0",
+  "version": "4.2.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/sdk": "^4.1.0",
+    "@agg-build/hooks": "^4.0.1"
   },
   "dependencies": {
     "@number-flow/react": "^0.6.0",