@agg-build/ui 1.0.0

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

@@ -0,0 +1,192 @@
+import type { AggUiLabels, DagStepProgress, EventTradingState, VenueMarket, VenueMarketOutcome } from "@agg-build/hooks";
+import type { SmartRouteResponse } from "@agg-build/sdk";
+import type { PlaceOrderRoutingRow, PlaceOrderStatus, PlaceOrderTab, TradingVenue } from "../types";
+export type PlaceOrderProps = {
+    /** Custom class name applied to the place-order root. */
+    className?: string;
+    /** Custom class name applied to the place-order elements. */
+    classNames?: PlaceOrderClassNames;
+    /** Trading state used to drive markets, balances, and quotes. */
+    eventTradingState?: EventTradingState;
+    /** Whether the place-order panel should render its loading state. */
+    isLoading?: boolean;
+    /** Whether the primary submit action should be disabled. */
+    isPrimaryActionDisabled?: boolean;
+    /** Whether the primary submit action should show a loading spinner. */
+    isPrimaryActionLoading?: boolean;
+    /** Called when the entered order amount changes. */
+    onAmountChange?: (amount: number) => void;
+    /** Called when the place-order panel should close. */
+    onClose?: () => void;
+    /** Called when the selected outcome changes. */
+    onOutcomeChange?: (outcomeId: string) => void;
+    /** Called when the primary action is triggered. */
+    onPrimaryAction?: (context?: {
+        quoteId?: string;
+    }) => void;
+    /** Called when the slippage control value changes. */
+    onSlippageChange?: (value: string) => void;
+    /** Called when the active trade tab changes. */
+    onTabChange?: (tab: PlaceOrderTab) => void;
+    /** Optional chain balance overrides keyed by chain ID. */
+    chainBalancesOverride?: Record<string, number>;
+    /** Called when order execution completes successfully. */
+    onSuccess?: (summary: PlaceOrderExecutionSummary) => void;
+    /** Called when order execution fails. */
+    onError?: (error: Error) => void;
+    /** Called on each execution phase transition (finding-route → submitting → executing → success → failed). */
+    onExecutionStateChange?: (state: PlaceOrderSubmissionProgressState) => void;
+    /** Optional resolved-event claim summary shown in read-only state. */
+    resolvedClaim?: PlaceOrderResolvedClaimSummary;
+};
+export type PlaceOrderResolvedClaimSummary = {
+    /** Resolution date label, e.g. "Mar 21, 2026". */
+    resolutionDateLabel: string;
+    /** Winning outcome label, e.g. "Yes". */
+    winningOutcomeLabel: string;
+    /** Shares label, e.g. "286 Yes". */
+    sharesLabel: string;
+    /** Total payout label, e.g. "$8.50". */
+    totalPayoutLabel: string;
+    /** Whether the claim action is currently in-flight. */
+    isClaiming?: boolean;
+    /** Optional claim action for eligible winnings. */
+    onClaim?: () => void;
+};
+export type PlaceOrderClassNames = {
+    root?: string;
+    body?: string;
+    header?: string;
+    content?: string;
+    footer?: string;
+};
+export type PlaceOrderSlippageControlProps = {
+    /** Default slippage value shown when the control initializes. */
+    defaultValue: string;
+    /** Whether the control should animate state changes. */
+    enableAnimations: boolean;
+    /** Minimum allowed slippage percentage. */
+    minimumValue: number;
+    /** Called when the slippage value changes. */
+    onChange?: (value: string) => void;
+    /** Controlled slippage value. */
+    value: string;
+};
+export type PlaceOrderRouteCardKind = "split" | "venue";
+export type PlaceOrderRouteCard = {
+    id: string;
+    hint: string;
+    kind: PlaceOrderRouteCardKind;
+    label: string;
+    numericValue: number;
+    quoteData: SmartRouteResponse;
+    rows?: PlaceOrderRoutingRow[];
+    value: string;
+    venue?: TradingVenue;
+    /** Whether the venue is unavailable in the user's region (geo-blocked). */
+    isUnavailable?: boolean;
+};
+export type PlaceOrderOutcomeClassNameParams = {
+    enableAnimations: boolean;
+    isActive: boolean;
+    isPositive: boolean;
+};
+export type PlaceOrderOutcomeLabelValue = Pick<VenueMarketOutcome, "id" | "label">;
+export type PlaceOrderVenueOutcome = Pick<VenueMarketOutcome, "id" | "label" | "price"> & {
+    title?: string | null;
+};
+export type PlaceOrderVenueQuote = {
+    price: number;
+    venue: TradingVenue;
+    venueMarketId: string;
+    venueMarketOutcomeId: string;
+};
+export type PlaceOrderResultTone = "default" | "success";
+export type PlaceOrderQuoteResult = {
+    hint: string;
+    value: string;
+};
+export type PlaceOrderTradingLabels = AggUiLabels["trading"];
+export type PlaceOrderExecutionStep = {
+    id: string;
+    label: string;
+    tone?: "complete" | "warning" | "error";
+    venue?: TradingVenue;
+};
+export type PlaceOrderExecutionStepGroup = PlaceOrderExecutionStep[];
+export type PlaceOrderTerminalOrderEvent = {
+    orderId: string;
+    venue: string;
+    event: "filled" | "partial_fill" | "failed";
+    filledAmountRaw?: string;
+    remainingAmountRaw?: string;
+    errorReason?: string;
+    timestamp: number;
+};
+export type PlaceOrderFailureStepTone = "complete" | "warning" | "error";
+export type PlaceOrderFailureStep = {
+    id: string;
+    label: string;
+    tone: PlaceOrderFailureStepTone;
+    venue?: TradingVenue;
+};
+export type PlaceOrderFailureAction = {
+    id: string;
+    label: string;
+    variant: "retry" | "dismiss" | "continue" | "skip";
+};
+export type PlaceOrderFailureKind = "partial_fill" | "venue_unavailable" | "market_resolved" | "generic";
+export type PlaceOrderFailureSummary = {
+    actionLabel: string;
+    actions: PlaceOrderFailureAction[];
+    errorMessage?: string;
+    eventImage?: string | null;
+    eventSubtitle?: string;
+    eventTitle: string;
+    kind: PlaceOrderFailureKind;
+    steps: PlaceOrderFailureStep[];
+};
+export type ResolvePlaceOrderQuoteResultParams = {
+    labels: PlaceOrderTradingLabels;
+    quoteData: SmartRouteResponse | null;
+    tradeSide: PlaceOrderTab;
+};
+export type ResolvePlaceOrderQuoteStatusParams = {
+    amount: number;
+    labels: PlaceOrderTradingLabels;
+    quoteData: SmartRouteResponse | null;
+    selectedMarket: VenueMarket | null;
+};
+export type ResolvePlaceOrderTabKeyParams = {
+    currentTab: PlaceOrderTab;
+    key: string;
+};
+export type PlaceOrderQuoteStatus = PlaceOrderStatus | undefined;
+export type PlaceOrderSubmissionProgressPhase = "finding-route" | "submitting" | "executing" | "success" | "failed";
+export type PlaceOrderExecutionSummary = {
+    tradeSide?: PlaceOrderTab;
+    shares: string;
+    avgPrice: string;
+    estimatedCost: string;
+    venue?: string;
+    eventTitle?: string;
+    eventDateLabel?: string;
+    eventImage?: string | null;
+    actionLabel?: string;
+    actionTone?: "positive" | "negative";
+    amountLabel?: string;
+    toWinLabel?: string;
+    potentialReturnLabel?: string;
+    executionStepGroups?: PlaceOrderExecutionStepGroup[];
+    shareText?: string;
+};
+export type PlaceOrderSubmissionProgressState = {
+    errorMessage?: string;
+    executionVenue?: TradingVenue;
+    failureSummary?: PlaceOrderFailureSummary;
+    orderId?: string;
+    orderIds?: string[];
+    phase: PlaceOrderSubmissionProgressPhase;
+    summary?: PlaceOrderExecutionSummary;
+    dagProgress?: DagStepProgress | null;
+};

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

