import { type Numberish } from "../format.js";
/** The USD decimals policy: 2 for dollars, more as the value shrinks, significant-digit floor below a cent. */
export declare function usdDecimals(value: number): number;
export interface UsdOptions {
    /** Fixed decimal places, overriding the optimal-decimals policy. */
    decimals?: number;
    /** Compact notation for market-cap-scale money: $60.9M. */
    compact?: boolean;
}
/**
 * The USD decimals POLICY as Intl.NumberFormatOptions, for consumers that
 * format internally — animated numbers (NumberFlow), chart axes, table cell
 * renderers. One policy serves strings and widgets alike; `usd()` below is
 * just this policy applied. Value-dependent: recompute when the value moves.
 */
export declare function usdIntlOptions(value: number, opts?: UsdOptions): Intl.NumberFormatOptions;
/**
 * $1,234.56 with optimal decimals (grouped, en-pinned — SSR-hydration-safe);
 * sub-cent values keep 2 significant digits ($0.00000043) instead of rounding
 * to $0.000000. `{compact: true}` → $60.9M; `{decimals}` overrides the policy.
 */
export declare function usd(value: Numberish, opts?: UsdOptions): string;
//# sourceMappingURL=usd.d.ts.map