@agg-build/ui 4.18.2 → 4.19.0

package/dist/types/pages/leaderboard/components/leaderboard-row.d.ts

@@ -0,0 +1,7 @@
+import type { LeaderboardRow } from "../leaderboard.types";
+export interface LeaderboardRowViewProps {
+    row: LeaderboardRow;
+    isCurrentUser: boolean;
+    className?: string;
+}
+export declare function LeaderboardRowView({ row, isCurrentUser, className, }: LeaderboardRowViewProps): JSX.Element;

package/dist/types/pages/leaderboard/components/leaderboard-skeleton.d.mts

@@ -0,0 +1,3 @@
+export declare function LeaderboardSkeleton({ rows }: {
+    rows?: number;
+}): JSX.Element;

package/dist/types/pages/leaderboard/components/leaderboard-skeleton.d.ts

@@ -0,0 +1,3 @@
+export declare function LeaderboardSkeleton({ rows }: {
+    rows?: number;
+}): JSX.Element;

package/dist/types/pages/leaderboard/components/segmented-control.d.mts

@@ -0,0 +1,18 @@
+export interface SegmentedControlItem<T extends string> {
+    value: T;
+    label: string;
+}
+export interface SegmentedControlProps<T extends string> {
+    /** Accessible group name, e.g. "Period". */
+    label: string;
+    value: T;
+    onChange: (value: T) => void;
+    items: SegmentedControlItem<T>[];
+    className?: string;
+    itemClassName?: string;
+}
+/**
+ * Bordered segmented toggle — the same shell as the profile page's position
+ * filters (`rounded-agg-sm border`, 1px dividers, pressed item filled).
+ */
+export declare function SegmentedControl<T extends string>({ label, value, onChange, items, className, itemClassName, }: SegmentedControlProps<T>): JSX.Element;

package/dist/types/pages/leaderboard/components/segmented-control.d.ts

@@ -0,0 +1,18 @@
+export interface SegmentedControlItem<T extends string> {
+    value: T;
+    label: string;
+}
+export interface SegmentedControlProps<T extends string> {
+    /** Accessible group name, e.g. "Period". */
+    label: string;
+    value: T;
+    onChange: (value: T) => void;
+    items: SegmentedControlItem<T>[];
+    className?: string;
+    itemClassName?: string;
+}
+/**
+ * Bordered segmented toggle — the same shell as the profile page's position
+ * filters (`rounded-agg-sm border`, 1px dividers, pressed item filled).
+ */
+export declare function SegmentedControl<T extends string>({ label, value, onChange, items, className, itemClassName, }: SegmentedControlProps<T>): JSX.Element;

package/dist/types/pages/leaderboard/index.d.mts

@@ -0,0 +1,28 @@
+import type { LeaderboardClassNames, LeaderboardMetric, LeaderboardPeriod, LeaderboardRow } from "./leaderboard.types";
+export type { LeaderboardClassNames, LeaderboardMetric, LeaderboardPeriod, LeaderboardRow, } from "./leaderboard.types";
+export { LEADERBOARD_DEFAULT_METRIC, LEADERBOARD_DEFAULT_PERIOD, LEADERBOARD_METRICS, } from "./leaderboard.constants";
+export interface LeaderboardPageProps {
+    /** Rows to render. When absent the page fetches via `useLeaderboard`. */
+    rows?: LeaderboardRow[];
+    isLoading?: boolean;
+    error?: unknown;
+    hasNextPage?: boolean;
+    isLoadingMore?: boolean;
+    onLoadMore?: () => void;
+    /** Controlled period; uncontrolled state is used when absent. */
+    period?: LeaderboardPeriod;
+    onPeriodChange?: (period: LeaderboardPeriod) => void;
+    metric?: LeaderboardMetric;
+    onMetricChange?: (metric: LeaderboardMetric) => void;
+    /** Row to mark as "you". Defaults to the signed-in user. */
+    currentUserId?: string;
+    /** Shown in the subtitle as "Top traders on {appName}". */
+    appName?: string;
+    onError?: (error: Error) => void;
+    className?: string;
+    classNames?: LeaderboardClassNames;
+}
+export declare function LeaderboardPage(props: LeaderboardPageProps): JSX.Element;
+export declare namespace LeaderboardPage {
+    var displayName: string;
+}

