@agg-build/ui 1.0.0

package/dist/types/events/shared/chart-venue-selection.d.mts

@@ -0,0 +1,20 @@
+import { type MarketChartData } from "@agg-build/hooks";
+type ChartVenueOutcomeLike = {
+    venue: string;
+    outcome: {
+        id: string;
+        price: number;
+    };
+};
+type LivePriceLookup = {
+    get: (outcomeId: string) => number | undefined;
+};
+export declare const resolveChartVenueOutcomes: <TOutcome extends ChartVenueOutcomeLike>({ eligibleVenueOutcomes, livePrices, }: {
+    eligibleVenueOutcomes: TOutcome[];
+    livePrices: LivePriceLookup;
+}) => TOutcome[];
+export declare const filterChartVenueOutcomesByRenderableVenues: <TOutcome extends Pick<ChartVenueOutcomeLike, "venue">>({ chartData, venueOutcomes, }: {
+    chartData: MarketChartData | null | undefined;
+    venueOutcomes: TOutcome[];
+}) => TOutcome[];
+export {};

package/dist/types/events/shared/chart-venue-selection.d.ts

@@ -0,0 +1,20 @@
+import { type MarketChartData } from "@agg-build/hooks";
+type ChartVenueOutcomeLike = {
+    venue: string;
+    outcome: {
+        id: string;
+        price: number;
+    };
+};
+type LivePriceLookup = {
+    get: (outcomeId: string) => number | undefined;
+};
+export declare const resolveChartVenueOutcomes: <TOutcome extends ChartVenueOutcomeLike>({ eligibleVenueOutcomes, livePrices, }: {
+    eligibleVenueOutcomes: TOutcome[];
+    livePrices: LivePriceLookup;
+}) => TOutcome[];
+export declare const filterChartVenueOutcomesByRenderableVenues: <TOutcome extends Pick<ChartVenueOutcomeLike, "venue">>({ chartData, venueOutcomes, }: {
+    chartData: MarketChartData | null | undefined;
+    venueOutcomes: TOutcome[];
+}) => TOutcome[];
+export {};

package/dist/types/events/shared/event-trading-state.utils.d.mts

@@ -0,0 +1,14 @@
+import type { AggUiLabels, OrderEligibilityReason, TradingStateBase, TradingStateKind } from "@agg-build/hooks";
+export type TradingStatePresentation = {
+    badgeLabel: string;
+    title: string;
+    description: string;
+    iconName: "check-circle" | "warning-filled" | "info";
+    timestampLabel: string | null;
+    winningOutcomeLabel: string | null;
+};
+export declare const resolveTradingStateTimestampLabel: (labels: AggUiLabels, state: TradingStateBase) => string | null;
+export declare const resolveTradingStatePresentation: (labels: AggUiLabels, state: TradingStateBase) => TradingStatePresentation;
+export declare const resolveTradingStateBadgeClassName: (kind: TradingStateKind) => string;
+export declare const resolveTradingStatePanelClassName: (kind: TradingStateKind) => string;
+export declare const resolveOrderEligibilityMessage: (labels: AggUiLabels, reason: OrderEligibilityReason) => string | null;

package/dist/types/events/shared/event-trading-state.utils.d.ts

@@ -0,0 +1,14 @@
+import type { AggUiLabels, OrderEligibilityReason, TradingStateBase, TradingStateKind } from "@agg-build/hooks";
+export type TradingStatePresentation = {
+    badgeLabel: string;
+    title: string;
+    description: string;
+    iconName: "check-circle" | "warning-filled" | "info";
+    timestampLabel: string | null;
+    winningOutcomeLabel: string | null;
+};
+export declare const resolveTradingStateTimestampLabel: (labels: AggUiLabels, state: TradingStateBase) => string | null;
+export declare const resolveTradingStatePresentation: (labels: AggUiLabels, state: TradingStateBase) => TradingStatePresentation;
+export declare const resolveTradingStateBadgeClassName: (kind: TradingStateKind) => string;
+export declare const resolveTradingStatePanelClassName: (kind: TradingStateKind) => string;
+export declare const resolveOrderEligibilityMessage: (labels: AggUiLabels, reason: OrderEligibilityReason) => string | null;

package/dist/types/events/shared/venue-market-cluster.d.mts

