@agg-build/ui 1.0.0

package/dist/types/events/market-details/market-details.types.d.ts

@@ -0,0 +1,143 @@
+import type { EventTradingState, VenueMarket } from "@agg-build/hooks";
+import type React from "react";
+import type { VenueLogoName } from "../../primitives/venue-logo/venue-logo.types";
+export type MarketDetailsTab = "order-book" | "graph" | "other";
+export type MarketDetailsClassNames = Partial<{
+    root: string;
+    header: string;
+    tabs: string;
+    content: string;
+    orderBook: string;
+    graph: string;
+    footer: string;
+}>;
+export type MarketDetailsBaseProps = {
+    /** Market ID used to fetch or match the active market details. */
+    marketId?: string;
+    /** Title shown in the market details header. */
+    title?: string;
+    /** Optional image shown alongside the market header content. */
+    image?: string | null;
+    /** Whether the accordion item should start opened. */
+    defaultIsOpened?: boolean;
+    /** Controlled open state for the market details accordion item. */
+    isOpened?: boolean;
+    /** Called when the market details accordion is opened. */
+    onOpenChange?: (marketId: string) => void;
+    /** Called when the market details surface is clicked. */
+    onClick?: (market?: VenueMarket) => void;
+    /** Default tab shown when the details open. */
+    defaultTab?: MarketDetailsTab;
+    /** Default outcome label used for order book and graph context. */
+    defaultOutcomeLabel?: string;
+    /** Number of order book rows to show per side. */
+    orderBookDepth?: number;
+    /** Accessible label applied to the market details surface. */
+    ariaLabel?: string;
+    /** Class name overrides for market details layout slots. */
+    classNames?: MarketDetailsClassNames;
+    /** Custom content rendered in the "other" tab. */
+    otherContent?: React.ReactNode;
+    /** Whether the market details should render a loading state. */
+    isLoading?: boolean;
+    /** Override live WS subscriptions for chart and orderbook hooks.
+     *  Set to `false` when a parent component already manages subscriptions
+     *  (e.g. useEventOrderbookData on the event page).
+     *  Defaults to the global `enableLiveUpdates` feature flag. */
+    live?: boolean;
+};
+export type MarketDetailsLoadingProps = MarketDetailsBaseProps & {
+    /** Forces the market details component into its loading state. */
+    isLoading: true;
+    /** Prevents passing prefetched markets while loading. */
+    venueMarkets?: never;
+    /** Legacy event prop is not supported in loading mode. */
+    event?: never;
+    /** Optional event ID used to fetch market details while loading. */
+    eventId?: string;
+};
+export type MarketDetailsWithMarketsProps = MarketDetailsBaseProps & {
+    /** Venue markets to display. Replaces the old event-based data source. */
+    venueMarkets: VenueMarket[];
+    /** Legacy event prop is intentionally unsupported. */
+    event?: never;
+    /** Prevents mixing prefetched markets with event ID fetching. */
+    eventId?: never;
+    /** Marks the market details component as loaded. */
+    isLoading?: false;
+    /**
+     * Optional REST midpoints keyed by outcome id. Used as a fallback when the
+     * live (WebSocket) cache has no data for an outcome — typically because the
+     * card is not the selected market and therefore isn't on the WS feed.
+     */
+    midpointsFallback?: Map<string, number>;
+};
+export type MarketDetailsProps = MarketDetailsLoadingProps | MarketDetailsWithMarketsProps;
+export type MarketDetailsContentProps = MarketDetailsBaseProps & {
+    /** Prefetched venue markets rendered by the content component. */
+    venueMarkets: VenueMarket[];
+    /** See MarketDetailsWithMarketsProps.midpointsFallback. */
+    midpointsFallback?: Map<string, number>;
+};
+export type MarketDetailsListClassNames = Partial<{
+    root: string;
+    item: string;
+}>;
+export type MarketDetailsListProps = {
+    /** Venue event ID to fetch all markets for. */
+    eventId?: string;
+    /** Prefetched markets to render instead of fetching by event ID. */
+    markets?: VenueMarket[];
+    /** Shared event-level trading state passed from the page when already derived. */
+    eventTradingState?: EventTradingState;
+    /** Called when the expanded market changes. */
+    onExpandedMarketChange?: (marketId: string | null) => void;
+    /** Called when a market is clicked. */
+    onClick?: (market: VenueMarket) => void;
+    /** Default tab to display. */
+    defaultTab?: MarketDetailsTab;
+    /** Class names for the market details list. */
+    classNames?: MarketDetailsListClassNames;
+    /** Override live WS subscriptions for child MarketDetails.
+     *  Set to `false` when a parent manages subscriptions centrally. */
+    live?: boolean;
+};
+export type MarketDetailsOrderBookTone = "positive" | "negative";
+export type MarketDetailsOutcomeTone = MarketDetailsOrderBookTone;
+export type MarketDetailsHeaderOutcomeItem = {
+    id: string;
+    label: string;
+    probability: number | undefined;
+    tone: MarketDetailsOutcomeTone;
+    venue: VenueLogoName;
+};
+export type MarketDetailsOrderBookRow = {
+    id: string;
+    venues: VenueLogoName[];
+    price: number;
+    size: number;
+    total: number;
+    tone: MarketDetailsOrderBookTone;
+    barScale: number;
+    venueBreakdown?: Partial<Record<VenueLogoName, number>>;
+    sourceOutcomeIds?: string[];
+};
+export type MarketDetailsMetaRow = {
+    label: string;
+    value: string;
+};
+export type UnifiedOrderBookEntry = {
+    kind: "ask";
+    row: MarketDetailsOrderBookRow;
+    cumulativeDepth: number;
+    unifiedBarScale: number;
+} | {
+    kind: "bid";
+    row: MarketDetailsOrderBookRow;
+    cumulativeDepth: number;
+    unifiedBarScale: number;
+} | {
+    kind: "spread";
+    midPrice: number | null;
+    spread: number | null;
+};