package/dist/types/pages/leaderboard/index.d.ts

@@ -0,0 +1,28 @@
+import type { LeaderboardClassNames, LeaderboardMetric, LeaderboardPeriod, LeaderboardRow } from "./leaderboard.types";
+export type { LeaderboardClassNames, LeaderboardMetric, LeaderboardPeriod, LeaderboardRow, } from "./leaderboard.types";
+export { LEADERBOARD_DEFAULT_METRIC, LEADERBOARD_DEFAULT_PERIOD, LEADERBOARD_METRICS, } from "./leaderboard.constants";
+export interface LeaderboardPageProps {
+    /** Rows to render. When absent the page fetches via `useLeaderboard`. */
+    rows?: LeaderboardRow[];
+    isLoading?: boolean;
+    error?: unknown;
+    hasNextPage?: boolean;
+    isLoadingMore?: boolean;
+    onLoadMore?: () => void;
+    /** Controlled period; uncontrolled state is used when absent. */
+    period?: LeaderboardPeriod;
+    onPeriodChange?: (period: LeaderboardPeriod) => void;
+    metric?: LeaderboardMetric;
+    onMetricChange?: (metric: LeaderboardMetric) => void;
+    /** Row to mark as "you". Defaults to the signed-in user. */
+    currentUserId?: string;
+    /** Shown in the subtitle as "Top traders on {appName}". */
+    appName?: string;
+    onError?: (error: Error) => void;
+    className?: string;
+    classNames?: LeaderboardClassNames;
+}
+export declare function LeaderboardPage(props: LeaderboardPageProps): JSX.Element;
+export declare namespace LeaderboardPage {
+    var displayName: string;
+}

package/dist/types/pages/leaderboard/leaderboard.constants.d.mts

@@ -0,0 +1,8 @@
+import type { LeaderboardMetric, LeaderboardPeriod } from "./leaderboard.types";
+export declare const LEADERBOARD_DEFAULT_PERIOD: LeaderboardPeriod;
+export declare const LEADERBOARD_DEFAULT_METRIC: LeaderboardMetric;
+export declare const LEADERBOARD_METRICS: readonly LeaderboardMetric[];
+/** Ranks that get the emphasised chip. */
+export declare const LEADERBOARD_TOP_RANKS = 3;
+/** Shared grid template: rank | identity | trades | volume | P&L. */
+export declare const LEADERBOARD_GRID_CLASS = "grid grid-cols-[36px_minmax(0,1fr)] grid-rows-[auto_auto] gap-x-3 gap-y-2 sm:grid-cols-[48px_minmax(0,1fr)_88px_128px_128px] sm:grid-rows-1 sm:gap-x-3 sm:gap-y-0";

package/dist/types/pages/leaderboard/leaderboard.constants.d.ts

@@ -0,0 +1,8 @@
+import type { LeaderboardMetric, LeaderboardPeriod } from "./leaderboard.types";
+export declare const LEADERBOARD_DEFAULT_PERIOD: LeaderboardPeriod;
+export declare const LEADERBOARD_DEFAULT_METRIC: LeaderboardMetric;
+export declare const LEADERBOARD_METRICS: readonly LeaderboardMetric[];
+/** Ranks that get the emphasised chip. */
+export declare const LEADERBOARD_TOP_RANKS = 3;
+/** Shared grid template: rank | identity | trades | volume | P&L. */
+export declare const LEADERBOARD_GRID_CLASS = "grid grid-cols-[36px_minmax(0,1fr)] grid-rows-[auto_auto] gap-x-3 gap-y-2 sm:grid-cols-[48px_minmax(0,1fr)_88px_128px_128px] sm:grid-rows-1 sm:gap-x-3 sm:gap-y-0";

package/dist/types/pages/leaderboard/leaderboard.types.d.mts

@@ -0,0 +1,11 @@
+import type { LeaderboardMetric, LeaderboardRow } from "@agg-build/sdk";
+import type { LeaderboardPeriod } from "@agg-build/hooks";
+export type { LeaderboardMetric, LeaderboardRow, LeaderboardPeriod };
+export interface LeaderboardClassNames {
+    root?: string;
+    header?: string;
+    toolbar?: string;
+    list?: string;
+    row?: string;
+    footer?: string;
+}

