import type { IsoPrice } from '../../domain.objects/IsoPrice';
import { IsoPriceRoundMode } from '../../domain.objects/IsoPriceRoundMode';
import type { IsoPriceShape } from '../../domain.objects/IsoPriceShape';
import type { IsoPriceWords } from '../../domain.objects/IsoPriceWords';
/**
 * .what = divides a price by a scalar
 * .why = enables per-unit calculations and cost breakdowns
 *
 * auto-scales precision when divisors are large.
 * for small divisors, maintains input precision with round.
 *
 * @throws BadRequestError if divisor is zero
 *
 * @example
 * dividePrice({ of: 'USD 10.00', by: 4 })
 * // => 'USD 2.50'
 *
 * @example
 * dividePrice({ of: '$0.25', by: 1_000_000 })
 * // => 'USD 0.000_000_250' (nano precision)
 */
export declare function dividePrice<TCurrency extends string = string>(input: {
    of: IsoPrice<TCurrency> | string;
    by: number;
}, options?: {
    format?: 'words';
    round?: IsoPriceRoundMode;
}): IsoPriceWords<TCurrency>;
export declare function dividePrice<TCurrency extends string = string>(input: {
    of: IsoPrice<TCurrency> | string;
    by: number;
}, options: {
    format: 'shape';
    round?: IsoPriceRoundMode;
}): IsoPriceShape<TCurrency>;
/**
 * .what = alias for dividePrice
 * .why = provides price-prefixed variant
 */
export declare const priceDivide: typeof dividePrice;