import { NonNegativeNumber } from '../number/number';
/**
 * A nominal type for radians.
 */
export type Radians = number;
/**
 * Returns the inverse cosine [0, π] of the given cosine value [-1, 1].
 *
 * @throws Exception - if the given cosine is less than -1, greater than 1, or is NaN.
 *
 * @since v0.11.0
 */
export declare function arccos(cosine: number): Radians | null;
/**
 * Returns the inverse hyperbolic cosine [0, +∞) of a given number from [1, +∞).
 *
 * @throws Exception - if the given value is less than 1 or is NaN.
 *
 * @since v0.11.0
 */
export declare function arccosh(value: number): NonNegativeNumber | null;
/**
 * Returns the inverse sine [-π/2, π/2] of the given sine value [-1, 1].
 *
 * @throws Exception - if the given value is less than -1, greater than 1, or is NaN.
 *
 * @since v0.11.0
 */
export declare function arcsin(sine: number): Radians | null;
/**
 * Returns the inverse hyperbolic sine (-∞, +∞) of a given number from (-∞, +∞).
 *
 * @throws Exception - if the given value is NaN.
 *
 * @since v0.11.0
 */
export declare function arcsinh(value: number): number;
/**
 * Returns the inverse tangent [-π/2, π/2] of a given number from (-∞, +∞).
 *
 * @throws Exception - if the given value is NaN.
 *
 * @since v0.11.0
 */
export declare function arctan(value: number): Radians;
/**
 * Returns the angle in radians [-π, π] between the positive x-axis and the ray from (0, 0) to the point (x, y).
 *
 * Note that `arctan2(y, x)` is not the same as `arctan(y / x)`.
 *
 * @throws Exception - if either `y` or `x` is `NaN`.
 *
 * @since v0.11.0
 */
export declare function arctan2(y: number, x: number): Radians;
/**
 * Returns the angle in radians [-π, π] between the positive x-axis and the ray from (0, 0) to the point (x, y).
 *
 * @param point - A tuple of [y, x] coordinates.
 *
 * @throws Exception - if either `y` or `x` is `NaN`.
 *
 * @since v0.11.0
 */
export declare function arctan2(point: [number, number]): Radians;
/**
 * Returns the inverse hyperbolic tangent (-∞, +∞) of a given number from (-1, 1).
 *
 * @throws Exception - if the given value is less than or equal -1, greater than or equal 1, or is NaN.
 *
 * @since v0.11.0
 */
export declare function arctanh(value: number): number;
/**
 * Returns the cosine [-1, 1] of a given finite angle in radians.
 *
 * @throws Exception - if the given angle is NaN or Infinity.
 *
 * @since v0.11.0
 */
export declare function cos(angle: Radians): number;
/**
 * Returns the hyperbolic cosine [1, +∞) of a given number.
 *
 * @throws Exception - if the given value is NaN.
 *
 * @since v0.11.0
 */
export declare function cosh(value: number): number;
/**
 * Returns the sine [-1, 1] of a given finite angle in radians.
 *
 * @throws Exception - if the given angle is NaN or Infinity.
 *
 * @since v0.11.0
 */
export declare function sin(angle: Radians): number;
/**
 * Returns the hyperbolic sine (-∞, +∞) of a given number.
 *
 * @throws Exception - if the given value is NaN.
 *
 * @since v0.11.0
 */
export declare function sinh(value: number): number;
/**
 * Returns the tangent (-∞, +∞) of a given finite angle in radians.
 *
 * @throws Exception - if the given angle is NaN or Infinity.
 *
 * NOTE: For Math.PI / 2 the result is a finite number due to floating point precision issues.
 *
 * @since v0.11.0
 */
export declare function tan(angle: number): number;
/**
 * Returns the hyperbolic tangent (-1, 1) of a given number.
 * Returns 1 if a given value is Infinity.
 * Returns -1 if a given value is -Infinity.
 *
 * @throws Exception - if the given value is NaN.
 *
 * @since v0.11.0
 */
export declare function tanh(value: number): number;