@@ -0,0 +1,100 @@
+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";
+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;
+export declare const getResultValueClassName: (tone: PlaceOrderResultTone) => string;
+/**
+ * Determines if an outcome is "positive" (typically Yes/first outcome).
+ *
+ * Uses index as the primary signal: index 0 is positive, index 1+ is negative.
+ * This aligns with the standard binary prediction market convention where
+ * the first outcome is "Yes" and the second is "No".
+ */
+export declare const resolveIsPositiveOutcome: (_outcome: PlaceOrderOutcomeLabelValue, index: number) => boolean;
+export declare const getOutcomeButtonClassName: ({ enableAnimations, isActive, isPositive, }: PlaceOrderOutcomeClassNameParams) => string;
+export declare const mapVenueMarketOutcomesToPlaceOrderOutcomes: (venueMarketOutcomes: PlaceOrderVenueOutcome[] | null | undefined) => PlaceOrderOutcome[];
+export declare const mapQuoteDataToRoutingRows: (quoteData: ResolvePlaceOrderQuoteResultParams["quoteData"]) => PlaceOrderRoutingRow[];
+/**
+ * Aggregate execution outcome for a (possibly split) order.
+ * - `pending`          – not all order legs have reached a terminal state yet
+ * - `full_success`     – every leg filled completely
+ * - `partial_failure`  – at least one leg partially filled or failed while another filled/partially filled
+ * - `full_failure`     – every leg failed with no fills
+ */
+export type PlaceOrderAggregateOrderStatus = "pending" | "full_success" | "partial_failure" | "full_failure";
+/**
+ * Derives the aggregate outcome once all order legs of a split (or single) trade
+ * have terminal WebSocket events. Returns `"pending"` until every orderId has a
+ * corresponding terminal event so the UI never transitions prematurely.
+ */
+export declare const deriveAggregateOrderStatus: (orderIds: string[], terminalEvents: PlaceOrderTerminalOrderEvent[]) => PlaceOrderAggregateOrderStatus;
+export declare const resolvePlaceOrderQuoteResult: ({ labels, quoteData, tradeSide, }: ResolvePlaceOrderQuoteResultParams) => PlaceOrderQuoteResult | null;
+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 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;
+    orderId?: string;
+    quoteData: SmartRouteResponse | null | undefined;
+    submittedOrders?: WsOrderSubmitted[];
+}) => PlaceOrderExecutionStepGroup[];
+export declare const groupPlaceOrderFailureSteps: (steps: PlaceOrderFailureStep[]) => PlaceOrderFailureStep[][];
+export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ labels, summary, }: {
+    labels: PlaceOrderTradingLabels;
+    summary: PlaceOrderFailureSummary;
+}) => PlaceOrderExecutionStepGroup[];
+export declare const normalizePlaceOrderErrorMessage: ({ errorMessage, fallbackMessage, }: {
+    errorMessage?: string | null;
+    fallbackMessage: string;
+}) => 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.
+ */
+export declare const getPlaceOrderUnfilledRemaining: ({ originalAmount, terminalOrderEvents, }: {
+    originalAmount: number;
+    terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
+}) => number;
+export declare const buildPlaceOrderFailureSummary: ({ actionLabel, canRetryRemaining, errorMessage, eventImage, eventSubtitle, eventTitle, labels, orderId, quoteData, submittedOrders, terminalOrderEvents, }: {
+    actionLabel: string;
+    canRetryRemaining?: boolean;
+    errorMessage?: string;
+    eventImage?: string | null;
+    eventSubtitle?: string;
+    eventTitle: string;
+    labels: PlaceOrderTradingLabels;
+    orderId?: string;
+    quoteData: SmartRouteResponse | null | undefined;
+    submittedOrders?: WsOrderSubmitted[];
+    terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
+}) => PlaceOrderFailureSummary;
+export declare const buildPlaceOrderShareText: ({ actionLabel, amountLabel, eventTitle, potentialReturnLabel, tab, toWinLabel, tradingLabels, }: {
+    actionLabel: string;
+    amountLabel: string;
+    eventTitle: string;
+    potentialReturnLabel?: string;
+    tab: "buy" | "sell";
+    toWinLabel: string;
+    tradingLabels: Pick<PlaceOrderTradingLabels, "amount" | "potentialReturnBonus" | "toWin" | "withSmartRouting">;
+}) => string;
+export declare const resolveNextTabFromKey: ({ currentTab, key, }: ResolvePlaceOrderTabKeyParams) => PlaceOrderTab | null;
+export declare const sanitizePercentageInput: (value: string) => string;
+export declare const finalizePercentageValue: (value: string | undefined) => string;
+export declare const parsePercentageValue: (value: string | undefined) => number | null;
+export declare const formatPercentageValue: (value: string | undefined) => string;
+export declare const isPercentageBelowMinimum: (value: string | undefined, minimumValue: number | null) => boolean;

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