package/dist/types/events/market-details/market-details.utils.d.mts

@@ -0,0 +1,72 @@
+import type { AggUiLabels, MarketOrderbookData, VenueMarket } from "@agg-build/hooks";
+import { buildPriceHistoryGroups, formatXAxisDateLabel, getTimeWindowByRange, resolveCanonicalMarketId, resolveMarketChartDisplaySeries, resolveMarketChartLiveState, resolveMarketChartVenueSeries, resolveOutcomesByVenue, resolveSeriesColor, scaledCandlesToLineChartPoints } from "../item-details/event-list-item-details.utils";
+import { resolveOutcomeTitle } from "../item/event-list-item.utils";
+import type { OrderbookRowData } from "../orderbook/orderbook.types";
+import type { MarketDetailsHeaderOutcomeItem, MarketDetailsMetaRow, MarketDetailsOrderBookTone, MarketDetailsTab } from "./market-details.types";
+export { formatProbabilityCents, resolveOrderBookRows, resolveUnifiedOrderBookEntries, } from "../orderbook/orderbook.utils";
+/**
+ * Converts aggregated orderbook data (from `useMarketOrderbook`) into presentational
+ * `OrderbookRowData[]` for the `Orderbook` component.
+ *
+ * Each `AggregatedOrderbookLevel` has a `venues` map (venue → size). We keep all
+ * contributing venues so the row can display multiple logos.
+ */
+export declare const resolveAggregatedOrderBookRows: ({ orderbookData, side, }: {
+    orderbookData: MarketOrderbookData | null | undefined;
+    side: "asks" | "bids";
+}) => OrderbookRowData[];
+export declare const resolveInitialTab: (defaultTab: MarketDetailsTab | undefined) => MarketDetailsTab;
+export type ResolvedMarket = {
+    id: string;
+    venueMarkets: VenueMarket[];
+    volume: number | null | undefined;
+    status?: string;
+    startDate?: string | null;
+    endDate?: string | null;
+    creationDate?: string | null;
+    question: string;
+};
+/**
+ * Build a ResolvedMarket from a flat array of venue markets.
+ * When `marketId` is provided, resolves the full logical match cluster for that market.
+ * When `marketId` is omitted, uses all provided markets.
+ */
+export declare const resolveMarketFromVenueMarkets: (venueMarkets: VenueMarket[], marketId: string | undefined) => ResolvedMarket | undefined;
+export declare const resolveDisplayOutcomeLabels: (labels: string[]) => string[];
+export declare const resolveInitialOutcomeLabel: (labels: string[], defaultOutcomeLabel: string | undefined) => string | undefined;
+export declare const resolveScopedSelectedOutcome: ({ venueMarkets, selectedOutcomeId, defaultOutcomeLabel, }: {
+    venueMarkets: VenueMarket[];
+    selectedOutcomeId: string | null | undefined;
+    defaultOutcomeLabel: string | undefined;
+}) => {
+    outcomeId: string | null;
+    outcomeLabel: string | undefined;
+};
+export declare const resolveAverageProbabilityByLabel: (venueMarkets: VenueMarket[], labels: string[]) => Map<string, number | undefined>;
+export declare const formatProbabilityPercent: (value: number | null | undefined, formatPercent?: (value: number) => string) => string;
+export declare const resolveOutcomeTone: (label: string, index: number) => MarketDetailsOrderBookTone;
+export declare const resolveHeaderOutcomeItems: (venueMarkets: VenueMarket[]) => MarketDetailsHeaderOutcomeItem[];
+export declare const resolveSubtitle: ({ venueMarkets, volume, formatCompactCurrency, labels, }: {
+    venueMarkets: VenueMarket[];
+    volume: number | undefined;
+    formatCompactCurrency: (value: number) => string;
+    labels: AggUiLabels;
+}) => string;
+export declare const resolveOtherTabRows: (market: ResolvedMarket, labels: AggUiLabels) => MarketDetailsMetaRow[];
+export declare const buildMarketDetailsModel: ({ venueMarkets, marketId, title, image, formatCompactCurrency, labels, }: {
+    venueMarkets: VenueMarket[];
+    marketId: string | undefined;
+    title: string | undefined;
+    image: string | null | undefined;
+    formatCompactCurrency: (value: number) => string;
+    labels: AggUiLabels;
+}) => {
+    market: ResolvedMarket;
+    primaryVenueMarket: VenueMarket;
+    title: string;
+    image: string | undefined;
+    subtitle: string;
+    outcomeLabels: string[];
+    probabilityByLabel: Map<string, number | undefined>;
+} | undefined;
+export { buildPriceHistoryGroups, formatXAxisDateLabel, getTimeWindowByRange, resolveCanonicalMarketId, resolveMarketChartDisplaySeries, resolveMarketChartLiveState, resolveMarketChartVenueSeries, resolveOutcomesByVenue, resolveOutcomeTitle, resolveSeriesColor, scaledCandlesToLineChartPoints, };

