@agg-build/ui 1.2.9 → 1.2.11

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

@@ -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, }: {

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

@@ -1,5 +1,5 @@
 import type { WithdrawModalProps } from "./withdraw-modal.types";
-export type { WithdrawMethod, WithdrawModalControlledProps, WithdrawModalProps, WithdrawModalSelfDrivenProps, WithdrawFlowData, WithdrawSummary, } from "./withdraw-modal.types";
+export type { WithdrawMethod, WithdrawModalControlledProps, WithdrawModalProps, WithdrawModalSelfDrivenProps, WithdrawFlowData, WithdrawFeeEstimate, WithdrawSummary, } from "./withdraw-modal.types";
 export declare const WithdrawModal: {
     (props: WithdrawModalProps): JSX.Element;
     displayName: string;

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

@@ -1,5 +1,5 @@
 import type { WithdrawModalProps } from "./withdraw-modal.types";
-export type { WithdrawMethod, WithdrawModalControlledProps, WithdrawModalProps, WithdrawModalSelfDrivenProps, WithdrawFlowData, WithdrawSummary, } from "./withdraw-modal.types";
+export type { WithdrawMethod, WithdrawModalControlledProps, WithdrawModalProps, WithdrawModalSelfDrivenProps, WithdrawFlowData, WithdrawFeeEstimate, WithdrawSummary, } from "./withdraw-modal.types";
 export declare const WithdrawModal: {
     (props: WithdrawModalProps): JSX.Element;
     displayName: string;

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

@@ -1,14 +1,20 @@
+import type { WithdrawalLifecycleState } from "@agg-build/hooks/withdraw";
 import type { WithdrawSummary } from "../withdraw-modal.types";
+export type WithdrawResultStatus = "success" | "partial_success" | "failed";
+interface WithdrawLoadingStepProps {
+    lifecycleState: WithdrawalLifecycleState;
+    onClose: () => void;
+}
 export interface WithdrawSuccessStepProps {
     summary: WithdrawSummary;
     tokenSymbol: string;
-    /**
-     * The submitted withdrawal id. When non-null the success step subscribes to
-     * `withdrawal_lifecycle` WS events and renders live progress; when null it
-     * falls back to the static "submitted" copy.
-     */
-    withdrawalId: string | null;
+    requestedWithdrawal: string;
+    resultStatus: WithdrawResultStatus;
+    errorMessage?: string | null;
     onDone: () => void;
+    onRetry: () => void;
     onClose: () => void;
 }
-export declare const WithdrawSuccessStep: ({ summary, tokenSymbol, withdrawalId, onDone, onClose, }: WithdrawSuccessStepProps) => JSX.Element;
+export declare const WithdrawLoadingStep: ({ lifecycleState, onClose, }: WithdrawLoadingStepProps) => JSX.Element;
+export declare const WithdrawSuccessStep: ({ summary, tokenSymbol, requestedWithdrawal, resultStatus, errorMessage, onDone, onRetry, onClose, }: WithdrawSuccessStepProps) => JSX.Element;
+export {};

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

@@ -1,14 +1,20 @@
+import type { WithdrawalLifecycleState } from "@agg-build/hooks/withdraw";
 import type { WithdrawSummary } from "../withdraw-modal.types";
+export type WithdrawResultStatus = "success" | "partial_success" | "failed";
+interface WithdrawLoadingStepProps {
+    lifecycleState: WithdrawalLifecycleState;
+    onClose: () => void;
+}
 export interface WithdrawSuccessStepProps {
     summary: WithdrawSummary;
     tokenSymbol: string;
-    /**
-     * The submitted withdrawal id. When non-null the success step subscribes to
-     * `withdrawal_lifecycle` WS events and renders live progress; when null it
-     * falls back to the static "submitted" copy.
-     */
-    withdrawalId: string | null;
+    requestedWithdrawal: string;
+    resultStatus: WithdrawResultStatus;
+    errorMessage?: string | null;
     onDone: () => void;
+    onRetry: () => void;
     onClose: () => void;
 }
-export declare const WithdrawSuccessStep: ({ summary, tokenSymbol, withdrawalId, onDone, onClose, }: WithdrawSuccessStepProps) => JSX.Element;
+export declare const WithdrawLoadingStep: ({ lifecycleState, onClose, }: WithdrawLoadingStepProps) => JSX.Element;
+export declare const WithdrawSuccessStep: ({ summary, tokenSymbol, requestedWithdrawal, resultStatus, errorMessage, onDone, onRetry, onClose, }: WithdrawSuccessStepProps) => JSX.Element;
+export {};

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

@@ -9,6 +9,8 @@ export interface WithdrawalLifecycleStep {
     id: string;
     label: string;
     status: WithdrawalLifecycleStepStatus;
+    /** Failure reason propagated from `leg.errorMessage`. Only set when `status === "error"`. */
+    errorMessage?: string | null;
 }
 export type WithdrawalLifecycleStepGroup = WithdrawalLifecycleStep[];
 export declare const resolveChainLabel: (chainId: number) => string;

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

@@ -9,6 +9,8 @@ export interface WithdrawalLifecycleStep {
     id: string;
     label: string;
     status: WithdrawalLifecycleStepStatus;
+    /** Failure reason propagated from `leg.errorMessage`. Only set when `status === "error"`. */
+    errorMessage?: string | null;
 }
 export type WithdrawalLifecycleStepGroup = WithdrawalLifecycleStep[];
 export declare const resolveChainLabel: (chainId: number) => string;

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

@@ -23,6 +23,11 @@ export interface WithdrawSummary {
     toWallet: string;
     fees: string;
 }
+export interface WithdrawFeeEstimate {
+    estimatedFees: string;
+    networkReserve: string;
+    youReceive: string;
+}
 export interface WithdrawFlowData {
     /** Top-level balance shown in the entry step (numeric, e.g. 179.9). */
     balance: number;

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

@@ -23,6 +23,11 @@ export interface WithdrawSummary {
     toWallet: string;
     fees: string;
 }
+export interface WithdrawFeeEstimate {
+    estimatedFees: string;
+    networkReserve: string;
+    youReceive: string;
+}
 export interface WithdrawFlowData {
     /** Top-level balance shown in the entry step (numeric, e.g. 179.9). */
     balance: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/ui",
-  "version": "1.2.9",
+  "version": "1.2.11",
   "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": "^1.2.0",
-    "@agg-build/sdk": "^1.2.0"
+    "@agg-build/hooks": "^1.2.11",
+    "@agg-build/sdk": "^1.2.11"
   },
   "dependencies": {
     "@number-flow/react": "^0.6.0",