@agg-build/ui 1.2.9 → 1.2.11

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

@@ -65,6 +65,8 @@ export interface UserProfilePosition {
     title: string;
     /** Outcome name for the pill only, e.g. "Yes" (no price). */
     outcomeLabel: string;
+    /** Resolved winning outcome name shown in closed position rows, e.g. "No". */
+    resolutionLabel?: string | null;
     /** Per-venue position sizes with logos below the pill. */
     venueShareBreakdown: UserProfilePositionVenueShare[];
     /** Total shares/contracts represented by this row. */
@@ -130,6 +132,10 @@ export interface UserProfileTradeActivity {
     isFailed?: boolean;
     /** Whether the row should use error-colored text because the activity has an error. */
     hasError?: boolean;
+    /** Error message for the activity. */
+    errorMessage?: string;
+    /** Normalized lifecycle status driving row tone. Defaults to "completed". */
+    status?: UserProfileActivityStatus;
     /** Activity type, e.g. "Buy", "Sell" */
     type: string;
     /** Market thumbnail image URL */
@@ -147,6 +153,14 @@ export interface UserProfileTradeActivity {
     /** Time label, e.g. "3d ago" */
     timeLabel: string;
 }
+/**
+ * Normalized UI state for activity rows. Backend statuses collapse into
+ * one of four buckets so row tone, status icons, titles, and amounts stay
+ * aligned. Unknown statuses fall back to "completed" — a stale row at rest
+ * is the safer default than a sticky spinner.
+ */
+export type UserProfileActivityStatus = "completed" | "pending" | "failed" | "canceled";
+export type UserProfileTransferStatus = UserProfileActivityStatus;
 /** Non-trade activity row: withdrawal / deposit / bridge / user_op. */
 export interface UserProfileTransferActivity {
     kind: "withdrawal" | "deposit" | "bridge" | "user_op";
@@ -155,6 +169,10 @@ export interface UserProfileTransferActivity {
     isFailed?: boolean;
     /** Whether the row should use error-colored text because the activity has an error. */
     hasError?: boolean;
+    /** Error message for the activity. */
+    errorMessage?: string;
+    /** Normalized status driving icon, title, and amount rendering. Defaults to "completed". */
+    status?: UserProfileTransferStatus;
     /** Header label, e.g. "Withdraw", "Deposit", "Bridge", "Wallet op". */
     type: string;
     /** Title, e.g. "Withdraw USDC". */
@@ -254,8 +272,43 @@ export interface UserProfilePageProps {
     getPositionHref?: (position: UserProfilePosition) => string | undefined;
     /** Called when the user claims a closed winning position. */
     onClaim?: (position: UserProfilePosition) => Promise<void> | void;
-    /** Map of claim key (marketId or position id) to loading state while claim is in-flight. */
+    /**
+     * Map of claim key (marketId or position id) to loading state while claim is in-flight.
+     *
+     * Passing this prop overrides the internal lifecycle-driven spinner (the page derives
+     * spinner state from the in-flight redeem's WS lifecycle when this prop is omitted).
+     * Partners who own the claim flow via `onClaim` typically pass their own state here;
+     * partners who let the page own the flow should omit this prop.
+     */
     claimingPositionKeys?: Record<string, boolean>;
+    /**
+     * Called once per redeem when its lifecycle reaches terminal (every expected leg
+     * confirmed or failed on chain). Receives the same `claimKey` that
+     * `claimingPositionKeys` uses (i.e. `position.marketId ?? position.id`) plus a
+     * summary of the terminal lifecycle state. Use this to fire one-shot success/failure
+     * toasts.
+     *
+     * NOT fired for synchronous submit failures (network errors, `RedeemRejectedError`)
+     * — those go through `onClaimSubmitError`.
+     *
+     * Only fired when the internal claim path is used (i.e. when the caller does NOT
+     * pass an `onClaim` prop). Callers that own the claim flow via `onClaim` are
+     * responsible for their own toasting.
+     */
+    onClaimResult?: (claimKey: string, lifecycle: {
+        allConfirmed: boolean;
+        anyFailed: boolean;
+        errorMessage: string | null;
+    }) => void;
+    /**
+     * Called when the redeem mutation itself rejects — i.e. transport error, validation
+     * error, or `RedeemRejectedError` (all legs ineligible/rejected at submit time). The
+     * redeem never enters the WS lifecycle in these cases, so `onClaimResult` does NOT
+     * fire.
+     *
+     * Only fired when the internal claim path is used.
+     */
+    onClaimSubmitError?: (claimKey: string, error: Error) => void;
     /** Called when an activity row is clicked */
     onActivityClick?: (activity: UserProfileActivity) => void;
     /** Optional href for an activity row (enables ctrl/cmd/middle-click to open in a new tab). */

package/dist/types/primitives/chart/chart.utils.d.mts

@@ -15,17 +15,16 @@ export declare const padSparseCandles: (candles: CandlePoint[], intervalSeconds?
 export declare const resolveCandleWidthSeconds: (points: LineChartPoint[], fallback?: number) => number | undefined;
 export declare const resolveWindowSeconds: (normalizedSeries: LineChartSeries[]) => number;
 /**
- * Liveline is a real-time chart that anchors its visible window to
- * `Date.now()`. Historical data that ended well before "now" falls outside
- * the visible region, causing liveline to draw "No data". Additionally,
- * liveline's multi-series render path requires `visible.length >= 2` per
- * series inside the window.
+ * Renderer-only fallback. Liveline anchors its visible window to `Date.now()`
+ * and refuses to draw fewer than 2 points per series, so this helper:
+ *   - extends a series forward to "now" (projecting the last known value)
+ *     when the tail is older than 5 minutes, and
+ *   - pads single-point series with a duplicate shifted 5m back.
  *
- * This helper extends every series so that data reaches up to "now", ensuring
- * the points always fall inside the liveline visible window. It also guarantees
- * at least 2 points per series (the minimum liveline requires).
- *
- * The returned series should be used for both `data` and `series` props.
+ * **It is a fallback only.** The real-time pipeline keeps the chart fresh by
+ * (a) ticking the rolling window's `nowSec`, (b) backfilling via REST refetch
+ * at each candle bucket, and (c) promoting closed WS live candles into the
+ * cached history. When those are working, `extendSeriesToNow` is a no-op.
  */
 export declare const extendSeriesToNow: (series: LineChartSeries[]) => LineChartSeries[];
 export declare const resolveLatestValue: (points: LineChartPoint[]) => number;

package/dist/types/primitives/chart/chart.utils.d.ts

@@ -15,17 +15,16 @@ export declare const padSparseCandles: (candles: CandlePoint[], intervalSeconds?
 export declare const resolveCandleWidthSeconds: (points: LineChartPoint[], fallback?: number) => number | undefined;
 export declare const resolveWindowSeconds: (normalizedSeries: LineChartSeries[]) => number;
 /**
- * Liveline is a real-time chart that anchors its visible window to
- * `Date.now()`. Historical data that ended well before "now" falls outside
- * the visible region, causing liveline to draw "No data". Additionally,
- * liveline's multi-series render path requires `visible.length >= 2` per
- * series inside the window.
+ * Renderer-only fallback. Liveline anchors its visible window to `Date.now()`
+ * and refuses to draw fewer than 2 points per series, so this helper:
+ *   - extends a series forward to "now" (projecting the last known value)
+ *     when the tail is older than 5 minutes, and
+ *   - pads single-point series with a duplicate shifted 5m back.
  *
- * This helper extends every series so that data reaches up to "now", ensuring
- * the points always fall inside the liveline visible window. It also guarantees
- * at least 2 points per series (the minimum liveline requires).
- *
- * The returned series should be used for both `data` and `series` props.
+ * **It is a fallback only.** The real-time pipeline keeps the chart fresh by
+ * (a) ticking the rolling window's `nowSec`, (b) backfilling via REST refetch
+ * at each candle bucket, and (c) promoting closed WS live candles into the
+ * cached history. When those are working, `extendSeriesToNow` is a no-op.
  */
 export declare const extendSeriesToNow: (series: LineChartSeries[]) => LineChartSeries[];
 export declare const resolveLatestValue: (points: LineChartPoint[]) => number;

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

@@ -14,6 +14,7 @@ import { CheckCircleIcon } from "./svg/check-circle";
 import { ChartCandlestickIcon } from "./svg/chart-candlestick";
 import { ChartLineIcon } from "./svg/chart-line";
 import { CircleOverlapIcon } from "./svg/circle-overlap";
+import { CircleXmarkIcon } from "./svg/circle-xmark";
 import { ChevronDownIcon } from "./svg/chevron-down";
 import { ChevronLeftIcon } from "./svg/chevron-left";
 import { ChevronRightIcon } from "./svg/chevron-right";
@@ -69,4 +70,4 @@ export declare const Icon: {
     ({ name, color, size, className, style, ...props }: IconProps): JSX.Element | null;
     displayName: string;
 };
-export { ActivityChartIcon, AppleIcon, AppsIcon, BadgeCheckThinIcon, ArbitrumIcon, ArrowRightIcon, ArrowTrendUpIcon, ArrowsToDotIcon, BankIcon, BaseIcon, BestPricesIcon, BnbIcon, BoltIcon, CheckCircleIcon, ChartCandlestickIcon, ChartLineIcon, CircleOverlapIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, CloseIcon, CopyIcon, CreateAccountIcon, CreditCardIcon, DisconnectIcon, DotsHorizontalIcon, DocumentIcon, DownloadIcon, ErrorFilledIcon, EthereumIcon, ExternalLinkIcon, GoogleIcon, HourglassStartIcon, iconNames, ImageIcon, InfoIcon, LinkAccountsIcon, LockIcon, PencilIcon, PlaySquareIcon, PolygonIcon, ProfileIcon, RevenueAltIcon, SearchIcon, ShieldTrustIcon, SolanaIcon, SparklesFilledIcon, StayInControlIcon, SuccessCheckIcon, TriangleDownIcon, TriangleUpFilledIcon, TriangleUpIcon, UploadIcon, UserTrustIcon, UsdcIcon, PaperPlaneIcon, WalletAvatarIcon, WalletFilledIcon, WalletIcon, WarningFilledIcon, WarningIcon, };
+export { ActivityChartIcon, AppleIcon, AppsIcon, BadgeCheckThinIcon, ArbitrumIcon, ArrowRightIcon, ArrowTrendUpIcon, ArrowsToDotIcon, BankIcon, BaseIcon, BestPricesIcon, BnbIcon, BoltIcon, CheckCircleIcon, ChartCandlestickIcon, ChartLineIcon, CircleOverlapIcon, CircleXmarkIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, CloseIcon, CopyIcon, CreateAccountIcon, CreditCardIcon, DisconnectIcon, DotsHorizontalIcon, DocumentIcon, DownloadIcon, ErrorFilledIcon, EthereumIcon, ExternalLinkIcon, GoogleIcon, HourglassStartIcon, iconNames, ImageIcon, InfoIcon, LinkAccountsIcon, LockIcon, PencilIcon, PlaySquareIcon, PolygonIcon, ProfileIcon, RevenueAltIcon, SearchIcon, ShieldTrustIcon, SolanaIcon, SparklesFilledIcon, StayInControlIcon, SuccessCheckIcon, TriangleDownIcon, TriangleUpFilledIcon, TriangleUpIcon, UploadIcon, UserTrustIcon, UsdcIcon, PaperPlaneIcon, WalletAvatarIcon, WalletFilledIcon, WalletIcon, WarningFilledIcon, WarningIcon, };

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

@@ -14,6 +14,7 @@ import { CheckCircleIcon } from "./svg/check-circle";
 import { ChartCandlestickIcon } from "./svg/chart-candlestick";
 import { ChartLineIcon } from "./svg/chart-line";
 import { CircleOverlapIcon } from "./svg/circle-overlap";
+import { CircleXmarkIcon } from "./svg/circle-xmark";
 import { ChevronDownIcon } from "./svg/chevron-down";
 import { ChevronLeftIcon } from "./svg/chevron-left";
 import { ChevronRightIcon } from "./svg/chevron-right";
@@ -69,4 +70,4 @@ export declare const Icon: {
     ({ name, color, size, className, style, ...props }: IconProps): JSX.Element | null;
     displayName: string;
 };
-export { ActivityChartIcon, AppleIcon, AppsIcon, BadgeCheckThinIcon, ArbitrumIcon, ArrowRightIcon, ArrowTrendUpIcon, ArrowsToDotIcon, BankIcon, BaseIcon, BestPricesIcon, BnbIcon, BoltIcon, CheckCircleIcon, ChartCandlestickIcon, ChartLineIcon, CircleOverlapIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, CloseIcon, CopyIcon, CreateAccountIcon, CreditCardIcon, DisconnectIcon, DotsHorizontalIcon, DocumentIcon, DownloadIcon, ErrorFilledIcon, EthereumIcon, ExternalLinkIcon, GoogleIcon, HourglassStartIcon, iconNames, ImageIcon, InfoIcon, LinkAccountsIcon, LockIcon, PencilIcon, PlaySquareIcon, PolygonIcon, ProfileIcon, RevenueAltIcon, SearchIcon, ShieldTrustIcon, SolanaIcon, SparklesFilledIcon, StayInControlIcon, SuccessCheckIcon, TriangleDownIcon, TriangleUpFilledIcon, TriangleUpIcon, UploadIcon, UserTrustIcon, UsdcIcon, PaperPlaneIcon, WalletAvatarIcon, WalletFilledIcon, WalletIcon, WarningFilledIcon, WarningIcon, };
+export { ActivityChartIcon, AppleIcon, AppsIcon, BadgeCheckThinIcon, ArbitrumIcon, ArrowRightIcon, ArrowTrendUpIcon, ArrowsToDotIcon, BankIcon, BaseIcon, BestPricesIcon, BnbIcon, BoltIcon, CheckCircleIcon, ChartCandlestickIcon, ChartLineIcon, CircleOverlapIcon, CircleXmarkIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, CloseIcon, CopyIcon, CreateAccountIcon, CreditCardIcon, DisconnectIcon, DotsHorizontalIcon, DocumentIcon, DownloadIcon, ErrorFilledIcon, EthereumIcon, ExternalLinkIcon, GoogleIcon, HourglassStartIcon, iconNames, ImageIcon, InfoIcon, LinkAccountsIcon, LockIcon, PencilIcon, PlaySquareIcon, PolygonIcon, ProfileIcon, RevenueAltIcon, SearchIcon, ShieldTrustIcon, SolanaIcon, SparklesFilledIcon, StayInControlIcon, SuccessCheckIcon, TriangleDownIcon, TriangleUpFilledIcon, TriangleUpIcon, UploadIcon, UserTrustIcon, UsdcIcon, PaperPlaneIcon, WalletAvatarIcon, WalletFilledIcon, WalletIcon, WarningFilledIcon, WarningIcon, };

package/dist/types/primitives/icon/registry.d.mts

@@ -80,6 +80,10 @@ export declare const iconRegistry: {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;
     };
+    readonly "circle-xmark": {
+        ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
+        displayName: string;
+    };
     readonly "chevron-down": {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;
@@ -232,6 +236,10 @@ export declare const iconRegistry: {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;
     };
+    readonly spinner: {
+        ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
+        displayName: string;
+    };
     readonly "stay-in-control": {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;

package/dist/types/primitives/icon/registry.d.ts

@@ -80,6 +80,10 @@ export declare const iconRegistry: {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;
     };
+    readonly "circle-xmark": {
+        ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
+        displayName: string;
+    };
     readonly "chevron-down": {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;
@@ -232,6 +236,10 @@ export declare const iconRegistry: {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;
     };
+    readonly spinner: {
+        ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
+        displayName: string;
+    };
     readonly "stay-in-control": {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;

package/dist/types/primitives/icon/svg/circle-xmark.d.mts

@@ -0,0 +1,5 @@
+import type { IconSvgProps } from "../types";
+export declare const CircleXmarkIcon: {
+    ({ title, className, ...props }: IconSvgProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/icon/svg/circle-xmark.d.ts

@@ -0,0 +1,5 @@
+import type { IconSvgProps } from "../types";
+export declare const CircleXmarkIcon: {
+    ({ title, className, ...props }: IconSvgProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/icon/svg/spinner.d.mts

@@ -0,0 +1,5 @@
+import type { IconSvgProps } from "../types";
+export declare const SpinnerIcon: {
+    ({ title, className, ...props }: IconSvgProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/primitives/icon/svg/spinner.d.ts

@@ -0,0 +1,5 @@
+import type { IconSvgProps } from "../types";
+export declare const SpinnerIcon: {
+    ({ title, className, ...props }: IconSvgProps): JSX.Element;
+    displayName: string;
+};

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

@@ -2,3 +2,5 @@ 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;
+/** Like {@link useToast}, but returns `null` when no `<ToastProvider>` is mounted. */
+export declare function useOptionalToast(): ToastContextValue | null;

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

@@ -2,3 +2,5 @@ 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;
+/** Like {@link useToast}, but returns `null` when no `<ToastProvider>` is mounted. */
+export declare function useOptionalToast(): ToastContextValue | null;

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

@@ -5,6 +5,7 @@ export type TooltipClassNames = {
     content?: string;
     trigger?: string;
     arrow?: string;
+    icon?: string;
 };
 export interface TooltipProps {
     /** Content rendered inside the tooltip surface. */

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

@@ -5,6 +5,7 @@ export type TooltipClassNames = {
     content?: string;
     trigger?: string;
     arrow?: string;
+    icon?: string;
 };
 export interface TooltipProps {
     /** Content rendered inside the tooltip surface. */

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

@@ -3,6 +3,6 @@ export type { LegacyTypographyVariant, TokenTypographyVariant, TypographyProps,
 export { typographyVariants } from "./typography.constants";
 /** Renders semantic text content using the selected typography variant styles. */
 export declare const Typography: {
-    ({ as: Component, variant, className, children, }: TypographyProps): JSX.Element;
+    ({ as: Component, variant, className, children, "aria-label": ariaLabel, }: TypographyProps): JSX.Element;
     displayName: string;
 };

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

@@ -3,6 +3,6 @@ export type { LegacyTypographyVariant, TokenTypographyVariant, TypographyProps,
 export { typographyVariants } from "./typography.constants";
 /** Renders semantic text content using the selected typography variant styles. */
 export declare const Typography: {
-    ({ as: Component, variant, className, children, }: TypographyProps): JSX.Element;
+    ({ as: Component, variant, className, children, "aria-label": ariaLabel, }: TypographyProps): JSX.Element;
     displayName: string;
 };

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

@@ -11,4 +11,6 @@ export type TypographyProps = {
     className?: string;
     /** Content rendered inside the typography element. */
     children: ReactNode;
+    /** Accessible label forwarded to the underlying element. */
+    "aria-label"?: string;
 };

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

@@ -11,4 +11,6 @@ export type TypographyProps = {
     className?: string;
     /** Content rendered inside the typography element. */
     children: ReactNode;
+    /** Accessible label forwarded to the underlying element. */
+    "aria-label"?: string;
 };

package/dist/types/shared/transfer-fee-summary.d.mts

@@ -0,0 +1,10 @@
+import { type WithdrawFeeEstimate } from "@agg-build/hooks";
+type TransferFeeSummaryView = "deposit" | "withdraw";
+export interface TransferFeeSummaryProps {
+    estimate: WithdrawFeeEstimate | null;
+    view: TransferFeeSummaryView;
+    minDeposit?: string;
+    eta?: string;
+}
+export declare const TransferFeeSummary: ({ estimate, view, minDeposit, eta, }: TransferFeeSummaryProps) => JSX.Element | null;
+export {};

package/dist/types/shared/transfer-fee-summary.d.ts

@@ -0,0 +1,10 @@
+import { type WithdrawFeeEstimate } from "@agg-build/hooks";
+type TransferFeeSummaryView = "deposit" | "withdraw";
+export interface TransferFeeSummaryProps {
+    estimate: WithdrawFeeEstimate | null;
+    view: TransferFeeSummaryView;
+    minDeposit?: string;
+    eta?: string;
+}
+export declare const TransferFeeSummary: ({ estimate, view, minDeposit, eta, }: TransferFeeSummaryProps) => JSX.Element | null;
+export {};

package/dist/types/shared/utils.d.mts

@@ -17,5 +17,8 @@ type FormatUsdOptions = {
 export declare const formatUsd: (value: number, options?: FormatUsdOptions) => string;
 /** Compact USD format (e.g. 127.8 → "$127.8", 50 → "$50"). */
 export declare const formatCompactUsd: (amount: number) => string;
+export declare const formatTokenAmount: (amount: number, symbol: string, options?: {
+    maximumFractionDigits?: number;
+}) => string;
 /** Format a raw numeric string for the amount input (adds locale grouping). */
 export declare const formatAmountDisplay: (value: string) => string;

package/dist/types/shared/utils.d.ts

@@ -17,5 +17,8 @@ type FormatUsdOptions = {
 export declare const formatUsd: (value: number, options?: FormatUsdOptions) => string;
 /** Compact USD format (e.g. 127.8 → "$127.8", 50 → "$50"). */
 export declare const formatCompactUsd: (amount: number) => string;
+export declare const formatTokenAmount: (amount: number, symbol: string, options?: {
+    maximumFractionDigits?: number;
+}) => string;
 /** Format a raw numeric string for the amount input (adds locale grouping). */
 export declare const formatAmountDisplay: (value: string) => string;

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

@@ -5,6 +5,6 @@ export { PlaceOrderSuccessView } from "./index.place-order.success";
 export type { PlaceOrderSuccessViewProps } from "./index.place-order.success";
 export type { PlaceOrderClassNames, PlaceOrderExecutionSummary, PlaceOrderResolvedClaimSummary, PlaceOrderTradingLabels, } from "./index.place-order.types";
 export declare const PlaceOrder: {
-    ({ className, classNames, eventTradingState, isLoading, isPrimaryActionDisabled, isPrimaryActionLoading, chainBalancesOverride, onAmountChange, onClose, onOutcomeChange, onPrimaryAction, onSlippageChange, onTabChange, onSuccess, onError, onExecutionStateChange, resolvedClaim, }: PlaceOrderProps): JSX.Element;
+    ({ className, classNames, eventTradingState, isLoading, isPrimaryActionDisabled, isPrimaryActionLoading, chainBalancesOverride, onAmountChange, onClose, onOutcomeChange, onPrimaryAction, onSlippageChange, onTabChange, onSuccess, onError, onExecutionStateChange, resolvedClaim, midpointsResult, }: PlaceOrderProps): JSX.Element;
     displayName: string;
 };

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

@@ -5,6 +5,6 @@ export { PlaceOrderSuccessView } from "./index.place-order.success";
 export type { PlaceOrderSuccessViewProps } from "./index.place-order.success";
 export type { PlaceOrderClassNames, PlaceOrderExecutionSummary, PlaceOrderResolvedClaimSummary, PlaceOrderTradingLabels, } from "./index.place-order.types";
 export declare const PlaceOrder: {
-    ({ className, classNames, eventTradingState, isLoading, isPrimaryActionDisabled, isPrimaryActionLoading, chainBalancesOverride, onAmountChange, onClose, onOutcomeChange, onPrimaryAction, onSlippageChange, onTabChange, onSuccess, onError, onExecutionStateChange, resolvedClaim, }: PlaceOrderProps): JSX.Element;
+    ({ className, classNames, eventTradingState, isLoading, isPrimaryActionDisabled, isPrimaryActionLoading, chainBalancesOverride, onAmountChange, onClose, onOutcomeChange, onPrimaryAction, onSlippageChange, onTabChange, onSuccess, onError, onExecutionStateChange, resolvedClaim, midpointsResult, }: PlaceOrderProps): JSX.Element;
     displayName: string;
 };

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

@@ -48,6 +48,15 @@ type PhaseTimelineEntry = NormalizedExecutionPhase & {
  * 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 = {

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

@@ -48,6 +48,15 @@ type PhaseTimelineEntry = NormalizedExecutionPhase & {
  * 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 = {

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

@@ -1,4 +1,4 @@
-import type { AggUiLabels, DagStepProgress, EventTradingState, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
+import type { AggUiLabels, DagStepProgress, EventTradingState, UseMidpointsResult, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
 import type { SmartRouteResponse } from "@agg-build/sdk";
 import type { PlaceOrderRoutingRow, PlaceOrderStatus, PlaceOrderTab, TradingVenue } from "../types";
 export type PlaceOrderProps = {
@@ -38,6 +38,8 @@ export type PlaceOrderProps = {
     onExecutionStateChange?: (state: PlaceOrderSubmissionProgressState) => void;
     /** Optional resolved-event claim summary shown in read-only state. */
     resolvedClaim?: PlaceOrderResolvedClaimSummary;
+    /** Pre-fetched midpoint data (best price included) passed from parent. Optional for backward compatibility. */
+    midpointsResult?: UseMidpointsResult;
 };
 export type PlaceOrderResolvedClaimSummary = {
     /** Resolution date label, e.g. "Mar 21, 2026". */
@@ -91,7 +93,7 @@ export type PlaceOrderOutcomeClassNameParams = {
     isActive: boolean;
     isPositive: boolean;
 };
-export type PlaceOrderOutcomeLabelValue = Pick<VenueMarketOutcome, "id" | "label">;
+export type PlaceOrderOutcomeLabelValue = Pick<VenueMarketOutcome, "id" | "label" | "title">;
 export type PlaceOrderVenueOutcome = Pick<VenueMarketOutcome, "id" | "label" | "price"> & {
     title?: string | null;
 };
@@ -120,6 +122,17 @@ export type PlaceOrderTerminalOrderEvent = {
     event: "filled" | "partial_fill" | "failed";
     filledAmountRaw?: string;
     remainingAmountRaw?: string;
+    /** Actual shares + payout received, 6-decimal atomic. Populated by the
+     * venue's finalize handler on filled/partial_fill and used to override
+     * the stale quote estimate in the execution summary. */
+    actualSharesRaw?: string;
+    actualToWinRaw?: string;
+    /** Quote-time shares + payout, 6-decimal atomic. */
+    quotedSharesRaw?: string;
+    quotedToWinRaw?: string;
+    /** Avg execution price as a numeric string (e.g. "0.087"). */
+    executionPriceRaw?: string;
+    quotedPriceRaw?: string;
     errorReason?: string;
     timestamp: number;
 };

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

@@ -1,4 +1,4 @@
-import type { AggUiLabels, DagStepProgress, EventTradingState, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
+import type { AggUiLabels, DagStepProgress, EventTradingState, UseMidpointsResult, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
 import type { SmartRouteResponse } from "@agg-build/sdk";
 import type { PlaceOrderRoutingRow, PlaceOrderStatus, PlaceOrderTab, TradingVenue } from "../types";
 export type PlaceOrderProps = {
@@ -38,6 +38,8 @@ export type PlaceOrderProps = {
     onExecutionStateChange?: (state: PlaceOrderSubmissionProgressState) => void;
     /** Optional resolved-event claim summary shown in read-only state. */
     resolvedClaim?: PlaceOrderResolvedClaimSummary;
+    /** Pre-fetched midpoint data (best price included) passed from parent. Optional for backward compatibility. */
+    midpointsResult?: UseMidpointsResult;
 };
 export type PlaceOrderResolvedClaimSummary = {
     /** Resolution date label, e.g. "Mar 21, 2026". */
@@ -91,7 +93,7 @@ export type PlaceOrderOutcomeClassNameParams = {
     isActive: boolean;
     isPositive: boolean;
 };
-export type PlaceOrderOutcomeLabelValue = Pick<VenueMarketOutcome, "id" | "label">;
+export type PlaceOrderOutcomeLabelValue = Pick<VenueMarketOutcome, "id" | "label" | "title">;
 export type PlaceOrderVenueOutcome = Pick<VenueMarketOutcome, "id" | "label" | "price"> & {
     title?: string | null;
 };
@@ -120,6 +122,17 @@ export type PlaceOrderTerminalOrderEvent = {
     event: "filled" | "partial_fill" | "failed";
     filledAmountRaw?: string;
     remainingAmountRaw?: string;
+    /** Actual shares + payout received, 6-decimal atomic. Populated by the
+     * venue's finalize handler on filled/partial_fill and used to override
+     * the stale quote estimate in the execution summary. */
+    actualSharesRaw?: string;
+    actualToWinRaw?: string;
+    /** Quote-time shares + payout, 6-decimal atomic. */
+    quotedSharesRaw?: string;
+    quotedToWinRaw?: string;
+    /** Avg execution price as a numeric string (e.g. "0.087"). */
+    executionPriceRaw?: string;
+    quotedPriceRaw?: string;
     errorReason?: string;
     timestamp: number;
 };

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

@@ -49,18 +49,61 @@ export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ la
     summary: PlaceOrderFailureSummary;
     treatPartialAsComplete?: boolean;
 }) => PlaceOrderExecutionStepGroup[];
-export declare const normalizePlaceOrderErrorMessage: ({ errorMessage, fallbackMessage, }: {
+export declare const normalizePlaceOrderErrorMessage: ({ errorMessage, fallbackMessage, labels, }: {
     errorMessage?: string | null;
     fallbackMessage: string;
+    labels?: Pick<PlaceOrderTradingLabels, "quoteBalanceMismatch">;
 }) => string;
 /**
- * Sum filled + partially-filled amounts (1e6-atomic) across terminal events
- * and subtract from the originally-requested amount. Works for both buy
- * (USD remainder) and sell (share remainder) — the executor uses the same
- * 1e6 atomic convention for `filledAmountRaw` in both directions.
+ * Resolves the actual execution economics from terminal WS events, overriding
+ * the stale quote estimate after a `partial_fill` (or `filled`) event arrives.
+ *
+ * Returns the same shape as the relevant fields on `SmartRouteResponse`
+ * (`rawExecCost` = USD side, `totalFilled` = shares side) so call sites can
+ * swap the quote estimate for actuals without restructuring.
+ *
+ * Per-side semantics (matches `polymarket-finalize` / `kalshi-finalize`):
+ *   - BUY:  `filledAmountRaw` is USD spent (6dp atomic). Shares received come
+ *           from `actualSharesRaw` if present, else derived from filled ÷ price.
+ *   - SELL: `actualSharesRaw` is the authoritative share count (always set by
+ *           `OrderExecutionService`). USD payout is `actualSharesRaw ×
+ *           executionPriceRaw`; `filledAmountRaw` is venue-specific (USD on
+ *           Polymarket, shares on Kalshi) so we don't rely on it here.
+ *   - `actualToWinRaw` mirrors `actualSharesRaw` (binary outcome: 1 share = $1
+ *           if it resolves YES) — it's NOT the realized sell payout.
+ *
+ * Execution-price precedence: `executionPriceRaw` → submittedOrders.price →
+ * quote fill avgPrice for the same venue → quote-wide vwap.
+ *
+ * When no fill data is present (`hasActualFillData === false`), callers should
+ * fall back to the quote estimate.
+ */
+export type PlaceOrderActualEconomics = {
+    hasActualFillData: boolean;
+    actualRawExecCost: number;
+    actualTotalFilled: number;
+    avgExecutionPrice: number;
+};
+export declare const resolveActualExecutionEconomics: ({ quoteData, tradeSide, terminalOrderEvents, submittedOrders, }: {
+    quoteData: SmartRouteResponse | null | undefined;
+    tradeSide: PlaceOrderTab;
+    terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
+    submittedOrders?: WsOrderSubmitted[];
+}) => PlaceOrderActualEconomics;
+/**
+ * Compute the unfilled remainder of an order from terminal WS events.
+ *
+ * `originalAmount` is in the same units as the user's input field:
+ *   - BUY:  USD requested  → subtract `filledAmountRaw` (USD) per event.
+ *   - SELL: shares requested → subtract `actualSharesRaw` (shares) per event.
+ *           For sells we never subtract `filledAmountRaw` because its unit is
+ *           venue-specific (USD on Polymarket, shares on Kalshi) — mixing
+ *           units corrupts the "Retry remaining" amount and the auto-skip
+ *           threshold. `actualSharesRaw` is always shares.
  */
-export declare const getPlaceOrderUnfilledRemaining: ({ originalAmount, terminalOrderEvents, }: {
+export declare const getPlaceOrderUnfilledRemaining: ({ originalAmount, tradeSide, terminalOrderEvents, }: {
     originalAmount: number;
+    tradeSide: PlaceOrderTab;
     terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
 }) => number;
 export declare const buildPlaceOrderFailureSummary: ({ actionLabel, canRetryRemaining, errorMessage, eventImage, eventSubtitle, eventTitle, labels, orderId, quoteData, submittedOrders, terminalOrderEvents, }: {