@agg-build/ui 2.1.0 → 2.1.2

package/dist/trading.mjs

@@ -5,8 +5,10 @@ import {
   PlaceOrderSuccessView,
   SettlementDetails,
   parseAmount,
-  parseVenue
-} from "./chunk-YAEA6EDG.mjs";
+  parseVenue,
+  useClaimWinnings,
+  useResolvedMarketClaim
+} from "./chunk-ZOECARZW.mjs";
 import {
   SETTLEMENT_SECTION_ID,
   Settlement,
@@ -21,9 +23,9 @@ import {
   getTradingValueLabel,
   getTradingVenueLabel,
   useEventTradingContext
-} from "./chunk-C5M2OOM3.mjs";
-import "./chunk-YMVD6Q2A.mjs";
-import "./chunk-DXF2LMNN.mjs";
+} from "./chunk-5RBHMMY3.mjs";
+import "./chunk-75AMJAWR.mjs";
+import "./chunk-TBD3N4T4.mjs";
 export {
   PlaceOrder,
   PlaceOrderFailureView,
@@ -43,5 +45,7 @@ export {
   getTradingVenueLabel,
   parseAmount,
   parseVenue,
-  useEventTradingContext
+  useClaimWinnings,
+  useEventTradingContext,
+  useResolvedMarketClaim
 };

package/dist/types/events/shared/format-event-title.d.mts

@@ -0,0 +1,25 @@
+type EventCategoryLike = {
+    id?: string | null;
+    category?: {
+        id?: string | null;
+        name?: string | null;
+        displayName?: string | null;
+        parentId?: string | null;
+    } | null;
+};
+type FormatEventTitleWithDateSuffixParams = {
+    title: string;
+    categories?: readonly EventCategoryLike[] | null;
+    structureType?: string | null;
+    /**
+     * Scheduled kickoff of the underlying game. Preferred over `endDate` for
+     * the date suffix because `endDate` is the market close/expiration, which
+     * can sit well after the game (e.g. Kalshi World Cup markets expire weeks
+     * later — a June 22 game would otherwise read "- July 6").
+     */
+    gameStartTime?: string | null;
+    endDate?: string | null;
+    locale?: string;
+};
+export declare const formatEventTitleWithDateSuffix: ({ title, categories, structureType, gameStartTime, endDate, locale, }: FormatEventTitleWithDateSuffixParams) => string;
+export {};

package/dist/types/events/shared/format-event-title.d.ts

@@ -0,0 +1,25 @@
+type EventCategoryLike = {
+    id?: string | null;
+    category?: {
+        id?: string | null;
+        name?: string | null;
+        displayName?: string | null;
+        parentId?: string | null;
+    } | null;
+};
+type FormatEventTitleWithDateSuffixParams = {
+    title: string;
+    categories?: readonly EventCategoryLike[] | null;
+    structureType?: string | null;
+    /**
+     * Scheduled kickoff of the underlying game. Preferred over `endDate` for
+     * the date suffix because `endDate` is the market close/expiration, which
+     * can sit well after the game (e.g. Kalshi World Cup markets expire weeks
+     * later — a June 22 game would otherwise read "- July 6").
+     */
+    gameStartTime?: string | null;
+    endDate?: string | null;
+    locale?: string;
+};
+export declare const formatEventTitleWithDateSuffix: ({ title, categories, structureType, gameStartTime, endDate, locale, }: FormatEventTitleWithDateSuffixParams) => string;
+export {};

package/dist/types/events/shared/select-best-outcome.d.mts

@@ -0,0 +1,88 @@
+import type { LiveBestPriceCandidate } from "@agg-build/hooks";
+/** Which data tier produced the winning price + venue. */
+export type BestOutcomeSource = "ws" | "rest-best" | "rest-midpoint" | "static";
+/**
+ * The single, unified result for an outcome pill: price and venue resolved
+ * together from the *same* tier, so the displayed price and the venue logo can
+ * never disagree. `venueMarketId`, `source` and `updatedAt` are carried for
+ * telemetry/debugging and to let callers reason about freshness.
+ */
+export interface BestOutcomeCandidate {
+    price: number;
+    venue: string | undefined;
+    venueMarketId: string | undefined;
+    outcomeId: string;
+    source: BestOutcomeSource;
+    updatedAt: number | undefined;
+}
+export interface SelectBestOutcomeArgs {
+    outcomeId: string | null | undefined;
+    outcomeLabel?: string | null | undefined;
+    /** Active trade side. When set, the best ask (buy) / best bid (sell) wins. */
+    selection?: "buy" | "sell" | undefined;
+    /**
+     * Live WS candidate for this outcome — already folded across all venues for
+     * the outcome's MVMO group (see `buildLiveBestPriceCandidates`). Carries the
+     * venue that owns each side, so when a different venue takes the best live
+     * price the logo follows the price.
+     */
+    live?: LiveBestPriceCandidate | null | undefined;
+    /** REST cross-venue best bid/ask (fallback when WS hasn't landed). */
+    restBest?: {
+        bestBid?: number;
+        bestAsk?: number;
+    } | null | undefined;
+    /** REST venue that produced each side of `restBest`. */
+    restBestVenues?: {
+        bestBidVenue?: string;
+        bestAskVenue?: string;
+    } | null | undefined;
+    /** REST per-outcome midpoint (display-path fallback). */
+    restMidpoint?: number | null | undefined;
+    /** Venue that produced `restMidpoint`. */
+    restMidpointVenue?: string | null | undefined;
+    /** Cluster-wide "Yes" reference midpoint (display path, "yes" labels only). */
+    bestMidpoint?: number | null | undefined;
+    /** Venue that produced `bestMidpoint`. */
+    bestMidpointVenue?: string | null | undefined;
+    /** Final static fallback — the outcome's payload price. */
+    staticPrice?: number | null | undefined;
+    /** Venue for the static fallback (typically the local market's own venue). */
+    staticVenue?: string | null | undefined;
+    /** Resolves a venue name → its venueMarketId within the cluster (best effort). */
+    venueMarketIdByVenue?: ReadonlyMap<string, string> | null | undefined;
+}
+/**
+ * Resolve the single best price + venue for an outcome across all venues.
+ *
+ * Candidate priority (price and venue are always taken from the SAME tier):
+ *   With a trade selection (buy/sell):
+ *     1. fresh WS best ask/bid for that side  → source "ws"
+ *     2. REST best ask/bid for that side       → source "rest-best"
+ *     3. fresh WS midpoint                      → source "ws"
+ *     4. REST per-outcome midpoint              → source "rest-midpoint"
+ *     5. static outcome price                   → source "static"
+ *   Display path (no selection):
+ *     1. fresh WS midpoint                      → source "ws"
+ *     2. cluster "Yes" reference (yes labels)   → source "rest-midpoint"
+ *     3. REST per-outcome midpoint              → source "rest-midpoint"
+ *     4. static outcome price                   → source "static"
+ *
+ * Because WS is preferred per side over REST, a stale REST snapshot can never
+ * override newer live data — and because the venue is read from whichever tier
+ * supplied the price, the logo and the price switch together.
+ */
+export declare const selectBestOutcomeCandidate: (args: SelectBestOutcomeArgs) => BestOutcomeCandidate | undefined;
+/**
+ * Build a venue-name → venueMarketId lookup across a cluster (including matched
+ * siblings). First occurrence wins. Used to resolve the winning venue's market
+ * id for {@link selectBestOutcomeCandidate}.
+ */
+export declare const buildVenueMarketIdByVenue: (venueMarkets: ReadonlyArray<{
+    id?: string;
+    venue?: string | null;
+    matchedVenueMarkets?: ReadonlyArray<{
+        id?: string;
+        venue?: string | null;
+    }> | null;
+}> | null | undefined) => Map<string, string>;

package/dist/types/events/shared/select-best-outcome.d.ts

@@ -0,0 +1,88 @@
+import type { LiveBestPriceCandidate } from "@agg-build/hooks";
+/** Which data tier produced the winning price + venue. */
+export type BestOutcomeSource = "ws" | "rest-best" | "rest-midpoint" | "static";
+/**
+ * The single, unified result for an outcome pill: price and venue resolved
+ * together from the *same* tier, so the displayed price and the venue logo can
+ * never disagree. `venueMarketId`, `source` and `updatedAt` are carried for
+ * telemetry/debugging and to let callers reason about freshness.
+ */
+export interface BestOutcomeCandidate {
+    price: number;
+    venue: string | undefined;
+    venueMarketId: string | undefined;
+    outcomeId: string;
+    source: BestOutcomeSource;
+    updatedAt: number | undefined;
+}
+export interface SelectBestOutcomeArgs {
+    outcomeId: string | null | undefined;
+    outcomeLabel?: string | null | undefined;
+    /** Active trade side. When set, the best ask (buy) / best bid (sell) wins. */
+    selection?: "buy" | "sell" | undefined;
+    /**
+     * Live WS candidate for this outcome — already folded across all venues for
+     * the outcome's MVMO group (see `buildLiveBestPriceCandidates`). Carries the
+     * venue that owns each side, so when a different venue takes the best live
+     * price the logo follows the price.
+     */
+    live?: LiveBestPriceCandidate | null | undefined;
+    /** REST cross-venue best bid/ask (fallback when WS hasn't landed). */
+    restBest?: {
+        bestBid?: number;
+        bestAsk?: number;
+    } | null | undefined;
+    /** REST venue that produced each side of `restBest`. */
+    restBestVenues?: {
+        bestBidVenue?: string;
+        bestAskVenue?: string;
+    } | null | undefined;
+    /** REST per-outcome midpoint (display-path fallback). */
+    restMidpoint?: number | null | undefined;
+    /** Venue that produced `restMidpoint`. */
+    restMidpointVenue?: string | null | undefined;
+    /** Cluster-wide "Yes" reference midpoint (display path, "yes" labels only). */
+    bestMidpoint?: number | null | undefined;
+    /** Venue that produced `bestMidpoint`. */
+    bestMidpointVenue?: string | null | undefined;
+    /** Final static fallback — the outcome's payload price. */
+    staticPrice?: number | null | undefined;
+    /** Venue for the static fallback (typically the local market's own venue). */
+    staticVenue?: string | null | undefined;
+    /** Resolves a venue name → its venueMarketId within the cluster (best effort). */
+    venueMarketIdByVenue?: ReadonlyMap<string, string> | null | undefined;
+}
+/**
+ * Resolve the single best price + venue for an outcome across all venues.
+ *
+ * Candidate priority (price and venue are always taken from the SAME tier):
+ *   With a trade selection (buy/sell):
+ *     1. fresh WS best ask/bid for that side  → source "ws"
+ *     2. REST best ask/bid for that side       → source "rest-best"
+ *     3. fresh WS midpoint                      → source "ws"
+ *     4. REST per-outcome midpoint              → source "rest-midpoint"
+ *     5. static outcome price                   → source "static"
+ *   Display path (no selection):
+ *     1. fresh WS midpoint                      → source "ws"
+ *     2. cluster "Yes" reference (yes labels)   → source "rest-midpoint"
+ *     3. REST per-outcome midpoint              → source "rest-midpoint"
+ *     4. static outcome price                   → source "static"
+ *
+ * Because WS is preferred per side over REST, a stale REST snapshot can never
+ * override newer live data — and because the venue is read from whichever tier
+ * supplied the price, the logo and the price switch together.
+ */
+export declare const selectBestOutcomeCandidate: (args: SelectBestOutcomeArgs) => BestOutcomeCandidate | undefined;
+/**
+ * Build a venue-name → venueMarketId lookup across a cluster (including matched
+ * siblings). First occurrence wins. Used to resolve the winning venue's market
+ * id for {@link selectBestOutcomeCandidate}.
+ */
+export declare const buildVenueMarketIdByVenue: (venueMarkets: ReadonlyArray<{
+    id?: string;
+    venue?: string | null;
+    matchedVenueMarkets?: ReadonlyArray<{
+        id?: string;
+        venue?: string | null;
+    }> | null;
+}> | null | undefined) => Map<string, string>;

package/dist/types/pages/event-market/event-market.types.d.mts

@@ -1,5 +1,6 @@
 import type { VenueEventWithMarkets } from "../../events/item/event-list-item.types";
 import type { PlaceOrderResolvedClaimSummary } from "../../trading";
+import type { PlaceOrderProps } from "../../trading/place-order/index.place-order.types";
 export type EventMarketPageClassNames = Partial<{
     root: string;
     content: string;
@@ -44,6 +45,12 @@ export type EventMarketPageBaseProps = {
     defaultOutcomeId?: string;
     /** Whether to render the place-order panel. */
     showPlaceOrder?: boolean;
+    /**
+     * Pre-flight gate run before the internal quote execution, forwarded to the
+     * place-order panel. When it resolves the order fills as usual; return
+     * `false` to cancel or throw to abort. See `PlaceOrderProps.onBeforePrimaryAction`.
+     */
+    onBeforePrimaryAction?: PlaceOrderProps["onBeforePrimaryAction"];
     executionMode?: "live" | "paper";
     /** Optional resolved-event claim summary shown inside the read-only order panel. */
     resolvedClaim?: PlaceOrderResolvedClaimSummary;

package/dist/types/pages/event-market/event-market.types.d.ts

@@ -1,5 +1,6 @@
 import type { VenueEventWithMarkets } from "../../events/item/event-list-item.types";
 import type { PlaceOrderResolvedClaimSummary } from "../../trading";
+import type { PlaceOrderProps } from "../../trading/place-order/index.place-order.types";
 export type EventMarketPageClassNames = Partial<{
     root: string;
     content: string;
@@ -44,6 +45,12 @@ export type EventMarketPageBaseProps = {
     defaultOutcomeId?: string;
     /** Whether to render the place-order panel. */
     showPlaceOrder?: boolean;
+    /**
+     * Pre-flight gate run before the internal quote execution, forwarded to the
+     * place-order panel. When it resolves the order fills as usual; return
+     * `false` to cancel or throw to abort. See `PlaceOrderProps.onBeforePrimaryAction`.
+     */
+    onBeforePrimaryAction?: PlaceOrderProps["onBeforePrimaryAction"];
     executionMode?: "live" | "paper";
     /** Optional resolved-event claim summary shown inside the read-only order panel. */
     resolvedClaim?: PlaceOrderResolvedClaimSummary;

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

@@ -2,6 +2,7 @@ import type { UserProfilePageProps } from "./user-profile.types";
 export type { UserProfileActivity, UserProfileActivityStatus, UserProfileBalance, UserProfileConnectedExchange, UserProfileConnectedWallet, UserProfileInfo, UserProfilePageClassNames, UserProfilePageProps, UserProfilePosition, UserProfilePositionFilter, UserProfilePositionVenueShare, UserProfileSocialLink, UserProfileTransferStatus, UserProfileVenueBalance, } from "./user-profile.types";
 export { USER_PROFILE_TAB_ACTIVITY, USER_PROFILE_TAB_OPEN_ORDERS, USER_PROFILE_TAB_POSITIONS, } from "./user-profile.constants";
 export type { UserProfileTabValue } from "./user-profile.constants";
+export { buildAggTxExplorerHref } from "./transaction-explorer";
 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, 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

@@ -2,6 +2,7 @@ import type { UserProfilePageProps } from "./user-profile.types";
 export type { UserProfileActivity, UserProfileActivityStatus, UserProfileBalance, UserProfileConnectedExchange, UserProfileConnectedWallet, UserProfileInfo, UserProfilePageClassNames, UserProfilePageProps, UserProfilePosition, UserProfilePositionFilter, UserProfilePositionVenueShare, UserProfileSocialLink, UserProfileTransferStatus, UserProfileVenueBalance, } from "./user-profile.types";
 export { USER_PROFILE_TAB_ACTIVITY, USER_PROFILE_TAB_OPEN_ORDERS, USER_PROFILE_TAB_POSITIONS, } from "./user-profile.constants";
 export type { UserProfileTabValue } from "./user-profile.constants";
+export { buildAggTxExplorerHref } from "./transaction-explorer";
 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, 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/transaction-explorer.d.mts

@@ -0,0 +1 @@
+export declare const buildAggTxExplorerHref: (chainId: string | number | null | undefined, txHash: string | null | undefined) => string | undefined;

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

@@ -0,0 +1 @@
+export declare const buildAggTxExplorerHref: (chainId: string | number | null | undefined, txHash: string | null | undefined) => string | undefined;

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

@@ -156,6 +156,10 @@ export interface UserProfileTradeActivity {
 export interface UserProfileRedeemActivity {
     kind: "redeem";
     id: string;
+    /** Chain ID used to build an explorer link for the redeem transaction. */
+    chainId?: string;
+    /** Transaction hash used to build an explorer link for the redeem transaction. */
+    txHash?: string;
     /** Whether the activity failed and should render in a degraded state. */
     isFailed?: boolean;
     /** Whether the row should use error-colored text because the activity has an error. */
@@ -191,6 +195,10 @@ export type UserProfileTransferStatus = UserProfileActivityStatus;
 export interface UserProfileTransferActivity {
     kind: "withdrawal" | "deposit" | "bridge" | "user_op" | "unknown";
     id: string;
+    /** Chain ID used to build an explorer link for the activity transaction. */
+    chainId?: string;
+    /** Transaction hash used to build an explorer link for the activity transaction. */
+    txHash?: string;
     /** Whether the activity failed and should render in a degraded state. */
     isFailed?: boolean;
     /** Whether the row should use error-colored text because the activity has an error. */
@@ -211,8 +219,6 @@ export interface UserProfileTransferActivity {
     timeLabel: string;
     /** Deposit source — determines the icon in the thumbnail square. Only set when kind is "deposit". */
     depositSource?: "wallet" | "crypto" | "card";
-    /** Chain ID for chain-aware deposit icons. */
-    chainId?: string | number;
 }
 export type UserProfileActivity = UserProfileTradeActivity | UserProfileRedeemActivity | UserProfileTransferActivity;
 export interface UserProfileOpenOrder {

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

@@ -156,6 +156,10 @@ export interface UserProfileTradeActivity {
 export interface UserProfileRedeemActivity {
     kind: "redeem";
     id: string;
+    /** Chain ID used to build an explorer link for the redeem transaction. */
+    chainId?: string;
+    /** Transaction hash used to build an explorer link for the redeem transaction. */
+    txHash?: string;
     /** Whether the activity failed and should render in a degraded state. */
     isFailed?: boolean;
     /** Whether the row should use error-colored text because the activity has an error. */
@@ -191,6 +195,10 @@ export type UserProfileTransferStatus = UserProfileActivityStatus;
 export interface UserProfileTransferActivity {
     kind: "withdrawal" | "deposit" | "bridge" | "user_op" | "unknown";
     id: string;
+    /** Chain ID used to build an explorer link for the activity transaction. */
+    chainId?: string;
+    /** Transaction hash used to build an explorer link for the activity transaction. */
+    txHash?: string;
     /** Whether the activity failed and should render in a degraded state. */
     isFailed?: boolean;
     /** Whether the row should use error-colored text because the activity has an error. */
@@ -211,8 +219,6 @@ export interface UserProfileTransferActivity {
     timeLabel: string;
     /** Deposit source — determines the icon in the thumbnail square. Only set when kind is "deposit". */
     depositSource?: "wallet" | "crypto" | "card";
-    /** Chain ID for chain-aware deposit icons. */
-    chainId?: string | number;
 }
 export type UserProfileActivity = UserProfileTradeActivity | UserProfileRedeemActivity | UserProfileTransferActivity;
 export interface UserProfileOpenOrder {

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

@@ -38,6 +38,7 @@ import { InfoIcon } from "./svg/info";
 import { iconNames } from "./registry";
 import { LinkAccountsIcon } from "./svg/link-accounts";
 import { LockIcon } from "./svg/lock";
+import { PaperModeIcon } from "./svg/paper-mode";
 import { PencilIcon } from "./svg/pencil";
 import { PlaySquareIcon } from "./svg/play-square";
 import { PolygonIcon } from "./svg/polygon";
@@ -71,4 +72,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, CircleXmarkIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, CloseIcon, CopyIcon, CreateAccountIcon, CreditCardIcon, DisconnectIcon, DotsHorizontalIcon, DocumentIcon, DownloadIcon, ErrorFilledIcon, EthereumIcon, ExternalLinkIcon, GiftBonusIcon, 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, GiftBonusIcon, GoogleIcon, HourglassStartIcon, iconNames, ImageIcon, InfoIcon, LinkAccountsIcon, LockIcon, PaperModeIcon, 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

@@ -38,6 +38,7 @@ import { InfoIcon } from "./svg/info";
 import { iconNames } from "./registry";
 import { LinkAccountsIcon } from "./svg/link-accounts";
 import { LockIcon } from "./svg/lock";
+import { PaperModeIcon } from "./svg/paper-mode";
 import { PencilIcon } from "./svg/pencil";
 import { PlaySquareIcon } from "./svg/play-square";
 import { PolygonIcon } from "./svg/polygon";
@@ -71,4 +72,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, CircleXmarkIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, CloseIcon, CopyIcon, CreateAccountIcon, CreditCardIcon, DisconnectIcon, DotsHorizontalIcon, DocumentIcon, DownloadIcon, ErrorFilledIcon, EthereumIcon, ExternalLinkIcon, GiftBonusIcon, 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, GiftBonusIcon, GoogleIcon, HourglassStartIcon, iconNames, ImageIcon, InfoIcon, LinkAccountsIcon, LockIcon, PaperModeIcon, 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

@@ -188,6 +188,10 @@ export declare const iconRegistry: {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;
     };
+    readonly "paper-mode": {
+        ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
+        displayName: string;
+    };
     readonly pencil: {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;

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

@@ -188,6 +188,10 @@ export declare const iconRegistry: {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;
     };
+    readonly "paper-mode": {
+        ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
+        displayName: string;
+    };
     readonly pencil: {
         ({ title, className, ...props }: import("./types").IconSvgProps): JSX.Element;
         displayName: string;

package/dist/types/primitives/icon/svg/paper-mode.d.mts

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

package/dist/types/primitives/icon/svg/paper-mode.d.ts

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

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

@@ -1,4 +1,6 @@
 import type { AggUiLabels } from "@agg-build/hooks";
 import type { VenueEventWithMarkets } from "../../events/item";
 import type { SearchResultItem } from "./search.types";
-export declare const mapVenueEventToSearchResult: (event: VenueEventWithMarkets, labels: AggUiLabels, formatPercent: (value: number) => string, formatCompactCurrency: (value: number) => string) => SearchResultItem | null;
+export declare const mapVenueEventToSearchResult: (event: VenueEventWithMarkets, labels: AggUiLabels, formatPercent: (value: number) => string, formatCompactCurrency: (value: number) => string, options?: {
+    locale?: string;
+}) => SearchResultItem | null;

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

@@ -1,4 +1,6 @@
 import type { AggUiLabels } from "@agg-build/hooks";
 import type { VenueEventWithMarkets } from "../../events/item";
 import type { SearchResultItem } from "./search.types";
-export declare const mapVenueEventToSearchResult: (event: VenueEventWithMarkets, labels: AggUiLabels, formatPercent: (value: number) => string, formatCompactCurrency: (value: number) => string) => SearchResultItem | null;
+export declare const mapVenueEventToSearchResult: (event: VenueEventWithMarkets, labels: AggUiLabels, formatPercent: (value: number) => string, formatCompactCurrency: (value: number) => string, options?: {
+    locale?: string;
+}) => SearchResultItem | null;

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

@@ -4,3 +4,5 @@ export * from "./settlement";
 export * from "./settlement/settlement-details";
 export * from "./place-order";
 export * from "./trading-context";
+export * from "./use-claim-winnings";
+export * from "./use-resolved-market-claim";

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

@@ -4,3 +4,5 @@ export * from "./settlement";
 export * from "./settlement/settlement-details";
 export * from "./place-order";
 export * from "./trading-context";
+export * from "./use-claim-winnings";
+export * from "./use-resolved-market-claim";

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, executionMode, isLoading, isPrimaryActionDisabled, isPrimaryActionLoading, chainBalancesOverride, onAmountChange, onClose, onOutcomeChange, onPrimaryAction, onTabChange, onSuccess, onError, onExecutionStateChange, resolvedClaim, midpointsResult, }: PlaceOrderProps): JSX.Element;
+    ({ className, classNames, eventTradingState, executionMode, isLoading, isPrimaryActionDisabled, isPrimaryActionLoading, chainBalancesOverride, onAmountChange, onClose, onOutcomeChange, onPrimaryAction, onBeforePrimaryAction, 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, executionMode, isLoading, isPrimaryActionDisabled, isPrimaryActionLoading, chainBalancesOverride, onAmountChange, onClose, onOutcomeChange, onPrimaryAction, onTabChange, onSuccess, onError, onExecutionStateChange, resolvedClaim, midpointsResult, }: PlaceOrderProps): JSX.Element;
+    ({ className, classNames, eventTradingState, executionMode, isLoading, isPrimaryActionDisabled, isPrimaryActionLoading, chainBalancesOverride, onAmountChange, onClose, onOutcomeChange, onPrimaryAction, onBeforePrimaryAction, onTabChange, onSuccess, onError, onExecutionStateChange, resolvedClaim, midpointsResult, }: PlaceOrderProps): JSX.Element;
     displayName: string;
 };

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

@@ -22,11 +22,33 @@ export type PlaceOrderProps = {
     onClose?: () => void;
     /** Called when the selected outcome changes. */
     onOutcomeChange?: (outcomeId: string) => void;
-    /** Called when the primary action is triggered. */
+    /**
+     * Called when the primary action is triggered, in place of the internal
+     * quote execution. When provided, the component delegates the fill entirely
+     * to this callback and does NOT run its own execution. For a pre-flight gate
+     * that should run *before* the normal fill (and let it proceed), use
+     * `onBeforePrimaryAction` instead.
+     */
     onPrimaryAction?: (context?: {
         quoteId?: string;
         mode?: ExecutionMode;
     }) => void;
+    /**
+     * Called when the primary action is triggered, BEFORE the internal quote
+     * execution. Unlike `onPrimaryAction`, this does not replace the fill — it
+     * runs in between and, when it resolves, the order is filled as usual. Use it
+     * for a partner gate such as a verification/KYC modal that must complete
+     * before the order goes through.
+     *
+     * The returned promise is awaited before execution proceeds:
+     * - resolve (return `undefined`/`true`) → continue with the normal fill
+     * - return `false` → cancel silently; the panel returns to idle
+     * - throw → abort and surface the error as submission feedback
+     */
+    onBeforePrimaryAction?: (context?: {
+        quoteId?: string;
+        mode?: ExecutionMode;
+    }) => void | boolean | Promise<void | boolean>;
     /** Called when the slippage control value changes. */
     onSlippageChange?: (value: string) => void;
     /** Called when the active trade tab changes. */

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

@@ -22,11 +22,33 @@ export type PlaceOrderProps = {
     onClose?: () => void;
     /** Called when the selected outcome changes. */
     onOutcomeChange?: (outcomeId: string) => void;
-    /** Called when the primary action is triggered. */
+    /**
+     * Called when the primary action is triggered, in place of the internal
+     * quote execution. When provided, the component delegates the fill entirely
+     * to this callback and does NOT run its own execution. For a pre-flight gate
+     * that should run *before* the normal fill (and let it proceed), use
+     * `onBeforePrimaryAction` instead.
+     */
     onPrimaryAction?: (context?: {
         quoteId?: string;
         mode?: ExecutionMode;
     }) => void;
+    /**
+     * Called when the primary action is triggered, BEFORE the internal quote
+     * execution. Unlike `onPrimaryAction`, this does not replace the fill — it
+     * runs in between and, when it resolves, the order is filled as usual. Use it
+     * for a partner gate such as a verification/KYC modal that must complete
+     * before the order goes through.
+     *
+     * The returned promise is awaited before execution proceeds:
+     * - resolve (return `undefined`/`true`) → continue with the normal fill
+     * - return `false` → cancel silently; the panel returns to idle
+     * - throw → abort and surface the error as submission feedback
+     */
+    onBeforePrimaryAction?: (context?: {
+        quoteId?: string;
+        mode?: ExecutionMode;
+    }) => void | boolean | Promise<void | boolean>;
     /** Called when the slippage control value changes. */
     onSlippageChange?: (value: string) => void;
     /** Called when the active trade tab changes. */