@agg-build/ui 2.0.0 → 2.1.0

package/dist/types/events/list/category-sidebar.d.mts

@@ -0,0 +1,33 @@
+import type { Category } from "@agg-build/sdk";
+import type { SubcategoryPathEntry } from "./event-list.utils";
+export type CategorySidebarLabels = {
+    subcategoriesAll: string;
+};
+export type CategorySidebarToggleParams = {
+    entry: SubcategoryPathEntry;
+    depth: number;
+    hasKnownChildren: boolean;
+    isExpanded: boolean;
+    isSelected: boolean;
+};
+export type CategorySidebarProps = {
+    /** Root category whose direct children populate the sidebar. */
+    baseCategoryId: string | null;
+    /** Children of each category, keyed by parent ID. */
+    childrenByParentId: ReadonlyMap<string, readonly Category[]>;
+    /** Drill path beneath the root (depth-0 = first child of baseCategoryId). */
+    categoryPath: readonly SubcategoryPathEntry[];
+    /** Categories that are selected but explicitly collapsed. */
+    collapsedCategoryIds: ReadonlySet<string>;
+    /** Event count shown on the "All" row (total for the root category). */
+    totalEventCount: number;
+    labels: CategorySidebarLabels;
+    /** Called when the "All" row is clicked. */
+    onSelectAll: () => void;
+    /** Called when any category row is clicked. */
+    onToggleCategory: (params: CategorySidebarToggleParams) => void;
+};
+export declare const CategorySidebar: {
+    ({ baseCategoryId, childrenByParentId, categoryPath, collapsedCategoryIds, totalEventCount, labels, onSelectAll, onToggleCategory, }: CategorySidebarProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/events/list/category-sidebar.d.ts

@@ -0,0 +1,33 @@
+import type { Category } from "@agg-build/sdk";
+import type { SubcategoryPathEntry } from "./event-list.utils";
+export type CategorySidebarLabels = {
+    subcategoriesAll: string;
+};
+export type CategorySidebarToggleParams = {
+    entry: SubcategoryPathEntry;
+    depth: number;
+    hasKnownChildren: boolean;
+    isExpanded: boolean;
+    isSelected: boolean;
+};
+export type CategorySidebarProps = {
+    /** Root category whose direct children populate the sidebar. */
+    baseCategoryId: string | null;
+    /** Children of each category, keyed by parent ID. */
+    childrenByParentId: ReadonlyMap<string, readonly Category[]>;
+    /** Drill path beneath the root (depth-0 = first child of baseCategoryId). */
+    categoryPath: readonly SubcategoryPathEntry[];
+    /** Categories that are selected but explicitly collapsed. */
+    collapsedCategoryIds: ReadonlySet<string>;
+    /** Event count shown on the "All" row (total for the root category). */
+    totalEventCount: number;
+    labels: CategorySidebarLabels;
+    /** Called when the "All" row is clicked. */
+    onSelectAll: () => void;
+    /** Called when any category row is clicked. */
+    onToggleCategory: (params: CategorySidebarToggleParams) => void;
+};
+export declare const CategorySidebar: {
+    ({ baseCategoryId, childrenByParentId, categoryPath, collapsedCategoryIds, totalEventCount, labels, onSelectAll, onToggleCategory, }: CategorySidebarProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/events/list/event-list-tabs.d.mts

@@ -1,6 +1,8 @@
 import { type MutableRefObject } from "react";
 import { type TabsOverflowBehavior } from "../../primitives/tabs";
 import type { EventListTab, EventListTabValue } from "./event-list.types";
+export { useHorizontalScrollState } from "../../shared/use-horizontal-scroll-state";
+export type { UseHorizontalScrollStateResult } from "../../shared/use-horizontal-scroll-state";
 export type EventListTabsProps = {
     /** Override the canonical tab list. Disabled-venue filtering is still applied. */
     tabs?: EventListTab[];

package/dist/types/events/list/event-list-tabs.d.ts

@@ -1,6 +1,8 @@
 import { type MutableRefObject } from "react";
 import { type TabsOverflowBehavior } from "../../primitives/tabs";
 import type { EventListTab, EventListTabValue } from "./event-list.types";
+export { useHorizontalScrollState } from "../../shared/use-horizontal-scroll-state";
+export type { UseHorizontalScrollStateResult } from "../../shared/use-horizontal-scroll-state";
 export type EventListTabsProps = {
     /** Override the canonical tab list. Disabled-venue filtering is still applied. */
     tabs?: EventListTab[];

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

@@ -1,4 +1,5 @@
 import type { EventListProps } from "./event-list.types";
+export type { CategorySidebarLabels, CategorySidebarProps } from "./category-sidebar";
 export type { EventListProps, EventListStateRef } from "./event-list.types";
 export declare const EventList: {
     ({ title, limit, maxVisibleItems, search, categoryIds, onCategoryRootChange, onEventClick, onMarketClick, getMarketHref, getEventHref, initialVenueTab, initialLoadedPageCount, stateRef, }: EventListProps): JSX.Element;

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

@@ -1,4 +1,5 @@
 import type { EventListProps } from "./event-list.types";
+export type { CategorySidebarLabels, CategorySidebarProps } from "./category-sidebar";
 export type { EventListProps, EventListStateRef } from "./event-list.types";
 export declare const EventList: {
     ({ title, limit, maxVisibleItems, search, categoryIds, onCategoryRootChange, onEventClick, onMarketClick, getMarketHref, getEventHref, initialVenueTab, initialLoadedPageCount, stateRef, }: EventListProps): JSX.Element;

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

@@ -44,6 +44,7 @@ export type EventMarketPageBaseProps = {
     defaultOutcomeId?: string;
     /** Whether to render the place-order panel. */
     showPlaceOrder?: boolean;
+    executionMode?: "live" | "paper";
     /** Optional resolved-event claim summary shown inside the read-only order panel. */
     resolvedClaim?: PlaceOrderResolvedClaimSummary;
     /** Class name overrides for page layout slots. */

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

@@ -44,6 +44,7 @@ export type EventMarketPageBaseProps = {
     defaultOutcomeId?: string;
     /** Whether to render the place-order panel. */
     showPlaceOrder?: boolean;
+    executionMode?: "live" | "paper";
     /** Optional resolved-event claim summary shown inside the read-only order panel. */
     resolvedClaim?: PlaceOrderResolvedClaimSummary;
     /** Class name overrides for page layout slots. */

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

@@ -3,7 +3,7 @@ export type { UserProfileActivity, UserProfileActivityStatus, UserProfileBalance
 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, onClaimResult, onClaimSubmitError, 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 & {
+    ({ user, balanceChainsOverride, venueBalances: _venueBalances, balance, activePositions, closedPositions, activities, executionMode, onEditProfile, onDeposit, onWithdraw, openOrders, initialPositionFilter, tab, onTabChange, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onClaimResult, onClaimSubmitError, 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

@@ -3,7 +3,7 @@ export type { UserProfileActivity, UserProfileActivityStatus, UserProfileBalance
 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, onClaimResult, onClaimSubmitError, 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 & {
+    ({ user, balanceChainsOverride, venueBalances: _venueBalances, balance, activePositions, closedPositions, activities, executionMode, onEditProfile, onDeposit, onWithdraw, openOrders, initialPositionFilter, tab, onTabChange, onPositionClick, getPositionHref, onClaim, claimingPositionKeys, onClaimResult, onClaimSubmitError, 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.types.d.mts

@@ -286,6 +286,7 @@ export interface UserProfilePageProps {
     openOrders?: UserProfileOpenOrder[];
     /** Activity items */
     activities?: UserProfileActivity[];
+    executionMode?: "live" | "paper";
     /** Called when the user clicks "Edit" on the user info card */
     onEditProfile?: () => void;
     /** Called when the user clicks "Deposit" */

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

@@ -286,6 +286,7 @@ export interface UserProfilePageProps {
     openOrders?: UserProfileOpenOrder[];
     /** Activity items */
     activities?: UserProfileActivity[];
+    executionMode?: "live" | "paper";
     /** Called when the user clicks "Edit" on the user info card */
     onEditProfile?: () => void;
     /** Called when the user clicks "Deposit" */

package/dist/types/shared/use-horizontal-scroll-state.d.mts

@@ -0,0 +1,15 @@
+import { type MutableRefObject } from "react";
+export type UseHorizontalScrollStateResult<T extends HTMLElement = HTMLElement> = {
+    containerRef: MutableRefObject<T | null>;
+    canScrollLeft: boolean;
+    canScrollRight: boolean;
+    /** Call after content changes that alter overflow without triggering scroll/resize. */
+    update: () => void;
+};
+/**
+ * Tracks whether a horizontally scrollable container can scroll further left
+ * or right. Attaches a passive scroll listener and a ResizeObserver. Call
+ * `update()` after programmatic content mutations that may change overflow
+ * without emitting a native scroll or resize event.
+ */
+export declare const useHorizontalScrollState: <T extends HTMLElement = HTMLElement>() => UseHorizontalScrollStateResult<T>;

package/dist/types/shared/use-horizontal-scroll-state.d.ts

@@ -0,0 +1,15 @@
+import { type MutableRefObject } from "react";
+export type UseHorizontalScrollStateResult<T extends HTMLElement = HTMLElement> = {
+    containerRef: MutableRefObject<T | null>;
+    canScrollLeft: boolean;
+    canScrollRight: boolean;
+    /** Call after content changes that alter overflow without triggering scroll/resize. */
+    update: () => void;
+};
+/**
+ * Tracks whether a horizontally scrollable container can scroll further left
+ * or right. Attaches a passive scroll listener and a ResizeObserver. Call
+ * `update()` after programmatic content mutations that may change overflow
+ * without emitting a native scroll or resize event.
+ */
+export declare const useHorizontalScrollState: <T extends HTMLElement = HTMLElement>() => UseHorizontalScrollStateResult<T>;

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

@@ -1,5 +1,13 @@
-import type { WithdrawModalProps } from "./withdraw-modal.types";
+import type { WithdrawModalProps, WithdrawSummary } from "./withdraw-modal.types";
 export type { WithdrawMethod, WithdrawModalControlledProps, WithdrawModalProps, WithdrawModalSelfDrivenProps, WithdrawFlowData, WithdrawFeeEstimate, WithdrawSummary, } from "./withdraw-modal.types";
+export declare const buildTerminalSummary: ({ fallbackSummary, lifecycleCompletedAmountRaw, lifecycleRequestedAmountRaw, lifecycleFeeRaw, tokenSymbol, chainId, }: {
+    fallbackSummary: WithdrawSummary;
+    lifecycleCompletedAmountRaw: string | null;
+    lifecycleRequestedAmountRaw: string | null;
+    lifecycleFeeRaw: string | null;
+    tokenSymbol: string;
+    chainId: string;
+}) => WithdrawSummary;
 export declare const WithdrawModal: {
     (props: WithdrawModalProps): JSX.Element;
     displayName: string;

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

@@ -1,5 +1,13 @@
-import type { WithdrawModalProps } from "./withdraw-modal.types";
+import type { WithdrawModalProps, WithdrawSummary } from "./withdraw-modal.types";
 export type { WithdrawMethod, WithdrawModalControlledProps, WithdrawModalProps, WithdrawModalSelfDrivenProps, WithdrawFlowData, WithdrawFeeEstimate, WithdrawSummary, } from "./withdraw-modal.types";
+export declare const buildTerminalSummary: ({ fallbackSummary, lifecycleCompletedAmountRaw, lifecycleRequestedAmountRaw, lifecycleFeeRaw, tokenSymbol, chainId, }: {
+    fallbackSummary: WithdrawSummary;
+    lifecycleCompletedAmountRaw: string | null;
+    lifecycleRequestedAmountRaw: string | null;
+    lifecycleFeeRaw: string | null;
+    tokenSymbol: string;
+    chainId: string;
+}) => WithdrawSummary;
 export declare const WithdrawModal: {
     (props: WithdrawModalProps): JSX.Element;
     displayName: string;

package/dist/types/withdraw/steps/withdraw-amount.d.mts

@@ -7,8 +7,17 @@ export interface WithdrawAmountStepProps {
     networkOptions: WithdrawSelectOption[];
     selectedToken: string;
     selectedNetwork: string;
+    /** Decimals for the destination token on the selected chain (e.g. 18 for USDC on BNB, 6 elsewhere). */
+    destDecimals: number;
     isConfirming?: boolean;
     error?: string | null;
+    /**
+     * When `true`, the preview request includes `max:true` so the backend caps
+     * the withdrawal to the deliverable maximum rather than returning unviable.
+     * Should only be set after the user clicks Max — manual over-amounts must
+     * still show the unviable state.
+     */
+    max?: boolean;
     onBack: () => void;
     onAmountChange: (amount: string) => void;
     onDestinationChange: (address: string) => void;
@@ -17,4 +26,4 @@ export interface WithdrawAmountStepProps {
     onMaxClick?: () => void;
     onContinue: () => void;
 }
-export declare const WithdrawAmountStep: ({ amount, destinationWallet, balanceDisplay, tokenOptions, networkOptions, selectedToken, selectedNetwork, isConfirming, error, onBack, onAmountChange, onDestinationChange, onTokenChange, onNetworkChange, onMaxClick, onContinue, }: WithdrawAmountStepProps) => JSX.Element;
+export declare const WithdrawAmountStep: ({ amount, destinationWallet, balanceDisplay, tokenOptions, networkOptions, selectedToken, selectedNetwork, destDecimals, isConfirming, error, max, onBack, onAmountChange, onDestinationChange, onTokenChange, onNetworkChange, onMaxClick, onContinue, }: WithdrawAmountStepProps) => JSX.Element;

package/dist/types/withdraw/steps/withdraw-amount.d.ts

@@ -7,8 +7,17 @@ export interface WithdrawAmountStepProps {
     networkOptions: WithdrawSelectOption[];
     selectedToken: string;
     selectedNetwork: string;
+    /** Decimals for the destination token on the selected chain (e.g. 18 for USDC on BNB, 6 elsewhere). */
+    destDecimals: number;
     isConfirming?: boolean;
     error?: string | null;
+    /**
+     * When `true`, the preview request includes `max:true` so the backend caps
+     * the withdrawal to the deliverable maximum rather than returning unviable.
+     * Should only be set after the user clicks Max — manual over-amounts must
+     * still show the unviable state.
+     */
+    max?: boolean;
     onBack: () => void;
     onAmountChange: (amount: string) => void;
     onDestinationChange: (address: string) => void;
@@ -17,4 +26,4 @@ export interface WithdrawAmountStepProps {
     onMaxClick?: () => void;
     onContinue: () => void;
 }
-export declare const WithdrawAmountStep: ({ amount, destinationWallet, balanceDisplay, tokenOptions, networkOptions, selectedToken, selectedNetwork, isConfirming, error, onBack, onAmountChange, onDestinationChange, onTokenChange, onNetworkChange, onMaxClick, onContinue, }: WithdrawAmountStepProps) => JSX.Element;
+export declare const WithdrawAmountStep: ({ amount, destinationWallet, balanceDisplay, tokenOptions, networkOptions, selectedToken, selectedNetwork, destDecimals, isConfirming, error, max, onBack, onAmountChange, onDestinationChange, onTokenChange, onNetworkChange, onMaxClick, onContinue, }: WithdrawAmountStepProps) => JSX.Element;

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

@@ -8,6 +8,8 @@ export interface WithdrawSelectOption {
     value: string;
     label: string;
     iconUrl?: string;
+    /** When true, the option is shown but not selectable (e.g. a chain that can't receive the entered address). */
+    disabled?: boolean;
 }
 export interface WithdrawProviderOption {
     id: string;
@@ -46,6 +48,12 @@ export interface WithdrawFlowData {
      * `withdrawal_lifecycle` WS events.
      */
     withdrawalId: string | null;
+    /**
+     * True when the user clicked Max — the backend should apply its own cap
+     * rather than rejecting an over-balance request. Reset to false when the
+     * user manually edits the amount field afterward.
+     */
+    isMax: boolean;
 }
 export type WithdrawMethod = "wallet";
 export interface WithdrawModalControlledProps {

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

@@ -8,6 +8,8 @@ export interface WithdrawSelectOption {
     value: string;
     label: string;
     iconUrl?: string;
+    /** When true, the option is shown but not selectable (e.g. a chain that can't receive the entered address). */
+    disabled?: boolean;
 }
 export interface WithdrawProviderOption {
     id: string;
@@ -46,6 +48,12 @@ export interface WithdrawFlowData {
      * `withdrawal_lifecycle` WS events.
      */
     withdrawalId: string | null;
+    /**
+     * True when the user clicked Max — the backend should apply its own cap
+     * rather than rejecting an over-balance request. Reset to false when the
+     * user manually edits the amount field afterward.
+     */
+    isMax: boolean;
 }
 export type WithdrawMethod = "wallet";
 export interface WithdrawModalControlledProps {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/ui",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "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",
@@ -100,8 +100,8 @@
     "liveline": "^0.0.7",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
-    "@agg-build/hooks": "^2.0.0",
-    "@agg-build/sdk": "^2.0.0"
+    "@agg-build/hooks": "^2.1.0",
+    "@agg-build/sdk": "^2.1.0"
   },
   "dependencies": {
     "@number-flow/react": "^0.6.0",