@lakuna/umath 2.0.0 → 3.0.1

package/src/linalg/Vector3.ts

@@ -1,7 +1,8 @@
-import type { default as Vector, VectorLike } from "./Vector.js";
 import type { Matrix3Like } from "./Matrix3.js";
 import type { Matrix4Like } from "./Matrix4.js";
 import type { QuaternionLike } from "./Quaternion.js";
+import type { default as Vector, VectorLike } from "./Vector.js";
+
 import approxRelative from "../algorithms/approxRelative.js";
 
 /**
@@ -10,12 +11,15 @@ import approxRelative from "../algorithms/approxRelative.js";
  */
 export interface Vector3Like extends VectorLike {
 	/** The first component of this vector. */
+	// eslint-disable-next-line @typescript-eslint/naming-convention
 	0: number;
 
 	/** The second component of this vector. */
+	// eslint-disable-next-line @typescript-eslint/naming-convention
 	1: number;
 
 	/** The third component of this vector. */
+	// eslint-disable-next-line @typescript-eslint/naming-convention
 	2: number;
 }
 
@@ -24,9 +28,9 @@ export interface Vector3Like extends VectorLike {
  * @returns A 3x1 vector-like object.
  * @public
  */
-export const createVector3Like = (): Float32Array & Vector3Like => {
-	return new Float32Array(3) as Float32Array & Vector3Like;
-};
+export const createVector3Like = (): Float32Array & Vector3Like =>
+	// eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+	new Float32Array(3) as Float32Array & Vector3Like;
 
 /**
  * Create a vector with the given values.
@@ -56,7 +60,10 @@ export const fromValues = <T extends Vector3Like>(
  * @returns Whether or not the vectors are equivalent.
  * @public
  */
-export const equals = (a: Vector3Like, b: Vector3Like): boolean =>
+export const equals = (
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>
+): boolean =>
 	approxRelative(a[0], b[0]) &&
 	approxRelative(a[1], b[1]) &&
 	approxRelative(a[2], b[2]);
@@ -68,8 +75,10 @@ export const equals = (a: Vector3Like, b: Vector3Like): boolean =>
  * @returns Whether the vectors are equivalent.
  * @public
  */
-export const exactEquals = (a: Vector3Like, b: Vector3Like): boolean =>
-	a[0] === b[0] && a[1] === b[1] && a[2] === b[2];
+export const exactEquals = (
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>
+): boolean => a[0] === b[0] && a[1] === b[1] && a[2] === b[2];
 
 /**
  * Add two vectors.
@@ -80,8 +89,8 @@ export const exactEquals = (a: Vector3Like, b: Vector3Like): boolean =>
  * @public
  */
 export const add = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
 	out: T
 ): T => fromValues(a[0] + b[0], a[1] + b[1], a[2] + b[2], out);
 
@@ -92,8 +101,10 @@ export const add = <T extends Vector3Like>(
  * @returns The copy.
  * @public
  */
-export const copy = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
-	fromValues(vector[0], vector[1], vector[2], out);
+export const copy = <T extends Vector3Like>(
+	vector: Readonly<Vector3Like>,
+	out: T
+): T => fromValues(vector[0], vector[1], vector[2], out);
 
 /**
  * Multiply two vectors.
@@ -104,8 +115,8 @@ export const copy = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
  * @public
  */
 export const multiply = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
 	out: T
 ): T => fromValues(a[0] * b[0], a[1] * b[1], a[2] * b[2], out);
 
@@ -118,8 +129,8 @@ export const multiply = <T extends Vector3Like>(
  * @public
  */
 export const divide = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
 	out: T
 ): T => fromValues(a[0] / b[0], a[1] / b[1], a[2] / b[2], out);
 
@@ -132,8 +143,8 @@ export const divide = <T extends Vector3Like>(
  * @public
  */
 export const subtract = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
 	out: T
 ): T => fromValues(a[0] - b[0], a[1] - b[1], a[2] - b[2], out);
 
