@agg-build/ui 1.0.0 → 1.0.2

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

@@ -5,6 +5,7 @@ export * from "./badge";
 export * from "./button";
 export * from "./card";
 export * from "./chart";
+export * from "./copy-button";
 export * from "./currency-input";
 export * from "./footer";
 export * from "./header";
@@ -20,6 +21,7 @@ export * from "./skeleton";
 export * from "./state-message";
 export * from "./switch-button";
 export * from "./tabs";
+export * from "./toast";
 export * from "./tooltip";
 export * from "./typography";
 export * from "./venue-logo";

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

@@ -1,6 +1,6 @@
 import type { SelectProps } from "./select.types";
 export type { SelectItem, SelectProps } from "./select.types";
-/** Renders a native select or custom icon-aware dropdown depending on available item icons. */
+/** Renders a custom select trigger and portaled listbox. */
 export declare const Select: {
     <TValue extends string = string>({ items, value, onChange, ariaLabel, className, triggerClassName, disabled, }: SelectProps<TValue>): JSX.Element;
     displayName: string;

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

@@ -1,6 +1,6 @@
 import type { SelectProps } from "./select.types";
 export type { SelectItem, SelectProps } from "./select.types";
-/** Renders a native select or custom icon-aware dropdown depending on available item icons. */
+/** Renders a custom select trigger and portaled listbox. */
 export declare const Select: {
     <TValue extends string = string>({ items, value, onChange, ariaLabel, className, triggerClassName, disabled, }: SelectProps<TValue>): JSX.Element;
     displayName: string;

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

@@ -18,7 +18,7 @@ export type SelectProps<TValue extends string = string> = {
     ariaLabel?: string;
     /** Custom class name applied to the select root. */
     className?: string;
-    /** Extra classes for the trigger (`<select>` or `<button>`), e.g. corner radius. */
+    /** Extra classes for the trigger button, e.g. corner radius. */
     triggerClassName?: string;
     /** Whether the select should block user interaction. */
     disabled?: boolean;

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

@@ -18,7 +18,7 @@ export type SelectProps<TValue extends string = string> = {
     ariaLabel?: string;
     /** Custom class name applied to the select root. */
     className?: string;
-    /** Extra classes for the trigger (`<select>` or `<button>`), e.g. corner radius. */
+    /** Extra classes for the trigger button, e.g. corner radius. */
     triggerClassName?: string;
     /** Whether the select should block user interaction. */
     disabled?: boolean;

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

@@ -1,7 +1,6 @@
 import type { SelectItem } from "./select.types";
 /** Utility helpers for resolving select UI state from items and selected value. */
 export declare const resolveHasEnabledItems: <TValue extends string>(items: SelectItem<TValue>[]) => boolean;
-export declare const resolveHasAnyIcon: <TValue extends string>(items: SelectItem<TValue>[]) => boolean;
 export declare const resolveSelectedItem: <TValue extends string>(items: SelectItem<TValue>[], value: TValue) => SelectItem<TValue> | undefined;
 export declare const resolveIsSelectDisabled: ({ disabled, items, }: {
     disabled: boolean;

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

@@ -1,7 +1,6 @@
 import type { SelectItem } from "./select.types";
 /** Utility helpers for resolving select UI state from items and selected value. */
 export declare const resolveHasEnabledItems: <TValue extends string>(items: SelectItem<TValue>[]) => boolean;
-export declare const resolveHasAnyIcon: <TValue extends string>(items: SelectItem<TValue>[]) => boolean;
 export declare const resolveSelectedItem: <TValue extends string>(items: SelectItem<TValue>[], value: TValue) => SelectItem<TValue> | undefined;
 export declare const resolveIsSelectDisabled: ({ disabled, items, }: {
     disabled: boolean;

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

@@ -1,5 +1,6 @@
+import { PlaceOrderRouteCardSkeleton } from "./views/place-order-skeleton-view";
 import { skeletonViews, type SkeletonProps } from "./skeleton.types";
-export { skeletonViews };
+export { skeletonViews, PlaceOrderRouteCardSkeleton };
 export type { SkeletonProps, SkeletonView } from "./skeleton.types";
 /** Renders the requested skeleton placeholder surface for loading UI states. */
 export declare const Skeleton: {

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

@@ -1,5 +1,6 @@
+import { PlaceOrderRouteCardSkeleton } from "./views/place-order-skeleton-view";
 import { skeletonViews, type SkeletonProps } from "./skeleton.types";
-export { skeletonViews };
+export { skeletonViews, PlaceOrderRouteCardSkeleton };
 export type { SkeletonProps, SkeletonView } from "./skeleton.types";
 /** Renders the requested skeleton placeholder surface for loading UI states. */
 export declare const Skeleton: {

package/dist/types/primitives/skeleton/views/place-order-skeleton-view.d.mts

@@ -1,4 +1,8 @@
 import type { SkeletonViewProps } from "../skeleton.types";
+export declare const PlaceOrderRouteCardSkeleton: {
+    (): JSX.Element;
+    displayName: string;
+};
 export declare const PlaceOrderSkeletonView: {
     ({ className, ariaLabel, }: SkeletonViewProps): JSX.Element;
     displayName: string;

package/dist/types/primitives/skeleton/views/place-order-skeleton-view.d.ts

@@ -1,4 +1,8 @@
 import type { SkeletonViewProps } from "../skeleton.types";
+export declare const PlaceOrderRouteCardSkeleton: {
+    (): JSX.Element;
+    displayName: string;
+};
 export declare const PlaceOrderSkeletonView: {
     ({ className, ariaLabel, }: SkeletonViewProps): JSX.Element;
     displayName: string;

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

@@ -0,0 +1,4 @@
+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;

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

@@ -0,0 +1,4 @@
+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;

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

@@ -0,0 +1,31 @@
+import type { ReactNode } from "react";
+export type ToastTone = "info" | "success" | "warning" | "error";
+export interface ToastOptions {
+    tone?: ToastTone;
+    title?: string;
+    /** Auto-dismiss duration in ms. Pass `Infinity` (or `0`) to require manual dismissal. Defaults to 5000. */
+    durationMs?: number;
+}
+export interface ToastEntry {
+    id: number;
+    message: string;
+    tone: ToastTone;
+    title?: string;
+    durationMs: number;
+}
+export interface ToastContextValue {
+    toast: (message: string, options?: ToastOptions) => number;
+    dismiss: (id: number) => void;
+}
+export type ToastSwipeDirection = "right" | "left" | "up" | "down";
+export interface ToastProviderProps {
+    children: ReactNode;
+    /** Default auto-dismiss duration applied when a toast doesn't override it. Defaults to 5000ms. */
+    defaultDurationMs?: number;
+    /** Swipe gesture direction for dismissal. Defaults to "right". */
+    swipeDirection?: ToastSwipeDirection;
+    /** Distance in pixels the user must swipe to dismiss. Defaults to 50. */
+    swipeThreshold?: number;
+    /** Tailwind classes applied to the toast viewport (positioning container). */
+    viewportClassName?: string;
+}

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

@@ -0,0 +1,31 @@
+import type { ReactNode } from "react";
+export type ToastTone = "info" | "success" | "warning" | "error";
+export interface ToastOptions {
+    tone?: ToastTone;
+    title?: string;
+    /** Auto-dismiss duration in ms. Pass `Infinity` (or `0`) to require manual dismissal. Defaults to 5000. */
+    durationMs?: number;
+}
+export interface ToastEntry {
+    id: number;
+    message: string;
+    tone: ToastTone;
+    title?: string;
+    durationMs: number;
+}
+export interface ToastContextValue {
+    toast: (message: string, options?: ToastOptions) => number;
+    dismiss: (id: number) => void;
+}
+export type ToastSwipeDirection = "right" | "left" | "up" | "down";
+export interface ToastProviderProps {
+    children: ReactNode;
+    /** Default auto-dismiss duration applied when a toast doesn't override it. Defaults to 5000ms. */
+    defaultDurationMs?: number;
+    /** Swipe gesture direction for dismissal. Defaults to "right". */
+    swipeDirection?: ToastSwipeDirection;
+    /** Distance in pixels the user must swipe to dismiss. Defaults to 50. */
+    swipeThreshold?: number;
+    /** Tailwind classes applied to the toast viewport (positioning container). */
+    viewportClassName?: string;
+}

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

@@ -1,5 +1,5 @@
 import type { TypographyProps } from "./typography.types";
-export type { TypographyProps, TypographyVariant } from "./typography.types";
+export type { LegacyTypographyVariant, TokenTypographyVariant, TypographyProps, TypographyVariant, } from "./typography.types";
 export { typographyVariants } from "./typography.constants";
 /** Renders semantic text content using the selected typography variant styles. */
 export declare const Typography: {

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

@@ -1,5 +1,5 @@
 import type { TypographyProps } from "./typography.types";
-export type { TypographyProps, TypographyVariant } from "./typography.types";
+export type { LegacyTypographyVariant, TokenTypographyVariant, TypographyProps, TypographyVariant, } from "./typography.types";
 export { typographyVariants } from "./typography.constants";
 /** Renders semantic text content using the selected typography variant styles. */
 export declare const Typography: {

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

@@ -1,5 +1,7 @@
 import type { ReactNode } from "react";
-export type TypographyVariant = "display" | "heading" | "title" | "title-strong" | "body-large" | "body-large-strong" | "body" | "body-strong" | "label" | "label-strong" | "label-caps" | "caption" | "caption-strong" | "caption-caps" | "overline";
+export type LegacyTypographyVariant = "display" | "heading" | "title" | "title-strong" | "body-large" | "body-large-strong" | "body" | "body-strong" | "label" | "label-strong" | "label-caps" | "caption" | "caption-strong" | "caption-caps" | "overline";
+export type TokenTypographyVariant = "text-3xl" | "text-2xl" | "text-xl" | "text-xl-bold" | "text-lg" | "text-lg-bold" | "text-base" | "text-base-bold" | "text-sm" | "text-sm-bold" | "text-sm-caps" | "text-xs" | "text-xs-bold" | "text-xs-caps" | "text-2xs-caps";
+export type TypographyVariant = LegacyTypographyVariant | TokenTypographyVariant;
 export type TypographyProps = {
     /** HTML element or custom intrinsic tag used for rendering. */
     as?: keyof JSX.IntrinsicElements;

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

@@ -1,5 +1,7 @@
 import type { ReactNode } from "react";
-export type TypographyVariant = "display" | "heading" | "title" | "title-strong" | "body-large" | "body-large-strong" | "body" | "body-strong" | "label" | "label-strong" | "label-caps" | "caption" | "caption-strong" | "caption-caps" | "overline";
+export type LegacyTypographyVariant = "display" | "heading" | "title" | "title-strong" | "body-large" | "body-large-strong" | "body" | "body-strong" | "label" | "label-strong" | "label-caps" | "caption" | "caption-strong" | "caption-caps" | "overline";
+export type TokenTypographyVariant = "text-3xl" | "text-2xl" | "text-xl" | "text-xl-bold" | "text-lg" | "text-lg-bold" | "text-base" | "text-base-bold" | "text-sm" | "text-sm-bold" | "text-sm-caps" | "text-xs" | "text-xs-bold" | "text-xs-caps" | "text-2xs-caps";
+export type TypographyVariant = LegacyTypographyVariant | TokenTypographyVariant;
 export type TypographyProps = {
     /** HTML element or custom intrinsic tag used for rendering. */
     as?: keyof JSX.IntrinsicElements;

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

@@ -7,7 +7,9 @@ export declare const getMotionClassName: (enabled: boolean, ...values: ClassValu
 export declare const getScrollBehavior: (enabled: boolean) => "auto" | "smooth";
 export declare const isValidDateValue: (value: unknown) => value is Date;
 export declare const toDate: (value: string | Date | undefined) => Date | null;
-export declare const shortenAddress: (value: string) => string;
+export declare const shortenAddress: (value: string | null | undefined, options?: {
+    chain?: string;
+}) => string | undefined;
 export declare const formatUsd: (value: number) => string;
 /** Compact USD format (e.g. 127.8 → "$127.8", 50 → "$50"). */
 export declare const formatCompactUsd: (amount: number) => string;

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

@@ -7,7 +7,9 @@ export declare const getMotionClassName: (enabled: boolean, ...values: ClassValu
 export declare const getScrollBehavior: (enabled: boolean) => "auto" | "smooth";
 export declare const isValidDateValue: (value: unknown) => value is Date;
 export declare const toDate: (value: string | Date | undefined) => Date | null;
-export declare const shortenAddress: (value: string) => string;
+export declare const shortenAddress: (value: string | null | undefined, options?: {
+    chain?: string;
+}) => string | undefined;
 export declare const formatUsd: (value: number) => string;
 /** Compact USD format (e.g. 127.8 → "$127.8", 50 → "$50"). */
 export declare const formatCompactUsd: (amount: number) => string;

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

@@ -2,6 +2,5 @@ export * from "./types";
 export * from "./utils";
 export * from "./settlement";
 export * from "./settlement/settlement-details";
-export * from "./settlement/settlement-details.utils";
 export * from "./place-order";
 export * from "./trading-context";

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

@@ -2,6 +2,5 @@ export * from "./types";
 export * from "./utils";
 export * from "./settlement";
 export * from "./settlement/settlement-details";
-export * from "./settlement/settlement-details.utils";
 export * from "./place-order";
 export * from "./trading-context";

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

@@ -1,9 +1,17 @@
 import type { PlaceOrderResultTone } from "./index.place-order.types";
+/** Default amount pre-filled on mount so an initial quote is fetched immediately. */
+export declare const PLACE_ORDER_DEFAULT_AMOUNT = 20;
 /**
  * Order minimum is 1$ in all venues
  * This will prevent from retrying partially filled order
  */
 export declare const MIN_BUY_ORDER_AMOUNT = 1;
+/**
+ * Sell-side minimum: venues won't accept a sell smaller than 1 outcome-token
+ * share, so a partial-fill retry whose remainder is below this floor would be
+ * rejected. Used to gate the "Retry remaining" action on the sell flow.
+ */
+export declare const MIN_SELL_ORDER_SHARES = 1;
 export declare const DEFAULT_SLIPPAGE_VALUE = "0.5";
 export declare const DEFAULT_SLIPPAGE_MINIMUM = 0.5;
 export declare const HIGH_SLIPPAGE_THRESHOLD = 10;

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

@@ -1,9 +1,17 @@
 import type { PlaceOrderResultTone } from "./index.place-order.types";
+/** Default amount pre-filled on mount so an initial quote is fetched immediately. */
+export declare const PLACE_ORDER_DEFAULT_AMOUNT = 20;
 /**
  * Order minimum is 1$ in all venues
  * This will prevent from retrying partially filled order
  */
 export declare const MIN_BUY_ORDER_AMOUNT = 1;
+/**
+ * Sell-side minimum: venues won't accept a sell smaller than 1 outcome-token
+ * share, so a partial-fill retry whose remainder is below this floor would be
+ * rejected. Used to gate the "Retry remaining" action on the sell flow.
+ */
+export declare const MIN_SELL_ORDER_SHARES = 1;
 export declare const DEFAULT_SLIPPAGE_VALUE = "0.5";
 export declare const DEFAULT_SLIPPAGE_MINIMUM = 0.5;
 export declare const HIGH_SLIPPAGE_THRESHOLD = 10;

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

@@ -151,6 +151,12 @@ export type ResolvePlaceOrderQuoteResultParams = {
     quoteData: SmartRouteResponse | null;
     tradeSide: PlaceOrderTab;
 };
+export type BuildLiveRouteCardsParams = {
+    labels: PlaceOrderTradingLabels;
+    quoteData: SmartRouteResponse;
+    tradeSide: PlaceOrderTab;
+    eventVenues?: TradingVenue[];
+};
 export type ResolvePlaceOrderQuoteStatusParams = {
     amount: number;
     labels: PlaceOrderTradingLabels;
@@ -173,7 +179,6 @@ export type PlaceOrderExecutionSummary = {
     eventDateLabel?: string;
     eventImage?: string | null;
     actionLabel?: string;
-    actionTone?: "positive" | "negative";
     amountLabel?: string;
     toWinLabel?: string;
     potentialReturnLabel?: string;

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

@@ -151,6 +151,12 @@ export type ResolvePlaceOrderQuoteResultParams = {
     quoteData: SmartRouteResponse | null;
     tradeSide: PlaceOrderTab;
 };
+export type BuildLiveRouteCardsParams = {
+    labels: PlaceOrderTradingLabels;
+    quoteData: SmartRouteResponse;
+    tradeSide: PlaceOrderTab;
+    eventVenues?: TradingVenue[];
+};
 export type ResolvePlaceOrderQuoteStatusParams = {
     amount: number;
     labels: PlaceOrderTradingLabels;
@@ -173,7 +179,6 @@ export type PlaceOrderExecutionSummary = {
     eventDateLabel?: string;
     eventImage?: string | null;
     actionLabel?: string;
-    actionTone?: "positive" | "negative";
     amountLabel?: string;
     toWinLabel?: string;
     potentialReturnLabel?: string;

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

@@ -1,6 +1,6 @@
 import type { SmartRouteResponse, WsOrderSubmitted } from "@agg-build/sdk";
 import { type PlaceOrderOutcome, type PlaceOrderRoutingRow, type PlaceOrderTab, type TradingVenue } from "../types";
-import type { PlaceOrderOutcomeClassNameParams, PlaceOrderExecutionStepGroup, PlaceOrderFailureStep, PlaceOrderFailureSummary, PlaceOrderOutcomeLabelValue, PlaceOrderQuoteResult, PlaceOrderQuoteStatus, PlaceOrderResultTone, PlaceOrderRouteCard, PlaceOrderTerminalOrderEvent, PlaceOrderTradingLabels, PlaceOrderVenueOutcome, ResolvePlaceOrderQuoteResultParams, ResolvePlaceOrderQuoteStatusParams, ResolvePlaceOrderTabKeyParams } from "./index.place-order.types";
+import type { BuildLiveRouteCardsParams, PlaceOrderOutcomeClassNameParams, PlaceOrderExecutionStepGroup, PlaceOrderFailureStep, PlaceOrderFailureSummary, PlaceOrderOutcomeLabelValue, PlaceOrderQuoteResult, PlaceOrderQuoteStatus, PlaceOrderResultTone, PlaceOrderRouteCard, PlaceOrderTerminalOrderEvent, PlaceOrderTradingLabels, PlaceOrderVenueOutcome, ResolvePlaceOrderQuoteResultParams, ResolvePlaceOrderQuoteStatusParams, ResolvePlaceOrderTabKeyParams } from "./index.place-order.types";
 export declare const extractGeoBlockedVenues: (warnings: SmartRouteResponse["warnings"]) => Set<string>;
 /** Pure helpers for PlaceOrder view-model shaping, formatting, and keyboard logic. */
 export declare const getPlaceOrderContainerClassName: () => string;
@@ -34,16 +34,8 @@ export declare const resolvePlaceOrderQuoteResult: ({ labels, quoteData, tradeSi
 export declare const sanitizePlaceOrderAmount: (value: number) => number;
 export declare const getTradingRoutePriceLabel: (value: number) => string;
 export declare const resolvePlaceOrderQuoteStatus: ({ amount, labels, quoteData, selectedMarket, }: ResolvePlaceOrderQuoteStatusParams) => PlaceOrderQuoteStatus;
-export declare const buildLiveRouteCards: ({ labels, quoteData, tradeSide, }: {
-    labels: PlaceOrderTradingLabels;
-    quoteData: SmartRouteResponse;
-    tradeSide: PlaceOrderTab;
-}) => PlaceOrderRouteCard[];
+export declare const buildLiveRouteCards: ({ labels, quoteData, tradeSide, eventVenues, }: BuildLiveRouteCardsParams) => PlaceOrderRouteCard[];
 export declare const resolveExecutionVenueFromQuote: (quoteData: SmartRouteResponse | null) => TradingVenue | undefined;
-export declare const resolvePlaceOrderSuccessTone: ({ outcomeIndex, tab, }: {
-    outcomeIndex: number;
-    tab: PlaceOrderTab;
-}) => "positive" | "negative";
 export declare const getPlaceOrderPotentialReturn: (quoteData: SmartRouteResponse | null | undefined) => number;
 export declare const buildPlaceOrderExecutionStepGroups: ({ labels, orderId, quoteData, submittedOrders, }: {
     labels: PlaceOrderTradingLabels;
@@ -52,9 +44,10 @@ export declare const buildPlaceOrderExecutionStepGroups: ({ labels, orderId, quo
     submittedOrders?: WsOrderSubmitted[];
 }) => PlaceOrderExecutionStepGroup[];
 export declare const groupPlaceOrderFailureSteps: (steps: PlaceOrderFailureStep[]) => PlaceOrderFailureStep[][];
-export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ labels, summary, }: {
+export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ labels, summary, treatPartialAsComplete, }: {
     labels: PlaceOrderTradingLabels;
     summary: PlaceOrderFailureSummary;
+    treatPartialAsComplete?: boolean;
 }) => PlaceOrderExecutionStepGroup[];
 export declare const normalizePlaceOrderErrorMessage: ({ errorMessage, fallbackMessage, }: {
     errorMessage?: string | null;

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

@@ -1,6 +1,6 @@
 import type { SmartRouteResponse, WsOrderSubmitted } from "@agg-build/sdk";
 import { type PlaceOrderOutcome, type PlaceOrderRoutingRow, type PlaceOrderTab, type TradingVenue } from "../types";
-import type { PlaceOrderOutcomeClassNameParams, PlaceOrderExecutionStepGroup, PlaceOrderFailureStep, PlaceOrderFailureSummary, PlaceOrderOutcomeLabelValue, PlaceOrderQuoteResult, PlaceOrderQuoteStatus, PlaceOrderResultTone, PlaceOrderRouteCard, PlaceOrderTerminalOrderEvent, PlaceOrderTradingLabels, PlaceOrderVenueOutcome, ResolvePlaceOrderQuoteResultParams, ResolvePlaceOrderQuoteStatusParams, ResolvePlaceOrderTabKeyParams } from "./index.place-order.types";
+import type { BuildLiveRouteCardsParams, PlaceOrderOutcomeClassNameParams, PlaceOrderExecutionStepGroup, PlaceOrderFailureStep, PlaceOrderFailureSummary, PlaceOrderOutcomeLabelValue, PlaceOrderQuoteResult, PlaceOrderQuoteStatus, PlaceOrderResultTone, PlaceOrderRouteCard, PlaceOrderTerminalOrderEvent, PlaceOrderTradingLabels, PlaceOrderVenueOutcome, ResolvePlaceOrderQuoteResultParams, ResolvePlaceOrderQuoteStatusParams, ResolvePlaceOrderTabKeyParams } from "./index.place-order.types";
 export declare const extractGeoBlockedVenues: (warnings: SmartRouteResponse["warnings"]) => Set<string>;
 /** Pure helpers for PlaceOrder view-model shaping, formatting, and keyboard logic. */
 export declare const getPlaceOrderContainerClassName: () => string;
@@ -34,16 +34,8 @@ export declare const resolvePlaceOrderQuoteResult: ({ labels, quoteData, tradeSi
 export declare const sanitizePlaceOrderAmount: (value: number) => number;
 export declare const getTradingRoutePriceLabel: (value: number) => string;
 export declare const resolvePlaceOrderQuoteStatus: ({ amount, labels, quoteData, selectedMarket, }: ResolvePlaceOrderQuoteStatusParams) => PlaceOrderQuoteStatus;
-export declare const buildLiveRouteCards: ({ labels, quoteData, tradeSide, }: {
-    labels: PlaceOrderTradingLabels;
-    quoteData: SmartRouteResponse;
-    tradeSide: PlaceOrderTab;
-}) => PlaceOrderRouteCard[];
+export declare const buildLiveRouteCards: ({ labels, quoteData, tradeSide, eventVenues, }: BuildLiveRouteCardsParams) => PlaceOrderRouteCard[];
 export declare const resolveExecutionVenueFromQuote: (quoteData: SmartRouteResponse | null) => TradingVenue | undefined;
-export declare const resolvePlaceOrderSuccessTone: ({ outcomeIndex, tab, }: {
-    outcomeIndex: number;
-    tab: PlaceOrderTab;
-}) => "positive" | "negative";
 export declare const getPlaceOrderPotentialReturn: (quoteData: SmartRouteResponse | null | undefined) => number;
 export declare const buildPlaceOrderExecutionStepGroups: ({ labels, orderId, quoteData, submittedOrders, }: {
     labels: PlaceOrderTradingLabels;
@@ -52,9 +44,10 @@ export declare const buildPlaceOrderExecutionStepGroups: ({ labels, orderId, quo
     submittedOrders?: WsOrderSubmitted[];
 }) => PlaceOrderExecutionStepGroup[];
 export declare const groupPlaceOrderFailureSteps: (steps: PlaceOrderFailureStep[]) => PlaceOrderFailureStep[][];
-export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ labels, summary, }: {
+export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ labels, summary, treatPartialAsComplete, }: {
     labels: PlaceOrderTradingLabels;
     summary: PlaceOrderFailureSummary;
+    treatPartialAsComplete?: boolean;
 }) => PlaceOrderExecutionStepGroup[];
 export declare const normalizePlaceOrderErrorMessage: ({ errorMessage, fallbackMessage, }: {
     errorMessage?: string | null;

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

@@ -1,12 +1,15 @@
-import type { SettlementViewModel, TradingVenue } from "../types";
-export type SettlementProps = SettlementViewModel & {
+export declare const SETTLEMENT_SECTION_ID = "agg-settlement-section";
+export type SettlementProps = {
     className?: string;
-    expandedVenue?: TradingVenue | null;
+    id?: string;
+    sectionLabel?: string;
+    question?: string;
+    eventDescription?: string | null;
+    marketDescription?: string | null;
+    primaryRules?: string | null;
     isLoading?: boolean;
-    onExpandedVenueChange?: (venue: TradingVenue | null) => void;
-    onShowMore?: (venue: TradingVenue) => void;
 };
 export declare const Settlement: {
-    ({ sectionLabel, question, differencesTitle, differences, venues, expandedVenue, isLoading, onExpandedVenueChange, onShowMore, className, }: SettlementProps): JSX.Element;
+    ({ className, id, sectionLabel, question, eventDescription, marketDescription, primaryRules, isLoading, }: SettlementProps): JSX.Element;
     displayName: string;
 };

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

@@ -1,12 +1,15 @@
-import type { SettlementViewModel, TradingVenue } from "../types";
-export type SettlementProps = SettlementViewModel & {
+export declare const SETTLEMENT_SECTION_ID = "agg-settlement-section";
+export type SettlementProps = {
     className?: string;
-    expandedVenue?: TradingVenue | null;
+    id?: string;
+    sectionLabel?: string;
+    question?: string;
+    eventDescription?: string | null;
+    marketDescription?: string | null;
+    primaryRules?: string | null;
     isLoading?: boolean;
-    onExpandedVenueChange?: (venue: TradingVenue | null) => void;
-    onShowMore?: (venue: TradingVenue) => void;
 };
 export declare const Settlement: {
-    ({ sectionLabel, question, differencesTitle, differences, venues, expandedVenue, isLoading, onExpandedVenueChange, onShowMore, className, }: SettlementProps): JSX.Element;
+    ({ className, id, sectionLabel, question, eventDescription, marketDescription, primaryRules, isLoading, }: SettlementProps): JSX.Element;
     displayName: string;
 };

package/dist/types/trading/settlement/settlement-text-renderer.d.mts

@@ -0,0 +1,8 @@
+export type SettlementTextRendererProps = {
+    content: string;
+    className?: string;
+};
+export declare const SettlementTextRenderer: {
+    ({ content, className, }: SettlementTextRendererProps): JSX.Element | null;
+    displayName: string;
+};

package/dist/types/trading/settlement/settlement-text-renderer.d.ts

@@ -0,0 +1,8 @@
+export type SettlementTextRendererProps = {
+    content: string;
+    className?: string;
+};
+export declare const SettlementTextRenderer: {
+    ({ content, className, }: SettlementTextRendererProps): JSX.Element | null;
+    displayName: string;
+};

package/dist/types/trading/settlement/settlement-text.utils.d.mts

@@ -0,0 +1,36 @@
+/**
+ * Helpers used only by the Settlement / SettlementSummary surface to parse and
+ * normalize settlement-related text (event description, market description,
+ * primary rules). Not intended for use elsewhere.
+ */
+export type SettlementBlock = {
+    kind: "paragraph";
+    lines: string[];
+} | {
+    kind: "list";
+    items: string[];
+};
+export declare const parseSettlementBlocks: (input: string) => SettlementBlock[];
+/**
+ * Returns the first non-empty paragraph from the input — used by
+ * SettlementSummary to show only a teaser of the event description.
+ */
+export declare const getFirstSettlementParagraph: (input: string | null | undefined) => string;
+/** Lower-cased, whitespace-collapsed form used for dedup comparisons. */
+export declare const normalizeSettlementForCompare: (input: string) => string;
+export type SettlementSourceInput = {
+    eventDescription?: string | null;
+    marketDescription?: string | null;
+    primaryRules?: string | null;
+};
+export type SettlementSourceKey = "eventDescription" | "marketDescription" | "primaryRules";
+export type SettlementSourceBlock = {
+    key: SettlementSourceKey;
+    content: string;
+};
+/**
+ * Produces the ordered list of non-empty settlement blocks for the Settlement
+ * section, dropping any source whose normalized text is identical to a block
+ * already included.
+ */
+export declare const dedupeSettlementSources: (sources: SettlementSourceInput) => SettlementSourceBlock[];

package/dist/types/trading/settlement/settlement-text.utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Helpers used only by the Settlement / SettlementSummary surface to parse and
+ * normalize settlement-related text (event description, market description,
+ * primary rules). Not intended for use elsewhere.
+ */
+export type SettlementBlock = {
+    kind: "paragraph";
+    lines: string[];
+} | {
+    kind: "list";
+    items: string[];
+};
+export declare const parseSettlementBlocks: (input: string) => SettlementBlock[];
+/**
+ * Returns the first non-empty paragraph from the input — used by
+ * SettlementSummary to show only a teaser of the event description.
+ */
+export declare const getFirstSettlementParagraph: (input: string | null | undefined) => string;
+/** Lower-cased, whitespace-collapsed form used for dedup comparisons. */
+export declare const normalizeSettlementForCompare: (input: string) => string;
+export type SettlementSourceInput = {
+    eventDescription?: string | null;
+    marketDescription?: string | null;
+    primaryRules?: string | null;
+};
+export type SettlementSourceKey = "eventDescription" | "marketDescription" | "primaryRules";
+export type SettlementSourceBlock = {
+    key: SettlementSourceKey;
+    content: string;
+};
+/**
+ * Produces the ordered list of non-empty settlement blocks for the Settlement
+ * section, dropping any source whose normalized text is identical to a block
+ * already included.
+ */
+export declare const dedupeSettlementSources: (sources: SettlementSourceInput) => SettlementSourceBlock[];

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

@@ -4,25 +4,6 @@ export type TradingVenue = Venue;
 export declare const parseVenue: (v: unknown) => import("@agg-build/sdk").SafeParseResult<Venue>;
 /** safeParse-compatible finite non-negative number check. */
 export declare const parseAmount: (v: unknown) => import("@agg-build/sdk").SafeParseResult<number>;
-export interface SettlementVenueItem {
-    marketId: string;
-    venue: TradingVenue;
-    label?: string;
-    description: string;
-    showMoreLabel?: string;
-}
-export interface SettlementViewModel {
-    sectionLabel?: string;
-    question?: string;
-    differencesTitle?: string;
-    differences?: string[];
-    venues: SettlementVenueItem[];
-}
-export interface SettlementSection {
-    key: string;
-    label: string;
-    venues: SettlementVenueItem[];
-}
 export type PlaceOrderTab = "buy" | "sell";
 export type PlaceOrderStatusTone = "warning" | "error";
 export type PlaceOrderStatusPlacement = "above-action" | "below-action";

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

@@ -4,25 +4,6 @@ export type TradingVenue = Venue;
 export declare const parseVenue: (v: unknown) => import("@agg-build/sdk").SafeParseResult<Venue>;
 /** safeParse-compatible finite non-negative number check. */
 export declare const parseAmount: (v: unknown) => import("@agg-build/sdk").SafeParseResult<number>;
-export interface SettlementVenueItem {
-    marketId: string;
-    venue: TradingVenue;
-    label?: string;
-    description: string;
-    showMoreLabel?: string;
-}
-export interface SettlementViewModel {
-    sectionLabel?: string;
-    question?: string;
-    differencesTitle?: string;
-    differences?: string[];
-    venues: SettlementVenueItem[];
-}
-export interface SettlementSection {
-    key: string;
-    label: string;
-    venues: SettlementVenueItem[];
-}
 export type PlaceOrderTab = "buy" | "sell";
 export type PlaceOrderStatusTone = "warning" | "error";
 export type PlaceOrderStatusPlacement = "above-action" | "below-action";

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

@@ -1,6 +1,5 @@
 import type { TradingVenue } from "./types";
 export declare const defaultSettlementSectionLabel: string;
-export declare const defaultSettlementDifferencesTitle: string;
 export declare const defaultTradingDisclaimer: string;
 export declare const getTradingDateLabel: (value: string | Date) => string;
 export declare const getTradingVenueLabel: (venue: TradingVenue | undefined, label?: string) => string;