@@ -0,0 +1,100 @@
+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";
+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;
+export declare const getResultValueClassName: (tone: PlaceOrderResultTone) => string;
+/**
+ * Determines if an outcome is "positive" (typically Yes/first outcome).
+ *
+ * Uses index as the primary signal: index 0 is positive, index 1+ is negative.
+ * This aligns with the standard binary prediction market convention where
+ * the first outcome is "Yes" and the second is "No".
+ */
+export declare const resolveIsPositiveOutcome: (_outcome: PlaceOrderOutcomeLabelValue, index: number) => boolean;
+export declare const getOutcomeButtonClassName: ({ enableAnimations, isActive, isPositive, }: PlaceOrderOutcomeClassNameParams) => string;
+export declare const mapVenueMarketOutcomesToPlaceOrderOutcomes: (venueMarketOutcomes: PlaceOrderVenueOutcome[] | null | undefined) => PlaceOrderOutcome[];
+export declare const mapQuoteDataToRoutingRows: (quoteData: ResolvePlaceOrderQuoteResultParams["quoteData"]) => PlaceOrderRoutingRow[];
+/**
+ * Aggregate execution outcome for a (possibly split) order.
+ * - `pending`          – not all order legs have reached a terminal state yet
+ * - `full_success`     – every leg filled completely
+ * - `partial_failure`  – at least one leg partially filled or failed while another filled/partially filled
+ * - `full_failure`     – every leg failed with no fills
+ */
+export type PlaceOrderAggregateOrderStatus = "pending" | "full_success" | "partial_failure" | "full_failure";
+/**
+ * Derives the aggregate outcome once all order legs of a split (or single) trade
+ * have terminal WebSocket events. Returns `"pending"` until every orderId has a
+ * corresponding terminal event so the UI never transitions prematurely.
+ */
+export declare const deriveAggregateOrderStatus: (orderIds: string[], terminalEvents: PlaceOrderTerminalOrderEvent[]) => PlaceOrderAggregateOrderStatus;
+export declare const resolvePlaceOrderQuoteResult: ({ labels, quoteData, tradeSide, }: ResolvePlaceOrderQuoteResultParams) => PlaceOrderQuoteResult | null;
+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 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;
+    orderId?: string;
+    quoteData: SmartRouteResponse | null | undefined;
+    submittedOrders?: WsOrderSubmitted[];
+}) => PlaceOrderExecutionStepGroup[];
+export declare const groupPlaceOrderFailureSteps: (steps: PlaceOrderFailureStep[]) => PlaceOrderFailureStep[][];
+export declare const buildPlaceOrderExecutionStepGroupsFromFailureSummary: ({ labels, summary, }: {
+    labels: PlaceOrderTradingLabels;
+    summary: PlaceOrderFailureSummary;
+}) => PlaceOrderExecutionStepGroup[];
+export declare const normalizePlaceOrderErrorMessage: ({ errorMessage, fallbackMessage, }: {
+    errorMessage?: string | null;
+    fallbackMessage: string;
+}) => 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.
+ */
+export declare const getPlaceOrderUnfilledRemaining: ({ originalAmount, terminalOrderEvents, }: {
+    originalAmount: number;
+    terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
+}) => number;
+export declare const buildPlaceOrderFailureSummary: ({ actionLabel, canRetryRemaining, errorMessage, eventImage, eventSubtitle, eventTitle, labels, orderId, quoteData, submittedOrders, terminalOrderEvents, }: {
+    actionLabel: string;
+    canRetryRemaining?: boolean;
+    errorMessage?: string;
+    eventImage?: string | null;
+    eventSubtitle?: string;
+    eventTitle: string;
+    labels: PlaceOrderTradingLabels;
+    orderId?: string;
+    quoteData: SmartRouteResponse | null | undefined;
+    submittedOrders?: WsOrderSubmitted[];
+    terminalOrderEvents?: PlaceOrderTerminalOrderEvent[];
+}) => PlaceOrderFailureSummary;
+export declare const buildPlaceOrderShareText: ({ actionLabel, amountLabel, eventTitle, potentialReturnLabel, tab, toWinLabel, tradingLabels, }: {
+    actionLabel: string;
+    amountLabel: string;
+    eventTitle: string;
+    potentialReturnLabel?: string;
+    tab: "buy" | "sell";
+    toWinLabel: string;
+    tradingLabels: Pick<PlaceOrderTradingLabels, "amount" | "potentialReturnBonus" | "toWin" | "withSmartRouting">;
+}) => string;
+export declare const resolveNextTabFromKey: ({ currentTab, key, }: ResolvePlaceOrderTabKeyParams) => PlaceOrderTab | null;
+export declare const sanitizePercentageInput: (value: string) => string;
+export declare const finalizePercentageValue: (value: string | undefined) => string;
+export declare const parsePercentageValue: (value: string | undefined) => number | null;
+export declare const formatPercentageValue: (value: string | undefined) => string;
+export declare const isPercentageBelowMinimum: (value: string | undefined, minimumValue: number | null) => boolean;

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

