import { type ComponentProps } from 'react'; export interface AmountProps extends ComponentProps<'span'> { /** * The monetary value to display. * For exact precision beyond 2^53, pass either: * - a `string` — supports decimals (e.g. "1299" or "12.99") * - a `bigint` — integer-only; treated as already in major units, so * `valueInMinorUnits` is ignored when value is a bigint * @default 0 * @example * valueInMinorUnits=true: 1299 => "$12.99" * valueInMinorUnits=false: 12.99 => "$12.99" * Large strings: "999999999999999" => "$9,999,999,999,999.99" * BigInt: 1299n => "$1,299.00" (always major units) */ value: number | string | bigint; /** * ISO 4217 currency code * @default 'USD' */ currency?: string; /** * Whether the value is in minor units (cents, paise, etc.) * If true, the value will be converted based on the currency's decimal places * If false, the value will be used as is * @default true * @example * USD: 1299 => $12.99 (2 decimals) * JPY: 1299 => ¥1,299 (0 decimals) * BHD: 1299 => BHD 1.299 (3 decimals) */ valueInMinorUnits?: boolean; /** * BCP 47 language tag * @default 'en-US' * @example 'en-US', 'de-DE', 'ja-JP' */ locale?: string; /** * Truncates decimal places * @default false */ hideDecimals?: boolean; /** * Currency display format * @default 'symbol' * @example 'symbol' - $12.99, 'code' - USD 12.99, 'name' - 12.99 US Dollars */ currencyDisplay?: 'symbol' | 'code' | 'name'; /** * Number of minimum fraction digits * @default undefined (uses currency's default) */ minimumFractionDigits?: number; /** * Number of maximum fraction digits * @default undefined (uses currency's default) */ maximumFractionDigits?: number; /** * Group digits (e.g., thousand separators) * @default true */ groupDigits?: boolean; /** * Render the formatted number without a currency symbol, code, or name. * Locale-driven separators, grouping, and fraction digits are preserved. * When true, `currencyDisplay` is ignored. * @default false * @example * => "12.99" */ hideCurrency?: boolean; } /** * Amount component for displaying monetary values. * Automatically formats currencies using Intl.NumberFormat. * Inherits styling from parent Text component. * * @example * ```tsx * // Basic usage * * Total: // Shows as "$12.99" * * * // With different currency and locale * * Prix: // Shows as "12,99 €" * * * // Without decimals * * Price: // Shows as "$12" * * * // With currency code * * Amount: // Shows as "USD 12.99" * * * // With value in major units * * Amount: // Shows as "$12.99" * * * // With groupDigits (default is true) * * Amount: // Shows as "$129,999,999.99" * * ``` */ export declare const Amount: { ({ value, currency, locale, hideDecimals, currencyDisplay, minimumFractionDigits, maximumFractionDigits, groupDigits, valueInMinorUnits, hideCurrency, className, ...props }: AmountProps): import("react/jsx-runtime").JSX.Element; displayName: string; }; //# sourceMappingURL=amount.d.ts.map