package/dist/types/pages/leaderboard/leaderboard.types.d.ts

@@ -0,0 +1,11 @@
+import type { LeaderboardMetric, LeaderboardRow } from "@agg-build/sdk";
+import type { LeaderboardPeriod } from "@agg-build/hooks";
+export type { LeaderboardMetric, LeaderboardRow, LeaderboardPeriod };
+export interface LeaderboardClassNames {
+    root?: string;
+    header?: string;
+    toolbar?: string;
+    list?: string;
+    row?: string;
+    footer?: string;
+}

package/dist/types/pages/user-profile/position-view-model.d.mts

@@ -1,7 +1,8 @@
+import { formatCurrency, formatSignedCurrency, getPositionTone, type PositionTone } from "../../shared/pnl-format";
 import type { UserProfilePosition } from "./user-profile.types";
+export { formatCurrency, formatSignedCurrency, getPositionTone, type PositionTone };
 export type PositionStatus = "open" | "won_unclaimed" | "won_claimed" | "lost" | "sold";
 export type PositionBucket = "active" | "closed";
-export type PositionTone = "positive" | "negative" | "neutral";
 export type PositionValueDisplay = {
     primaryLabel: string;
     deltaLabel: string;
@@ -43,8 +44,6 @@ export type PositionViewModelFormatters = {
     /** Receives a dollar amount. */
     formatCurrency?: (value: number) => string;
 };
-export declare const formatCurrency: (value: number | null | undefined, formatCurrencyOverride?: (value: number) => string) => string;
-export declare const formatSignedCurrency: (value: number | null | undefined, formatCurrencyOverride?: (value: number) => string) => string;
 export declare const formatPriceCents: (value: number | null | undefined, formatPrice?: (value: number) => string) => string;
 export declare const formatSignedPercent: (value: number | null | undefined) => string;
 export declare const resolvePositionStatus: (position: UserProfilePosition) => PositionStatus;
@@ -61,5 +60,4 @@ export declare const getPnlValue: (position: UserProfilePosition, value: number
 export declare const getPnlPercent: (position: UserProfilePosition, pnlValue: number | null) => number | null;
 export declare const getFinalPnlValue: (position: UserProfilePosition, value: number | null) => number | null;
 export declare const getFinalPnlPercent: (position: UserProfilePosition, pnlValue: number | null) => number | null;
-export declare const getPositionTone: (value: number | null | undefined) => PositionTone;
 export declare const toPositionRowViewModel: (position: UserProfilePosition, labels?: PositionViewModelLabels, formatters?: PositionViewModelFormatters) => PositionRowViewModel;

package/dist/types/pages/user-profile/position-view-model.d.ts

@@ -1,7 +1,8 @@
+import { formatCurrency, formatSignedCurrency, getPositionTone, type PositionTone } from "../../shared/pnl-format";
 import type { UserProfilePosition } from "./user-profile.types";
+export { formatCurrency, formatSignedCurrency, getPositionTone, type PositionTone };
 export type PositionStatus = "open" | "won_unclaimed" | "won_claimed" | "lost" | "sold";
 export type PositionBucket = "active" | "closed";
-export type PositionTone = "positive" | "negative" | "neutral";
 export type PositionValueDisplay = {
     primaryLabel: string;
     deltaLabel: string;
@@ -43,8 +44,6 @@ export type PositionViewModelFormatters = {
     /** Receives a dollar amount. */
     formatCurrency?: (value: number) => string;
 };
-export declare const formatCurrency: (value: number | null | undefined, formatCurrencyOverride?: (value: number) => string) => string;
-export declare const formatSignedCurrency: (value: number | null | undefined, formatCurrencyOverride?: (value: number) => string) => string;
 export declare const formatPriceCents: (value: number | null | undefined, formatPrice?: (value: number) => string) => string;
 export declare const formatSignedPercent: (value: number | null | undefined) => string;
 export declare const resolvePositionStatus: (position: UserProfilePosition) => PositionStatus;
@@ -61,5 +60,4 @@ export declare const getPnlValue: (position: UserProfilePosition, value: number
 export declare const getPnlPercent: (position: UserProfilePosition, pnlValue: number | null) => number | null;
 export declare const getFinalPnlValue: (position: UserProfilePosition, value: number | null) => number | null;
 export declare const getFinalPnlPercent: (position: UserProfilePosition, pnlValue: number | null) => number | null;
-export declare const getPositionTone: (value: number | null | undefined) => PositionTone;
 export declare const toPositionRowViewModel: (position: UserProfilePosition, labels?: PositionViewModelLabels, formatters?: PositionViewModelFormatters) => PositionRowViewModel;

package/dist/types/shared/pnl-format.d.mts

@@ -0,0 +1,20 @@
+export type PositionTone = "positive" | "negative" | "neutral";
+export declare const MISSING_VALUE_LABEL = "\u2014";
+export declare const isFiniteNumber: (value: number | null | undefined) => value is number;
+export declare const formatCurrency: (value: number | null | undefined, formatCurrencyOverride?: (value: number) => string) => string;
+/** Magnitudes below this render as "<$0.01" instead of a misleading "$0.00" when `markNegligible` is set. */
+export declare const NEGLIGIBLE_CURRENCY_THRESHOLD = 0.005;
+export interface SignedCurrencyOptions {
+    /**
+     * Render a non-zero value that would round to $0.00 as `+<$0.01` / `-<$0.01`
+     * so dust (fractional-share settlements, rounding residue) reads as
+     * negligible rather than as exactly zero. Exact 0 still renders `$0.00`.
+     */
+    markNegligible?: boolean;
+}
+export declare const formatSignedCurrency: (value: number | null | undefined, formatCurrencyOverride?: (value: number) => string, options?: SignedCurrencyOptions) => string;
+/** Unsigned counterpart for volume: a positive value below half a cent reads `<$0.01`. */
+export declare const formatCurrencyMarkingNegligible: (value: number | null | undefined, formatCurrencyOverride?: (value: number) => string) => string;
+export declare const getPositionTone: (value: number | null | undefined) => PositionTone;
+/** Token class for a P&L tone; mirrors position-row.tsx's mapping. */
+export declare const toneClassName: (tone: PositionTone) => string;

package/dist/types/shared/pnl-format.d.ts

@@ -0,0 +1,20 @@
+export type PositionTone = "positive" | "negative" | "neutral";
+export declare const MISSING_VALUE_LABEL = "\u2014";
+export declare const isFiniteNumber: (value: number | null | undefined) => value is number;
+export declare const formatCurrency: (value: number | null | undefined, formatCurrencyOverride?: (value: number) => string) => string;
+/** Magnitudes below this render as "<$0.01" instead of a misleading "$0.00" when `markNegligible` is set. */
+export declare const NEGLIGIBLE_CURRENCY_THRESHOLD = 0.005;
+export interface SignedCurrencyOptions {
+    /**
+     * Render a non-zero value that would round to $0.00 as `+<$0.01` / `-<$0.01`
+     * so dust (fractional-share settlements, rounding residue) reads as
+     * negligible rather than as exactly zero. Exact 0 still renders `$0.00`.
+     */
+    markNegligible?: boolean;
+}
+export declare const formatSignedCurrency: (value: number | null | undefined, formatCurrencyOverride?: (value: number) => string, options?: SignedCurrencyOptions) => string;
+/** Unsigned counterpart for volume: a positive value below half a cent reads `<$0.01`. */
+export declare const formatCurrencyMarkingNegligible: (value: number | null | undefined, formatCurrencyOverride?: (value: number) => string) => string;
+export declare const getPositionTone: (value: number | null | undefined) => PositionTone;
+/** Token class for a P&L tone; mirrors position-row.tsx's mapping. */
+export declare const toneClassName: (tone: PositionTone) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/ui",
-  "version": "4.18.2",
+  "version": "4.19.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": "^4.18.2",
-    "@agg-build/sdk": "^4.18.0"
+    "@agg-build/hooks": "^4.19.0",
+    "@agg-build/sdk": "^4.19.0"
   },
   "dependencies": {
     "@number-flow/react": "^0.6.0",