@agg-build/ui 1.0.0

package/dist/types/pages/user-profile/components/open-order-row.d.ts

@@ -0,0 +1,12 @@
+import type { UserProfileOpenOrder } from "../user-profile.types";
+type OpenOrderRowProps = {
+    order: UserProfileOpenOrder;
+    onClick?: (order: UserProfileOpenOrder) => void;
+    onCancel?: (order: UserProfileOpenOrder) => void;
+    isCancelling?: boolean;
+};
+export declare const OpenOrderRow: {
+    ({ order, onClick, onCancel, isCancelling, }: OpenOrderRowProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/pages/user-profile/components/position-row.d.mts

@@ -0,0 +1,15 @@
+import type { UserProfilePosition } from "../user-profile.types";
+type PositionRowVariant = "active" | "closed";
+type PositionRowProps = {
+    position: UserProfilePosition;
+    variant?: PositionRowVariant;
+    href?: string;
+    onClick?: (position: UserProfilePosition) => void;
+    onClaim?: (position: UserProfilePosition) => Promise<void> | void;
+    isClaiming?: boolean;
+};
+export declare const PositionRow: {
+    ({ position, variant, href, onClick, onClaim, isClaiming, }: PositionRowProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/pages/user-profile/components/position-row.d.ts

@@ -0,0 +1,15 @@
+import type { UserProfilePosition } from "../user-profile.types";
+type PositionRowVariant = "active" | "closed";
+type PositionRowProps = {
+    position: UserProfilePosition;
+    variant?: PositionRowVariant;
+    href?: string;
+    onClick?: (position: UserProfilePosition) => void;
+    onClaim?: (position: UserProfilePosition) => Promise<void> | void;
+    isClaiming?: boolean;
+};
+export declare const PositionRow: {
+    ({ position, variant, href, onClick, onClaim, isClaiming, }: PositionRowProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/pages/user-profile/components/positions-activity.d.mts

@@ -0,0 +1,51 @@
+import { type UserProfileTabValue } from "../user-profile.constants";
+import type { UserProfileActivity, UserProfileCancelOrderHandler, UserProfileOpenOrder, UserProfilePosition, UserProfilePositionFilter } from "../user-profile.types";
+type PositionsActivityProps = {
+    activePositions?: UserProfilePosition[];
+    closedPositions?: UserProfilePosition[];
+    openOrders?: UserProfileOpenOrder[];
+    activities?: UserProfileActivity[];
+    onPositionClick?: (position: UserProfilePosition) => void;
+    getPositionHref?: (position: UserProfilePosition) => string | undefined;
+    onClaim?: (position: UserProfilePosition) => Promise<void> | void;
+    claimingPositionKeys?: Record<string, boolean>;
+    onActivityClick?: (activity: UserProfileActivity) => void;
+    getActivityHref?: (activity: UserProfileActivity) => string | undefined;
+    onOpenOrderClick?: (order: UserProfileOpenOrder) => void;
+    onCancelOrder?: UserProfileCancelOrderHandler;
+    cancellingOrderIds?: Record<string, boolean>;
+    isLoadingPositions?: boolean;
+    isLoadingActivities?: boolean;
+    isLoadingOpenOrders?: boolean;
+    positionsError?: boolean;
+    activitiesError?: boolean;
+    openOrdersError?: boolean;
+    hasMoreActivePositions?: boolean;
+    isLoadingMoreActivePositions?: boolean;
+    onLoadMoreActivePositions?: () => void;
+    hasMoreClosedPositions?: boolean;
+    isLoadingMoreClosedPositions?: boolean;
+    onLoadMoreClosedPositions?: () => void;
+    onPositionFilterChange?: (filter: "active" | "closed") => void;
+    hasMoreActivities?: boolean;
+    isLoadingMoreActivities?: boolean;
+    onLoadMoreActivities?: () => void;
+    hasMoreOpenOrders?: boolean;
+    isLoadingMoreOpenOrders?: boolean;
+    onLoadMoreOpenOrders?: () => void;
+    /**
+     * Active tab. When provided, the component is controlled — `onTabChange` is
+     * invoked on click but the source of truth is the host (typically URL state).
+     * When omitted, the component manages its own tab state, defaulting to "positions".
+     */
+    tab?: UserProfileTabValue;
+    onTabChange?: (tab: UserProfileTabValue) => void;
+    /** Initial active/closed segmented filter for the positions tab (defaults to "active"). */
+    initialPositionFilter?: UserProfilePositionFilter;
+    className?: string;
+};
+export declare const PositionsActivity: {
+    ({ activePositions, closedPositions, activities, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onActivityClick, getActivityHref, isLoadingPositions, isLoadingActivities, positionsError, activitiesError, hasMoreActivePositions, isLoadingMoreActivePositions, onLoadMoreActivePositions, hasMoreClosedPositions, isLoadingMoreClosedPositions, onLoadMoreClosedPositions, onPositionFilterChange, hasMoreActivities, isLoadingMoreActivities, onLoadMoreActivities, tab, onTabChange, initialPositionFilter, className, }: PositionsActivityProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/pages/user-profile/components/positions-activity.d.ts

@@ -0,0 +1,51 @@
+import { type UserProfileTabValue } from "../user-profile.constants";
+import type { UserProfileActivity, UserProfileCancelOrderHandler, UserProfileOpenOrder, UserProfilePosition, UserProfilePositionFilter } from "../user-profile.types";
+type PositionsActivityProps = {
+    activePositions?: UserProfilePosition[];
+    closedPositions?: UserProfilePosition[];
+    openOrders?: UserProfileOpenOrder[];
+    activities?: UserProfileActivity[];
+    onPositionClick?: (position: UserProfilePosition) => void;
+    getPositionHref?: (position: UserProfilePosition) => string | undefined;
+    onClaim?: (position: UserProfilePosition) => Promise<void> | void;
+    claimingPositionKeys?: Record<string, boolean>;
+    onActivityClick?: (activity: UserProfileActivity) => void;
+    getActivityHref?: (activity: UserProfileActivity) => string | undefined;
+    onOpenOrderClick?: (order: UserProfileOpenOrder) => void;
+    onCancelOrder?: UserProfileCancelOrderHandler;
+    cancellingOrderIds?: Record<string, boolean>;
+    isLoadingPositions?: boolean;
+    isLoadingActivities?: boolean;
+    isLoadingOpenOrders?: boolean;
+    positionsError?: boolean;
+    activitiesError?: boolean;
+    openOrdersError?: boolean;
+    hasMoreActivePositions?: boolean;
+    isLoadingMoreActivePositions?: boolean;
+    onLoadMoreActivePositions?: () => void;
+    hasMoreClosedPositions?: boolean;
+    isLoadingMoreClosedPositions?: boolean;
+    onLoadMoreClosedPositions?: () => void;
+    onPositionFilterChange?: (filter: "active" | "closed") => void;
+    hasMoreActivities?: boolean;
+    isLoadingMoreActivities?: boolean;
+    onLoadMoreActivities?: () => void;
+    hasMoreOpenOrders?: boolean;
+    isLoadingMoreOpenOrders?: boolean;
+    onLoadMoreOpenOrders?: () => void;
+    /**
+     * Active tab. When provided, the component is controlled — `onTabChange` is
+     * invoked on click but the source of truth is the host (typically URL state).
+     * When omitted, the component manages its own tab state, defaulting to "positions".
+     */
+    tab?: UserProfileTabValue;
+    onTabChange?: (tab: UserProfileTabValue) => void;
+    /** Initial active/closed segmented filter for the positions tab (defaults to "active"). */
+    initialPositionFilter?: UserProfilePositionFilter;
+    className?: string;
+};
+export declare const PositionsActivity: {
+    ({ activePositions, closedPositions, activities, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onActivityClick, getActivityHref, isLoadingPositions, isLoadingActivities, positionsError, activitiesError, hasMoreActivePositions, isLoadingMoreActivePositions, onLoadMoreActivePositions, hasMoreClosedPositions, isLoadingMoreClosedPositions, onLoadMoreClosedPositions, onPositionFilterChange, hasMoreActivities, isLoadingMoreActivities, onLoadMoreActivities, tab, onTabChange, initialPositionFilter, className, }: PositionsActivityProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/pages/user-profile/components/positions-value-card.d.mts

@@ -0,0 +1,10 @@
+type PositionsValueCardProps = {
+    label?: string;
+    valueLabel: string;
+    className?: string;
+};
+export declare const PositionsValueCard: {
+    ({ label, valueLabel, className, }: PositionsValueCardProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/pages/user-profile/components/positions-value-card.d.ts

@@ -0,0 +1,10 @@
+type PositionsValueCardProps = {
+    label?: string;
+    valueLabel: string;
+    className?: string;
+};
+export declare const PositionsValueCard: {
+    ({ label, valueLabel, className, }: PositionsValueCardProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/pages/user-profile/components/user-info-card.d.mts

@@ -0,0 +1,15 @@
+import type { UserProfileInfo } from "../user-profile.types";
+type UserInfoCardProps = {
+    user: UserProfileInfo;
+    onEditProfile?: () => void;
+    onDeposit?: () => void;
+    onWithdraw?: () => void;
+    /** Whether deposits are blocked for the user's geo location. */
+    isDepositBlocked?: boolean;
+    className?: string;
+};
+export declare const UserInfoCard: {
+    ({ user, onEditProfile, onDeposit, onWithdraw, isDepositBlocked, className, }: UserInfoCardProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/pages/user-profile/components/user-info-card.d.ts

@@ -0,0 +1,15 @@
+import type { UserProfileInfo } from "../user-profile.types";
+type UserInfoCardProps = {
+    user: UserProfileInfo;
+    onEditProfile?: () => void;
+    onDeposit?: () => void;
+    onWithdraw?: () => void;
+    /** Whether deposits are blocked for the user's geo location. */
+    isDepositBlocked?: boolean;
+    className?: string;
+};
+export declare const UserInfoCard: {
+    ({ user, onEditProfile, onDeposit, onWithdraw, isDepositBlocked, className, }: UserInfoCardProps): JSX.Element;
+    displayName: string;
+};
+export {};

package/dist/types/pages/user-profile/index.d.mts

@@ -0,0 +1,10 @@
+import type { UserProfilePageProps } from "./user-profile.types";
+export type { UserProfileActivity, UserProfileBalance, UserProfileConnectedExchange, UserProfileConnectedWallet, UserProfileInfo, UserProfilePageClassNames, UserProfilePageProps, UserProfilePosition, UserProfilePositionFilter, UserProfilePositionVenueShare, UserProfileSocialLink, UserProfileVenueBalance, } from "./user-profile.types";
+export { USER_PROFILE_TAB_ACTIVITY, USER_PROFILE_TAB_OPEN_ORDERS, USER_PROFILE_TAB_POSITIONS, } from "./user-profile.constants";
+export type { UserProfileTabValue } from "./user-profile.constants";
+export declare const UserProfilePage: {
+    ({ user, balanceChainsOverride, venueBalances: _venueBalances, balance, activePositions, closedPositions, activities, onEditProfile, onDeposit, onWithdraw, openOrders, initialPositionFilter, tab, onTabChange, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onActivityClick, getActivityHref, onOpenOrderClick, onCancelOrder, cancellingOrderIds, isLoadingPositions, isLoadingActivities, isLoadingOpenOrders, positionsError, activitiesError, openOrdersError, hasMoreActivePositions, isLoadingMoreActivePositions, onLoadMoreActivePositions, hasMoreClosedPositions, isLoadingMoreClosedPositions, onLoadMoreClosedPositions, onPositionFilterChange: onPositionFilterChangeProp, hasMoreActivities, isLoadingMoreActivities, onLoadMoreActivities, hasMoreOpenOrders, isLoadingMoreOpenOrders, onLoadMoreOpenOrders, classNames, onError, }: UserProfilePageProps & {
+        onError?: (error: Error) => void;
+    }): JSX.Element;
+    displayName: string;
+};

package/dist/types/pages/user-profile/index.d.ts

@@ -0,0 +1,10 @@
+import type { UserProfilePageProps } from "./user-profile.types";
+export type { UserProfileActivity, UserProfileBalance, UserProfileConnectedExchange, UserProfileConnectedWallet, UserProfileInfo, UserProfilePageClassNames, UserProfilePageProps, UserProfilePosition, UserProfilePositionFilter, UserProfilePositionVenueShare, UserProfileSocialLink, UserProfileVenueBalance, } from "./user-profile.types";
+export { USER_PROFILE_TAB_ACTIVITY, USER_PROFILE_TAB_OPEN_ORDERS, USER_PROFILE_TAB_POSITIONS, } from "./user-profile.constants";
+export type { UserProfileTabValue } from "./user-profile.constants";
+export declare const UserProfilePage: {
+    ({ user, balanceChainsOverride, venueBalances: _venueBalances, balance, activePositions, closedPositions, activities, onEditProfile, onDeposit, onWithdraw, openOrders, initialPositionFilter, tab, onTabChange, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onActivityClick, getActivityHref, onOpenOrderClick, onCancelOrder, cancellingOrderIds, isLoadingPositions, isLoadingActivities, isLoadingOpenOrders, positionsError, activitiesError, openOrdersError, hasMoreActivePositions, isLoadingMoreActivePositions, onLoadMoreActivePositions, hasMoreClosedPositions, isLoadingMoreClosedPositions, onLoadMoreClosedPositions, onPositionFilterChange: onPositionFilterChangeProp, hasMoreActivities, isLoadingMoreActivities, onLoadMoreActivities, hasMoreOpenOrders, isLoadingMoreOpenOrders, onLoadMoreOpenOrders, classNames, onError, }: UserProfilePageProps & {
+        onError?: (error: Error) => void;
+    }): JSX.Element;
+    displayName: string;
+};

package/dist/types/pages/user-profile/user-profile.constants.d.mts

@@ -0,0 +1,9 @@
+import type { UserProfilePositionFilter } from "./user-profile.types";
+export declare const USER_PROFILE_TAB_POSITIONS: "positions";
+export declare const USER_PROFILE_TAB_OPEN_ORDERS: "open-orders";
+export declare const USER_PROFILE_TAB_ACTIVITY: "activity";
+export type UserProfileTabValue = typeof USER_PROFILE_TAB_POSITIONS | typeof USER_PROFILE_TAB_OPEN_ORDERS | typeof USER_PROFILE_TAB_ACTIVITY;
+export declare const USER_PROFILE_POSITION_FILTERS: {
+    value: UserProfilePositionFilter;
+    label: string;
+}[];

package/dist/types/pages/user-profile/user-profile.constants.d.ts

@@ -0,0 +1,9 @@
+import type { UserProfilePositionFilter } from "./user-profile.types";
+export declare const USER_PROFILE_TAB_POSITIONS: "positions";
+export declare const USER_PROFILE_TAB_OPEN_ORDERS: "open-orders";
+export declare const USER_PROFILE_TAB_ACTIVITY: "activity";
+export type UserProfileTabValue = typeof USER_PROFILE_TAB_POSITIONS | typeof USER_PROFILE_TAB_OPEN_ORDERS | typeof USER_PROFILE_TAB_ACTIVITY;
+export declare const USER_PROFILE_POSITION_FILTERS: {
+    value: UserProfilePositionFilter;
+    label: string;
+}[];

package/dist/types/pages/user-profile/user-profile.types.d.mts

@@ -0,0 +1,281 @@
+import type { VenueLogoName } from "../../primitives/venue-logo/venue-logo.types";
+import type { UserProfileTabValue } from "./user-profile.constants";
+export interface UserProfileSocialLink {
+    platform: "twitter" | "discord" | "telegram";
+    handle?: string;
+}
+export interface UserProfileConnectedExchange {
+    venue: VenueLogoName;
+}
+export interface UserProfileConnectedWallet {
+    /** Chain identifier, e.g. "evm" or "solana" */
+    chain: string;
+    /** Shortened wallet address, e.g. "0xec57...f8460" */
+    displayAddress: string;
+}
+export interface UserProfileInfo {
+    /** Display name */
+    username: string;
+    /** Avatar image URL; falls back to default SVG when absent */
+    avatarUrl?: string | null;
+    /** Social handles shown as icons beside the username */
+    socialLinks?: UserProfileSocialLink[];
+    /** Connected exchanges displayed as overlapping venue logos */
+    connectedExchanges?: UserProfileConnectedExchange[];
+    /** Connected wallets with chain icons (Ethereum for EVM, Solana for Solana) */
+    connectedWallets?: UserProfileConnectedWallet[];
+    /** Shortened wallet address displayed next to exchange logos, e.g. "0x82b1E...CeDB0" */
+    displayAddress?: string;
+    /** Primary social handle displayed in connected accounts section, e.g. "CryptoPapay" */
+    socialHandle?: string;
+    /** Venue logo displayed next to the socialHandle */
+    socialHandleVenue?: VenueLogoName;
+}
+export interface UserProfileVenueBalance {
+    chain: string;
+    accountCount?: number;
+    /** Balance formatted as a string, e.g. "$1,234.56" */
+    balanceLabel: string;
+}
+export interface UserProfileBalance {
+    /** Formatted total value, e.g. "$103,456.00" */
+    totalLabel: string;
+    /** Formatted change value, e.g. "+$1,234.56" (deprecated; optional) */
+    changeLabel?: string;
+    /** Formatted change percentage, e.g. "+12.3%" (deprecated; optional) */
+    changePercentLabel?: string;
+    /** True when the change is positive (green), false when negative (deprecated; optional) */
+    isPositive?: boolean;
+}
+/** One venue line under the outcome pill (API `venueBreakdown` entry). */
+export interface UserProfilePositionVenueShare {
+    venue: VenueLogoName;
+    /** Localized shares string, e.g. "103.4 shares" */
+    sharesLabel: string;
+}
+export interface UserProfilePosition {
+    id: string;
+    /** Event ID used for deep-link navigation to event details. */
+    eventId?: string;
+    /** Market ID used to preselect a market on the event details page. */
+    marketId?: string;
+    /** Market thumbnail image URL */
+    thumbnailSrc: string;
+    /** Market title */
+    title: string;
+    /** Outcome name for the pill only, e.g. "Yes" (no price). */
+    outcomeLabel: string;
+    /** Per-venue position sizes with logos below the pill. */
+    venueShareBreakdown: UserProfilePositionVenueShare[];
+    /** Average price, e.g. "29¢" */
+    averageLabel: string;
+    /** Current price, e.g. "25¢" */
+    currentLabel: string;
+    /** Total value, e.g. "$25.86" */
+    valueLabel: string;
+    /** P&L label, e.g. "-$4.14 (-13.79%)" */
+    pnlLabel: string;
+    /** True when P&L is positive */
+    isPnlPositive: boolean;
+    /** Bucket the backend placed this row in. */
+    status: "active" | "closed";
+    /** Raw VenueMarket.status for the primary market in the group. */
+    marketStatus: "unopened" | "paused" | "open" | "closed" | "resolved";
+    /** Aggregated winner across sibling outcomes; null until any venue resolves. */
+    winner: boolean | null;
+    /** Earliest non-null resolutionDate across sibling markets, ISO. */
+    resolutionDate: string | null;
+    /** Closed-table total traded label, e.g. "$310.11". */
+    closedTotalTradedLabel?: string;
+    /** Closed-table amount won label, e.g. "$469.95". */
+    closedAmountWonLabel?: string;
+    /** Closed-table return label, e.g. "+51.54%". */
+    closedReturnLabel?: string;
+    /** Redeem state used by the closed-table Claim column. */
+    closedClaimStatus?: "eligible" | "pending" | "redeemed" | "ineligible";
+    /** Winning outcome ids used to redeem closed winning positions. */
+    winningOutcomeIds?: string[];
+}
+export type UserProfileActivityKind = "trade" | "withdrawal" | "deposit" | "bridge" | "user_op";
+export interface UserProfileTradeActivity {
+    kind: "trade";
+    id: string;
+    /** Event ID used for deep-link navigation when available. */
+    eventId?: string;
+    /** Market ID used to preselect the market on event details when available. */
+    marketId?: string;
+    /** Whether the activity failed and should render in a degraded state. */
+    isFailed?: boolean;
+    /** Whether the row should use error-colored text because the activity has an error. */
+    hasError?: boolean;
+    /** Activity type, e.g. "Buy", "Sell" */
+    type: string;
+    /** Market thumbnail image URL */
+    thumbnailSrc: string;
+    /** Market title */
+    title: string;
+    /** Venue logo for the market */
+    venue: VenueLogoName;
+    /** Outcome label, e.g. "Yes 29¢" */
+    outcomeLabel: string;
+    /** Number of shares, e.g. "103.4 shares" */
+    sharesLabel: string;
+    /** Amount label, e.g. "$100.00" */
+    amountLabel: string;
+    /** Time label, e.g. "3d ago" */
+    timeLabel: string;
+}
+/** Non-trade activity row: withdrawal / deposit / bridge / user_op. */
+export interface UserProfileTransferActivity {
+    kind: "withdrawal" | "deposit" | "bridge" | "user_op";
+    id: string;
+    /** Whether the activity failed and should render in a degraded state. */
+    isFailed?: boolean;
+    /** Whether the row should use error-colored text because the activity has an error. */
+    hasError?: boolean;
+    /** Header label, e.g. "Withdraw", "Deposit", "Bridge", "Wallet op". */
+    type: string;
+    /** Title, e.g. "Withdraw USDC". */
+    title: string;
+    /** Subtitle line, e.g. "to 0xab…cd · base". */
+    subtitleLabel: string;
+    /** Right-side amount, e.g. "-100 USDC". May be empty. */
+    amountLabel: string;
+    /** Time label, e.g. "3d ago". */
+    timeLabel: string;
+    /** Deposit source — determines the icon in the thumbnail square. Only set when kind is "deposit". */
+    depositSource?: "wallet" | "crypto" | "card";
+    /** Chain ID for chain-aware deposit icons. */
+    chainId?: string | number;
+}
+export type UserProfileActivity = UserProfileTradeActivity | UserProfileTransferActivity;
+export interface UserProfileOpenOrder {
+    id: string;
+    /** Market thumbnail image URL */
+    thumbnailSrc: string;
+    /** Market title */
+    title: string;
+    /** Outcome name for the pill, e.g. "Yes" */
+    outcomeLabel: string;
+    /** Venue logo for the market */
+    venue: VenueLogoName;
+    /** Filled-out-of-total label, e.g. "0/150" */
+    filledLabel: string;
+    /** Total notional label, e.g. "$25.86" */
+    valueLabel: string;
+    /** Raw order status from API (used to gate Cancel availability). */
+    status: string;
+    /** DAG run ID; present once the order has been picked up by the processing queue. */
+    dagRunId?: string | null;
+}
+export type UserProfilePositionFilter = "active" | "closed";
+export type UserProfilePageClassNames = Partial<{
+    root: string;
+    topRow: string;
+    leftColumn: string;
+    rightColumn: string;
+    userInfoCard: string;
+    balanceDisplay: string;
+    balancesCard: string;
+    positionsActivity: string;
+}>;
+export type UserProfileCancelOrderHandler = (order: UserProfileOpenOrder) => void;
+export interface UserProfilePageProps {
+    /** User information. When omitted, page resolves current authenticated user via hooks. */
+    user?: UserProfileInfo;
+    /** Override for balances-by-network tooltip in storybook/demos; when omitted, hooks are used. */
+    balanceChainsOverride?: Array<{
+        /** Stable key for the balance chain row. */
+        key: string;
+        /** User-facing label for the chain. */
+        label: string;
+        /** Numeric balance value shown for the chain. */
+        balance: number;
+        /** Number of connected accounts contributing to this chain balance. */
+        accountCount: number;
+        /**
+         * Optional venues that hold this chain's balance (renders venue logos in tooltip).
+         * Unknown values are ignored at render time.
+         */
+        venues?: string[];
+    }>;
+    /** Venue balances shown in the sidebar card */
+    venueBalances?: UserProfileVenueBalance[];
+    /** Consolidated Balance / P&L data */
+    balance?: UserProfileBalance;
+    /** Active-tab positions (size > threshold && market not resolved). */
+    activePositions?: UserProfilePosition[];
+    /** Closed-tab positions (sold, resolved, dust). */
+    closedPositions?: UserProfilePosition[];
+    /** Initial positions filter selection. */
+    initialPositionFilter?: UserProfilePositionFilter;
+    /**
+     * Active tab — controlled. Pair with `onTabChange` so the host (e.g. router /
+     * URL state) drives the selected tab. Defaults to "positions" when omitted.
+     */
+    tab?: UserProfileTabValue;
+    /** Fires when the user clicks a tab. Use to reflect the change in your URL. */
+    onTabChange?: (tab: UserProfileTabValue) => void;
+    /** Open orders (resting / partially filled) */
+    openOrders?: UserProfileOpenOrder[];
+    /** Activity items */
+    activities?: UserProfileActivity[];
+    /** Called when the user clicks "Edit" on the user info card */
+    onEditProfile?: () => void;
+    /** Called when the user clicks "Deposit" */
+    onDeposit?: () => void;
+    /** Called when the user clicks "Withdraw" */
+    onWithdraw?: () => void;
+    /** Called when a position row is clicked */
+    onPositionClick?: (position: UserProfilePosition) => void;
+    /** Optional href for a position row (enables ctrl/cmd/middle-click to open in a new tab). */
+    getPositionHref?: (position: UserProfilePosition) => string | undefined;
+    /** Called when the user claims a closed winning position. */
+    onClaim?: (position: UserProfilePosition) => Promise<void> | void;
+    /** Map of claim key (marketId or position id) to loading state while claim is in-flight. */
+    claimingPositionKeys?: Record<string, boolean>;
+    /** Called when an activity row is clicked */
+    onActivityClick?: (activity: UserProfileActivity) => void;
+    /** Optional href for an activity row (enables ctrl/cmd/middle-click to open in a new tab). */
+    getActivityHref?: (activity: UserProfileActivity) => string | undefined;
+    /** Called when an open-order row is clicked */
+    onOpenOrderClick?: (order: UserProfileOpenOrder) => void;
+    /** Called when the user clicks Cancel on an open order. */
+    onCancelOrder?: UserProfileCancelOrderHandler;
+    /** Map of orderId → true while a cancel request is in-flight. */
+    cancellingOrderIds?: Record<string, boolean>;
+    /** Whether to show loading state on the currently-visible positions tab. */
+    isLoadingPositions?: boolean;
+    /** Whether the activity tab content is currently loading. */
+    isLoadingActivities?: boolean;
+    isLoadingOpenOrders?: boolean;
+    /** Whether to show error state on the currently-visible positions tab. */
+    positionsError?: boolean;
+    /** Whether the activity tab should render its error state. */
+    activitiesError?: boolean;
+    openOrdersError?: boolean;
+    /** Active-tab pagination */
+    hasMoreActivePositions?: boolean;
+    isLoadingMoreActivePositions?: boolean;
+    onLoadMoreActivePositions?: () => void;
+    /** Closed-tab pagination */
+    hasMoreClosedPositions?: boolean;
+    isLoadingMoreClosedPositions?: boolean;
+    onLoadMoreClosedPositions?: () => void;
+    /** Called when the user switches between Active and Closed filter pills. */
+    onPositionFilterChange?: (filter: "active" | "closed") => void;
+    /** Whether there are more activity items to fetch in connected mode. */
+    hasMoreActivities?: boolean;
+    /** Loading state for activity pagination. */
+    isLoadingMoreActivities?: boolean;
+    /** Cursor pagination handler for activity. */
+    onLoadMoreActivities?: () => void;
+    /** Whether there are more open orders to fetch in connected mode. */
+    hasMoreOpenOrders?: boolean;
+    /** Loading state for open-orders pagination. */
+    isLoadingMoreOpenOrders?: boolean;
+    /** Cursor pagination handler for open orders. */
+    onLoadMoreOpenOrders?: () => void;
+    /** Custom class names for sub-sections */
+    classNames?: UserProfilePageClassNames;
+}