package/dist/types/events/market-details/market-details.utils.d.ts

@@ -0,0 +1,72 @@
+import type { AggUiLabels, MarketOrderbookData, VenueMarket } from "@agg-build/hooks";
+import { buildPriceHistoryGroups, formatXAxisDateLabel, getTimeWindowByRange, resolveCanonicalMarketId, resolveMarketChartDisplaySeries, resolveMarketChartLiveState, resolveMarketChartVenueSeries, resolveOutcomesByVenue, resolveSeriesColor, scaledCandlesToLineChartPoints } from "../item-details/event-list-item-details.utils";
+import { resolveOutcomeTitle } from "../item/event-list-item.utils";
+import type { OrderbookRowData } from "../orderbook/orderbook.types";
+import type { MarketDetailsHeaderOutcomeItem, MarketDetailsMetaRow, MarketDetailsOrderBookTone, MarketDetailsTab } from "./market-details.types";
+export { formatProbabilityCents, resolveOrderBookRows, resolveUnifiedOrderBookEntries, } from "../orderbook/orderbook.utils";
+/**
+ * Converts aggregated orderbook data (from `useMarketOrderbook`) into presentational
+ * `OrderbookRowData[]` for the `Orderbook` component.
+ *
+ * Each `AggregatedOrderbookLevel` has a `venues` map (venue → size). We keep all
+ * contributing venues so the row can display multiple logos.
+ */
+export declare const resolveAggregatedOrderBookRows: ({ orderbookData, side, }: {
+    orderbookData: MarketOrderbookData | null | undefined;
+    side: "asks" | "bids";
+}) => OrderbookRowData[];
+export declare const resolveInitialTab: (defaultTab: MarketDetailsTab | undefined) => MarketDetailsTab;
+export type ResolvedMarket = {
+    id: string;
+    venueMarkets: VenueMarket[];
+    volume: number | null | undefined;
+    status?: string;
+    startDate?: string | null;
+    endDate?: string | null;
+    creationDate?: string | null;
+    question: string;
+};
+/**
+ * Build a ResolvedMarket from a flat array of venue markets.
+ * When `marketId` is provided, resolves the full logical match cluster for that market.
+ * When `marketId` is omitted, uses all provided markets.
+ */
+export declare const resolveMarketFromVenueMarkets: (venueMarkets: VenueMarket[], marketId: string | undefined) => ResolvedMarket | undefined;
+export declare const resolveDisplayOutcomeLabels: (labels: string[]) => string[];
+export declare const resolveInitialOutcomeLabel: (labels: string[], defaultOutcomeLabel: string | undefined) => string | undefined;
+export declare const resolveScopedSelectedOutcome: ({ venueMarkets, selectedOutcomeId, defaultOutcomeLabel, }: {
+    venueMarkets: VenueMarket[];
+    selectedOutcomeId: string | null | undefined;
+    defaultOutcomeLabel: string | undefined;
+}) => {
+    outcomeId: string | null;
+    outcomeLabel: string | undefined;
+};
+export declare const resolveAverageProbabilityByLabel: (venueMarkets: VenueMarket[], labels: string[]) => Map<string, number | undefined>;
+export declare const formatProbabilityPercent: (value: number | null | undefined, formatPercent?: (value: number) => string) => string;
+export declare const resolveOutcomeTone: (label: string, index: number) => MarketDetailsOrderBookTone;
+export declare const resolveHeaderOutcomeItems: (venueMarkets: VenueMarket[]) => MarketDetailsHeaderOutcomeItem[];
+export declare const resolveSubtitle: ({ venueMarkets, volume, formatCompactCurrency, labels, }: {
+    venueMarkets: VenueMarket[];
+    volume: number | undefined;
+    formatCompactCurrency: (value: number) => string;
+    labels: AggUiLabels;
+}) => string;
+export declare const resolveOtherTabRows: (market: ResolvedMarket, labels: AggUiLabels) => MarketDetailsMetaRow[];
+export declare const buildMarketDetailsModel: ({ venueMarkets, marketId, title, image, formatCompactCurrency, labels, }: {
+    venueMarkets: VenueMarket[];
+    marketId: string | undefined;
+    title: string | undefined;
+    image: string | null | undefined;
+    formatCompactCurrency: (value: number) => string;
+    labels: AggUiLabels;
+}) => {
+    market: ResolvedMarket;
+    primaryVenueMarket: VenueMarket;
+    title: string;
+    image: string | undefined;
+    subtitle: string;
+    outcomeLabels: string[];
+    probabilityByLabel: Map<string, number | undefined>;
+} | undefined;
+export { buildPriceHistoryGroups, formatXAxisDateLabel, getTimeWindowByRange, resolveCanonicalMarketId, resolveMarketChartDisplaySeries, resolveMarketChartLiveState, resolveMarketChartVenueSeries, resolveOutcomesByVenue, resolveOutcomeTitle, resolveSeriesColor, scaledCandlesToLineChartPoints, };