@@ -0,0 +1,12 @@
+import type { SettlementViewModel, TradingVenue } from "../types";
+export type SettlementProps = SettlementViewModel & {
+    className?: string;
+    expandedVenue?: TradingVenue | 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;
+    displayName: string;
+};

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

@@ -0,0 +1,12 @@
+import type { SettlementViewModel, TradingVenue } from "../types";
+export type SettlementProps = SettlementViewModel & {
+    className?: string;
+    expandedVenue?: TradingVenue | 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;
+    displayName: string;
+};

package/dist/types/trading/settlement/settlement-details.d.mts

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

package/dist/types/trading/settlement/settlement-details.d.ts

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

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

@@ -0,0 +1,7 @@
+import type { AggUiLabels, VenueMarket } from "@agg-build/hooks";
+import type { SettlementSection } from "../types";
+/**
+ * Maps venue markets to settlement sections, filtering out sections
+ * where no venue has meaningful content for that field.
+ */
+export declare function mapVenueMarketsToSettlementSections(venueMarkets: VenueMarket[], labels: AggUiLabels, selectedMarketId?: string): SettlementSection[];

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

@@ -0,0 +1,7 @@
+import type { AggUiLabels, VenueMarket } from "@agg-build/hooks";
+import type { SettlementSection } from "../types";
+/**
+ * Maps venue markets to settlement sections, filtering out sections
+ * where no venue has meaningful content for that field.
+ */
+export declare function mapVenueMarketsToSettlementSections(venueMarkets: VenueMarket[], labels: AggUiLabels, selectedMarketId?: string): SettlementSection[];

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

