@tlua/gmod 1.0.1

package/math.d.tlua

@@ -0,0 +1,899 @@
+// AUTO-GENERATED tlua declarations. Do not edit by hand.
+
+/**
+ * An easing library that allows you to interpolate with various kinds of smoothing [functions](https://easings.net/). To use with [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp), input what you would to the fraction argument in one of these easing functions and then the output of that into the [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) fraction argument.
+ *
+ * 	Example usage with Lerp and [math.ease.InSine](https://wiki.facepunch.com/gmod/math.ease.InSine)
+ *
+ * -- Define a wrapper function to make it easier to work with
+ * local function easedLerp(fraction, from, to)
+ * 	return Lerp(math.ease.InSine(fraction), from, to)
+ * end
+ *
+ * -- Compare with the non-eased version of Lerp
+ * print(easedLerp(0.25, 0, 1))
+ * print(Lerp(0.25, 0, 1))
+ *
+ * print(easedLerp(0.25, 0, 5))
+ * print(Lerp(0.25, 0, 5))
+ *
+ *
+ * ```
+ * 0.076120467488713
+ * 0.25
+ *
+ * 0.38060233744357
+ * 1.25
+ * ```
+ *
+ *
+ *
+ *
+ *
+ *
+ * 		A brief visual example of different easing methods
+ *
+ *
+ *
+ *
+ * @source https://wiki.facepunch.com/gmod/math.ease
+ */
+interface MathLib {
+    ease: MatheaseLib;
+}
+
+/**
+ * The math library is a standard Lua library that provides functions for manipulating numbers. In Garry's Mod several additional math functions have been added.
+ * @source https://wiki.facepunch.com/gmod/math
+ */
+interface MathLib {
+    /**
+     * Calculates the difference between two angles.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.AngleDifference
+     */
+    AngleDifference(a: number, b: number): number;
+}
+
+interface MathLib {
+    /**
+     * Gradually approaches the target value by the specified amount.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.Approach
+     */
+    Approach(current: number, target: number, change: number): number;
+}
+
+interface MathLib {
+    /**
+     * Increments an angle towards another by specified rate.
+     *
+     * **NOTE**: This function is for numbers representing angles (0-360), NOT [Angle](https://wiki.facepunch.com/gmod/Angle) objects!
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ApproachAngle
+     */
+    ApproachAngle(currentAngle: number, targetAngle: number, rate: number): number;
+}
+
+interface MathLib {
+    /**
+     * Basic code for Bézier-Spline algorithm.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.BSplinePoint
+     */
+    BSplinePoint(fraction: number, points: table, fractionMax: number): Vector;
+}
+
+interface MathLib {
+    /**
+     * Converts a binary string into a number.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.BinToInt
+     */
+    BinToInt(string: string): number;
+}
+
+interface MathLib {
+    /**
+     * Cubic Hermite spline algorithm.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.CHSpline
+     */
+    CHSpline(frac: number, point0: Vector, tan0: Vector, point1: Vector, tan1: Vector): Vector;
+}
+
+interface MathLib {
+    /**
+     * Clamps a number between a minimum and maximum value.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.Clamp
+     */
+    Clamp(input: number, min: number, max: number): number;
+}
+
+interface MathLib {
+    /**
+     * Lerp point between 4 control points with cubic bezier.
+     *
+     * See [math.QuadraticBezier](https://wiki.facepunch.com/gmod/math.QuadraticBezier) for a similar function which works with 3 control points.
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.CubicBezier
+     */
+    CubicBezier(frac: number, p0: Vector, p1: Vector, p2: Vector, p3: Vector): Vector;
+}
+
+interface MathLib {
+    /**
+     * Returns the difference between two points in 2D space. Alias of [math.Distance](https://wiki.facepunch.com/gmod/math.Distance).
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.Dist
+     * @deprecated You should use math.Distance instead
+     */
+    Dist(x1: number, y1: number, x2: number, y2: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the difference between two points in 2D space.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.Distance
+     */
+    Distance(x1: number, y1: number, x2: number, y2: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the squared difference between two points in 2D space. This is computationally faster than [math.Distance](https://wiki.facepunch.com/gmod/math.Distance).
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.DistanceSqr
+     */
+    DistanceSqr(x1: number, y1: number, x2: number, y2: number): number;
+}
+
+interface MathLib {
+    /**
+     * Calculates the progress of a value fraction, taking in to account given easing fractions
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.EaseInOut
+     */
+    EaseInOut(progress: number, easeIn?: number, easeOut?: number): number;
+}
+
+interface MathLib {
+    /**
+     * Simple function that calculates [factorial](https://en.wikipedia.org/wiki/Factorial) of a whole number.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.Factorial
+     */
+    Factorial(val_in: number): number;
+}
+
+interface MathLib {
+    /**
+     * Converts an integer to a binary (base-2) string.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.IntToBin
+     */
+    IntToBin(int: number): string;
+}
+
+interface MathLib {
+    /**
+     * Checks if two floating point numbers are nearly equal.
+     *
+     * This is useful to mitigate  [accuracy issues in floating point numbers](https://en.wikipedia.org/wiki/Floating-point_arithmetic#Accuracy_problems). See examples below.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.IsNearlyEqual
+     */
+    IsNearlyEqual(a: number, b: number, tolerance?: number): boolean;
+}
+
+interface MathLib {
+    /**
+     * Normalizes angle, so it returns value between -180 and 180.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.NormalizeAngle
+     */
+    NormalizeAngle(angle: number): number;
+}
+
+interface MathLib {
+    /**
+     * Lerp point between 3 control points with quadratic bezier.
+     *
+     * See [math.CubicBezier](https://wiki.facepunch.com/gmod/math.CubicBezier) for a function which works with 4 control points.
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.QuadraticBezier
+     */
+    QuadraticBezier(frac: number, p0: Vector, p1: Vector, p2: Vector): Vector;
+}
+
+interface MathLib {
+    /**
+     * Returns a random float between min and max.
+     *
+     * See also [math.random](https://wiki.facepunch.com/gmod/math.random)
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.Rand
+     */
+    Rand(min: number, max: number): number;
+}
+
+interface MathLib {
+    /**
+     * Remaps the value from one range to another
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.Remap
+     */
+    Remap(value: number, inMin: number, inMax: number, outMin: number, outMax: number): number;
+}
+
+interface MathLib {
+    /**
+     * Rounds the given value to the nearest whole number or to the given decimal places.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.Round
+     */
+    Round(value: number, decimals?: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the mathematical negative/positive sign of the input number.
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.Sign
+     */
+    Sign(value: number): number;
+}
+
+interface MathLib {
+    /**
+     * Snaps a number to the closest multiplicative of given number. See also [Angle:SnapTo](https://wiki.facepunch.com/gmod/Angle:SnapTo).
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.SnapTo
+     */
+    SnapTo(input: number, snapTo: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the fraction of where the current time is relative to the start and end times
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.TimeFraction
+     */
+    TimeFraction(start: number, _end: number, current: number): number;
+}
+
+interface MathLib {
+    /**
+     * Trim unwanted decimal places.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.Truncate
+     */
+    Truncate(num: number, digits?: number): number;
+}
+
+interface MathLib {
+    /**
+     * Calculates the absolute value of a number (effectively removes any negative sign).
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.abs
+     */
+    abs(x: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the [arccosine](https://en.wikipedia.org/wiki/Arccosine) of the given number.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.acos
+     */
+    acos(cos: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the [arcsine](https://en.wikipedia.org/wiki/Inverse_trigonometric_functions) of the given number.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.asin
+     */
+    asin(normal: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the [arctangent](https://en.wikipedia.org/wiki/Inverse_trigonometric_functions) of the given number.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.atan
+     */
+    atan(normal: number): number;
+}
+
+interface MathLib {
+    /**
+     * functions like [math.atan](https://wiki.facepunch.com/gmod/math.atan)(y / x), except it also takes into account the quadrant of the angle and so doesn't have a limited range of output.
+     *
+     * **NOTE**: The Y argument comes first!
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.atan2
+     */
+    atan2(y: number, x: number): number;
+}
+
+interface MathLib {
+    /**
+     * **INTERNAL**: Use [math.BSplinePoint](https://wiki.facepunch.com/gmod/math.BSplinePoint) instead.
+     *
+     *
+     * Basic code for Bezier-Spline algorithm, helper function for [math.BSplinePoint](https://wiki.facepunch.com/gmod/math.BSplinePoint).
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.calcBSplineN
+     */
+    calcBSplineN(i: number, k: number, t: number, tinc: number): number;
+}
+
+interface MathLib {
+    /**
+     * Ceils or rounds a number up.
+     *
+     * 	See [math.floor](https://wiki.facepunch.com/gmod/math.floor) for the inverse of this function.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ceil
+     */
+    ceil(number: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the [cosine](https://en.wikipedia.org/wiki/Trigonometric_functions#cos) of given angle.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.cos
+     */
+    cos(number: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the [hyperbolic cosine](https://en.wikipedia.org/wiki/Cosh_(mathematical_function)) of the given angle.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.cosh
+     */
+    cosh(number: number): number;
+}
+
+interface MathLib {
+    /**
+     * Converts radians to degrees.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.deg
+     */
+    deg(radians: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in by reversing the direction of the ease slightly before returning.
+     * 	**NOTE**: This doesn't work properly when used with [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) as it clamps the fraction between 0 and 1. Using your own version of [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) that is unclamped would be necessary instead.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InBack
+     */
+    InBack(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in like a bouncy ball.
+     * 	**NOTE**: This doesn't work properly when used with [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) as it clamps the fraction between 0 and 1. Using your own version of [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) that is unclamped would be necessary instead.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InBounce
+     */
+    InBounce(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in using a circular function.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InCirc
+     */
+    InCirc(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in by cubing the fraction.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InCubic
+     */
+    InCubic(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in like a rubber band.
+     * 	**NOTE**: This doesn't work properly when used with [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) as it clamps the fraction between 0 and 1. Using your own version of [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) that is unclamped would be necessary instead.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InElastic
+     */
+    InElastic(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in using an exponential equation with a base of 2 and where the fraction is used in the exponent.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InExpo
+     */
+    InExpo(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in and out by reversing the direction of the ease slightly before returning on both ends.
+     * 	**NOTE**: This doesn't work properly when used with [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) as it clamps the fraction between 0 and 1. Using your own version of [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) that is unclamped would be necessary instead.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InOutBack
+     */
+    InOutBack(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in and out like a bouncy ball.
+     * 	**NOTE**: This doesn't work properly when used with [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) as it clamps the fraction between 0 and 1. Using your own version of [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) that is unclamped would be necessary instead.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InOutBounce
+     */
+    InOutBounce(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in and out using a circular function.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InOutCirc
+     */
+    InOutCirc(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in and out by cubing the fraction.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InOutCubic
+     */
+    InOutCubic(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in and out like a rubber band.
+     * 	**NOTE**: This doesn't work properly when used with [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) as it clamps the fraction between 0 and 1. Using your own version of [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) that is unclamped would be necessary instead.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InOutElastic
+     */
+    InOutElastic(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in and out using an exponential equation with a base of 2 and where the fraction is used in the exponent.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InOutExpo
+     */
+    InOutExpo(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in and out by squaring the fraction.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InOutQuad
+     */
+    InOutQuad(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in and out by raising the fraction to the power of 4.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InOutQuart
+     */
+    InOutQuart(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in and out by raising the fraction to the power of 5.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InOutQuint
+     */
+    InOutQuint(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in and out using [math.sin](https://wiki.facepunch.com/gmod/math.sin).
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InOutSine
+     */
+    InOutSine(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in by squaring the fraction.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InQuad
+     */
+    InQuad(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in by raising the fraction to the power of 4.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InQuart
+     */
+    InQuart(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in by raising the fraction to the power of 5.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InQuint
+     */
+    InQuint(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases in using [math.sin](https://wiki.facepunch.com/gmod/math.sin).
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.InSine
+     */
+    InSine(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases out by reversing the direction of the ease slightly before finishing.
+     * 	**NOTE**: This doesn't work properly when used with [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) as it clamps the fraction between 0 and 1. Using your own version of [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) that is unclamped would be necessary instead.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.OutBack
+     */
+    OutBack(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases out like a bouncy ball.
+     * 	**NOTE**: This doesn't work properly when used with [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) as it clamps the fraction between 0 and 1. Using your own version of [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) that is unclamped would be necessary instead.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.OutBounce
+     */
+    OutBounce(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases out using a circular function.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.OutCirc
+     */
+    OutCirc(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases out by cubing the fraction.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.OutCubic
+     */
+    OutCubic(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases out like a rubber band.
+     * 	**NOTE**: This doesn't work properly when used with [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) as it clamps the fraction between 0 and 1. Using your own version of [Global.Lerp](https://wiki.facepunch.com/gmod/Global.Lerp) that is unclamped would be necessary instead.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.OutElastic
+     */
+    OutElastic(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases out using an exponential equation with a base of 2 and where the fraction is used in the exponent.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.OutExpo
+     */
+    OutExpo(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases out by squaring the fraction.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.OutQuad
+     */
+    OutQuad(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases out by raising the fraction to the power of 4.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.OutQuart
+     */
+    OutQuart(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases out by raising the fraction to the power of 5.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.OutQuint
+     */
+    OutQuint(fraction: number): number;
+}
+
+interface MatheaseLib {
+    /**
+     * Eases out using [math.sin](https://wiki.facepunch.com/gmod/math.sin).
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ease.OutSine
+     */
+    OutSine(fraction: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns e to the power of the input.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.exp
+     */
+    exp(exponent: number): number;
+}
+
+interface MathLib {
+    /**
+     * Floors or rounds a number down.
+     *
+     * 	See [math.ceil](https://wiki.facepunch.com/gmod/math.ceil) for the inverse of this function.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.floor
+     */
+    floor(number: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the modulus of the specified values.
+     *
+     * While this is similar to the `%` operator, **it will return a negative value if the first argument is negative**, whereas the % operator will return a **positive** value **even if the first operand is negative**.
+     *
+     * This function is also slower than the `%` operator.
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.fmod
+     */
+    fmod(base: number, modulator: number): number;
+}
+
+interface MathLib {
+    /**
+     * **Lua reference description**: Returns `m` and `e` such that `x = m2e`, `e` is an integer and the absolute value of `m` is in the range ((0.5, 1) (or zero when x is zero).
+     *
+     * Used to split the number value into a normalized fraction and an exponent. Two values are returned: the first is a multiplier in the range `1/2` (**inclusive**) to `1` (**exclusive**) and the second is an integer exponent.
+     *
+     * The result is such that `x = m*2^e`.
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.frexp
+     */
+    frexp(x: number): (number, number);
+}
+
+interface MathLib {
+    /**
+     * Takes a normalised number and returns the floating point representation.
+     *
+     * Effectively it returns the result of `normalizedFraction * 2.0 ^ exponent`. [math.frexp](https://wiki.facepunch.com/gmod/math.frexp) is the opposite function.
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.ldexp
+     */
+    ldexp(normalizedFraction: number, exponent: number): number;
+}
+
+interface MathLib {
+    /**
+     * With one argument, return the natural logarithm of x (to base e).
+     *
+     * With two arguments, return the logarithm of x to the given base, calculated as log(x)/log(base).
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.log
+     */
+    log(x: number, base?: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the base-10 logarithm of x. This is usually more accurate than math.log(x, 10).
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.log10
+     */
+    log10(x: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the largest value of all arguments.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.max
+     */
+    max(...: any): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the smallest value of all arguments.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.min
+     */
+    min(...: any): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the modulus of the specified values. Same as [math.fmod](https://wiki.facepunch.com/gmod/math.fmod).
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.mod
+     * @deprecated This is removed in Lua versions later than what GMod is currently using. You should use the % operator or math.fmod instead.
+     */
+    mod(base: number, modulator: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the integral and fractional component of the modulo operation.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.modf
+     */
+    modf(base: number): (number, number);
+}
+
+interface MathLib {
+    /**
+     * Returns x raised to the power y.
+     * In particular, math.pow(1.0, x) and math.pow(x, 0.0) always return 1.0, even when x is a zero or a [nan](https://wiki.facepunch.com/gmod/nan). If both x and y are finite, x is negative, and y is not an integer then math.pow(x, y) is undefined.
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.pow
+     */
+    pow(x: number, y: number): number;
+}
+
+interface MathLib {
+    /**
+     * Converts an angle in degrees to it's equivalent in radians.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.rad
+     */
+    rad(degrees: number): number;
+}
+
+interface MathLib {
+    /**
+     * When called without arguments, returns a uniform pseudo-random real number in the range 0 to 1 which includes 0 but excludes 1.
+     *
+     * When called with an integer number m, returns a uniform pseudo-random integer in the range 1 to m inclusive.
+     *
+     * When called with two integer numbers m and n, returns a uniform pseudo-random integer in the range m to n inclusive.
+     *
+     * See also [math.Rand](https://wiki.facepunch.com/gmod/math.Rand)
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.random
+     */
+    random(m?: number, n?: number): number;
+}
+
+interface MathLib {
+    /**
+     * Seeds the random number generator. The same seed will guarantee the same sequence of numbers each time with [math.random](https://wiki.facepunch.com/gmod/math.random).
+     *
+     * For shared random values across predicted realms, use [util.SharedRandom](https://wiki.facepunch.com/gmod/util.SharedRandom).
+     *
+     * **WARNING**: Usage of this function affects **ALL** random numbers in the game. This means that improper use (such as setting the seed to a static value that doesn't change with time) can negatively affect other addons or the base game.
+     *
+     * It is a good idea to set the seed back to at least something like [Global.SysTime](https://wiki.facepunch.com/gmod/Global.SysTime) in those cases.
+     *
+     *
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.randomseed
+     */
+    randomseed(seed: number): void;
+}
+
+interface MathLib {
+    /**
+     * Returns the [sine](https://en.wikipedia.org/wiki/Trigonometric_functions) of given angle.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.sin
+     */
+    sin(number: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the [hyperbolic sine](https://en.wikipedia.org/wiki/Hyperbolic_functions) of the given angle.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.sinh
+     */
+    sinh(number: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the square root of the number.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.sqrt
+     */
+    sqrt(value: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the tangent of the given angle.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.tan
+     */
+    tan(value: number): number;
+}
+
+interface MathLib {
+    /**
+     * Returns the [hyperbolic tangent](https://en.wikipedia.org/wiki/Hyperbolic_functions) of the given number.
+     * @realm shared and menu
+     * @source https://wiki.facepunch.com/gmod/math.tanh
+     */
+    tanh(number: number): number;
+}
+