package/dist/types/events/market-details/orderbook-aggregation.d.mts

@@ -0,0 +1,30 @@
+import { type MarketOrderbookData, type VenueMarket, type VenueMarketOutcome } from "@agg-build/hooks";
+import type { OrderbookRowData } from "../orderbook";
+export type EligibleVenueOutcome = {
+    venue: VenueMarket["venue"];
+    market: VenueMarket;
+    outcome: VenueMarketOutcome;
+    outcomeId: string;
+    semanticLabel: string;
+};
+export type AggregatedOrderbookRows = {
+    askRows: OrderbookRowData[];
+    bidRows: OrderbookRowData[];
+    midpoint: number | null;
+    spread: number | null;
+    hasNoOrderBook: boolean;
+    includedOutcomeIds: string[];
+    missingOutcomeIds: string[];
+};
+export declare const collectEligibleVenueOutcomes: ({ venueMarkets, selectedOutcomeLabel, }: {
+    venueMarkets: VenueMarket[];
+    selectedOutcomeLabel: string | null | undefined;
+}) => EligibleVenueOutcome[];
+export declare const collectEligibleVenueOutcomeIds: ({ venueMarkets, selectedOutcomeLabel, }: {
+    venueMarkets: VenueMarket[];
+    selectedOutcomeLabel: string | null | undefined;
+}) => string[];
+export declare const mergeVenueOutcomeOrderbooks: ({ eligibleOutcomes, orderbooksByOutcomeId, }: {
+    eligibleOutcomes: EligibleVenueOutcome[];
+    orderbooksByOutcomeId: Record<string, MarketOrderbookData | null | undefined>;
+}) => AggregatedOrderbookRows;