@@ -0,0 +1,2 @@
+export { useEventTradingContext } from "@agg-build/hooks";
+export type { EventTradingContextValue } from "@agg-build/hooks";

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

@@ -0,0 +1,2 @@
+export { useEventTradingContext } from "@agg-build/hooks";
+export type { EventTradingContextValue } from "@agg-build/hooks";

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

@@ -0,0 +1,82 @@
+import { Venue } from "@agg-build/sdk";
+export type TradingVenue = Venue;
+/** safeParse-compatible venue check. */
+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";
+export type PlaceOrderRoutingTone = "default" | "highlighted";
+export type PlaceOrderResultTone = "default" | "success";
+export interface PlaceOrderOutcome {
+    id: string;
+    /** Canonical machine-readable label (e.g. "Yes", "No"). Use for logic
+     *  checks (isYesLabel, sort keys); never display this directly. */
+    label: string;
+    /** Descriptive human-readable text when the venue provides one (e.g.
+     *  Polymarket "Trump Wins"). Display this when present, fall back to
+     *  `label`. */
+    title: string | null;
+    price: number;
+    priceLabel: string;
+}
+export interface PlaceOrderMetric {
+    label: string;
+    hint: string;
+    value: number;
+}
+export interface PlaceOrderSlippage {
+    value: string;
+    label: string;
+    defaultValue?: string;
+    autoLabel?: string;
+    minimumValue?: number;
+    warningMessage?: string;
+    isExpandedByDefault?: boolean;
+}
+export interface PlaceOrderRoutingRow {
+    venue: TradingVenue;
+    label: string;
+    priceLabel: string;
+    resultLabel?: string;
+}
+export interface PlaceOrderRouting {
+    tone: PlaceOrderRoutingTone;
+    rows: PlaceOrderRoutingRow[];
+    helperLabel?: string;
+    highlightLabel?: string;
+    collapsedRowCount?: number;
+    isExpandedByDefault?: boolean;
+}
+export interface PlaceOrderResult {
+    label: string;
+    hint: string;
+    value: string;
+    tone: PlaceOrderResultTone;
+}
+export interface PlaceOrderStatus {
+    tone: PlaceOrderStatusTone;
+    message: string;
+    actionLabel?: string;
+    placement: PlaceOrderStatusPlacement;
+}

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