@@ -144,7 +155,10 @@ export const subtract = <T extends Vector3Like>(
  * @returns The absolutized vector.
  * @public
  */
-export const abs = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
+export const abs = <T extends Vector3Like>(
+	vector: Readonly<Vector3Like>,
+	out: T
+): T =>
 	fromValues(
 		Math.abs(vector[0]),
 		Math.abs(vector[1]),
@@ -159,7 +173,10 @@ export const abs = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
  * @returns The rounded vector.
  * @public
  */
-export const ceil = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
+export const ceil = <T extends Vector3Like>(
+	vector: Readonly<Vector3Like>,
+	out: T
+): T =>
 	fromValues(
 		Math.ceil(vector[0]),
 		Math.ceil(vector[1]),
@@ -174,7 +191,10 @@ export const ceil = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
  * @returns The rounded vector.
  * @public
  */
-export const floor = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
+export const floor = <T extends Vector3Like>(
+	vector: Readonly<Vector3Like>,
+	out: T
+): T =>
 	fromValues(
 		Math.floor(vector[0]),
 		Math.floor(vector[1]),
@@ -189,7 +209,10 @@ export const floor = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
  * @returns The rounded vector.
  * @public
  */
-export const round = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
+export const round = <T extends Vector3Like>(
+	vector: Readonly<Vector3Like>,
+	out: T
+): T =>
 	fromValues(
 		Math.round(vector[0]),
 		Math.round(vector[1]),
@@ -206,8 +229,8 @@ export const round = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
  * @public
  */
 export const min = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
 	out: T
 ): T =>
 	fromValues(
@@ -226,8 +249,8 @@ export const min = <T extends Vector3Like>(
  * @public
  */
 export const max = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
 	out: T
 ): T =>
 	fromValues(
@@ -246,7 +269,7 @@ export const max = <T extends Vector3Like>(
  * @public
  */
 export const pow = <T extends Vector3Like>(
-	vector: Vector3Like,
+	vector: Readonly<Vector3Like>,
 	scalar: number,
 	out: T
 ): T =>
@@ -266,7 +289,7 @@ export const pow = <T extends Vector3Like>(
  * @public
  */
 export const scale = <T extends Vector3Like>(
-	vector: Vector3Like,
+	vector: Readonly<Vector3Like>,
 	scalar: number,
 	out: T
 ): T =>
@@ -282,8 +305,8 @@ export const scale = <T extends Vector3Like>(
  * @public
  */
 export const scaleAndAdd = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
 	scalar: number,
 	out: T
 ): T =>
@@ -302,8 +325,10 @@ export const scaleAndAdd = <T extends Vector3Like>(
  * @see {@link https://en.wikipedia.org/wiki/Euclidean_distance | Euclidean distance}
  * @public
  */
-export const distance = (a: Vector3Like, b: Vector3Like): number =>
-	Math.hypot(b[0] - a[0], b[1] - a[1], b[2] - a[2]);
+export const distance = (
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>
+): number => Math.hypot(b[0] - a[0], b[1] - a[1], b[2] - a[2]);
 
 /**
  * Calculate the squared Euclidean distance between this vector and another.
@@ -313,7 +338,10 @@ export const distance = (a: Vector3Like, b: Vector3Like): number =>
  * @see {@link https://en.wikipedia.org/wiki/Euclidean_distance | Euclidean distance}
  * @public
  */
-export const squaredDistance = (a: Vector3Like, b: Vector3Like): number => {
+export const squaredDistance = (
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>
+): number => {
 	const x = b[0] - a[0];
 	const y = b[1] - a[1];
 	const z = b[2] - a[2];
@@ -326,7 +354,7 @@ export const squaredDistance = (a: Vector3Like, b: Vector3Like): number => {
  * @returns The magnitude.
  * @public
  */
-export const getMagnitude = (vector: Vector3Like): number =>
+export const getMagnitude = (vector: Readonly<Vector3Like>): number =>
 	Math.hypot(vector[0], vector[1], vector[2]);
 
 /**
@@ -335,7 +363,7 @@ export const getMagnitude = (vector: Vector3Like): number =>
  * @returns The squared magnitude.
  * @public
  */
-export const getSquaredMagnitude = (vector: Vector3Like): number => {
+export const getSquaredMagnitude = (vector: Readonly<Vector3Like>): number => {
 	const x = vector[0];
 	const y = vector[1];
 	const z = vector[2];
@@ -349,8 +377,10 @@ export const getSquaredMagnitude = (vector: Vector3Like): number => {
  * @returns The negated vector.
  * @public
  */
-export const negate = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
-	fromValues(-vector[0], -vector[1], -vector[2], out);
+export const negate = <T extends Vector3Like>(
+	vector: Readonly<Vector3Like>,
+	out: T
+): T => fromValues(-vector[0], -vector[1], -vector[2], out);
 
 /**
  * Calculate the multiplicative inverse of the components of a vector.
@@ -359,8 +389,10 @@ export const negate = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
  * @returns The inverted vector.
  * @public
  */
-export const invert = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
-	fromValues(1 / vector[0], 1 / vector[1], 1 / vector[2], out);
+export const invert = <T extends Vector3Like>(
+	vector: Readonly<Vector3Like>,
+	out: T
+): T => fromValues(1 / vector[0], 1 / vector[1], 1 / vector[2], out);
 
 /**
  * Normalize a vector.
@@ -371,7 +403,7 @@ export const invert = <T extends Vector3Like>(vector: Vector3Like, out: T): T =>
  * @public
  */
 export const normalize = <T extends Vector3Like>(
-	vector: Vector3Like,
+	vector: Readonly<Vector3Like>,
 	out: T
 ): T => {
 	const x = vector[0];
@@ -394,8 +426,10 @@ export const normalize = <T extends Vector3Like>(
  * @see {@link https://en.wikipedia.org/wiki/Dot_product | Dot product}
  * @public
  */
-export const dot = (a: Vector3Like, b: Vector3Like): number =>
-	a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+export const dot = (
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>
+): number => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
 
 /**
  * Calculate the cross product of two vectors.
@@ -407,8 +441,8 @@ export const dot = (a: Vector3Like, b: Vector3Like): number =>
  * @public
  */
 export const cross = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
 	out: T
 ): T => {
 	const ax = a[0];
@@ -438,8 +472,8 @@ export const cross = <T extends Vector3Like>(
  * @public
  */
 export const lerp = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
 	t: number,
 	out: T
 ): T => {
@@ -466,8 +500,8 @@ export const lerp = <T extends Vector3Like>(
  * @public
  */
 export const slerp = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
 	t: number,
 	out: T
 ): T => {
@@ -515,8 +549,8 @@ export const random = <T extends Vector3Like>(magnitude: number, out: T): T => {
  * @public
  */
 export const transformMatrix3 = <T extends Vector3Like>(
-	vector: Vector3Like,
-	matrix: Matrix3Like,
+	vector: Readonly<Vector3Like>,
+	matrix: Readonly<Matrix3Like>,
 	out: T
 ): T => {
 	const x = vector[0];
@@ -541,8 +575,8 @@ export const transformMatrix3 = <T extends Vector3Like>(
  * @public
  */
 export const transformMatrix4 = <T extends Vector3Like>(
-	vector: Vector3Like,
-	matrix: Matrix4Like,
+	vector: Readonly<Vector3Like>,
+	matrix: Readonly<Matrix4Like>,
 	out: T
 ): T => {
 	const x = vector[0];
@@ -568,8 +602,8 @@ export const transformMatrix4 = <T extends Vector3Like>(
  * @public
  */
 export const rotateX = <T extends Vector3Like>(
-	vector: Vector3Like,
-	origin: Vector3Like,
+	vector: Readonly<Vector3Like>,
+	origin: Readonly<Vector3Like>,
 	r: number,
 	out: T
 ): T => {
@@ -595,8 +629,8 @@ export const rotateX = <T extends Vector3Like>(
  * @public
  */
 export const rotateY = <T extends Vector3Like>(
-	vector: Vector3Like,
-	origin: Vector3Like,
+	vector: Readonly<Vector3Like>,
+	origin: Readonly<Vector3Like>,
 	r: number,
 	out: T
 ): T => {
@@ -622,8 +656,8 @@ export const rotateY = <T extends Vector3Like>(
  * @public
  */
 export const rotateZ = <T extends Vector3Like>(
-	vector: Vector3Like,
-	origin: Vector3Like,
+	vector: Readonly<Vector3Like>,
+	origin: Readonly<Vector3Like>,
 	r: number,
 	out: T
 ): T => {
@@ -646,7 +680,10 @@ export const rotateZ = <T extends Vector3Like>(
  * @returns The angular distance from the first vector to the second.
  * @public
  */
-export const angle = (a: Vector3Like, b: Vector3Like): number => {
+export const angle = (
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>
+): number => {
 	const mag = Math.hypot(a[0], a[1], a[2]) * Math.hypot(b[0], b[1], b[2]);
 	return Math.acos(Math.min(Math.max(mag && dot(a, b) / mag, -1), 1));
 };
@@ -673,10 +710,10 @@ export const zero = <T extends Vector3Like>(out: T): T =>
  * @public
  */
 export const hermite = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
-	c: Vector3Like,
-	d: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
+	c: Readonly<Vector3Like>,
+	d: Readonly<Vector3Like>,
 	t: number,
 	out: T
 ): T => {
@@ -708,10 +745,10 @@ export const hermite = <T extends Vector3Like>(
  * @public
  */
 export const bezier = <T extends Vector3Like>(
-	a: Vector3Like,
-	b: Vector3Like,
-	c: Vector3Like,
-	d: Vector3Like,
+	a: Readonly<Vector3Like>,
+	b: Readonly<Vector3Like>,
+	c: Readonly<Vector3Like>,
+	d: Readonly<Vector3Like>,
 	t: number,
 	out: T
 ): T => {
@@ -743,8 +780,8 @@ export const bezier = <T extends Vector3Like>(
  * @public
  */
 export const transformQuaternion = <T extends Vector3Like>(
-	vector: Vector3Like,
-	quaternion: QuaternionLike,
+	vector: Readonly<Vector3Like>,
+	quaternion: Readonly<QuaternionLike>,
 	out: T
 ): T => {
 	const x = vector[0];
@@ -777,6 +814,44 @@ export default class Vector3
 	extends Float32Array
 	implements Vector, Vector3Like
 {
+	/** The first component of this vector. */
+	// eslint-disable-next-line @typescript-eslint/naming-convention
+	public 0: number;
+
+	/** The second component of this vector. */
+	// eslint-disable-next-line @typescript-eslint/naming-convention
+	public 1: number;
+
+	/** The third component of this vector. */
+	// eslint-disable-next-line @typescript-eslint/naming-convention
+	public 2: number;
+
+	/** The magnitude (length) of this vector. */
+	public get magnitude(): number {
+		return getMagnitude(this);
+	}
+
+	public set magnitude(value: number) {
+		scale(normalize(this, this), value, this);
+	}
+
+	/** The squared magnitude (length) of this vector. */
+	public get squaredMagnitude(): number {
+		return getSquaredMagnitude(this);
+	}
+
+	public set squaredMagnitude(value: number) {
+		this.magnitude = Math.sqrt(value);
+	}
+
+	/**
+	 * Create a three-dimensional zero vector.
+	 * @see {@link https://en.wikipedia.org/wiki/Euclidean_vector | Euclidean vector}
+	 */
+	public constructor() {
+		super(3);
+	}
+
 	/**
 	 * Create a vector with the given values.
 	 * @param x - The first component.
@@ -789,47 +864,55 @@ export default class Vector3
 	}
 
 	/**
-	 * Create a three-dimensional zero vector.
-	 * @see {@link https://en.wikipedia.org/wiki/Euclidean_vector | Euclidean vector}
+	 * Absolutize the components of this vector.
+	 * @returns The absolutized vector.
 	 */
-	public constructor() {
-		super(3);
+	public abs(): Vector3 {
+		return abs(this, new Vector3());
 	}
 
-	/** The first component of this vector. */
-	public 0: number;
-
-	/** The second component of this vector. */
-	public 1: number;
-
-	/** The third component of this vector. */
-	public 2: number;
-
 	/**
-	 * Determine whether or not this vector is roughly equivalent to another.
+	 * Add two vectors of the same size.
 	 * @param vector - The other vector.
-	 * @returns Whether or not the vectors are equivalent.
+	 * @returns The sum of the vectors.
 	 */
-	public equals(vector: Vector3Like): boolean {
-		return equals(this, vector);
+	public add(vector: Readonly<Vector3Like>): Vector3 {
+		return add(this, vector, new Vector3());
 	}
 
 	/**
-	 * Determine whether or not this vector is exactly equivalent to another.
+	 * Get the angle from this vector to another in radians.
 	 * @param vector - The other vector.
-	 * @returns Whether or not the vectors are equivalent.
+	 * @returns The angular distance from this vector to the other.
 	 */
-	public exactEquals(vector: Vector3Like): boolean {
-		return exactEquals(this, vector);
+	public angle(vector: Readonly<Vector3Like>): number {
+		return angle(this, vector);
 	}
 
 	/**
-	 * Add two vectors of the same size.
-	 * @param vector - The other vector.
-	 * @returns The sum of the vectors.
+	 * Perform a Bézier interpolation with two control points between this vector and another.
+	 * @param a - The first control point.
+	 * @param b - The second control point.
+	 * @param end - The other vector.
+	 * @param t - The interpolation amount in the range `[0,1]`.
+	 * @returns The interpolated vector.
+	 * @see {@link https://en.wikipedia.org/wiki/B%C3%A9zier_curve | Bézier curve}
 	 */
-	public add(vector: Vector3Like): Vector3 {
-		return add(this, vector, new Vector3());
+	public bezier(
+		a: Readonly<Vector3Like>,
+		b: Readonly<Vector3Like>,
+		end: Readonly<Vector3Like>,
+		t: number
+	): Vector3 {
+		return bezier(this, a, b, end, t, new Vector3());
+	}
+
+	/**
+	 * Round up the components of this vector.
+	 * @returns The rounded vector.
+	 */
+	public ceil(): Vector3 {
+		return ceil(this, new Vector3());
 	}
 
 	/**
@@ -845,17 +928,28 @@ export default class Vector3
 	 * @param vector - The vector to copy.
 	 * @returns This vector.
 	 */
-	public copy(vector: Vector3Like): this {
+	public copy(vector: Readonly<Vector3Like>): this {
 		return copy(vector, this);
 	}
 
 	/**
-	 * Multiply this vector by another.
+	 * Calculate the cross product of this and another vector.
 	 * @param vector - The other vector.
-	 * @returns The product of the vectors.
+	 * @returns The cross product.
+	 * @see {@link https://en.wikipedia.org/wiki/Cross_product | Cross product}
 	 */
-	public multiply(vector: Vector3Like): Vector3 {
-		return multiply(this, vector, new Vector3());
+	public cross(vector: Readonly<Vector3Like>): Vector3 {
+		return cross(this, vector, new Vector3());
+	}
+
+	/**
+	 * Calculate the Euclidean distance between this vector and another.
+	 * @param vector - The other vector.
+	 * @returns The distance.
+	 * @see {@link https://en.wikipedia.org/wiki/Euclidean_distance | Euclidean distance}
+	 */
+	public distance(vector: Readonly<Vector3Like>): number {
+		return distance(this, vector);
 	}
 
 	/**
@@ -863,33 +957,36 @@ export default class Vector3
 	 * @param vector - The other vector.
 	 * @returns The quotient of the vectors.
 	 */
-	public divide(vector: Vector3Like): Vector3 {
+	public divide(vector: Readonly<Vector3Like>): Vector3 {
 		return divide(this, vector, new Vector3());
 	}
 
 	/**
-	 * Subtract another vector from this one.
+	 * Calculate the dot product of this and another vector.
 	 * @param vector - The other vector.
-	 * @returns The difference between the vectors.
+	 * @returns The dot product.
+	 * @see {@link https://en.wikipedia.org/wiki/Dot_product | Dot product}
 	 */
-	public subtract(vector: Vector3Like): Vector3 {
-		return subtract(this, vector, new Vector3());
+	public dot(vector: Readonly<Vector3Like>): number {
+		return dot(this, vector);
 	}
 
 	/**
-	 * Absolutize the components of this vector.
-	 * @returns The absolutized vector.
+	 * Determine whether or not this vector is roughly equivalent to another.
+	 * @param vector - The other vector.
+	 * @returns Whether or not the vectors are equivalent.
 	 */
-	public abs(): Vector3 {
-		return abs(this, new Vector3());
+	public equals(vector: Readonly<Vector3Like>): boolean {
+		return equals(this, vector);
 	}
 
 	/**
-	 * Round up the components of this vector.
-	 * @returns The rounded vector.
+	 * Determine whether or not this vector is exactly equivalent to another.
+	 * @param vector - The other vector.
+	 * @returns Whether or not the vectors are equivalent.
 	 */
-	public ceil(): Vector3 {
-		return ceil(this, new Vector3());
+	public exactEquals(vector: Readonly<Vector3Like>): boolean {
+		return exactEquals(this, vector);
 	}
 
 	/**
@@ -901,95 +998,67 @@ export default class Vector3
 	}
 
 	/**
-	 * Round the components of this vector.
-	 * @returns The rounded vector.
+	 * Perform a Hermite interpolation with two control points between this vector and another.
+	 * @param a - The first control point.
+	 * @param b - The second control point.
+	 * @param end - The other vector.
+	 * @param t - The interpolation amount in the range `[0,1]`.
+	 * @returns The interpolated vector.
+	 * @see {@link https://en.wikipedia.org/wiki/Hermite_interpolation | Hermite interpolation}
 	 */
-	public round(): Vector3 {
-		return round(this, new Vector3());
+	public hermite(
+		a: Readonly<Vector3Like>,
+		b: Readonly<Vector3Like>,
+		end: Readonly<Vector3Like>,
+		t: number
+	): Vector3 {
+		return hermite(this, a, b, end, t, new Vector3());
 	}
 
 	/**
-	 * Return the minimum of this and another vector.
-	 * @param vector - The other vector.
-	 * @returns The minimum.
+	 * Calculate the multiplicative inverse of the components of this vector.
+	 * @returns The inverted vector.
 	 */
-	public min(vector: Vector3Like): Vector3 {
-		return min(this, vector, new Vector3());
+	public invert(): Vector3 {
+		return invert(this, new Vector3());
 	}
 
 	/**
-	 * Return the maximum of this and another vector.
+	 * Perform a linear interpolation between this and another vector.
 	 * @param vector - The other vector.
-	 * @returns The maximum.
-	 */
-	public max(vector: Vector3Like): Vector3 {
-		return max(this, vector, new Vector3());
-	}
-
-	/**
-	 * Raise each component of this vector to the given power.
-	 * @param scalar - The exponent (power) to raise each component to.
-	 * @returns The power (result of the exponentiation).
-	 */
-	public pow(scalar: number): Vector3 {
-		return pow(this, scalar, new Vector3());
-	}
-
-	/**
-	 * Scale this vector by a scalar.
-	 * @param scalar - The scalar.
-	 * @returns The scaled vector.
+	 * @param t - The interpolation amount (in `[0,1]`).
+	 * @returns The interpolated vector.
+	 * @see {@link https://en.wikipedia.org/wiki/Linear_interpolation | Linear interpolation}
 	 */
-	public scale(scalar: number): Vector3 {
-		return scale(this, scalar, new Vector3());
+	public lerp(vector: Readonly<Vector3Like>, t: number): Vector3 {
+		return lerp(this, vector, t, new Vector3());
 	}
 
 	/**
-	 * Add another vector to this one after scaling the other by a scalar.
+	 * Return the maximum of this and another vector.
 	 * @param vector - The other vector.
-	 * @param scalar - The scalar.
-	 * @returns The sum.
+	 * @returns The maximum.
 	 */
-	public scaleAndAdd(vector: Vector3Like, scalar: number): Vector3 {
-		return scaleAndAdd(this, vector, scalar, new Vector3());
+	public max(vector: Readonly<Vector3Like>): Vector3 {
+		return max(this, vector, new Vector3());
 	}
 
 	/**
-	 * Calculate the Euclidean distance between this vector and another.
+	 * Return the minimum of this and another vector.
 	 * @param vector - The other vector.
-	 * @returns The distance.
-	 * @see {@link https://en.wikipedia.org/wiki/Euclidean_distance | Euclidean distance}
+	 * @returns The minimum.
 	 */
-	public distance(vector: Vector3Like): number {
-		return distance(this, vector);
+	public min(vector: Readonly<Vector3Like>): Vector3 {
+		return min(this, vector, new Vector3());
 	}
 
 	/**
-	 * Calculate the squared Euclidean distance between this vector and another.
+	 * Multiply this vector by another.
 	 * @param vector - The other vector.
-	 * @returns The squared distance.
-	 * @see {@link https://en.wikipedia.org/wiki/Euclidean_distance | Euclidean distance}
+	 * @returns The product of the vectors.
 	 */
-	public squaredDistance(vector: Vector3Like): number {
-		return squaredDistance(this, vector);
-	}
-
-	/** The magnitude (length) of this vector. */
-	public get magnitude(): number {
-		return getMagnitude(this);
-	}
-
-	public set magnitude(value: number) {
-		scale(normalize(this, this), value, this);
-	}
-
-	/** The squared magnitude (length) of this vector. */
-	public get squaredMagnitude(): number {
-		return getSquaredMagnitude(this);
-	}
-
-	public set squaredMagnitude(value: number) {
-		this.magnitude = Math.sqrt(value);
+	public multiply(vector: Readonly<Vector3Like>): Vector3 {
+		return multiply(this, vector, new Vector3());
 	}
 
 	/**
@@ -1000,14 +1069,6 @@ export default class Vector3
 		return negate(this, new Vector3());
 	}
 
-	/**
-	 * Calculate the multiplicative inverse of the components of this vector.
-	 * @returns The inverted vector.
-	 */
-	public invert(): Vector3 {
-		return invert(this, new Vector3());
-	}
-
 	/**
 	 * Normalize this vector.
 	 * @returns The normalized vector.
@@ -1018,34 +1079,12 @@ export default class Vector3
 	}
 
 	/**
-	 * Calculate the dot product of this and another vector.
-	 * @param vector - The other vector.
-	 * @returns The dot product.
-	 * @see {@link https://en.wikipedia.org/wiki/Dot_product | Dot product}
-	 */
-	public dot(vector: Vector3Like): number {
-		return dot(this, vector);
-	}
-
-	/**
-	 * Calculate the cross product of this and another vector.
-	 * @param vector - The other vector.
-	 * @returns The cross product.
-	 * @see {@link https://en.wikipedia.org/wiki/Cross_product | Cross product}
-	 */
-	public cross(vector: Vector3Like): Vector3 {
-		return cross(this, vector, new Vector3());
-	}
-
-	/**
-	 * Perform a linear interpolation between this and another vector.
-	 * @param vector - The other vector.
-	 * @param t - The interpolation amount (in `[0,1]`).
-	 * @returns The interpolated vector.
-	 * @see {@link https://en.wikipedia.org/wiki/Linear_interpolation | Linear interpolation}
+	 * Raise each component of this vector to the given power.
+	 * @param scalar - The exponent (power) to raise each component to.
+	 * @returns The power (result of the exponentiation).
 	 */
-	public lerp(vector: Vector3Like, t: number): Vector3 {
-		return lerp(this, vector, t, new Vector3());
+	public pow(scalar: number): Vector3 {
+		return pow(this, scalar, new Vector3());
 	}
 
 	/**
@@ -1057,31 +1096,13 @@ export default class Vector3
 		return random(magnitude, this);
 	}
 
-	/**
-	 * Transform this vector by a three-by-three matrix.
-	 * @param matrix - The matrix.
-	 * @returns The transformed vector.
-	 */
-	public transformMatrix3(matrix: Matrix3Like): Vector3 {
-		return transformMatrix3(this, matrix, new Vector3());
-	}
-
-	/**
-	 * Transform this vector by a four-by-four matrix.
-	 * @param matrix - The matrix.
-	 * @returns The transformed vector.
-	 */
-	public transformMatrix4(matrix: Matrix4Like): Vector3 {
-		return transformMatrix4(this, matrix, new Vector3());
-	}
-
 	/**
 	 * Rotate this vector around the X-axis.
 	 * @param origin - The origin of the rotation.
 	 * @param r - The angle of rotation in radians.
 	 * @returns The rotated vector.
 	 */
-	public rotateX(origin: Vector3Like, r: number): Vector3 {
+	public rotateX(origin: Readonly<Vector3Like>, r: number): Vector3 {
 		return rotateX(this, origin, r, new Vector3());
 	}
 
@@ -1091,7 +1112,7 @@ export default class Vector3
 	 * @param r - The angle of rotation in radians.
 	 * @returns The rotated vector.
 	 */
-	public rotateY(origin: Vector3Like, r: number): Vector3 {
+	public rotateY(origin: Readonly<Vector3Like>, r: number): Vector3 {
 		return rotateY(this, origin, r, new Vector3());
 	}
 
@@ -1101,61 +1122,72 @@ export default class Vector3
 	 * @param r - The angle of rotation in radians.
 	 * @returns The rotated vector.
 	 */
-	public rotateZ(origin: Vector3Like, r: number): Vector3 {
+	public rotateZ(origin: Readonly<Vector3Like>, r: number): Vector3 {
 		return rotateZ(this, origin, r, new Vector3());
 	}
 
 	/**
-	 * Get the angle from this vector to another in radians.
+	 * Round the components of this vector.
+	 * @returns The rounded vector.
+	 */
+	public round(): Vector3 {
+		return round(this, new Vector3());
+	}
+
+	/**
+	 * Scale this vector by a scalar.
+	 * @param scalar - The scalar.
+	 * @returns The scaled vector.
+	 */
+	public scale(scalar: number): Vector3 {
+		return scale(this, scalar, new Vector3());
+	}
+
+	/**
+	 * Add another vector to this one after scaling the other by a scalar.
 	 * @param vector - The other vector.
-	 * @returns The angular distance from this vector to the other.
+	 * @param scalar - The scalar.
+	 * @returns The sum.
 	 */
-	public angle(vector: Vector3Like): number {
-		return angle(this, vector);
+	public scaleAndAdd(vector: Readonly<Vector3Like>, scalar: number): Vector3 {
+		return scaleAndAdd(this, vector, scalar, new Vector3());
 	}
 
 	/**
-	 * Set this to the zero vector.
-	 * @returns This vector.
+	 * Calculate the squared Euclidean distance between this vector and another.
+	 * @param vector - The other vector.
+	 * @returns The squared distance.
+	 * @see {@link https://en.wikipedia.org/wiki/Euclidean_distance | Euclidean distance}
 	 */
-	public zero(): this {
-		return zero(this);
+	public squaredDistance(vector: Readonly<Vector3Like>): number {
+		return squaredDistance(this, vector);
 	}
 
 	/**
-	 * Perform a Hermite interpolation with two control points between this vector and another.
-	 * @param a - The first control point.
-	 * @param b - The second control point.
-	 * @param end - The other vector.
-	 * @param t - The interpolation amount in the range `[0,1]`.
-	 * @returns The interpolated vector.
-	 * @see {@link https://en.wikipedia.org/wiki/Hermite_interpolation | Hermite interpolation}
+	 * Subtract another vector from this one.
+	 * @param vector - The other vector.
+	 * @returns The difference between the vectors.
 	 */
-	public hermite(
-		a: Vector3Like,
-		b: Vector3Like,
-		end: Vector3Like,
-		t: number
-	): Vector3 {
-		return hermite(this, a, b, end, t, new Vector3());
+	public subtract(vector: Readonly<Vector3Like>): Vector3 {
+		return subtract(this, vector, new Vector3());
 	}
 
 	/**
-	 * Perform a Bézier interpolation with two control points between this vector and another.
-	 * @param a - The first control point.
-	 * @param b - The second control point.
-	 * @param end - The other vector.
-	 * @param t - The interpolation amount in the range `[0,1]`.
-	 * @returns The interpolated vector.
-	 * @see {@link https://en.wikipedia.org/wiki/B%C3%A9zier_curve | Bézier curve}
+	 * Transform this vector by a three-by-three matrix.
+	 * @param matrix - The matrix.
+	 * @returns The transformed vector.
 	 */
-	public bezier(
-		a: Vector3Like,
-		b: Vector3Like,
-		end: Vector3Like,
-		t: number
-	): Vector3 {
-		return bezier(this, a, b, end, t, new Vector3());
+	public transformMatrix3(matrix: Readonly<Matrix3Like>): Vector3 {
+		return transformMatrix3(this, matrix, new Vector3());
+	}
+
+	/**
+	 * Transform this vector by a four-by-four matrix.
+	 * @param matrix - The matrix.
+	 * @returns The transformed vector.
+	 */
+	public transformMatrix4(matrix: Readonly<Matrix4Like>): Vector3 {
+		return transformMatrix4(this, matrix, new Vector3());
 	}
 
 	/**
@@ -1164,7 +1196,15 @@ export default class Vector3
 	 * @returns The transformed vector.
 	 * @see {@link https://en.wikipedia.org/wiki/Quaternion | Quaternion}
 	 */
-	public transformQuaternion(quaternion: QuaternionLike): Vector3 {
+	public transformQuaternion(quaternion: Readonly<QuaternionLike>): Vector3 {
 		return transformQuaternion(this, quaternion, new Vector3());
 	}
+
+	/**
+	 * Set this to the zero vector.
+	 * @returns This vector.
+	 */
+	public zero(): this {
+		return zero(this);
+	}
 }