@agg-build/ui 1.2.7 → 1.2.9

package/dist/trading.mjs

@@ -6,7 +6,7 @@ import {
   SettlementDetails,
   parseAmount,
   parseVenue
-} from "./chunk-3RG2K7MV.mjs";
+} from "./chunk-K23CJ5UP.mjs";
 import {
   SETTLEMENT_SECTION_ID,
   Settlement,
@@ -21,9 +21,9 @@ import {
   getTradingValueLabel,
   getTradingVenueLabel,
   useEventTradingContext
-} from "./chunk-TBKDLNOE.mjs";
-import "./chunk-5FXMHTVR.mjs";
-import "./chunk-34L7ZKJW.mjs";
+} from "./chunk-5PSAIGOT.mjs";
+import "./chunk-5MDFM2MX.mjs";
+import "./chunk-QFW5NDJ6.mjs";
 export {
   PlaceOrder,
   PlaceOrderFailureView,

package/dist/types/primitives/switch-button/switch-button.constants.d.mts

@@ -2,4 +2,4 @@ export declare const SWITCH_BUTTON_ANIMATION_DURATION_MS = 350;
 export declare const SWITCH_BUTTON_CONTAINER_CLASS_NAME = "group/agg-switch-button min-w-fit inline-flex min-w-0 rounded-agg-full bg-agg-secondary-hover font-agg-sans cursor-pointer hover:bg-agg-tertiary";
 export declare const SWITCH_BUTTON_TRACK_CLASS_NAME = "agg-switch-button-track relative grid min-w-0 flex-1 items-center";
 export declare const SWITCH_BUTTON_TRACK_HIGHLIGHT_CLASS_NAME = "pointer-events-none absolute inset-y-0 left-0 rounded-agg-full border border-agg-primary bg-agg-secondary";
-export declare const SWITCH_BUTTON_OPTION_BASE_CLASS_NAME = "agg-switch-button-option whitespace-nowrap relative z-10 min-w-0 rounded-agg-full px-5 py-1.5 font-agg-sans text-agg-base leading-agg-6 text-agg-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-agg-primary focus-visible:ring-offset-0 focus-visible:ring-offset-agg-secondary-hover cursor-pointer disabled:cursor-not-allowed disabled:text-agg-muted-foreground";
+export declare const SWITCH_BUTTON_OPTION_BASE_CLASS_NAME = "agg-switch-button-option whitespace-nowrap relative z-10 min-w-0 rounded-agg-full px-5 py-1.5 font-agg-sans text-agg-sm leading-agg-5 md:text-agg-base md:leading-agg-6 text-agg-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-agg-primary focus-visible:ring-offset-0 focus-visible:ring-offset-agg-secondary-hover cursor-pointer disabled:cursor-not-allowed disabled:text-agg-muted-foreground";

package/dist/types/primitives/switch-button/switch-button.constants.d.ts

@@ -2,4 +2,4 @@ export declare const SWITCH_BUTTON_ANIMATION_DURATION_MS = 350;
 export declare const SWITCH_BUTTON_CONTAINER_CLASS_NAME = "group/agg-switch-button min-w-fit inline-flex min-w-0 rounded-agg-full bg-agg-secondary-hover font-agg-sans cursor-pointer hover:bg-agg-tertiary";
 export declare const SWITCH_BUTTON_TRACK_CLASS_NAME = "agg-switch-button-track relative grid min-w-0 flex-1 items-center";
 export declare const SWITCH_BUTTON_TRACK_HIGHLIGHT_CLASS_NAME = "pointer-events-none absolute inset-y-0 left-0 rounded-agg-full border border-agg-primary bg-agg-secondary";
-export declare const SWITCH_BUTTON_OPTION_BASE_CLASS_NAME = "agg-switch-button-option whitespace-nowrap relative z-10 min-w-0 rounded-agg-full px-5 py-1.5 font-agg-sans text-agg-base leading-agg-6 text-agg-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-agg-primary focus-visible:ring-offset-0 focus-visible:ring-offset-agg-secondary-hover cursor-pointer disabled:cursor-not-allowed disabled:text-agg-muted-foreground";
+export declare const SWITCH_BUTTON_OPTION_BASE_CLASS_NAME = "agg-switch-button-option whitespace-nowrap relative z-10 min-w-0 rounded-agg-full px-5 py-1.5 font-agg-sans text-agg-sm leading-agg-5 md:text-agg-base md:leading-agg-6 text-agg-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-agg-primary focus-visible:ring-offset-0 focus-visible:ring-offset-agg-secondary-hover cursor-pointer disabled:cursor-not-allowed disabled:text-agg-muted-foreground";

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

@@ -2,6 +2,6 @@ import type { TooltipProps } from "./tooltip.types";
 export type { TooltipProps } from "./tooltip.types";
 /** Renders a tooltip with an optional custom trigger and animated floating content. */
 export declare const Tooltip: {
-    ({ content, children, size, side, delayDuration, collisionPadding, classNames, "aria-label": ariaLabel, }: TooltipProps): JSX.Element;
+    ({ content, children, size, side, delayDuration, collisionPadding, sideOffset, classNames, "aria-label": ariaLabel, }: TooltipProps): JSX.Element;
     displayName: string;
 };

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

@@ -2,6 +2,6 @@ import type { TooltipProps } from "./tooltip.types";
 export type { TooltipProps } from "./tooltip.types";
 /** Renders a tooltip with an optional custom trigger and animated floating content. */
 export declare const Tooltip: {
-    ({ content, children, size, side, delayDuration, collisionPadding, classNames, "aria-label": ariaLabel, }: TooltipProps): JSX.Element;
+    ({ content, children, size, side, delayDuration, collisionPadding, sideOffset, classNames, "aria-label": ariaLabel, }: TooltipProps): JSX.Element;
     displayName: string;
 };

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

@@ -19,6 +19,8 @@ export interface TooltipProps {
     delayDuration?: number;
     /** Collision padding for viewport/surface boundaries. */
     collisionPadding?: number;
+    /** Distance in px between the tooltip and its trigger. */
+    sideOffset?: number;
     /** Optional className overrides for internal parts. */
     classNames?: TooltipClassNames;
     /** Accessible label for the default icon trigger. Ignored when a custom trigger is provided. */

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

@@ -19,6 +19,8 @@ export interface TooltipProps {
     delayDuration?: number;
     /** Collision padding for viewport/surface boundaries. */
     collisionPadding?: number;
+    /** Distance in px between the tooltip and its trigger. */
+    sideOffset?: number;
     /** Optional className overrides for internal parts. */
     classNames?: TooltipClassNames;
     /** Accessible label for the default icon trigger. Ignored when a custom trigger is provided. */

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

@@ -0,0 +1,183 @@
+/**
+ * Developer-only debug collector for the Place Order / quote-execution flow.
+ *
+ * When enabled, the surrounding component pushes structured snapshots of every
+ * meaningful step into a global store and exposes a small set of helpers on
+ * `window` so a developer (or designer reporting a bug) can do this in the
+ * browser console after a failed order:
+ *
+ *   window.getFailedExecutionData()   // copies sanitized JSON to clipboard
+ *   window.getExecutionData()         // full store, sanitized + copied
+ *   window.clearExecutionData()       // wipe the store and start fresh
+ *
+ * Enablement
+ * ----------
+ * Off by default. Partner apps opt in by setting `enableDebug: true` on
+ * `AggUiConfig` (typically gated on a `NEXT_PUBLIC_AGG_ENABLE_DEBUG` env var
+ * in the host app). When `enableDebug` is `false` the place-order component
+ * never invokes `enableExecutionDebugInBrowser`, so this module installs no
+ * window helpers and performs no side effects.
+ *
+ * What gets captured per attempt
+ * ------------------------------
+ *  - Quote request input + the selected route summary.
+ *  - Order side (buy/sell), market/event identifiers, venue identifiers.
+ *  - Normalized display steps and the raw DAG / websocket events that
+ *    produced them.
+ *  - Wallet-confirmation transitions.
+ *  - Bridge / venue-execution metadata when present in the route.
+ *  - Terminal status (`succeeded` / `failed` / `cancelled` / ...).
+ *  - Errors, including the failed step / message / code when available.
+ *  - Environment info: app + package versions if known, URL, user agent,
+ *    capture timestamp.
+ *
+ * What is intentionally redacted
+ * ------------------------------
+ *  - JWTs, access/refresh tokens, raw `Authorization` headers, cookies.
+ *  - Wallet signatures and private keys.
+ *  - Passwords, API keys, generic `secret` values.
+ *  - Email addresses (and any field whose name *contains* `email`).
+ *  - Raw HTTP `headers` blobs (the Authorization line is never useful in a
+ *    bug report and may carry session material).
+ *  Any field name containing one of the patterns in `SENSITIVE_FIELD_PATTERNS`
+ *  is replaced with the literal string `[redacted]` in the output. Cycles in
+ *  the captured object graph are broken with `[circular]`.
+ *
+ * Example workflow for designers / testers reporting a bug
+ * --------------------------------------------------------
+ *  1. Reproduce the failed order in dev/staging/preview.
+ *  2. Open DevTools → Console.
+ *  3. Run: `window.getFailedExecutionData()`
+ *  4. Paste the clipboard contents into the bug report (Linear / Slack).
+ *  5. Optionally `window.clearExecutionData()` before the next reproduction
+ *     so subsequent attempts start with an empty timeline.
+ */
+/**
+ * Recursively redact known-sensitive fields. The output is a structurally
+ * identical clone of the input where any sensitive value has been replaced
+ * with the literal `[redacted]` marker. Non-sensitive fields pass through
+ * unchanged.
+ *
+ * Cycle detection tracks only the current DFS path (parents of the node
+ * currently being walked), not every node ever seen. That distinction
+ * matters: shared references — e.g. the same `orderIds` array stored on
+ * multiple `state_change` events, or the same selected-route object
+ * referenced in two sibling fields — are NOT cycles and must serialize fully
+ * each time. Only true ancestor self-references (`a.self = a`) are
+ * collapsed to the literal `[circular]` marker.
+ */
+export declare const sanitizeExecutionDebugValue: <T>(input: T) => T;
+export type ExecutionDebugStatus = "idle" | "quoting" | "executing" | "wallet_confirmation_required" | "succeeded" | "failed" | "cancelled";
+export type ExecutionDebugQuoteSnapshot = {
+    request?: unknown;
+    response?: unknown;
+    selectedRoute?: unknown;
+    side?: "buy" | "sell";
+    marketId?: string;
+    eventId?: string;
+    outcomeId?: string;
+    venues?: string[];
+    capturedAt: number;
+};
+export type ExecutionDebugEvent = {
+    /** Stable category — useful for filtering. */
+    kind: "quote_request" | "quote_response" | "execute_request" | "execute_response" | "state_change" | "ws_update" | "normalized_steps" | "wallet_confirmation" | "terminal_event" | "error";
+    /** Free-form label distinguishing events of the same `kind`. */
+    label?: string;
+    data?: unknown;
+    timestamp: number;
+};
+export type ExecutionDebugError = {
+    message: string;
+    name?: string;
+    code?: string;
+    stack?: string;
+    failedStep?: string;
+    data?: unknown;
+    timestamp: number;
+};
+export type ExecutionDebugAttempt = {
+    attemptId: string;
+    startedAt: number;
+    updatedAt: number;
+    status: ExecutionDebugStatus;
+    /** Promoted to top level for at-a-glance triage when scrolling failed attempts. */
+    quoteId?: string;
+    /** First / primary order ID once `executeManaged` returns. */
+    orderId?: string;
+    /** All order IDs in the executed route (for split orders). */
+    orderIds?: string[];
+    quote?: ExecutionDebugQuoteSnapshot;
+    selectedRoute?: unknown;
+    bridge?: unknown;
+    venueExecution?: unknown;
+    rawEvents: ExecutionDebugEvent[];
+    normalizedSteps: unknown[];
+    errors: ExecutionDebugError[];
+    finalStatus?: ExecutionDebugStatus;
+};
+export type ExecutionDebugEnvironment = {
+    appVersion?: string;
+    packageVersions?: Record<string, string>;
+    url?: string;
+    userAgent?: string;
+    capturedAt: number;
+};
+export type ExecutionDebugStore = {
+    attempts: ExecutionDebugAttempt[];
+    environment: ExecutionDebugEnvironment;
+};
+export type AppendExecutionDebugAttemptInput = Partial<Pick<ExecutionDebugAttempt, "status" | "quoteId" | "orderId" | "orderIds" | "quote" | "selectedRoute" | "bridge" | "venueExecution">> & {
+    attemptId?: string;
+};
+export type UpdateExecutionDebugAttemptInput = Partial<Pick<ExecutionDebugAttempt, "status" | "quoteId" | "orderId" | "orderIds" | "quote" | "selectedRoute" | "bridge" | "venueExecution" | "finalStatus">>;
+/**
+ * Pure debug store. The window-scoped collector below is a thin wrapper around
+ * an instance of this — but the store itself is environment-agnostic and fully
+ * testable in isolation.
+ */
+export declare const createExecutionDebugStore: (initial?: Partial<Omit<ExecutionDebugEnvironment, "capturedAt">>) => {
+    appendAttempt: (input?: AppendExecutionDebugAttemptInput) => ExecutionDebugAttempt;
+    updateAttempt: (attemptId: string, patch: UpdateExecutionDebugAttemptInput) => void;
+    appendEvent: (attemptId: string, event: Omit<ExecutionDebugEvent, "timestamp"> & {
+        timestamp?: number;
+    }) => void;
+    appendError: (attemptId: string, error: Omit<ExecutionDebugError, "timestamp"> & {
+        timestamp?: number;
+    }) => void;
+    setNormalizedSteps: (attemptId: string, steps: unknown[]) => void;
+    getSnapshot: () => ExecutionDebugStore;
+    getFailedAttempts: () => ExecutionDebugAttempt[];
+    clear: () => void;
+};
+export type ExecutionDebugStoreInstance = ReturnType<typeof createExecutionDebugStore>;
+declare global {
+    interface Window {
+        executionData?: ExecutionDebugStore;
+        getExecutionData?: () => ExecutionDebugStore;
+        getFailedExecutionData?: () => {
+            attempts: ExecutionDebugAttempt[];
+        };
+        clearExecutionData?: () => void;
+        __aggExecutionDebugStore?: ExecutionDebugStoreInstance;
+    }
+}
+export type InstallExecutionDebugWindowOptions = {
+    store: ExecutionDebugStoreInstance;
+    /** Override `console` for testing the activation banner and copy logs. */
+    consoleImpl?: Pick<Console, "info" | "warn" | "log">;
+};
+/**
+ * Install the `window.executionData` / `window.getExecutionData()` /
+ * `window.getFailedExecutionData()` / `window.clearExecutionData()` helpers
+ * in the current document. Returns an `uninstall` callback that restores the
+ * previous values — handy for cleanup in tests and React effects.
+ */
+export declare const installExecutionDebugWindow: ({ store, consoleImpl, }: InstallExecutionDebugWindowOptions) => (() => void);
+/**
+ * Convenience: shared singleton + window-installer used by the React layer.
+ * Returns `null` when there is no `window` (SSR). Callers gate this on the
+ * `enableDebug` flag from `AggUiConfig` — when that flag is off, this is
+ * never invoked and the module has no runtime footprint.
+ */
+export declare const enableExecutionDebugInBrowser: (initial?: Partial<Omit<ExecutionDebugEnvironment, "capturedAt">>) => ExecutionDebugStoreInstance | null;

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

@@ -0,0 +1,183 @@
+/**
+ * Developer-only debug collector for the Place Order / quote-execution flow.
+ *
+ * When enabled, the surrounding component pushes structured snapshots of every
+ * meaningful step into a global store and exposes a small set of helpers on
+ * `window` so a developer (or designer reporting a bug) can do this in the
+ * browser console after a failed order:
+ *
+ *   window.getFailedExecutionData()   // copies sanitized JSON to clipboard
+ *   window.getExecutionData()         // full store, sanitized + copied
+ *   window.clearExecutionData()       // wipe the store and start fresh
+ *
+ * Enablement
+ * ----------
+ * Off by default. Partner apps opt in by setting `enableDebug: true` on
+ * `AggUiConfig` (typically gated on a `NEXT_PUBLIC_AGG_ENABLE_DEBUG` env var
+ * in the host app). When `enableDebug` is `false` the place-order component
+ * never invokes `enableExecutionDebugInBrowser`, so this module installs no
+ * window helpers and performs no side effects.
+ *
+ * What gets captured per attempt
+ * ------------------------------
+ *  - Quote request input + the selected route summary.
+ *  - Order side (buy/sell), market/event identifiers, venue identifiers.
+ *  - Normalized display steps and the raw DAG / websocket events that
+ *    produced them.
+ *  - Wallet-confirmation transitions.
+ *  - Bridge / venue-execution metadata when present in the route.
+ *  - Terminal status (`succeeded` / `failed` / `cancelled` / ...).
+ *  - Errors, including the failed step / message / code when available.
+ *  - Environment info: app + package versions if known, URL, user agent,
+ *    capture timestamp.
+ *
+ * What is intentionally redacted
+ * ------------------------------
+ *  - JWTs, access/refresh tokens, raw `Authorization` headers, cookies.
+ *  - Wallet signatures and private keys.
+ *  - Passwords, API keys, generic `secret` values.
+ *  - Email addresses (and any field whose name *contains* `email`).
+ *  - Raw HTTP `headers` blobs (the Authorization line is never useful in a
+ *    bug report and may carry session material).
+ *  Any field name containing one of the patterns in `SENSITIVE_FIELD_PATTERNS`
+ *  is replaced with the literal string `[redacted]` in the output. Cycles in
+ *  the captured object graph are broken with `[circular]`.
+ *
+ * Example workflow for designers / testers reporting a bug
+ * --------------------------------------------------------
+ *  1. Reproduce the failed order in dev/staging/preview.
+ *  2. Open DevTools → Console.
+ *  3. Run: `window.getFailedExecutionData()`
+ *  4. Paste the clipboard contents into the bug report (Linear / Slack).
+ *  5. Optionally `window.clearExecutionData()` before the next reproduction
+ *     so subsequent attempts start with an empty timeline.
+ */
+/**
+ * Recursively redact known-sensitive fields. The output is a structurally
+ * identical clone of the input where any sensitive value has been replaced
+ * with the literal `[redacted]` marker. Non-sensitive fields pass through
+ * unchanged.
+ *
+ * Cycle detection tracks only the current DFS path (parents of the node
+ * currently being walked), not every node ever seen. That distinction
+ * matters: shared references — e.g. the same `orderIds` array stored on
+ * multiple `state_change` events, or the same selected-route object
+ * referenced in two sibling fields — are NOT cycles and must serialize fully
+ * each time. Only true ancestor self-references (`a.self = a`) are
+ * collapsed to the literal `[circular]` marker.
+ */
+export declare const sanitizeExecutionDebugValue: <T>(input: T) => T;
+export type ExecutionDebugStatus = "idle" | "quoting" | "executing" | "wallet_confirmation_required" | "succeeded" | "failed" | "cancelled";
+export type ExecutionDebugQuoteSnapshot = {
+    request?: unknown;
+    response?: unknown;
+    selectedRoute?: unknown;
+    side?: "buy" | "sell";
+    marketId?: string;
+    eventId?: string;
+    outcomeId?: string;
+    venues?: string[];
+    capturedAt: number;
+};
+export type ExecutionDebugEvent = {
+    /** Stable category — useful for filtering. */
+    kind: "quote_request" | "quote_response" | "execute_request" | "execute_response" | "state_change" | "ws_update" | "normalized_steps" | "wallet_confirmation" | "terminal_event" | "error";
+    /** Free-form label distinguishing events of the same `kind`. */
+    label?: string;
+    data?: unknown;
+    timestamp: number;
+};
+export type ExecutionDebugError = {
+    message: string;
+    name?: string;
+    code?: string;
+    stack?: string;
+    failedStep?: string;
+    data?: unknown;
+    timestamp: number;
+};
+export type ExecutionDebugAttempt = {
+    attemptId: string;
+    startedAt: number;
+    updatedAt: number;
+    status: ExecutionDebugStatus;
+    /** Promoted to top level for at-a-glance triage when scrolling failed attempts. */
+    quoteId?: string;
+    /** First / primary order ID once `executeManaged` returns. */
+    orderId?: string;
+    /** All order IDs in the executed route (for split orders). */
+    orderIds?: string[];
+    quote?: ExecutionDebugQuoteSnapshot;
+    selectedRoute?: unknown;
+    bridge?: unknown;
+    venueExecution?: unknown;
+    rawEvents: ExecutionDebugEvent[];
+    normalizedSteps: unknown[];
+    errors: ExecutionDebugError[];
+    finalStatus?: ExecutionDebugStatus;
+};
+export type ExecutionDebugEnvironment = {
+    appVersion?: string;
+    packageVersions?: Record<string, string>;
+    url?: string;
+    userAgent?: string;
+    capturedAt: number;
+};
+export type ExecutionDebugStore = {
+    attempts: ExecutionDebugAttempt[];
+    environment: ExecutionDebugEnvironment;
+};
+export type AppendExecutionDebugAttemptInput = Partial<Pick<ExecutionDebugAttempt, "status" | "quoteId" | "orderId" | "orderIds" | "quote" | "selectedRoute" | "bridge" | "venueExecution">> & {
+    attemptId?: string;
+};
+export type UpdateExecutionDebugAttemptInput = Partial<Pick<ExecutionDebugAttempt, "status" | "quoteId" | "orderId" | "orderIds" | "quote" | "selectedRoute" | "bridge" | "venueExecution" | "finalStatus">>;
+/**
+ * Pure debug store. The window-scoped collector below is a thin wrapper around
+ * an instance of this — but the store itself is environment-agnostic and fully
+ * testable in isolation.
+ */
+export declare const createExecutionDebugStore: (initial?: Partial<Omit<ExecutionDebugEnvironment, "capturedAt">>) => {
+    appendAttempt: (input?: AppendExecutionDebugAttemptInput) => ExecutionDebugAttempt;
+    updateAttempt: (attemptId: string, patch: UpdateExecutionDebugAttemptInput) => void;
+    appendEvent: (attemptId: string, event: Omit<ExecutionDebugEvent, "timestamp"> & {
+        timestamp?: number;
+    }) => void;
+    appendError: (attemptId: string, error: Omit<ExecutionDebugError, "timestamp"> & {
+        timestamp?: number;
+    }) => void;
+    setNormalizedSteps: (attemptId: string, steps: unknown[]) => void;
+    getSnapshot: () => ExecutionDebugStore;
+    getFailedAttempts: () => ExecutionDebugAttempt[];
+    clear: () => void;
+};
+export type ExecutionDebugStoreInstance = ReturnType<typeof createExecutionDebugStore>;
+declare global {
+    interface Window {
+        executionData?: ExecutionDebugStore;
+        getExecutionData?: () => ExecutionDebugStore;
+        getFailedExecutionData?: () => {
+            attempts: ExecutionDebugAttempt[];
+        };
+        clearExecutionData?: () => void;
+        __aggExecutionDebugStore?: ExecutionDebugStoreInstance;
+    }
+}
+export type InstallExecutionDebugWindowOptions = {
+    store: ExecutionDebugStoreInstance;
+    /** Override `console` for testing the activation banner and copy logs. */
+    consoleImpl?: Pick<Console, "info" | "warn" | "log">;
+};
+/**
+ * Install the `window.executionData` / `window.getExecutionData()` /
+ * `window.getFailedExecutionData()` / `window.clearExecutionData()` helpers
+ * in the current document. Returns an `uninstall` callback that restores the
+ * previous values — handy for cleanup in tests and React effects.
+ */
+export declare const installExecutionDebugWindow: ({ store, consoleImpl, }: InstallExecutionDebugWindowOptions) => (() => void);
+/**
+ * Convenience: shared singleton + window-installer used by the React layer.
+ * Returns `null` when there is no `window` (SSR). Callers gate this on the
+ * `enableDebug` flag from `AggUiConfig` — when that flag is off, this is
+ * never invoked and the module has no runtime footprint.
+ */
+export declare const enableExecutionDebugInBrowser: (initial?: Partial<Omit<ExecutionDebugEnvironment, "capturedAt">>) => ExecutionDebugStoreInstance | null;

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

@@ -0,0 +1,72 @@
+import type { DagStepProgress } from "@agg-build/hooks";
+import type { TradingVenue } from "../types";
+import type { PlaceOrderSubmissionProgressPhase, PlaceOrderTradingLabels } from "./index.place-order.types";
+/**
+ * Stable, user-facing phases for the in-flight Place Order submission UI.
+ *
+ * The DAG executor emits many granular step types (`bridge-fetch-quote`,
+ * `polymarket-setup-resolve-need`, `submit-verify-order-status`, etc.) that
+ * are an implementation detail of how a route is fulfilled. Surfacing them
+ * directly produces noisy, confusing progress and leaks internal architecture
+ * to partners. We collapse every raw step into one of a small, fixed set of
+ * normalized phases here, then drive rendering off the normalized model.
+ *
+ * Anything not in this list (bridge, ata, approve, swap, transfer, position,
+ * polymarket-setup, hl-fund, wait sentinels) maps to either `checking-balance`
+ * (read-only probes) or `submitting`.
+ */
+export type NormalizedExecutionPhaseKind = "finding-route" | "checking-balance" | "submitting" | "wallet-confirm" | "executing-venue" | "filled" | "failed";
+export type NormalizedExecutionPhase = {
+    kind: NormalizedExecutionPhaseKind;
+    /** Set when the phase is venue-scoped — `executing-venue` and finalize legs. */
+    venue?: TradingVenue;
+};
+export type SubmissionDisplayRow = {
+    id: string;
+    label: string;
+    status: "pending" | "complete";
+    venue?: TradingVenue;
+};
+/**
+ * Classify a raw DAG step type into the normalized phase it represents.
+ *
+ * Returns `null` for wait sentinels and unrecognized step types — the caller
+ * should skip these so they don't introduce a fake "Wait" or `Step N of M`
+ * row in the UI.
+ */
+export declare const classifyExecutionStepType: (stepType: string) => NormalizedExecutionPhase | null;
+type PhaseTimelineEntry = NormalizedExecutionPhase & {
+    firstSeq: number;
+    lastSeq: number;
+    allCompleted: boolean;
+};
+/**
+ * Walk the DAG sequences in order, classify each, and merge consecutive
+ * entries that share the same kind+venue. The result is the
+ * presentation-layer timeline of high-level phases.
+ *
+ * A merged entry is `allCompleted` only when every underlying sequence has
+ * finished — so a single in-flight `bridge-submit` keeps the merged
+ * "submitting" row pending even if `bridge-fetch-quote` already completed.
+ */
+export declare const buildPhaseTimeline: (dag: DagStepProgress) => PhaseTimelineEntry[];
+export type BuildSubmissionDisplayRowsArgs = {
+    phase: PlaceOrderSubmissionProgressPhase;
+    dagProgress: DagStepProgress | null | undefined;
+    executionVenue?: TradingVenue;
+    /** Whether the active submitting beat is waiting on a wallet signature. */
+    isAwaitingWalletConfirmation?: boolean;
+    labels: PlaceOrderTradingLabels;
+};
+/**
+ * Produce the rows the in-flight Place Order surface should render.
+ *
+ * Invariants:
+ *   - At most one row has status `pending`.
+ *   - Completed rows are kept only when they correspond to a meaningful
+ *     user-facing milestone (the normalized phases above).
+ *   - The same kind+venue never appears twice — repeated `step_started` /
+ *     `step_waiting` events on the same phase don't duplicate rows.
+ */
+export declare const buildSubmissionDisplayRows: ({ phase, dagProgress, executionVenue, isAwaitingWalletConfirmation, labels, }: BuildSubmissionDisplayRowsArgs) => SubmissionDisplayRow[];
+export {};

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

@@ -0,0 +1,72 @@
+import type { DagStepProgress } from "@agg-build/hooks";
+import type { TradingVenue } from "../types";
+import type { PlaceOrderSubmissionProgressPhase, PlaceOrderTradingLabels } from "./index.place-order.types";
+/**
+ * Stable, user-facing phases for the in-flight Place Order submission UI.
+ *
+ * The DAG executor emits many granular step types (`bridge-fetch-quote`,
+ * `polymarket-setup-resolve-need`, `submit-verify-order-status`, etc.) that
+ * are an implementation detail of how a route is fulfilled. Surfacing them
+ * directly produces noisy, confusing progress and leaks internal architecture
+ * to partners. We collapse every raw step into one of a small, fixed set of
+ * normalized phases here, then drive rendering off the normalized model.
+ *
+ * Anything not in this list (bridge, ata, approve, swap, transfer, position,
+ * polymarket-setup, hl-fund, wait sentinels) maps to either `checking-balance`
+ * (read-only probes) or `submitting`.
+ */
+export type NormalizedExecutionPhaseKind = "finding-route" | "checking-balance" | "submitting" | "wallet-confirm" | "executing-venue" | "filled" | "failed";
+export type NormalizedExecutionPhase = {
+    kind: NormalizedExecutionPhaseKind;
+    /** Set when the phase is venue-scoped — `executing-venue` and finalize legs. */
+    venue?: TradingVenue;
+};
+export type SubmissionDisplayRow = {
+    id: string;
+    label: string;
+    status: "pending" | "complete";
+    venue?: TradingVenue;
+};
+/**
+ * Classify a raw DAG step type into the normalized phase it represents.
+ *
+ * Returns `null` for wait sentinels and unrecognized step types — the caller
+ * should skip these so they don't introduce a fake "Wait" or `Step N of M`
+ * row in the UI.
+ */
+export declare const classifyExecutionStepType: (stepType: string) => NormalizedExecutionPhase | null;
+type PhaseTimelineEntry = NormalizedExecutionPhase & {
+    firstSeq: number;
+    lastSeq: number;
+    allCompleted: boolean;
+};
+/**
+ * Walk the DAG sequences in order, classify each, and merge consecutive
+ * entries that share the same kind+venue. The result is the
+ * presentation-layer timeline of high-level phases.
+ *
+ * A merged entry is `allCompleted` only when every underlying sequence has
+ * finished — so a single in-flight `bridge-submit` keeps the merged
+ * "submitting" row pending even if `bridge-fetch-quote` already completed.
+ */
+export declare const buildPhaseTimeline: (dag: DagStepProgress) => PhaseTimelineEntry[];
+export type BuildSubmissionDisplayRowsArgs = {
+    phase: PlaceOrderSubmissionProgressPhase;
+    dagProgress: DagStepProgress | null | undefined;
+    executionVenue?: TradingVenue;
+    /** Whether the active submitting beat is waiting on a wallet signature. */
+    isAwaitingWalletConfirmation?: boolean;
+    labels: PlaceOrderTradingLabels;
+};
+/**
+ * Produce the rows the in-flight Place Order surface should render.
+ *
+ * Invariants:
+ *   - At most one row has status `pending`.
+ *   - Completed rows are kept only when they correspond to a meaningful
+ *     user-facing milestone (the normalized phases above).
+ *   - The same kind+venue never appears twice — repeated `step_started` /
+ *     `step_waiting` events on the same phase don't duplicate rows.
+ */
+export declare const buildSubmissionDisplayRows: ({ phase, dagProgress, executionVenue, isAwaitingWalletConfirmation, labels, }: BuildSubmissionDisplayRowsArgs) => SubmissionDisplayRow[];
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/ui",
-  "version": "1.2.7",
+  "version": "1.2.9",
   "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",