@agg-build/ui 1.2.10 → 1.2.12

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

@@ -1,7 +1,12 @@
 export type SelectItem<TValue extends string = string> = {
+    /** The value of the option */
     value: TValue;
+    /** The display label for the option */
     label: string;
+    /** If true, the option will be disabled and not clickable */
     disabled?: boolean;
+    /** If true, the option will be hidden and not displayed in the dropdown */
+    hidden?: boolean;
     /** Optional icon URL rendered beside the label in trigger and dropdown. */
     iconUrl?: string;
     /** Optional React node rendered as an icon beside the label (takes precedence over iconUrl). */
@@ -20,6 +25,10 @@ export type SelectProps<TValue extends string = string> = {
     className?: string;
     /** Extra classes for the trigger button, e.g. corner radius. */
     triggerClassName?: string;
+    /** Extra classes for the dropdown content container. */
+    contentClassName?: string;
+    /** Extra classes for each option row. */
+    itemClassName?: string;
     /** Whether the select should block user interaction. */
     disabled?: boolean;
 };

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/toast/toast.types.d.mts

@@ -3,6 +3,8 @@ export type ToastTone = "info" | "success" | "warning" | "error";
 export interface ToastOptions {
     tone?: ToastTone;
     title?: string;
+    /** Optional muted supporting line shown below the main message. */
+    detail?: string;
     /** Auto-dismiss duration in ms. Pass `Infinity` (or `0`) to require manual dismissal. Defaults to 5000. */
     durationMs?: number;
 }
@@ -11,6 +13,7 @@ export interface ToastEntry {
     message: string;
     tone: ToastTone;
     title?: string;
+    detail?: string;
     durationMs: number;
 }
 export interface ToastContextValue {

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

@@ -3,6 +3,8 @@ export type ToastTone = "info" | "success" | "warning" | "error";
 export interface ToastOptions {
     tone?: ToastTone;
     title?: string;
+    /** Optional muted supporting line shown below the main message. */
+    detail?: string;
     /** Auto-dismiss duration in ms. Pass `Infinity` (or `0`) to require manual dismissal. Defaults to 5000. */
     durationMs?: number;
 }
@@ -11,6 +13,7 @@ export interface ToastEntry {
     message: string;
     tone: ToastTone;
     title?: string;
+    detail?: string;
     durationMs: number;
 }
 export interface ToastContextValue {

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/profile/index.d.mts

@@ -1,6 +1,6 @@
 import type { ProfileModalProps } from "./profile-modal.types";
 export type { ProfileModalProps, ExchangeAccount, SocialAccountInfo, SocialAccountState, WalletAccountInfo, } from "./profile-modal.types";
 export declare const ProfileModal: {
-    ({ open, onOpenChange, username, avatarPreview, onSave, onDeleteProfile, exchanges, socialAccounts, wallets, email, onDisconnectExchange: onDisconnectExchangeProp, onConnectTwitter, onDisconnectTwitter, onConnectGoogle, onDisconnectGoogle, onConnectApple, onDisconnectApple, onConnectDiscord, onDisconnectDiscord, onConnectTelegram, onDisconnectTelegram, onDisconnectWallet, onConnectEmail, onKycError, }: ProfileModalProps): JSX.Element;
+    ({ open, onOpenChange, username, avatarPreview, onSave, onDeleteProfile, socialAccounts, wallets, email, onConnectTwitter, onDisconnectTwitter, onConnectGoogle, onDisconnectGoogle, onConnectApple, onDisconnectApple, onDisconnectWallet, onConnectEmail, onKycError, }: ProfileModalProps): JSX.Element;
     displayName: string;
 };

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

@@ -1,6 +1,6 @@
 import type { ProfileModalProps } from "./profile-modal.types";
 export type { ProfileModalProps, ExchangeAccount, SocialAccountInfo, SocialAccountState, WalletAccountInfo, } from "./profile-modal.types";
 export declare const ProfileModal: {
-    ({ open, onOpenChange, username, avatarPreview, onSave, onDeleteProfile, exchanges, socialAccounts, wallets, email, onDisconnectExchange: onDisconnectExchangeProp, onConnectTwitter, onDisconnectTwitter, onConnectGoogle, onDisconnectGoogle, onConnectApple, onDisconnectApple, onConnectDiscord, onDisconnectDiscord, onConnectTelegram, onDisconnectTelegram, onDisconnectWallet, onConnectEmail, onKycError, }: ProfileModalProps): JSX.Element;
+    ({ open, onOpenChange, username, avatarPreview, onSave, onDeleteProfile, socialAccounts, wallets, email, onConnectTwitter, onDisconnectTwitter, onConnectGoogle, onDisconnectGoogle, onConnectApple, onDisconnectApple, onDisconnectWallet, onConnectEmail, onKycError, }: ProfileModalProps): JSX.Element;
     displayName: string;
 };

package/dist/types/profile/profile-modal.constants.d.mts

@@ -1,7 +1,7 @@
 import type { IconName } from "../primitives/icon/registry";
 export declare const PROFILE_TAB_KEYS: {
-    readonly ABOUT: "about";
-    readonly ACCOUNTS_WALLETS: "accounts-wallets";
+    readonly PROFILE_ACCOUNTS: "profile-accounts";
+    readonly TRADING_ACCESS: "trading-access";
 };
 export type ProfileTabKey = (typeof PROFILE_TAB_KEYS)[keyof typeof PROFILE_TAB_KEYS];
 export interface ProfileTabItem {

package/dist/types/profile/profile-modal.constants.d.ts

@@ -1,7 +1,7 @@
 import type { IconName } from "../primitives/icon/registry";
 export declare const PROFILE_TAB_KEYS: {
-    readonly ABOUT: "about";
-    readonly ACCOUNTS_WALLETS: "accounts-wallets";
+    readonly PROFILE_ACCOUNTS: "profile-accounts";
+    readonly TRADING_ACCESS: "trading-access";
 };
 export type ProfileTabKey = (typeof PROFILE_TAB_KEYS)[keyof typeof PROFILE_TAB_KEYS];
 export interface ProfileTabItem {

package/dist/types/profile/tabs/accounts-wallets-tab.d.mts

@@ -1,33 +1,18 @@
-import type { ExchangeAccount, SocialAccountState, WalletAccountInfo } from "../profile-modal.types";
-interface VenueAccountInfo {
-    id: string;
-    venue: string;
-    status: string;
-    kycStatus: string;
-}
+import type { SocialAccountState, WalletAccountInfo } from "../profile-modal.types";
 export interface AccountsWalletsTabProps {
-    exchanges: ExchangeAccount[];
     wallets?: WalletAccountInfo[];
     socialAccounts?: SocialAccountState;
     email?: string | null;
-    venueAccounts?: VenueAccountInfo[] | null;
-    onKycError?: (error: Error) => void;
-    onDisconnectExchange?: (venue: string) => void;
     onConnectTwitter?: () => void;
     onDisconnectTwitter?: () => void;
     onConnectGoogle?: () => void;
     onDisconnectGoogle?: () => void;
     onConnectApple?: () => void;
     onDisconnectApple?: () => void;
-    onConnectDiscord?: () => void;
-    onDisconnectDiscord?: () => void;
-    onConnectTelegram?: () => void;
-    onDisconnectTelegram?: () => void;
     onDisconnectWallet?: (wallet: WalletAccountInfo) => void;
     onConnectEmail?: () => void;
 }
 export declare const AccountsWalletsTab: {
-    ({ exchanges: _exchanges, socialAccounts, email, venueAccounts, onKycError, onDisconnectExchange: _onDisconnectExchange, onConnectTwitter, onDisconnectTwitter, onConnectGoogle, onDisconnectGoogle, onConnectApple, onDisconnectApple, onConnectDiscord: _onConnectDiscord, onDisconnectDiscord: _onDisconnectDiscord, onConnectTelegram: _onConnectTelegram, onDisconnectTelegram: _onDisconnectTelegram, onConnectEmail, }: AccountsWalletsTabProps): JSX.Element;
+    ({ socialAccounts, email, wallets, onConnectTwitter, onDisconnectTwitter, onConnectGoogle, onDisconnectGoogle, onConnectApple, onDisconnectApple, onDisconnectWallet, onConnectEmail, }: AccountsWalletsTabProps): JSX.Element;
     displayName: string;
 };
-export {};

package/dist/types/profile/tabs/accounts-wallets-tab.d.ts

@@ -1,33 +1,18 @@
-import type { ExchangeAccount, SocialAccountState, WalletAccountInfo } from "../profile-modal.types";
-interface VenueAccountInfo {
-    id: string;
-    venue: string;
-    status: string;
-    kycStatus: string;
-}
+import type { SocialAccountState, WalletAccountInfo } from "../profile-modal.types";
 export interface AccountsWalletsTabProps {
-    exchanges: ExchangeAccount[];
     wallets?: WalletAccountInfo[];
     socialAccounts?: SocialAccountState;
     email?: string | null;
-    venueAccounts?: VenueAccountInfo[] | null;
-    onKycError?: (error: Error) => void;
-    onDisconnectExchange?: (venue: string) => void;
     onConnectTwitter?: () => void;
     onDisconnectTwitter?: () => void;
     onConnectGoogle?: () => void;
     onDisconnectGoogle?: () => void;
     onConnectApple?: () => void;
     onDisconnectApple?: () => void;
-    onConnectDiscord?: () => void;
-    onDisconnectDiscord?: () => void;
-    onConnectTelegram?: () => void;
-    onDisconnectTelegram?: () => void;
     onDisconnectWallet?: (wallet: WalletAccountInfo) => void;
     onConnectEmail?: () => void;
 }
 export declare const AccountsWalletsTab: {
-    ({ exchanges: _exchanges, socialAccounts, email, venueAccounts, onKycError, onDisconnectExchange: _onDisconnectExchange, onConnectTwitter, onDisconnectTwitter, onConnectGoogle, onDisconnectGoogle, onConnectApple, onDisconnectApple, onConnectDiscord: _onConnectDiscord, onDisconnectDiscord: _onDisconnectDiscord, onConnectTelegram: _onConnectTelegram, onDisconnectTelegram: _onDisconnectTelegram, onConnectEmail, }: AccountsWalletsTabProps): JSX.Element;
+    ({ socialAccounts, email, wallets, onConnectTwitter, onDisconnectTwitter, onConnectGoogle, onDisconnectGoogle, onConnectApple, onDisconnectApple, onDisconnectWallet, onConnectEmail, }: AccountsWalletsTabProps): JSX.Element;
     displayName: string;
 };
-export {};

package/dist/types/profile/tabs/trading-access-tab.d.mts

@@ -0,0 +1,15 @@
+interface VenueAccountInfo {
+    id: string;
+    venue: string;
+    status: string;
+    kycStatus: string;
+}
+export interface TradingAccessTabProps {
+    venueAccounts?: VenueAccountInfo[] | null;
+    onKycError?: (error: Error) => void;
+}
+export declare const TradingAccessTab: {
+    ({ venueAccounts, onKycError, }: TradingAccessTabProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/profile/tabs/trading-access-tab.d.ts

@@ -0,0 +1,15 @@
+interface VenueAccountInfo {
+    id: string;
+    venue: string;
+    status: string;
+    kycStatus: string;
+}
+export interface TradingAccessTabProps {
+    venueAccounts?: VenueAccountInfo[] | null;
+    onKycError?: (error: Error) => void;
+}
+export declare const TradingAccessTab: {
+    ({ venueAccounts, onKycError, }: TradingAccessTabProps): JSX.Element;
+    displayName: string;
+};
+export {};

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" | "quoteUnavailable" | "serviceTemporarilyUnavailable" | "orderDeadlineExpiredBeforeSubmission" | "sellNoOnchainPosition" | "venueQuoteUnfillable" | "venueMinOrderSize" | "sourceBalanceChanged" | "venueMarketResolved" | "dflowWalletUnverified" | "venueNoQuotePath" | "solanaBlockhashExpired" | "venueRateLimited" | "serviceBlockedOrder">;
 }) => 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/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" | "quoteUnavailable" | "serviceTemporarilyUnavailable" | "orderDeadlineExpiredBeforeSubmission" | "sellNoOnchainPosition" | "venueQuoteUnfillable" | "venueMinOrderSize" | "sourceBalanceChanged" | "venueMarketResolved" | "dflowWalletUnverified" | "venueNoQuotePath" | "solanaBlockhashExpired" | "venueRateLimited" | "serviceBlockedOrder">;
 }) => 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;