package/dist/types/events/market-details/orderbook-aggregation.d.ts

@@ -0,0 +1,30 @@
+import { type MarketOrderbookData, type VenueMarket, type VenueMarketOutcome } from "@agg-build/hooks";
+import type { OrderbookRowData } from "../orderbook";
+export type EligibleVenueOutcome = {
+    venue: VenueMarket["venue"];
+    market: VenueMarket;
+    outcome: VenueMarketOutcome;
+    outcomeId: string;
+    semanticLabel: string;
+};
+export type AggregatedOrderbookRows = {
+    askRows: OrderbookRowData[];
+    bidRows: OrderbookRowData[];
+    midpoint: number | null;
+    spread: number | null;
+    hasNoOrderBook: boolean;
+    includedOutcomeIds: string[];
+    missingOutcomeIds: string[];
+};
+export declare const collectEligibleVenueOutcomes: ({ venueMarkets, selectedOutcomeLabel, }: {
+    venueMarkets: VenueMarket[];
+    selectedOutcomeLabel: string | null | undefined;
+}) => EligibleVenueOutcome[];
+export declare const collectEligibleVenueOutcomeIds: ({ venueMarkets, selectedOutcomeLabel, }: {
+    venueMarkets: VenueMarket[];
+    selectedOutcomeLabel: string | null | undefined;
+}) => string[];
+export declare const mergeVenueOutcomeOrderbooks: ({ eligibleOutcomes, orderbooksByOutcomeId, }: {
+    eligibleOutcomes: EligibleVenueOutcome[];
+    orderbooksByOutcomeId: Record<string, MarketOrderbookData | null | undefined>;
+}) => AggregatedOrderbookRows;

package/dist/types/events/orderbook/index.d.mts