@@ -0,0 +1,82 @@
+import { Venue } from "@agg-build/sdk";
+export type TradingVenue = Venue;
+/** safeParse-compatible venue check. */
+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";
+export type PlaceOrderRoutingTone = "default" | "highlighted";
+export type PlaceOrderResultTone = "default" | "success";
+export interface PlaceOrderOutcome {
+    id: string;
+    /** Canonical machine-readable label (e.g. "Yes", "No"). Use for logic
+     *  checks (isYesLabel, sort keys); never display this directly. */
+    label: string;
+    /** Descriptive human-readable text when the venue provides one (e.g.
+     *  Polymarket "Trump Wins"). Display this when present, fall back to
+     *  `label`. */
+    title: string | null;
+    price: number;
+    priceLabel: string;
+}
+export interface PlaceOrderMetric {
+    label: string;
+    hint: string;
+    value: number;
+}
+export interface PlaceOrderSlippage {
+    value: string;
+    label: string;
+    defaultValue?: string;
+    autoLabel?: string;
+    minimumValue?: number;
+    warningMessage?: string;
+    isExpandedByDefault?: boolean;
+}
+export interface PlaceOrderRoutingRow {
+    venue: TradingVenue;
+    label: string;
+    priceLabel: string;
+    resultLabel?: string;
+}
+export interface PlaceOrderRouting {
+    tone: PlaceOrderRoutingTone;
+    rows: PlaceOrderRoutingRow[];
+    helperLabel?: string;
+    highlightLabel?: string;
+    collapsedRowCount?: number;
+    isExpandedByDefault?: boolean;
+}
+export interface PlaceOrderResult {
+    label: string;
+    hint: string;
+    value: string;
+    tone: PlaceOrderResultTone;
+}
+export interface PlaceOrderStatus {
+    tone: PlaceOrderStatusTone;
+    message: string;
+    actionLabel?: string;
+    placement: PlaceOrderStatusPlacement;
+}

package/dist/types/trading/use-kalshi-kyc-flow.d.mts

@@ -0,0 +1,22 @@
+export interface KalshiKycPendingState {
+    venue: "kalshi";
+    userId: string | null;
+    walletAddress: string | null;
+}
+interface UseKalshiKycFlowOptions {
+    isKalshiVerified: boolean | undefined;
+    userId?: string | null;
+    walletAddress?: string | null;
+    onError?: (error: Error) => void;
+}
+interface UseKalshiKycFlowResult {
+    isVerifyModalOpen: boolean;
+    showSuccessModal: boolean;
+    isInitiating: boolean;
+    openVerifyModal: () => void;
+    closeVerifyModal: () => void;
+    closeSuccessModal: () => void;
+    startVerification: () => void;
+}
+export declare const useKalshiKycFlow: ({ isKalshiVerified, userId, walletAddress, onError, }: UseKalshiKycFlowOptions) => UseKalshiKycFlowResult;
+export {};