export { type BaseCoerceNumberOpts as BaseCoerceOpts, coerceNumber as coerce, type CoerceNumberOpts as CoerceOpts } from '../../../../core/utils/coerce/number/index.js';
/**
 * Rounds a number to the specified decimal point.
 * @example
 * ```ts
 * round(3.14159) // 3
 * round(3.14159, 2) // 3.14
 * round(3.14159, 4) // 3.1416
 * round(3.14159, -1) // 3
 * round(3.14159, NaN) // 3
 * ```
 */
export declare const round: (value: number, decimalPosition?: number) => number;
export interface ReducerOpts {
    roundTo?: number;
    start?: number;
}
/**
 * Reduces an array of numbers using the provided callback function,
 * with options for rounding and starting value.
 * @example
 * ```ts
 * reduce([1.234, 2.345, 3.456], (a, b) => a + b, { roundTo: 2 }) // 7.04
 * reduce([1, 2, 3, 4], (a, b) => a * b, { start: 1 }) // 24
 * reduce([], (a, b) => a + b, { start: 10 }) // 10
 * ```
 */
export declare const reduce: (numbers: number[], cb: (a: number, b: number) => number, { roundTo, start }: ReducerOpts) => number;
/**
 * Calculates the sum of an array of numbers, with optional rounding.
 * @example
 * ```ts
 * sum([1.234, 2.345, 3.456], 2) // 7.04
 * sum([1, 2, 3, 4]) // 10
 * sum([], 2) // 0
 * ```
 */
export declare const sum: (numbers: number[], roundTo?: number) => number;
/**
 * Calculates the product of an array of numbers, with optional rounding.
 * @example
 * ```ts
 * product([1.5, 2, 3], 2) // 9
 * product([1, 2, 3, 4]) // 24
 * product([], 2) // 1
 * ```
 */
export declare const product: (numbers: number[], roundTo?: number) => number;
/**
 * Calculates the average of an array of numbers, with optional rounding.
 * Returns 0 for an empty array.
 * @example
 * ```ts
 * average([1.5, 2.5, 3.5], 2) // 2.5
 * average([1, 2, 3, 4]) // 2.5
 * average([], 2) // 0
 * ```
 */
export declare const average: (numbers: number[], roundTo?: number) => number;
/**
 * Calculates the range (max - min) of an array of numbers.
 * Returns NaN for an empty array.
 * @example
 * ```ts
 * range([1, 2, 3, 4]) // 3
 * range([-10, 0, 10]) // 20
 * range([]) // NaN
 * ```
 */
export declare const range: (numbers: number[]) => number;
export interface ClampOpts {
    decimal?: number;
    max?: number;
    min?: number;
}
/**
 * Clamps a number between min and max
 *  - Inclusive
 *  @default
 * ```ts
 * { min: -Infinity, max: Infinity, decimal: 0 }
 * ```
 *
 * @example
 * ```ts
 * clamp(10, { min: 0, max: 5 }) // 5
 * clamp(-10, { min: 0, max: 5 }) // 0
 * clamp(3.14159, { decimal: 2 }) // 3.14
 * clamp(3.14159, { decimal: 4 }) // 3.1416
 * clamp(3.14159) // 3
 * ```
 */
export declare const clamp: (value: number, { min, max, decimal }?: ClampOpts) => number;