@agg-build/ui 4.11.1 → 4.13.2

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

@@ -30,6 +30,11 @@ export type SportsSectionTab = {
 export type SportsMarketCardVariant = "outcome" | "line" | "yes_no";
 export type SportsMarketDisplayGroup = {
     id: string;
+    /**
+     * Wording for the whole group, derived from `markets[0]`. On a line ladder that
+     * is the LOWEST rung, so any line it names is the lowest one — the card swaps
+     * in the selected rung's number via {@link resolveSportsLadderTitle}.
+     */
     title: string;
     questionKey: string;
     sportsMarketType: SportsMarketTypeKey | null;
@@ -184,6 +189,28 @@ export type SportsCombinedLeg = {
  * ponytail: O(n) map build over one group's markets (a handful of rows).
  */
 export declare const resolveSportsCombinedLegs: (group: Pick<SportsMarketDisplayGroup, "markets" | "sportsMarketType">) => SportsCombinedLeg[] | null;
+/**
+ * The group's wording with the SELECTED rung's number in it.
+ *
+ * `group.title` is derived once, from `markets[0]` — the lowest rung — while the
+ * card renders whichever rung the rail has selected (by default the
+ * highest-volume one). Where a venue spells the line into its question and our
+ * cleaner can't strip it (kalshi's "Kentucky over 2.5 points scored" keeps its
+ * line because the strip is anchored to the END of the string), the heading
+ * quoted a line the card was not showing — contradicting its own chip, its
+ * Yes/No pills and the trade panel.
+ *
+ * Only the digits move. Re-deriving the title from the selected market instead
+ * would reword the card rung to rung, because the ladder is stocked from
+ * whichever venue lists each line and they phrase the same bet differently
+ * ("Kentucky O/U 23.5" strips down to a bare "Kentucky Totals", and prophetx
+ * would put "ALA: Team Points Fixed" in the header). One wording, one number.
+ *
+ * A title with no line in it — "Spreads", "Total Points", or a ladder whose
+ * lowest rung came from a venue we DO strip cleanly — has nothing to swap and is
+ * returned untouched.
+ */
+export declare const resolveSportsLadderTitle: (group: SportsMarketDisplayGroup, selectedLineDisplay: string) => string;
 export declare const buildSportsSlideFromGroup: (group: SportsMarketDisplayGroup) => SportsGameLineSlide;
 /**
  * Derive the Moneyline / Spreads / Total game-line slides (in that order) from a

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

@@ -30,6 +30,11 @@ export type SportsSectionTab = {
 export type SportsMarketCardVariant = "outcome" | "line" | "yes_no";
 export type SportsMarketDisplayGroup = {
     id: string;
+    /**
+     * Wording for the whole group, derived from `markets[0]`. On a line ladder that
+     * is the LOWEST rung, so any line it names is the lowest one — the card swaps
+     * in the selected rung's number via {@link resolveSportsLadderTitle}.
+     */
     title: string;
     questionKey: string;
     sportsMarketType: SportsMarketTypeKey | null;
@@ -184,6 +189,28 @@ export type SportsCombinedLeg = {
  * ponytail: O(n) map build over one group's markets (a handful of rows).
  */
 export declare const resolveSportsCombinedLegs: (group: Pick<SportsMarketDisplayGroup, "markets" | "sportsMarketType">) => SportsCombinedLeg[] | null;
+/**
+ * The group's wording with the SELECTED rung's number in it.
+ *
+ * `group.title` is derived once, from `markets[0]` — the lowest rung — while the
+ * card renders whichever rung the rail has selected (by default the
+ * highest-volume one). Where a venue spells the line into its question and our
+ * cleaner can't strip it (kalshi's "Kentucky over 2.5 points scored" keeps its
+ * line because the strip is anchored to the END of the string), the heading
+ * quoted a line the card was not showing — contradicting its own chip, its
+ * Yes/No pills and the trade panel.
+ *
+ * Only the digits move. Re-deriving the title from the selected market instead
+ * would reword the card rung to rung, because the ladder is stocked from
+ * whichever venue lists each line and they phrase the same bet differently
+ * ("Kentucky O/U 23.5" strips down to a bare "Kentucky Totals", and prophetx
+ * would put "ALA: Team Points Fixed" in the header). One wording, one number.
+ *
+ * A title with no line in it — "Spreads", "Total Points", or a ladder whose
+ * lowest rung came from a venue we DO strip cleanly — has nothing to swap and is
+ * returned untouched.
+ */
+export declare const resolveSportsLadderTitle: (group: SportsMarketDisplayGroup, selectedLineDisplay: string) => string;
 export declare const buildSportsSlideFromGroup: (group: SportsMarketDisplayGroup) => SportsGameLineSlide;
 /**
  * Derive the Moneyline / Spreads / Total game-line slides (in that order) from a

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

@@ -73,6 +73,34 @@ export type PlaceOrderAggregateOrderStatus = "pending" | "full_success" | "parti
  * corresponding terminal event so the UI never transitions prematurely.
  */
 export declare const deriveAggregateOrderStatus: (orderIds: string[], terminalEvents: PlaceOrderTerminalOrderEvent[]) => PlaceOrderAggregateOrderStatus;
+/**
+ * Dollars a BUY quote pays if the outcome wins. One dollar per share, less what
+ * the venue takes from that payout (Hyperliquid HIP-4's close fee), which the
+ * API reports as `estimatedPayout`. Older responses omit it — fall back to
+ * shares, which is exactly right for every venue that charges nothing at win.
+ */
+export declare const getPlaceOrderBuyPayout: (quoteData: Pick<SmartRouteResponse, "estimatedPayout" | "totalFilled">) => number;
+/**
+ * Dollars a SELL quote returns after the fees charged at fill. `rawExecCost` is
+ * gross proceeds on a sell (redeem legs at $1 plus router revenue), so subtract
+ * each fill's venue and builder fee. Sell fills carry no execution reserve.
+ */
+export declare const getPlaceOrderSellProceeds: (quoteData: Pick<SmartRouteResponse, "rawExecCost" | "fills">) => number;
+/** The dollar figure a route card shows and is ranked by. */
+export declare const getPlaceOrderQuoteValue: (quoteData: SmartRouteResponse, tradeSide: PlaceOrderTab) => number;
+/**
+ * The same net figure for realized fills: scale the actual shares (buy) or
+ * actual gross proceeds (sell) by each executed leg's quoted net-to-gross
+ * ratio. Without execution events, use the overall quote ratio.
+ */
+export declare const resolvePlaceOrderNetResult: ({ quoteData, tradeSide, shares, usd, terminalOrderEvents, submittedOrders, }: {
+    quoteData: SmartRouteResponse | null | undefined;
+    tradeSide: PlaceOrderTab;
+    shares: number;
+    usd: number;
+    terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
+    submittedOrders?: WsOrderSubmitted[];
+}) => number;
 export declare const resolvePlaceOrderQuoteResult: ({ labels, quoteData, tradeSide, }: ResolvePlaceOrderQuoteResultParams) => PlaceOrderQuoteResult | null;
 export declare const sanitizePlaceOrderAmount: (value: number) => number;
 export declare const getTradingRoutePriceLabel: (value: number) => string;

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

@@ -73,6 +73,34 @@ export type PlaceOrderAggregateOrderStatus = "pending" | "full_success" | "parti
  * corresponding terminal event so the UI never transitions prematurely.
  */
 export declare const deriveAggregateOrderStatus: (orderIds: string[], terminalEvents: PlaceOrderTerminalOrderEvent[]) => PlaceOrderAggregateOrderStatus;
+/**
+ * Dollars a BUY quote pays if the outcome wins. One dollar per share, less what
+ * the venue takes from that payout (Hyperliquid HIP-4's close fee), which the
+ * API reports as `estimatedPayout`. Older responses omit it — fall back to
+ * shares, which is exactly right for every venue that charges nothing at win.
+ */
+export declare const getPlaceOrderBuyPayout: (quoteData: Pick<SmartRouteResponse, "estimatedPayout" | "totalFilled">) => number;
+/**
+ * Dollars a SELL quote returns after the fees charged at fill. `rawExecCost` is
+ * gross proceeds on a sell (redeem legs at $1 plus router revenue), so subtract
+ * each fill's venue and builder fee. Sell fills carry no execution reserve.
+ */
+export declare const getPlaceOrderSellProceeds: (quoteData: Pick<SmartRouteResponse, "rawExecCost" | "fills">) => number;
+/** The dollar figure a route card shows and is ranked by. */
+export declare const getPlaceOrderQuoteValue: (quoteData: SmartRouteResponse, tradeSide: PlaceOrderTab) => number;
+/**
+ * The same net figure for realized fills: scale the actual shares (buy) or
+ * actual gross proceeds (sell) by each executed leg's quoted net-to-gross
+ * ratio. Without execution events, use the overall quote ratio.
+ */
+export declare const resolvePlaceOrderNetResult: ({ quoteData, tradeSide, shares, usd, terminalOrderEvents, submittedOrders, }: {
+    quoteData: SmartRouteResponse | null | undefined;
+    tradeSide: PlaceOrderTab;
+    shares: number;
+    usd: number;
+    terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
+    submittedOrders?: WsOrderSubmitted[];
+}) => number;
 export declare const resolvePlaceOrderQuoteResult: ({ labels, quoteData, tradeSide, }: ResolvePlaceOrderQuoteResultParams) => PlaceOrderQuoteResult | null;
 export declare const sanitizePlaceOrderAmount: (value: number) => number;
 export declare const getTradingRoutePriceLabel: (value: number) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/ui",
-  "version": "4.11.1",
+  "version": "4.13.2",
   "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",
@@ -101,7 +101,7 @@
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "@agg-build/hooks": "^4.11.0",
-    "@agg-build/sdk": "^4.11.0"
+    "@agg-build/sdk": "^4.13.1"
   },
   "dependencies": {
     "@number-flow/react": "^0.6.0",