@@ -0,0 +1,11 @@
+import type { OrderbookProps } from "./orderbook.types";
+export type { OrderbookEntry, OrderbookLabels, OrderbookProps, OrderbookRowData, OrderbookTone, } from "./orderbook.types";
+export { formatProbabilityCents, resolveOrderBookRows, resolveUnifiedOrderBookEntries, } from "./orderbook.utils";
+export { orderbookRowLimitDefault } from "./orderbook.constants";
+export { useCenterOrderbookSpread, type UseCenterOrderbookSpreadOptions, } from "./use-center-orderbook-spread";
+export { OrderbookWithStates } from "./orderbook-with-states";
+export type { OrderbookState, OrderbookWithStatesProps } from "./orderbook-with-states";
+export declare const Orderbook: {
+    ({ entries, formatNumber, formatCurrency, visibleRows, enableAnimations, marketId, snapshotKey, outcomeId, labels: labelsProp, className, }: OrderbookProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/events/orderbook/index.d.ts

@@ -0,0 +1,11 @@
+import type { OrderbookProps } from "./orderbook.types";
+export type { OrderbookEntry, OrderbookLabels, OrderbookProps, OrderbookRowData, OrderbookTone, } from "./orderbook.types";
+export { formatProbabilityCents, resolveOrderBookRows, resolveUnifiedOrderBookEntries, } from "./orderbook.utils";
+export { orderbookRowLimitDefault } from "./orderbook.constants";
+export { useCenterOrderbookSpread, type UseCenterOrderbookSpreadOptions, } from "./use-center-orderbook-spread";
+export { OrderbookWithStates } from "./orderbook-with-states";
+export type { OrderbookState, OrderbookWithStatesProps } from "./orderbook-with-states";
+export declare const Orderbook: {
+    ({ entries, formatNumber, formatCurrency, visibleRows, enableAnimations, marketId, snapshotKey, outcomeId, labels: labelsProp, className, }: OrderbookProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/events/orderbook/orderbook-with-states.d.mts

@@ -0,0 +1,35 @@
+import type React from "react";
+import { OrderbookProps } from "./index";
+export type OrderbookState = {
+    kind: "loading";
+} | {
+    kind: "error";
+    title: string;
+    description: string;
+    onRetry?: () => void;
+} | {
+    kind: "resolved";
+    title: string;
+    description: string;
+} | {
+    kind: "empty";
+    title: string;
+    description: string;
+} | {
+    kind: "disabled";
+    title: string;
+    description: string;
+    icon?: React.ReactElement;
+} | {
+    kind: "data";
+};
+export type OrderbookWithStatesProps = OrderbookProps & {
+    /** Current state of the orderbook. Determines which view to render. */
+    state: OrderbookState;
+    /** Optional className for the wrapper div. */
+    wrapperClassName?: string;
+};
+export declare const OrderbookWithStates: {
+    ({ state, wrapperClassName, ...orderbookProps }: OrderbookWithStatesProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/events/orderbook/orderbook-with-states.d.ts

@@ -0,0 +1,35 @@
+import type React from "react";
+import { OrderbookProps } from "./index";
+export type OrderbookState = {
+    kind: "loading";
+} | {
+    kind: "error";
+    title: string;
+    description: string;
+    onRetry?: () => void;
+} | {
+    kind: "resolved";
+    title: string;
+    description: string;
+} | {
+    kind: "empty";
+    title: string;
+    description: string;
+} | {
+    kind: "disabled";
+    title: string;
+    description: string;
+    icon?: React.ReactElement;
+} | {
+    kind: "data";
+};
+export type OrderbookWithStatesProps = OrderbookProps & {
+    /** Current state of the orderbook. Determines which view to render. */
+    state: OrderbookState;
+    /** Optional className for the wrapper div. */
+    wrapperClassName?: string;
+};
+export declare const OrderbookWithStates: {
+    ({ state, wrapperClassName, ...orderbookProps }: OrderbookWithStatesProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/events/orderbook/orderbook.constants.d.mts

@@ -0,0 +1,10 @@
+import type { OrderbookLabels } from "./orderbook.types";
+export declare const orderbookRowLimitDefault = 4;
+export declare const orderbookRowHeightPx = 36;
+export declare const orderbookDividerHeightPx = 0;
+export declare const orderbookRowGapPx = 0;
+export declare const orderbookSpreadRowHeightPx = 36;
+export declare const orderbookHeaderHeightPx = 36;
+/** Maximum number of venue logos displayed per row before showing "+N". */
+export declare const orderbookMaxVisibleVenues = 2;
+export declare const orderbookDefaultLabels: OrderbookLabels;

package/dist/types/events/orderbook/orderbook.constants.d.ts

@@ -0,0 +1,10 @@
+import type { OrderbookLabels } from "./orderbook.types";
+export declare const orderbookRowLimitDefault = 4;
+export declare const orderbookRowHeightPx = 36;
+export declare const orderbookDividerHeightPx = 0;
+export declare const orderbookRowGapPx = 0;
+export declare const orderbookSpreadRowHeightPx = 36;
+export declare const orderbookHeaderHeightPx = 36;
+/** Maximum number of venue logos displayed per row before showing "+N". */
+export declare const orderbookMaxVisibleVenues = 2;
+export declare const orderbookDefaultLabels: OrderbookLabels;

package/dist/types/events/orderbook/orderbook.types.d.mts

@@ -0,0 +1,65 @@
+import type { VenueLogoName } from "../../primitives/venue-logo/venue-logo.types";
+export type OrderbookTone = "positive" | "negative";
+export type OrderbookRowData = {
+    id: string;
+    venue: VenueLogoName;
+    /** All venues with orders at this price level (for multi-venue display). */
+    venues?: VenueLogoName[];
+    price: number;
+    size: number;
+    total: number;
+    tone: OrderbookTone;
+    barScale: number;
+    venueBreakdown?: Partial<Record<VenueLogoName, number>>;
+    sourceOutcomeIds?: string[];
+};
+export type OrderbookEntry = {
+    kind: "ask";
+    row: OrderbookRowData;
+    cumulativeDepth: number;
+    unifiedBarScale: number;
+} | {
+    kind: "bid";
+    row: OrderbookRowData;
+    cumulativeDepth: number;
+    unifiedBarScale: number;
+} | {
+    kind: "spread";
+    midPrice: number | null;
+    spread: number | null;
+};
+export type OrderbookLabels = {
+    midPrice: string;
+    spread: string;
+    /** Column header for the depth bar column (e.g. "Trade Yes"). */
+    tradeOutcome?: string;
+    price?: string;
+    shares?: string;
+    total?: string;
+    asks?: string;
+    bids?: string;
+    /** Prefix for the "Last" label in the spread row (e.g. "Yes"). */
+    lastOutcome?: string;
+};
+export type OrderbookProps = {
+    /** Pre-resolved unified entries (asks + spread + bids). */
+    entries: OrderbookEntry[];
+    /** Format a numeric quantity for display (e.g. size column). */
+    formatNumber: (value: number) => string;
+    /** Format a currency value for display (e.g. total column). */
+    formatCurrency: (value: number) => string;
+    /** Number of visible rows per side (asks/bids). Controls container height. Default: 4. */
+    visibleRows?: number;
+    /** Enable CSS transition animations on bar widths. Default: true. */
+    enableAnimations?: boolean;
+    /** Market identifier -- when this changes, the book re-centers the spread on first render. */
+    marketId?: string | null;
+    /** Snapshot identity metadata retained for compatibility. Snapshot updates do not auto-recenter. */
+    snapshotKey?: string | number | null;
+    /** Legacy alias for marketId. */
+    outcomeId?: string | null;
+    /** Labels for the orderbook. All fields are optional and default to English. */
+    labels?: Partial<OrderbookLabels>;
+    /** Optional className for the root element. */
+    className?: string;
+};

package/dist/types/events/orderbook/orderbook.types.d.ts

@@ -0,0 +1,65 @@
+import type { VenueLogoName } from "../../primitives/venue-logo/venue-logo.types";
+export type OrderbookTone = "positive" | "negative";
+export type OrderbookRowData = {
+    id: string;
+    venue: VenueLogoName;
+    /** All venues with orders at this price level (for multi-venue display). */
+    venues?: VenueLogoName[];
+    price: number;
+    size: number;
+    total: number;
+    tone: OrderbookTone;
+    barScale: number;
+    venueBreakdown?: Partial<Record<VenueLogoName, number>>;
+    sourceOutcomeIds?: string[];
+};
+export type OrderbookEntry = {
+    kind: "ask";
+    row: OrderbookRowData;
+    cumulativeDepth: number;
+    unifiedBarScale: number;
+} | {
+    kind: "bid";
+    row: OrderbookRowData;
+    cumulativeDepth: number;
+    unifiedBarScale: number;
+} | {
+    kind: "spread";
+    midPrice: number | null;
+    spread: number | null;
+};
+export type OrderbookLabels = {
+    midPrice: string;
+    spread: string;
+    /** Column header for the depth bar column (e.g. "Trade Yes"). */
+    tradeOutcome?: string;
+    price?: string;
+    shares?: string;
+    total?: string;
+    asks?: string;
+    bids?: string;
+    /** Prefix for the "Last" label in the spread row (e.g. "Yes"). */
+    lastOutcome?: string;
+};
+export type OrderbookProps = {
+    /** Pre-resolved unified entries (asks + spread + bids). */
+    entries: OrderbookEntry[];
+    /** Format a numeric quantity for display (e.g. size column). */
+    formatNumber: (value: number) => string;
+    /** Format a currency value for display (e.g. total column). */
+    formatCurrency: (value: number) => string;
+    /** Number of visible rows per side (asks/bids). Controls container height. Default: 4. */
+    visibleRows?: number;
+    /** Enable CSS transition animations on bar widths. Default: true. */
+    enableAnimations?: boolean;
+    /** Market identifier -- when this changes, the book re-centers the spread on first render. */
+    marketId?: string | null;
+    /** Snapshot identity metadata retained for compatibility. Snapshot updates do not auto-recenter. */
+    snapshotKey?: string | number | null;
+    /** Legacy alias for marketId. */
+    outcomeId?: string | null;
+    /** Labels for the orderbook. All fields are optional and default to English. */
+    labels?: Partial<OrderbookLabels>;
+    /** Optional className for the root element. */
+    className?: string;
+};

package/dist/types/events/orderbook/orderbook.utils.d.mts

@@ -0,0 +1,13 @@
+import type { OrderbookResult } from "@agg-build/hooks";
+import type { OrderbookEntry, OrderbookRowData } from "./orderbook.types";
+export declare const formatProbabilityCents: (value: number | null | undefined) => string;
+export declare const resolveOrderBookRows: ({ data, side, }: {
+    data: OrderbookResult[] | undefined;
+    side: "asks" | "bids";
+}) => OrderbookRowData[];
+export declare const resolveUnifiedOrderBookEntries: ({ askRows, bidRows, midPrice, spread, }: {
+    askRows: OrderbookRowData[];
+    bidRows: OrderbookRowData[];
+    midPrice: number | null;
+    spread: number | null;
+}) => OrderbookEntry[];

package/dist/types/events/orderbook/orderbook.utils.d.ts

@@ -0,0 +1,13 @@
+import type { OrderbookResult } from "@agg-build/hooks";
+import type { OrderbookEntry, OrderbookRowData } from "./orderbook.types";
+export declare const formatProbabilityCents: (value: number | null | undefined) => string;
+export declare const resolveOrderBookRows: ({ data, side, }: {
+    data: OrderbookResult[] | undefined;
+    side: "asks" | "bids";
+}) => OrderbookRowData[];
+export declare const resolveUnifiedOrderBookEntries: ({ askRows, bidRows, midPrice, spread, }: {
+    askRows: OrderbookRowData[];
+    bidRows: OrderbookRowData[];
+    midPrice: number | null;
+    spread: number | null;
+}) => OrderbookEntry[];

package/dist/types/events/orderbook/use-center-orderbook-spread.d.mts

@@ -0,0 +1,13 @@
+import { type RefObject } from "react";
+export type UseCenterOrderbookSpreadOptions = {
+    containerRef: RefObject<HTMLDivElement | null>;
+    spreadRef: RefObject<HTMLDivElement | null>;
+    marketId?: string | null;
+    snapshotKey?: string | number | null;
+    rowCount: number;
+    enabled?: boolean;
+};
+export type UseCenterOrderbookSpreadReturn = {
+    recenter: () => void;
+};
+export declare const useCenterOrderbookSpread: ({ containerRef, spreadRef, marketId, snapshotKey: _snapshotKey, rowCount, enabled, }: UseCenterOrderbookSpreadOptions) => UseCenterOrderbookSpreadReturn;

package/dist/types/events/orderbook/use-center-orderbook-spread.d.ts

@@ -0,0 +1,13 @@
+import { type RefObject } from "react";
+export type UseCenterOrderbookSpreadOptions = {
+    containerRef: RefObject<HTMLDivElement | null>;
+    spreadRef: RefObject<HTMLDivElement | null>;
+    marketId?: string | null;
+    snapshotKey?: string | number | null;
+    rowCount: number;
+    enabled?: boolean;
+};
+export type UseCenterOrderbookSpreadReturn = {
+    recenter: () => void;
+};
+export declare const useCenterOrderbookSpread: ({ containerRef, spreadRef, marketId, snapshotKey: _snapshotKey, rowCount, enabled, }: UseCenterOrderbookSpreadOptions) => UseCenterOrderbookSpreadReturn;