@agg-build/ui 4.18.1 → 4.19.0

package/dist/trading.js

@@ -4136,7 +4136,8 @@ var RemoteImage = ({
   width,
   height,
   onClick,
-  ariaLabel
+  ariaLabel,
+  fallback
 }) => {
   const {
     general: { theme }
@@ -4193,7 +4194,7 @@ var RemoteImage = ({
             className: cn(placeholderClasses, classNames == null ? void 0 : classNames.placeholder),
             "aria-hidden": true,
             "aria-errormessage": "Image failed to load",
-            children: /* @__PURE__ */ (0, import_jsx_runtime105.jsx)(
+            children: fallback != null ? fallback : /* @__PURE__ */ (0, import_jsx_runtime105.jsx)(
               Icon,
               {
                 name: "image",
@@ -10294,7 +10295,7 @@ var resolvePlaceOrderQuoteStatus = ({
   selectedMarket,
   tradeSide = "buy"
 }) => {
-  var _a, _b, _c, _d, _e;
+  var _a, _b, _c, _d, _e, _f;
   if (!selectedMarket) {
     return {
       tone: "warning",
@@ -10314,7 +10315,15 @@ var resolvePlaceOrderQuoteStatus = ({
     };
   }
   if (quoteData.status === "no_orderbooks") {
-    const serverError = (_a = quoteData.error) == null ? void 0 : _a.trim();
+    const warnings = (_a = quoteData.warnings) != null ? _a : [];
+    if (warnings.length > 0 && warnings.every((warning) => warning.reason === "hosted_cash_unavailable")) {
+      return {
+        tone: "warning",
+        message: labels.betdexBalanceUnavailable,
+        placement: "above-action"
+      };
+    }
+    const serverError = (_b = quoteData.error) == null ? void 0 : _b.trim();
     return {
       tone: "error",
       message: serverError || labels.noOrderbooks,
@@ -10331,24 +10340,24 @@ var resolvePlaceOrderQuoteStatus = ({
   if (quoteData.status === "insufficient_input_amount") {
     return {
       tone: "error",
-      message: (_b = quoteData.message) != null ? _b : labels.insufficientInputAmount,
+      message: (_c = quoteData.message) != null ? _c : labels.insufficientInputAmount,
       placement: "above-action"
     };
   }
   if (quoteData.status === "invalid_input") {
     return {
       tone: "error",
-      message: (_c = quoteData.message) != null ? _c : labels.quoteUnavailable,
+      message: (_d = quoteData.message) != null ? _d : labels.quoteUnavailable,
       placement: "above-action"
     };
   }
   if (quoteData.status === "insufficient_position") {
-    const total = (_d = quoteData.positionAvailability) == null ? void 0 : _d.totalSellableShares;
+    const total = (_e = quoteData.positionAvailability) == null ? void 0 : _e.totalSellableShares;
     const message = total != null ? labels.insufficientPosition(total) : labels.insufficientPositionGeneric;
     return { tone: "error", message, placement: "above-action" };
   }
   if (quoteData.status === "insufficient_depth") {
-    const serverError = (_e = quoteData.error) == null ? void 0 : _e.trim();
+    const serverError = (_f = quoteData.error) == null ? void 0 : _f.trim();
     return {
       tone: "error",
       message: tradeSide === "sell" ? serverError || labels.insufficientSellDepth : serverError || labels.insufficientLiquidity,
@@ -12936,6 +12945,7 @@ var renderCardHeader = ({
   headerSubtitle,
   headerImage,
   headerTitle,
+  headerVenue,
   onClose
 }) => {
   if (!headerTitle) return null;
@@ -12946,6 +12956,7 @@ var renderCardHeader = ({
         {
           src: headerImage,
           alt: "",
+          fallback: headerVenue ? /* @__PURE__ */ (0, import_jsx_runtime152.jsx)(VenueLogo, { venue: headerVenue, size: "large" }) : void 0,
           className: "agg-order-market-image h-12 w-12 shrink-0 overflow-hidden rounded-agg-lg object-cover"
         }
       ),
@@ -13272,7 +13283,7 @@ var PlaceOrder = ({
   showResolvingState = false,
   midpointsResult
 }) => {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca, _da, _ea, _fa, _ga, _ha;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca, _da, _ea, _fa, _ga, _ha, _ia;
   const {
     enableDebug: isExecutionDebugEnabled,
     features: { enableAnimations, showFeesBreakdown, showLimitOrders: limitOrdersFeature },
@@ -15558,6 +15569,7 @@ var PlaceOrder = ({
             headerSubtitle,
             headerImage,
             headerTitle,
+            headerVenue: (_ia = scopedSelectedMarket == null ? void 0 : scopedSelectedMarket.venue) != null ? _ia : scopedSelectedEvent == null ? void 0 : scopedSelectedEvent.venue,
             onClose
           }),
           /* @__PURE__ */ (0, import_jsx_runtime152.jsxs)("div", { className: cn("agg-order-panel-content flex flex-col gap-6", classNames == null ? void 0 : classNames.content), children: [

package/dist/trading.mjs

@@ -14,7 +14,7 @@ import {
   useClaimWinnings,
   useResolvedMarketClaim,
   venueRequiresSharedKyc
-} from "./chunk-2OBJ7DYT.mjs";
+} from "./chunk-5YHKIJ23.mjs";
 import {
   SETTLEMENT_SECTION_ID,
   Settlement,
@@ -32,9 +32,9 @@ import {
   prepareSettlementDifferences,
   resolveDifferenceIconClassName,
   useEventTradingContext
-} from "./chunk-JJ3VVCEP.mjs";
-import "./chunk-NRPS2D3Q.mjs";
-import "./chunk-WIGSRHUG.mjs";
+} from "./chunk-WOCZ4TVT.mjs";
+import "./chunk-ROA5K67W.mjs";
+import "./chunk-XZVGHKMW.mjs";
 export {
   FundKalshiModal,
   PlaceOrder,

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

@@ -1,4 +1,5 @@
 export * from "./home";
 export * from "./event-market";
 export * from "./user-profile";
+export * from "./leaderboard";
 export { DEPOSIT_MODAL_OPEN_EVENT, WITHDRAW_MODAL_OPEN_EVENT, requestAggDepositModalOpen, requestAggWithdrawModalOpen, } from "../shared/deposit-modal-events";

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

@@ -1,4 +1,5 @@
 export * from "./home";
 export * from "./event-market";
 export * from "./user-profile";
+export * from "./leaderboard";
 export { DEPOSIT_MODAL_OPEN_EVENT, WITHDRAW_MODAL_OPEN_EVENT, requestAggDepositModalOpen, requestAggWithdrawModalOpen, } from "../shared/deposit-modal-events";

package/dist/types/pages/leaderboard/components/leaderboard-header-row.d.mts

@@ -0,0 +1,7 @@
+import type { LeaderboardMetric } from "../leaderboard.types";
+export interface LeaderboardHeaderRowProps {
+    metric: LeaderboardMetric;
+    onMetricChange: (metric: LeaderboardMetric) => void;
+}
+/** Column captions; hidden on phones where each cell carries its own caption. */
+export declare function LeaderboardHeaderRow({ metric, onMetricChange, }: LeaderboardHeaderRowProps): JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { LeaderboardMetric } from "../leaderboard.types";
+export interface LeaderboardHeaderRowProps {
+    metric: LeaderboardMetric;
+    onMetricChange: (metric: LeaderboardMetric) => void;
+}
+/** Column captions; hidden on phones where each cell carries its own caption. */
+export declare function LeaderboardHeaderRow({ metric, onMetricChange, }: LeaderboardHeaderRowProps): JSX.Element;

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

@@ -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-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/primitives/remote-image/index.d.mts

@@ -2,6 +2,6 @@ import type { RemoteImageProps, RemoteImageStatus } from "./remote-image.types";
 export type { RemoteImageProps, RemoteImageStatus };
 /** Renders a remote image with loading skeleton and error placeholder fallbacks. */
 export declare const RemoteImage: {
-    ({ src, retinaSrc, alt, title, className, classNames, width, height, onClick, ariaLabel, }: RemoteImageProps): JSX.Element;
+    ({ src, retinaSrc, alt, title, className, classNames, width, height, onClick, ariaLabel, fallback, }: RemoteImageProps): JSX.Element;
     displayName: string;
 };

package/dist/types/primitives/remote-image/index.d.ts

@@ -2,6 +2,6 @@ import type { RemoteImageProps, RemoteImageStatus } from "./remote-image.types";
 export type { RemoteImageProps, RemoteImageStatus };
 /** Renders a remote image with loading skeleton and error placeholder fallbacks. */
 export declare const RemoteImage: {
-    ({ src, retinaSrc, alt, title, className, classNames, width, height, onClick, ariaLabel, }: RemoteImageProps): JSX.Element;
+    ({ src, retinaSrc, alt, title, className, classNames, width, height, onClick, ariaLabel, fallback, }: RemoteImageProps): JSX.Element;
     displayName: string;
 };

package/dist/types/primitives/remote-image/remote-image.types.d.mts

@@ -31,4 +31,10 @@ export type RemoteImageProps = {
     onClick?: () => void;
     /** Accessible label applied when the image acts like a control. */
     ariaLabel?: string;
+    /**
+     * Rendered instead of the generic image icon when there is no usable image
+     * (missing source or load failure), e.g. the owning venue's mark. The
+     * caller must pass real existing artwork, never an invented subject image.
+     */
+    fallback?: React.ReactNode;
 };

package/dist/types/primitives/remote-image/remote-image.types.d.ts

@@ -31,4 +31,10 @@ export type RemoteImageProps = {
     onClick?: () => void;
     /** Accessible label applied when the image acts like a control. */
     ariaLabel?: string;
+    /**
+     * Rendered instead of the generic image icon when there is no usable image
+     * (missing source or load failure), e.g. the owning venue's mark. The
+     * caller must pass real existing artwork, never an invented subject image.
+     */
+    fallback?: React.ReactNode;
 };

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.1",
+  "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.0",
-    "@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",