@@ -0,0 +1,11 @@
+type VenueMarketClusterNode = {
+    id: string;
+    venue: string;
+    matchedVenueMarkets?: readonly VenueMarketClusterNode[] | null;
+    matchEntry?: {
+        targetVenueMarketId?: string | null;
+        targetVenueMarket?: VenueMarketClusterNode | null;
+    } | null | undefined;
+};
+export declare const normalizeVenueMarketCluster: <TMarket extends VenueMarketClusterNode>(markets: readonly TMarket[], selectedMarketId?: string | null) => TMarket[];
+export {};

package/dist/types/events/shared/venue-market-cluster.d.ts

@@ -0,0 +1,11 @@
+type VenueMarketClusterNode = {
+    id: string;
+    venue: string;
+    matchedVenueMarkets?: readonly VenueMarketClusterNode[] | null;
+    matchEntry?: {
+        targetVenueMarketId?: string | null;
+        targetVenueMarket?: VenueMarketClusterNode | null;
+    } | null | undefined;
+};
+export declare const normalizeVenueMarketCluster: <TMarket extends VenueMarketClusterNode>(markets: readonly TMarket[], selectedMarketId?: string | null) => TMarket[];
+export {};

package/dist/types/geo-block-banner/index.d.mts

@@ -0,0 +1,12 @@
+export type GeoBlockBannerProps = {
+    /** When set, shows "Trading on {venue} is not available..." instead of the generic message. */
+    venue?: string;
+    /** URL for the "Terms of Use" link. Defaults to "#". */
+    termsUrl?: string;
+    /** Optional class name for the container. */
+    className?: string;
+};
+export declare const GeoBlockBanner: {
+    ({ venue, termsUrl, className, }: GeoBlockBannerProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/geo-block-banner/index.d.ts

@@ -0,0 +1,12 @@
+export type GeoBlockBannerProps = {
+    /** When set, shows "Trading on {venue} is not available..." instead of the generic message. */
+    venue?: string;
+    /** URL for the "Terms of Use" link. Defaults to "#". */
+    termsUrl?: string;
+    /** Optional class name for the container. */
+    className?: string;
+};
+export declare const GeoBlockBanner: {
+    ({ venue, termsUrl, className, }: GeoBlockBannerProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/geo-block-modal/geo-block-modal.types.d.mts

@@ -0,0 +1,13 @@
+export type GeoBlockModalProps = {
+    /** Whether the modal is open. */
+    open: boolean;
+    /** Called when the open state changes. */
+    onOpenChange: (open: boolean) => void;
+    /** Called when the user clicks Confirm. Defaults to closing the modal. */
+    onConfirm?: () => void;
+    /** Optional class name overrides. */
+    classNames?: {
+        container?: string;
+        body?: string;
+    };
+};

package/dist/types/geo-block-modal/geo-block-modal.types.d.ts

@@ -0,0 +1,13 @@
+export type GeoBlockModalProps = {
+    /** Whether the modal is open. */
+    open: boolean;
+    /** Called when the open state changes. */
+    onOpenChange: (open: boolean) => void;
+    /** Called when the user clicks Confirm. Defaults to closing the modal. */
+    onConfirm?: () => void;
+    /** Optional class name overrides. */
+    classNames?: {
+        container?: string;
+        body?: string;
+    };
+};

package/dist/types/geo-block-modal/index.d.mts

@@ -0,0 +1,6 @@
+import type { GeoBlockModalProps } from "./geo-block-modal.types";
+export type { GeoBlockModalProps } from "./geo-block-modal.types";
+export declare const GeoBlockModal: {
+    ({ open, onOpenChange, onConfirm, classNames, }: GeoBlockModalProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/geo-block-modal/index.d.ts

@@ -0,0 +1,6 @@
+import type { GeoBlockModalProps } from "./geo-block-modal.types";
+export type { GeoBlockModalProps } from "./geo-block-modal.types";
+export declare const GeoBlockModal: {
+    ({ open, onOpenChange, onConfirm, classNames, }: GeoBlockModalProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/index.d.mts

@@ -0,0 +1,10 @@
+export * from "./primitives";
+export * from "./auth/connect-button-view";
+export * from "./events";
+export * from "./pages";
+export * from "./modals";
+export * from "./trading";
+export * from "./constants";
+export * from "./shared/utils";
+export { DEPOSIT_MODAL_OPEN_EVENT, WITHDRAW_MODAL_OPEN_EVENT, requestAggDepositModalOpen, requestAggWithdrawModalOpen, } from "./shared/deposit-modal-events";
+export type { AvailableSizes } from "./shared/types";

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./primitives";
+export * from "./auth/connect-button-view";
+export * from "./events";
+export * from "./pages";
+export * from "./modals";
+export * from "./trading";
+export * from "./constants";
+export * from "./shared/utils";
+export { DEPOSIT_MODAL_OPEN_EVENT, WITHDRAW_MODAL_OPEN_EVENT, requestAggDepositModalOpen, requestAggWithdrawModalOpen, } from "./shared/deposit-modal-events";
+export type { AvailableSizes } from "./shared/types";

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

@@ -0,0 +1,6 @@
+export * from "../deposit";
+export * from "../withdraw";
+export * from "../onboarding";
+export * from "../profile";
+export * from "../geo-block-modal";
+export * from "../geo-block-banner";

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

@@ -0,0 +1,6 @@
+export * from "../deposit";
+export * from "../withdraw";
+export * from "../onboarding";
+export * from "../profile";
+export * from "../geo-block-modal";
+export * from "../geo-block-banner";

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

@@ -0,0 +1,11 @@
+import type { OnboardingModalProps } from "./onboarding-modal.types";
+export type { OnboardingModalProps, OnboardingProfileData, HowItWorksIcons, HowItWorksStepProps, ProfileSetupStepProps, ConnectAccountsStepProps, ConnectKalshiModalProps, ConnectOnchainModalProps, KalshiCredentials, ConnectionState, } from "./onboarding-modal.types";
+export { HowItWorksStep } from "./steps/how-it-works";
+export { ProfileSetupStep } from "./steps/profile-setup";
+export { ConnectAccountsStep } from "./steps/connect-accounts";
+export { ConnectKalshiModal } from "./steps/connect-kalshi-modal";
+export { ConnectOnchainModal } from "./steps/connect-onchain-modal";
+export declare const OnboardingModal: {
+    ({ open, onOpenChange, onProfileSubmit, onConnectOnchain, onConnectKalshi, onComplete, howItWorksIcons, connectedOnchain, connectedKalshi, }: OnboardingModalProps): JSX.Element;
+    displayName: string;
+};

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

@@ -0,0 +1,11 @@
+import type { OnboardingModalProps } from "./onboarding-modal.types";
+export type { OnboardingModalProps, OnboardingProfileData, HowItWorksIcons, HowItWorksStepProps, ProfileSetupStepProps, ConnectAccountsStepProps, ConnectKalshiModalProps, ConnectOnchainModalProps, KalshiCredentials, ConnectionState, } from "./onboarding-modal.types";
+export { HowItWorksStep } from "./steps/how-it-works";
+export { ProfileSetupStep } from "./steps/profile-setup";
+export { ConnectAccountsStep } from "./steps/connect-accounts";
+export { ConnectKalshiModal } from "./steps/connect-kalshi-modal";
+export { ConnectOnchainModal } from "./steps/connect-onchain-modal";
+export declare const OnboardingModal: {
+    ({ open, onOpenChange, onProfileSubmit, onConnectOnchain, onConnectKalshi, onComplete, howItWorksIcons, connectedOnchain, connectedKalshi, }: OnboardingModalProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/onboarding/onboarding-modal.constants.d.mts

@@ -0,0 +1,10 @@
+import type { VenueLogoName } from "../primitives/venue-logo";
+import type { HowItWorksIcons } from "./onboarding-modal.types";
+export type FeatureKey = keyof HowItWorksIcons;
+export declare const HOW_IT_WORKS_FEATURE_KEYS: FeatureKey[];
+export declare const ONBOARDING_STEPS: {
+    readonly HOW_IT_WORKS: 0;
+    readonly PROFILE_SETUP: 1;
+    readonly CONNECT_ACCOUNTS: 2;
+};
+export declare const ONCHAIN_VENUES: VenueLogoName[];

package/dist/types/onboarding/onboarding-modal.constants.d.ts

@@ -0,0 +1,10 @@
+import type { VenueLogoName } from "../primitives/venue-logo";
+import type { HowItWorksIcons } from "./onboarding-modal.types";
+export type FeatureKey = keyof HowItWorksIcons;
+export declare const HOW_IT_WORKS_FEATURE_KEYS: FeatureKey[];
+export declare const ONBOARDING_STEPS: {
+    readonly HOW_IT_WORKS: 0;
+    readonly PROFILE_SETUP: 1;
+    readonly CONNECT_ACCOUNTS: 2;
+};
+export declare const ONCHAIN_VENUES: VenueLogoName[];

package/dist/types/onboarding/onboarding-modal.types.d.mts

@@ -0,0 +1,76 @@
+import type { ReactNode } from "react";
+export interface OnboardingProfileData {
+    username: string;
+    avatarFile?: File;
+    avatarPreview?: string;
+}
+export interface HowItWorksIcons {
+    createAccount?: ReactNode;
+    linkAccounts?: ReactNode;
+    bestPrices?: ReactNode;
+    stayInControl?: ReactNode;
+}
+/** Connection state for a venue card. */
+export type ConnectionState = "idle" | "connecting" | "connected" | "error";
+export interface OnboardingModalProps {
+    /** Whether the onboarding modal is currently open. */
+    open: boolean;
+    /** Called whenever the onboarding modal open state changes. */
+    onOpenChange: (open: boolean) => void;
+    /** Called when the profile setup step is submitted. */
+    onProfileSubmit?: (data: OnboardingProfileData) => void;
+    /** Called when the user clicks "Connect" on the onchain card. Should resolve on success, reject/throw on failure. */
+    onConnectOnchain?: () => Promise<void>;
+    /** Called when the user submits Kalshi credentials. Should resolve on success, reject/throw on failure. */
+    onConnectKalshi?: (credentials: KalshiCredentials) => Promise<void>;
+    /** Called after the onboarding flow is fully completed. */
+    onComplete?: () => void;
+    /** Optional icon overrides for the how-it-works step. */
+    howItWorksIcons?: HowItWorksIcons;
+    /** Whether the onchain account connection has completed. */
+    connectedOnchain?: boolean;
+    /** Whether the Kalshi account connection has completed. */
+    connectedKalshi?: boolean;
+}
+export interface KalshiCredentials {
+    apiKeyId: string;
+    privateKey: string;
+}
+export interface HowItWorksStepProps {
+    /** Called when the user advances from the how-it-works step. */
+    onContinue: () => void;
+    /** Optional icon overrides for the how-it-works step. */
+    icons?: HowItWorksIcons;
+}
+export interface ProfileSetupStepProps {
+    /** Called when the profile setup step is submitted. */
+    onContinue: (data: OnboardingProfileData) => void;
+}
+export interface ConnectAccountsStepProps {
+    /** Called when the onchain connection CTA is activated. */
+    onConnectOnchain?: () => void;
+    /** Called when the Kalshi connection CTA is activated. */
+    onConnectKalshi?: () => void;
+    /** Called when the user continues past the connection step. */
+    onContinue: () => void;
+    /** Whether the onchain connection is already complete. */
+    connectedOnchain?: boolean;
+    /** Whether the Kalshi connection is already complete. */
+    connectedKalshi?: boolean;
+}
+export interface ConnectOnchainModalProps {
+    /** Whether the onchain connection modal is currently open. */
+    open: boolean;
+    /** Called whenever the onchain connection modal open state changes. */
+    onOpenChange: (open: boolean) => void;
+    /** Called when the onchain connection is confirmed. */
+    onConnect: () => Promise<void>;
+}
+export interface ConnectKalshiModalProps {
+    /** Whether the Kalshi connection modal is currently open. */
+    open: boolean;
+    /** Called whenever the Kalshi connection modal open state changes. */
+    onOpenChange: (open: boolean) => void;
+    /** Called when the Kalshi credentials are submitted for verification. */
+    onVerify: (credentials: KalshiCredentials) => Promise<void>;
+}

package/dist/types/onboarding/onboarding-modal.types.d.ts

@@ -0,0 +1,76 @@
+import type { ReactNode } from "react";
+export interface OnboardingProfileData {
+    username: string;
+    avatarFile?: File;
+    avatarPreview?: string;
+}
+export interface HowItWorksIcons {
+    createAccount?: ReactNode;
+    linkAccounts?: ReactNode;
+    bestPrices?: ReactNode;
+    stayInControl?: ReactNode;
+}
+/** Connection state for a venue card. */
+export type ConnectionState = "idle" | "connecting" | "connected" | "error";
+export interface OnboardingModalProps {
+    /** Whether the onboarding modal is currently open. */
+    open: boolean;
+    /** Called whenever the onboarding modal open state changes. */
+    onOpenChange: (open: boolean) => void;
+    /** Called when the profile setup step is submitted. */
+    onProfileSubmit?: (data: OnboardingProfileData) => void;
+    /** Called when the user clicks "Connect" on the onchain card. Should resolve on success, reject/throw on failure. */
+    onConnectOnchain?: () => Promise<void>;
+    /** Called when the user submits Kalshi credentials. Should resolve on success, reject/throw on failure. */
+    onConnectKalshi?: (credentials: KalshiCredentials) => Promise<void>;
+    /** Called after the onboarding flow is fully completed. */
+    onComplete?: () => void;
+    /** Optional icon overrides for the how-it-works step. */
+    howItWorksIcons?: HowItWorksIcons;
+    /** Whether the onchain account connection has completed. */
+    connectedOnchain?: boolean;
+    /** Whether the Kalshi account connection has completed. */
+    connectedKalshi?: boolean;
+}
+export interface KalshiCredentials {
+    apiKeyId: string;
+    privateKey: string;
+}
+export interface HowItWorksStepProps {
+    /** Called when the user advances from the how-it-works step. */
+    onContinue: () => void;
+    /** Optional icon overrides for the how-it-works step. */
+    icons?: HowItWorksIcons;
+}
+export interface ProfileSetupStepProps {
+    /** Called when the profile setup step is submitted. */
+    onContinue: (data: OnboardingProfileData) => void;
+}
+export interface ConnectAccountsStepProps {
+    /** Called when the onchain connection CTA is activated. */
+    onConnectOnchain?: () => void;
+    /** Called when the Kalshi connection CTA is activated. */
+    onConnectKalshi?: () => void;
+    /** Called when the user continues past the connection step. */
+    onContinue: () => void;
+    /** Whether the onchain connection is already complete. */
+    connectedOnchain?: boolean;
+    /** Whether the Kalshi connection is already complete. */
+    connectedKalshi?: boolean;
+}
+export interface ConnectOnchainModalProps {
+    /** Whether the onchain connection modal is currently open. */
+    open: boolean;
+    /** Called whenever the onchain connection modal open state changes. */
+    onOpenChange: (open: boolean) => void;
+    /** Called when the onchain connection is confirmed. */
+    onConnect: () => Promise<void>;
+}
+export interface ConnectKalshiModalProps {
+    /** Whether the Kalshi connection modal is currently open. */
+    open: boolean;
+    /** Called whenever the Kalshi connection modal open state changes. */
+    onOpenChange: (open: boolean) => void;
+    /** Called when the Kalshi credentials are submitted for verification. */
+    onVerify: (credentials: KalshiCredentials) => Promise<void>;
+}

package/dist/types/onboarding/steps/connect-accounts.d.mts

@@ -0,0 +1,5 @@
+import type { ConnectAccountsStepProps } from "../onboarding-modal.types";
+export declare const ConnectAccountsStep: {
+    ({ onConnectOnchain, onConnectKalshi, onContinue, connectedOnchain, connectedKalshi, }: ConnectAccountsStepProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/onboarding/steps/connect-accounts.d.ts

@@ -0,0 +1,5 @@
+import type { ConnectAccountsStepProps } from "../onboarding-modal.types";
+export declare const ConnectAccountsStep: {
+    ({ onConnectOnchain, onConnectKalshi, onContinue, connectedOnchain, connectedKalshi, }: ConnectAccountsStepProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/onboarding/steps/connect-kalshi-modal.d.mts

@@ -0,0 +1,5 @@
+import type { ConnectKalshiModalProps } from "../onboarding-modal.types";
+export declare const ConnectKalshiModal: {
+    ({ open, onOpenChange, onVerify, }: ConnectKalshiModalProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/onboarding/steps/connect-kalshi-modal.d.ts

@@ -0,0 +1,5 @@
+import type { ConnectKalshiModalProps } from "../onboarding-modal.types";
+export declare const ConnectKalshiModal: {
+    ({ open, onOpenChange, onVerify, }: ConnectKalshiModalProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/onboarding/steps/connect-onchain-modal.d.mts

@@ -0,0 +1,5 @@
+import type { ConnectOnchainModalProps } from "../onboarding-modal.types";
+export declare const ConnectOnchainModal: {
+    ({ open, onOpenChange, onConnect, }: ConnectOnchainModalProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/onboarding/steps/connect-onchain-modal.d.ts

@@ -0,0 +1,5 @@
+import type { ConnectOnchainModalProps } from "../onboarding-modal.types";
+export declare const ConnectOnchainModal: {
+    ({ open, onOpenChange, onConnect, }: ConnectOnchainModalProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/onboarding/steps/how-it-works.d.mts

@@ -0,0 +1,5 @@
+import type { HowItWorksStepProps } from "../onboarding-modal.types";
+export declare const HowItWorksStep: {
+    ({ onContinue, icons }: HowItWorksStepProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/onboarding/steps/how-it-works.d.ts

@@ -0,0 +1,5 @@
+import type { HowItWorksStepProps } from "../onboarding-modal.types";
+export declare const HowItWorksStep: {
+    ({ onContinue, icons }: HowItWorksStepProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/onboarding/steps/profile-setup.d.mts

@@ -0,0 +1,5 @@
+import type { ProfileSetupStepProps } from "../onboarding-modal.types";
+export declare const ProfileSetupStep: {
+    ({ onContinue }: ProfileSetupStepProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/onboarding/steps/profile-setup.d.ts

@@ -0,0 +1,5 @@
+import type { ProfileSetupStepProps } from "../onboarding-modal.types";
+export declare const ProfileSetupStep: {
+    ({ onContinue }: ProfileSetupStepProps): JSX.Element;
+    displayName: string;
+};

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

@@ -0,0 +1,84 @@
+import type { VenueEventWithMarkets } from "../../events/item/event-list-item.types";
+import type { PlaceOrderResolvedClaimSummary, SettlementViewModel } from "../../trading";
+export type EventMarketPageClassNames = Partial<{
+    root: string;
+    content: string;
+    main: string;
+    sidebar: string;
+    hero: string;
+    markets: string;
+    settlement: string;
+    trade: string;
+    tradeBody: string;
+    tradeHeader: string;
+    tradeContent: string;
+    tradeFooter: string;
+    mobileTrade: string;
+    mobileTradeBody: string;
+    mobileTradeHeader: string;
+    mobileTradeContent: string;
+    mobileTradeFooter: string;
+    mobileTradeCta: string;
+    mobileTradeModal: string;
+}>;
+export type EventMarketPageStickyOrderPanelConfig = {
+    /** Enable sticky order panel */
+    enabled?: boolean;
+    /** Extend or override desktop sticky classes for the order panel rail. */
+    className?: string;
+    /** Sticky top offset in px when a number is provided, or a raw CSS length value. */
+    top?: number | string;
+    /**
+     * Optional desktop breathing space below the sticky rail viewport.
+     * This value is subtracted from the rail max height.
+     * When omitted and `top` is numeric, spacing is derived from the header offset.
+     */
+    spacing?: number | string;
+};
+export type EventMarketPageBaseProps = {
+    /** Called when the expanded market accordion item changes. */
+    onExpandedMarketChange?: (marketId: string | null) => void;
+    /** Market ID to preselect in the event details hero. */
+    defaultMarketId?: string;
+    /** Outcome ID to preselect alongside defaultMarketId. */
+    defaultOutcomeId?: string;
+    /** Whether to render the place-order panel. */
+    showPlaceOrder?: boolean;
+    /** Optional resolved-event claim summary shown inside the read-only order panel. */
+    resolvedClaim?: PlaceOrderResolvedClaimSummary;
+    /** Settlement view model shown when the event has settled. */
+    settlement?: SettlementViewModel;
+    /** Class name overrides for page layout slots. */
+    classNames?: EventMarketPageClassNames;
+    /** Sticky order panel behavior configuration. */
+    stickyOrderPanel?: EventMarketPageStickyOrderPanelConfig;
+    /** Accessible label applied to the page root. */
+    ariaLabel?: string;
+    /** Whether the page should render its loading state. */
+    isLoading?: boolean;
+};
+export type EventMarketPageLoadingProps = EventMarketPageBaseProps & {
+    /** Forces the page into its loading state. */
+    isLoading: true;
+    /** Prevents passing a resolved event while loading. */
+    event?: never;
+    /** Optional event ID used to fetch the event data. */
+    eventId?: string;
+};
+export type EventMarketPageWithEventProps = EventMarketPageBaseProps & {
+    /** Fully resolved event rendered by the page. */
+    event: VenueEventWithMarkets;
+    /** Optional explicit event ID override. */
+    eventId?: string;
+    /** Marks the page as loaded when event data is present. */
+    isLoading?: false;
+};
+export type EventMarketPageWithEventIdProps = EventMarketPageBaseProps & {
+    /** Prevents passing a full event object in ID-driven mode. */
+    event?: never;
+    /** Event ID used to fetch the page data. */
+    eventId: string;
+    /** Marks the page as loaded when ID-driven fetching is used. */
+    isLoading?: false;
+};
+export type EventMarketPageProps = EventMarketPageLoadingProps | EventMarketPageWithEventProps | EventMarketPageWithEventIdProps;