type Vector3Tuple = [number, number, number];
/**
 * Represents a 3D vector with x, y and z components.
 */
declare class Vector3 {
    x: number;
    y: number;
    z: number;
    /**
     * Creates a new Vector3 with optional initial values for x, y and z.
     */
    constructor(x?: number, y?: number, z?: number);
    /**
     * Sets the x and y components of the vector.
     * @example
     * const v = new Vector3();
     * v.set(new Vector3(1, 2, 3)); // sets x = 1, y = 2 and z = 3
     * v.set([1, 2, 3]); // sets x = 1, y = 2 and z = 3
     * v.set(1, 2, 3); // sets x = 1, y = 2 and z = 3
     * v.set(1) // same as v.set(1, 1, 1)
     * @returns this
     */
    set(x: Vector3 | Vector3Tuple | number, y?: number, z?: number): this;
    /**
     * Sets the x component of the vector.
     * @example
     * const v = new Vector3();
     * v.setX(1); // sets x = 1
     * @returns this
     */
    setX(x: number): this;
    /**
     * Sets the y component of the vector.
     * @example
     * const v = new Vector3();
     * v.setY(1); // sets y = 1
     * @returns this
     */
    setY(y: number): this;
    /**
     * Sets the z component of the vector.
     * @example
     * const v = new Vector3();
     * v.setZ(1); // sets z = 1
     * @returns this
     */
    setZ(z: number): this;
    /**
     * Returns a new Vector3 with the same x, y and z components.
     * @example
     * const v1 = new Vector3(1, 2);
     * const v2 = v.clone(); // same as v1
     * @returns A new Vector3 with the same x, y and z components.
     */
    clone(): Vector3;
    /**
     * Copies the x and y components of another vector.
     * @example
     * const v1 = new Vector2(1, 2);
     * const v2 = new Vector2(3, 4);
     * v1.copy(v2); // v1 is now equal to v2
     * @returns this
     */
    copy(v: Vector3): this;
    /**
     * Returns an array with the x, y and z components of the vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.toArray(); // returns [1, 2, 3]
     * @returns An array with the x, y and z components of the vector.
     */
    toArray(): Vector3Tuple;
    /**
     * Returns a string representation of the vector.
     * @example
     * const v = new Vector3(1, 2);
     * v.toString(); // returns 'x: 1, y: 2'
     * @returns A string representation of the vector.
     */
    toString(): string;
    /**
     * Adds to the current vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.add(new Vector3(1, 2, 3)) // a is now equal to (2, 4, 6)
     * v.add([1, 2, 3]) // a is now equal to (3, 6, 9)
     * v.add(1, 2, 3) // a is now equal to (4, 8, 12)
     * v.add(1) // same as v.add(1, 1, 1)
     * @returns this
     */
    add(x: Vector3 | Vector3Tuple | number, y?: number, z?: number): this;
    /**
     * Subtracts from the current vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.sub(new Vector3(1, 2, 3)) // a is now equal to (0, 0, 0)
     * v.sub([1, 2, 3]) // a is now equal to (-1, -2, -3)
     * v.sub(1, 2, 3) // a is now equal to (-2, -4, -6)
     * v.sub(1) // same as v.sub(1, 1, 1)
     * @returns this
     */
    sub(x: Vector3 | Vector3Tuple | number, y?: number, z?: number): this;
    /**
     * Multiplies with the current vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.mult(new Vector3(1, 2, 3)) // a is now equal to (1, 4, 9)
     * v.mult([1, 2, 3]) // a is now equal to (1, 8, 27)
     * v.mult(1, 2, 3) // a is now equal to (1, 16, 81)
     * v.mult(1) // same as v.mult(1, 1, 1)
     * @returns this
     */
    mult(x: Vector3 | Vector3Tuple | number, y?: number, z?: number): this;
    /**
     * Divides with the current vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.div(new Vector3(1, 2, 3)) // a is now equal to (1, 1, 1)
     * v.div([1, 2, 3]) // a is now equal to (1, 0.5, 0.333)
     * v.div(1, 2, 3) // a is now equal to (1, 0.25, 0.111)
     * v.div(1) // same as v.div(1, 1, 1)
     * @returns this
     */
    div(x: Vector3 | Vector3Tuple | number, y?: number, z?: number): this;
    /**
     * Inverts the x, y and z components of the vector.
     * @example
     * const v = new Vector3(1, 2);
     * v.invert(); // v is now equal to (-1, -2)
     * @returns this
     */
    invert(): this;
    /**
     * Normalizes the vector.
     * @example
     * const v = new Vector3(1, 2);
     * v.normalize(); // v is now equal to (0.447, 0.894)
     * @returns this
     */
    normalize(): this;
    /**
     * Randomizes the vector.
     * @example
     * const v = new Vector3();
     * v.randomize(); // v is anything between (0, 0, 0) and (1, 1, 1)
     * v.randomize(new Vector3(1, 2, 3), new Vector3(4, 5, 6)); // v is anything between (1, 2, 3) and (4, 5, 6)
     * @returns this
     */
    randomize(min?: Vector3, max?: Vector3): this;
    /**
     * Clamps the vector between two vectors.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.clamp(new Vector3(2, 2, 2), new Vector3(3, 3, 3)); // v is now equal to (2, 2, 3)
     * @returns this
     */
    clamp(min: Vector3 | number, max: Vector3 | number): this;
    /**
     * Limits the vector to a maximum length.
     * @example
     * const v = new Vector2(1, 2, 3)
     * v.limit(2); // sets the length of v to a maximum of 2
     * @returns this
     */
    limit(max: number): this;
    /**
     * Rounds the vector to the nearest integer.
     * @example
     * const v = new Vector3(1.2, 2.8, 3.5);
     * v.round(); // v is now equal to (1, 3, 4)
     * @returns this
     */
    round(): this;
    /**
     * Rounds the vector to the nearest integer towards zero.
     * @example
     * const v = new Vector3(1.2, 2.8, 3.5);
     * v.roundToZero(); // v is now equal to (1, 2, 3)
     * @returns this
     */
    roundToZero(): this;
    /**
     * Checks if the vector is equal to another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(1, 2, 3);
     * a.equals(b); // returns true
     * @returns Whether the vector is equal to another vector.
     */
    equals(v: Vector3): boolean;
    /**
     * Calculates the minimum components of the vector and another vector.
     * @example
     * const a = new Vector3(-2, 0, 3);
     * const b = new Vector3(5, -1, 2);
     * a.min(b); // a becomes (-2, -1, 2)
     * @returns this
     */
    min(v: Vector3): this;
    /**
     * Calculates the maximum components of the vector and another vector.
     * @example
     * const a = new Vector3(-2, 0, 3);
     * const b = new Vector3(5, -1, 2);
     * a.max(b); // a becomes (5, 0, 3)
     * @returns this
     */
    max(v: Vector3): this;
    /**
     * Computes the dot product of the vector with another vector.
     * @example
     * const a = new Vector3(1, 2);
     * const b = new Vector3(3, 4);
     * a.dot(b); // returns 11
     * @returns dot product
     */
    dot(v: Vector3): number;
    /**
     * Computes the cross product of the vector with another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.cross(b); // returns (-2, 4, -2)
     * @returns cross product vector
     */
    cross(v: Vector3): Vector3;
    /**
     * Computes the length of the vector squared.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.lengthSq(); // returns 14
     * @returns squared length
     */
    lengthSq(): number;
    /**
     * Computes the length of the vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.length(); // returns 3.741
     * @returns length of the vector
     */
    length(): number;
    /**
     * Computes the Manhattan length of the vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.manhattanLength(); // returns 6
     * @returns manhattan length of the vector
     */
    manhattanLength(): number;
    /**
     * Sets the length of the vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.setLength(2); // sets the length of v to 2
     * @returns this
     */
    setLength(length: number): this;
    /**
     * Returns the X distance between current vector and another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.xDistTo(b); // returns -2
     * @returns distance between x components
     */
    xDistTo(v: Vector3): number;
    /**
     * Returns the Y distance between current vector and another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.yDistTo(b); // returns -2
     * @returns distance between y components
     */
    yDistTo(v: Vector3): number;
    /**
     * Returns the Z distance between current vector and another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.zDistTo(b); // returns -2
     * @returns distance between z components
     */
    zDistTo(v: Vector3): number;
    /**
     * Returns the XY distance between current vector and another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.xyDistTo(b); // returns 2.828
     * @returns distance between xy components
     */
    xyDistTo(v: Vector3): number;
    /**
     * Returns the YZ distance between current vector and another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.yzDistTo(b); // returns 2.828
     * @returns distance between yz components
     */
    yzDistTo(v: Vector3): number;
    /**
     * Returns the XZ distance between current vector and another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.xzDistTo(b); // returns 2.828
     * @returns distance between xz components
     */
    xzDistTo(v: Vector3): number;
    /**
     * Returns the squared distance between current vector and another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.distToSqrd(b); // returns 12
     * @returns distance squared between vectors
     */
    distToSqrd(v: Vector3): number;
    /**
     * Returns the distance between current vector and another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.distTo(b); // returns 3.464
     * @returns distance between vectors
     */
    distTo(v: Vector3): number;
    /**
     * Returns the Manhattan distance between current vector and another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.manhattanDist(b); // returns 6
     * @returns manhattan distance between vectors
     */
    manhattanDistTo(v: Vector3): number;
    /**
     * Returns the angle in radians with respect to the positive x-axis.
     * @example
     * const v = new Vector3(1, 2);
     * v.horizontalAngle(); // returns 1.107
     * @returns the calculated angle in radians
     */
    hAngle(): number;
    /**
     * @alias horizontalAngle
     */
    angle(): number;
    /**
     * Returns the angle in radians between the current vector and another vector.
     * @example
     * const a = new Vector3(1, 2);
     * const b = new Vector3(3, 4);
     * a.angleTo(b); // returns 0.179
     * @returns the calculated angle in radians
     */
    angleTo(v: Vector3): number;
    /**
     * Interpolates x component of the vector towards another vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.lerpX(3, 0.5); // v is now equal to (2, 2, 3)
     * @returns this
     */
    lerpX(v: Vector3, alpha: number): this;
    /**
     * Interpolates y component of the vector towards another vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.lerpY(3, 0.5); // v is now equal to (1, 2.5, 3)
     * @returns this
     */
    lerpY(v: Vector3, alpha: number): this;
    /**
     * Interpolates z component of the vector towards another vector.
     * @example
     * const v = new Vector3(1, 2, 3);
     * v.lerpZ(4, 0.5); // v is now equal to (1, 2, 3.5)
     * @returns this
     */
    lerpZ(v: Vector3, alpha: number): this;
    /**
     * Interpolates the vector towards another vector.
     * @example
     * const a = new Vector3(1, 2, 3);
     * const b = new Vector3(3, 4, 5);
     * a.lerp(b, 0.5); // a is now equal to (2, 3, 4)
     * @returns this
     */
    lerp(v: Vector3, alpha: number): this;
    toAngles(): {
        theta: number;
        phi: number;
    };
    /**
     * Adds two vectors.
     * @returns The added vector.
     */
    static add(a: Vector3, b: Vector3): Vector3;
    /**
     * Subtracts two vectors.
     * @returns The subtracted vector.
     */
    static sub(a: Vector3, b: Vector3): Vector3;
    /**
     * Multiplies two vectors.
     * @returns The multiplied vector.
     */
    static mult(a: Vector3, b: Vector3): Vector3;
    /**
     * Divides two vectors.
     * @returns The divided vector.
     */
    static div(a: Vector3, b: Vector3): Vector3;
    /**
     * Checks if two vectors are equal.
     * @returns Whether the two vectors are equal.
     */
    static equals(a: Vector3, b: Vector3): boolean;
    /**
     * Returns the minimum components of two vectors.
     * @returns The minimum vector.
     */
    static min(a: Vector3, b: Vector3): Vector3;
    /**
     * Returns the maximum components of two vectors.
     * @returns The maximum vector.
     */
    static max(a: Vector3, b: Vector3): Vector3;
    /**
     * Inverts the vector.
     * @returns The inverted vector.
     */
    static invert(v: Vector3): Vector3;
    /**
     * Calculates the length of a vector.
     * @returns The length of the vector.
     */
    static length(v: Vector3): number;
    /**
     * Returns the dot product of two vectors.
     * @returns The dot product of the two vectors.
     */
    static dot(a: Vector3, b: Vector3): number;
    /**
     * Calculates the cross product of two vectors.
     * @returns The cross product of the two vectors.
     */
    static cross(a: Vector3, b: Vector3): Vector3;
    /**
     * Normalizes the vector.
     * @returns The normalized vector.
     */
    static normalize(v: Vector3): Vector3;
    /**
     * Calculates the distance between two vectors.
     * @returns A vector with the distance between the two vectors.
     */
    static distBetween(a: Vector3, b: Vector3): number;
    /**
     * Calculates the angle in radians between two vectors.
     * @returns The angle in radians.
     */
    static angleBetween(a: Vector3, b: Vector3): number;
    /**
     * Interpolates the vector towards another vector.
     * @returns The interpolated vector.
     */
    static lerp(a: Vector3, b: Vector3, alpha: number): Vector3;
    static fromAngles(theta: number, phi: number): Vector3;
    static randomDirection(): Vector3;
    [Symbol.iterator](): Generator<number, void, unknown>;
}

export { Vector3, type Vector3Tuple, Vector3 as default };