@lakuna/umath 1.3.8 → 1.4.0

package/src/linalg/Matrix2.ts

@@ -1,12 +1,23 @@
+import {
+	add as vector4Add,
+	copy as vector4Copy,
+	exactEquals as vector4ExactEquals,
+	fromValues as vector4FromValues,
+	getMagnitude as vector4GetMagnitude,
+	scale as vector4Scale,
+	scaleAndAdd as vector4ScaleAndAdd,
+	subtract as vector4Subtract
+} from "./Vector4.js";
 import type { MatrixLike } from "./Matrix.js";
 import SingularMatrixError from "../utility/SingularMatrixError.js";
 import type SquareMatrix from "./SquareMatrix.js";
 import type { Vector2Like } from "./Vector2.js";
-import epsilon from "../utility/epsilon.js";
+import approxRelative from "../algorithms/approxRelative.js";
 
 /**
  * Numbers arranged into two columns and two rows.
- * @see [Matrix](https://en.wikipedia.org/wiki/Matrix_(mathematics))
+ * @see {@link https://en.wikipedia.org/wiki/Matrix_(mathematics) | Matrix}
+ * @public
  */
 export interface Matrix2Like extends MatrixLike {
 	/** The value in the first column and first row. */
@@ -23,29 +34,45 @@ export interface Matrix2Like extends MatrixLike {
 }
 
 /**
- * Create a 2x2 matrix-like object.
- * @returns A 2x2 matrix-like object.
+ * Create a two-by-two matrix-like object.
+ * @returns A two-by-two matrix-like object.
+ * @public
  */
-export const createMatrix2Like = () => {
+export const createMatrix2Like = (): Float32Array & Matrix2Like => {
 	return new Float32Array(4) as Float32Array & Matrix2Like;
 };
 
+/**
+ * Create a two-by-two matrix with the given values.
+ * @param c0r0 - The value in the first column and first row.
+ * @param c0r1 - The value in the first column and second row.
+ * @param c1r0 - The value in the second column and first row.
+ * @param c1r1 - The value in the second column and second row.
+ * @param out - The matrix to store the result in.
+ * @returns The matrix.
+ * @public
+ */
+export const fromValues: <T extends Matrix2Like>(
+	c0r0: number,
+	c0r1: number,
+	c1r0: number,
+	c1r1: number,
+	out: T
+) => T = vector4FromValues;
+
 /**
  * Create a transformation matrix that represents a rotation by the given angle around the Z-axis.
  * @param r - The angle in radians.
  * @param out - The matrix to store the result in.
  * @returns The transformation matrix.
- * @see [Rotation matrix](https://en.wikipedia.org/wiki/Rotation_matrix)
+ * @see {@link https://en.wikipedia.org/wiki/Rotation_matrix | Rotation matrix}
+ * @public
  */
 export const fromRotation = <T extends Matrix2Like>(r: number, out: T): T => {
 	const s = Math.sin(r);
 	const c = Math.cos(r);
 
-	out[0] = c;
-	out[1] = s;
-	out[2] = -s;
-	out[3] = c;
-	return out;
+	return fromValues(c, s, -s, c, out);
 };
 
 /**
@@ -53,76 +80,36 @@ export const fromRotation = <T extends Matrix2Like>(r: number, out: T): T => {
  * @param v - The scaling vector.
  * @param out - The matrix to store the result in.
  * @returns The transformation matrix.
- * @see [Transformation matrix](https://en.wikipedia.org/wiki/Transformation_matrix)
+ * @see {@link https://en.wikipedia.org/wiki/Transformation_matrix | Transformation matrix}
+ * @public
  */
 export const fromScaling = <T extends Matrix2Like>(
 	vector: Vector2Like,
 	out: T
-): T => {
-	out[0] = vector[0];
-	out[1] = 0;
-	out[2] = 0;
-	out[3] = vector[1];
-	return out;
-};
-
-/**
- * Create a two-by-two matrix with the given values.
- * @param c0r0 - The value in the first column and first row.
- * @param c0r1 - The value in the first column and second row.
- * @param c1r0 - The value in the second column and first row.
- * @param c1r1 - The value in the second column and second row.
- * @param out - The matrix to store the result in.
- * @returns The matrix.
- */
-export const fromValues = <T extends Matrix2Like>(
-	c0r0: number,
-	c0r1: number,
-	c1r0: number,
-	c1r1: number,
-	out: T
-): T => {
-	out[0] = c0r0;
-	out[1] = c0r1;
-	out[2] = c1r0;
-	out[3] = c1r1;
-	return out;
-};
+): T => fromValues(vector[0], 0, 0, vector[1], out);
 
 /**
  * Determine whether or not two matrices are roughly equivalent.
  * @param a - The first matrix.
  * @param b - The second matrix.
  * @returns Whether or not the matrices are equivalent.
+ * @public
  */
-export const equals = (a: Matrix2Like, b: Matrix2Like): boolean => {
-	const a0 = a[0];
-	const a1 = a[1];
-	const a2 = a[2];
-	const a3 = a[3];
-
-	const b0 = b[0];
-	const b1 = b[1];
-	const b2 = b[2];
-	const b3 = b[3];
-
-	return (
-		Math.abs(a0 - b0) <= epsilon * Math.max(1, Math.abs(a0), Math.abs(b0)) &&
-		Math.abs(a1 - b1) <= epsilon * Math.max(1, Math.abs(a1), Math.abs(b1)) &&
-		Math.abs(a2 - b2) <= epsilon * Math.max(1, Math.abs(a2), Math.abs(b2)) &&
-		Math.abs(a3 - b3) <= epsilon * Math.max(1, Math.abs(a3), Math.abs(b3))
-	);
-};
+export const equals = (a: Matrix2Like, b: Matrix2Like): boolean =>
+	approxRelative(a[0], b[0]) &&
+	approxRelative(a[1], b[1]) &&
+	approxRelative(a[2], b[2]) &&
+	approxRelative(a[3], b[3]);
 
 /**
  * Determine whether or not two matrices are exactly equivalent.
  * @param a - The first matrix.
  * @param b - The second matrix.
  * @returns Whether the matrices are equivalent.
+ * @public
  */
-export const exactEquals = (a: Matrix2Like, b: Matrix2Like): boolean => {
-	return a[0] === b[0] && a[1] === b[1] && a[2] === b[2] && a[3] === b[3];
-};
+export const exactEquals: (a: Matrix2Like, b: Matrix2Like) => boolean =
+	vector4ExactEquals;
 
 /**
  * Add two matrices.
@@ -130,70 +117,55 @@ export const exactEquals = (a: Matrix2Like, b: Matrix2Like): boolean => {
  * @param b - The addend.
  * @param out - The matrix to store the result in.
  * @returns The sum.
- * @see [Matrix addition](https://en.wikipedia.org/wiki/Matrix_addition)
+ * @see {@link https://en.wikipedia.org/wiki/Matrix_addition | Matrix addition}
+ * @public
  */
-export const add = <T extends Matrix2Like>(
+export const add: <T extends Matrix2Like>(
 	a: Matrix2Like,
 	b: Matrix2Like,
 	out: T
-): T => {
-	out[0] = a[0] + b[0];
-	out[1] = a[1] + b[1];
-	out[2] = a[2] + b[2];
-	out[3] = a[3] + b[3];
-	return out;
-};
+) => T = vector4Add;
 
 /**
  * Calculate the adjugate of a matrix.
  * @param matrix - The matrix.
  * @param out - The matrix to store the result in.
  * @returns The adjugate of the matrix.
- * @see [Adjugate matrix](https://en.wikipedia.org/wiki/Adjugate_matrix)
+ * @see {@link https://en.wikipedia.org/wiki/Adjugate_matrix | Adjugate matrix}
+ * @public
  */
 export const adjoint = <T extends Matrix2Like>(
 	matrix: Matrix2Like,
 	out: T
-): T => {
-	const a0 = matrix[0];
-	out[0] = matrix[3];
-	out[1] = -matrix[1];
-	out[2] = -matrix[2];
-	out[3] = a0;
-	return out;
-};
+): T => fromValues(matrix[3], -matrix[1], -matrix[2], matrix[0], out);
 
 /**
  * Copy the values from one matrix into another.
  * @param matrix - The matrix to copy.
  * @param out - The matrix to store the result in.
  * @returns The copy matrix.
+ * @public
  */
-export const copy = <T extends Matrix2Like>(matrix: Matrix2Like, out: T): T => {
-	out[0] = matrix[0];
-	out[1] = matrix[1];
-	out[2] = matrix[2];
-	out[3] = matrix[3];
-	return out;
-};
+export const copy: <T extends Matrix2Like>(matrix: Matrix2Like, out: T) => T =
+	vector4Copy;
 
 /**
  * Calculate the Frobenius norm of a matrix.
  * @param matrix - The matrix.
  * @returns The Frobenius norm.
- * @see [Matrix norm](https://en.wikipedia.org/wiki/Matrix_norm)
+ * @see {@link https://en.wikipedia.org/wiki/Matrix_norm | Matrix norm}
+ * @public
  */
-export const frob = (matrix: Matrix2Like): number => {
-	return Math.hypot(matrix[0], matrix[1], matrix[2], matrix[3]);
-};
+export const frob: (matrix: Matrix2Like) => number = vector4GetMagnitude;
 
 /**
  * Multiply one matrix by another.
- * @param a - The multiplicand.
- * @param b - The multiplier.
+ * @param a - The multiplier.
+ * @param b - The multiplicand.
  * @param out - The matrix to store the result in.
  * @returns The product.
- * @see [Matrix multiplication](https://en.wikipedia.org/wiki/Matrix_multiplication)
+ * @see {@link https://en.wikipedia.org/wiki/Matrix_multiplication | Matrix multiplication}
+ * @public
  */
 export const multiply = <T extends Matrix2Like>(
 	a: Matrix2Like,
@@ -210,32 +182,29 @@ export const multiply = <T extends Matrix2Like>(
 	const b2 = b[2];
 	const b3 = b[3];
 
-	out[0] = a0 * b0 + a2 * b1;
-	out[1] = a1 * b0 + a3 * b1;
-	out[2] = a0 * b2 + a2 * b3;
-	out[3] = a1 * b2 + a3 * b3;
-	return out;
+	return fromValues(
+		a0 * b0 + a2 * b1,
+		a1 * b0 + a3 * b1,
+		a0 * b2 + a2 * b3,
+		a1 * b2 + a3 * b3,
+		out
+	);
 };
 
 /**
  * Multiply a matrix by a scalar value.
- * @param matrix - The multiplicand.
- * @param scalar - The multiplier.
+ * @param matrix - The multiplier.
+ * @param scalar - The multiplicand.
  * @param out - The matrix to store the result in.
  * @returns The product.
- * @see [Matrix multiplication](https://en.wikipedia.org/wiki/Matrix_multiplication)
+ * @see {@link https://en.wikipedia.org/wiki/Matrix_multiplication | Matrix multiplication}
+ * @public
  */
-export const multiplyScalar = <T extends Matrix2Like>(
+export const multiplyScalar: <T extends Matrix2Like>(
 	matrix: Matrix2Like,
 	scalar: number,
 	out: T
-): T => {
-	out[0] = matrix[0] * scalar;
-	out[1] = matrix[1] * scalar;
-	out[2] = matrix[2] * scalar;
-	out[3] = matrix[3] * scalar;
-	return out;
-};
+) => T = vector4Scale;
 
 /**
  * Add a matrix to another after multiplying the other by a scalar.
@@ -244,21 +213,16 @@ export const multiplyScalar = <T extends Matrix2Like>(
  * @param scalar - The multiplier.
  * @param out - The matrix to store the result in.
  * @returns The sum.
- * @see [Matrix addition](https://en.wikipedia.org/wiki/Matrix_addition)
- * @see [Matrix multiplication](https://en.wikipedia.org/wiki/Matrix_multiplication)
+ * @see {@link https://en.wikipedia.org/wiki/Matrix_addition | Matrix addition}
+ * @see {@link https://en.wikipedia.org/wiki/Matrix_multiplication | Matrix multiplication}
+ * @public
  */
-export const multiplyScalarAndAdd = <T extends Matrix2Like>(
+export const multiplyScalarAndAdd: <T extends Matrix2Like>(
 	a: Matrix2Like,
 	b: Matrix2Like,
 	scalar: number,
 	out: T
-): T => {
-	out[0] = a[0] + b[0] * scalar;
-	out[1] = a[1] + b[1] * scalar;
-	out[2] = a[2] + b[2] * scalar;
-	out[3] = a[3] + b[3] * scalar;
-	return out;
-};
+) => T = vector4ScaleAndAdd;
 
 /**
  * Subtract one matrix from another.
@@ -266,26 +230,22 @@ export const multiplyScalarAndAdd = <T extends Matrix2Like>(
  * @param b - The subtrahend.
  * @param out - The matrix to store the result in.
  * @returns The difference.
- * @see [Matrix addition](https://en.wikipedia.org/wiki/Matrix_addition)
+ * @see {@link https://en.wikipedia.org/wiki/Matrix_addition | Matrix addition}
+ * @public
  */
-export const subtract = <T extends Matrix2Like>(
+export const subtract: <T extends Matrix2Like>(
 	a: Matrix2Like,
 	b: Matrix2Like,
 	out: T
-): T => {
-	out[0] = a[0] - b[0];
-	out[1] = a[1] - b[1];
-	out[2] = a[2] - b[2];
-	out[3] = a[3] - b[3];
-	return out;
-};
+) => T = vector4Subtract;
 
 /**
  * Transpose a matrix.
  * @param matrix - The matrix.
  * @param out - The matrix to store the result in.
  * @returns The transpose of the matrix.
- * @see [Transpose](https://en.wikipedia.org/wiki/Transpose)
+ * @see {@link https://en.wikipedia.org/wiki/Transpose | Transpose}
+ * @public
  */
 export const transpose = <T extends Matrix2Like>(
 	matrix: Matrix2Like,
@@ -295,45 +255,39 @@ export const transpose = <T extends Matrix2Like>(
 		const a1 = matrix[1];
 		out[1] = matrix[2];
 		out[2] = a1;
-	} else {
-		out[0] = matrix[0];
-		out[1] = matrix[2];
-		out[2] = matrix[1];
-		out[3] = matrix[3];
+		return out;
 	}
-	return out;
+
+	return fromValues(matrix[0], matrix[2], matrix[1], matrix[3], out);
 };
 
 /**
  * Calculate the determinant of a matrix.
  * @param matrix-  The matrix.
  * @returns The determinant.
- * @see [Determinant](https://en.wikipedia.org/wiki/Determinant)
+ * @see {@link https://en.wikipedia.org/wiki/Determinant | Determinant}
+ * @public
  */
-export const determinant = (matrix: Matrix2Like): number => {
-	return matrix[0] * matrix[3] - matrix[2] * matrix[1];
-};
+export const determinant = (matrix: Matrix2Like): number =>
+	matrix[0] * matrix[3] - matrix[2] * matrix[1];
 
 /**
  * Reset a matrix to identity.
  * @param out - The matrix to store the result in.
  * @returns The matrix.
- * @see [Identity matrix](https://en.wikipedia.org/wiki/Identity_matrix)
+ * @see {@link https://en.wikipedia.org/wiki/Identity_matrix | Identity matrix}
+ * @public
  */
-export const identity = <T extends Matrix2Like>(out: T): T => {
-	out[0] = 1;
-	out[1] = 0;
-	out[2] = 0;
-	out[3] = 1;
-	return out;
-};
+export const identity = <T extends Matrix2Like>(out: T): T =>
+	fromValues(1, 0, 0, 1, out);
 
 /**
  * Invert a matrix.
  * @param matrix - The matrix.
  * @param out - The matrix to store the result in.
  * @returns The inverted matrix.
- * @see [Invertible matrix](https://en.wikipedia.org/wiki/Invertible_matrix)
+ * @see {@link https://en.wikipedia.org/wiki/Invertible_matrix | Invertible matrix}
+ * @public
  */
 export const invert = <T extends Matrix2Like>(
 	matrix: Matrix2Like,
@@ -350,11 +304,7 @@ export const invert = <T extends Matrix2Like>(
 	}
 	det = 1 / det;
 
-	out[0] = a3 * det;
-	out[1] = -a1 * det;
-	out[2] = -a2 * det;
-	out[3] = a0 * det;
-	return out;
+	return fromValues(a3 * det, -a1 * det, -a2 * det, a0 * det, out);
 };
 
 /**
@@ -363,7 +313,8 @@ export const invert = <T extends Matrix2Like>(
  * @param r - The angle in radians.
  * @param out - The matrix to store the result in.
  * @returns The rotated matrix.
- * @see [Rotation matrix](https://en.wikipedia.org/wiki/Rotation_matrix)
+ * @see {@link https://en.wikipedia.org/wiki/Rotation_matrix | Rotation matrix}
+ * @public
  */
 export const rotate = <T extends Matrix2Like>(
 	matrix: Matrix2Like,
@@ -378,11 +329,13 @@ export const rotate = <T extends Matrix2Like>(
 	const s = Math.sin(r);
 	const c = Math.cos(r);
 
-	out[0] = a0 * c + a2 * s;
-	out[1] = a1 * c + a3 * s;
-	out[2] = a0 * -s + a2 * c;
-	out[3] = a1 * -s + a3 * c;
-	return out;
+	return fromValues(
+		a0 * c + a2 * s,
+		a1 * c + a3 * s,
+		a0 * -s + a2 * c,
+		a1 * -s + a3 * c,
+		out
+	);
 };
 
 /**
@@ -391,7 +344,8 @@ export const rotate = <T extends Matrix2Like>(
  * @param vector - The scaling vector.
  * @param out - The matrix to store the result in.
  * @returns The scaled matrix.
- * @see [Transformation matrix](https://en.wikipedia.org/wiki/Transformation_matrix)
+ * @see {@link https://en.wikipedia.org/wiki/Transformation_matrix | Transformation matrix}
+ * @public
  */
 export const scale = <T extends Matrix2Like>(
 	matrix: Matrix2Like,
@@ -401,16 +355,19 @@ export const scale = <T extends Matrix2Like>(
 	const v0 = vector[0];
 	const v1 = vector[1];
 
-	out[0] = matrix[0] * v0;
-	out[1] = matrix[1] * v0;
-	out[2] = matrix[2] * v1;
-	out[3] = matrix[3] * v1;
-	return out;
+	return fromValues(
+		matrix[0] * v0,
+		matrix[1] * v0,
+		matrix[2] * v1,
+		matrix[3] * v1,
+		out
+	);
 };
 
 /**
  * A two-by-two matrix.
- * @see [Matrix](https://en.wikipedia.org/wiki/Matrix_(mathematics))
+ * @see {@link https://en.wikipedia.org/wiki/Matrix_(mathematics) | Matrix}
+ * @public
  */
 export default class Matrix2
 	extends Float32Array
@@ -421,7 +378,7 @@ export default class Matrix2
 	 * @param r - The angle in radians.
 	 * @param out - The matrix to store the result in.
 	 * @returns The transformation matrix.
-	 * @see [Rotation matrix](https://en.wikipedia.org/wiki/Rotation_matrix)
+	 * @see {@link https://en.wikipedia.org/wiki/Rotation_matrix | Rotation matrix}
 	 */
 	public static fromRotation<T extends Matrix2Like = Matrix2>(
 		r: number,
@@ -435,7 +392,7 @@ export default class Matrix2
 	 * @param vector - The scaling vector.
 	 * @param out - The matrix to store the result in.
 	 * @returns The transformation matrix.
-	 * @see [Transformation matrix](https://en.wikipedia.org/wiki/Transformation_matrix)
+	 * @see {@link https://en.wikipedia.org/wiki/Transformation_matrix | Transformation matrix}
 	 */
 	public static fromScaling<T extends Matrix2Like = Matrix2>(
 		vector: Vector2Like,
@@ -465,7 +422,7 @@ export default class Matrix2
 
 	/**
 	 * Create a two-by-two identity matrix.
-	 * @see [Identity matrix](https://en.wikipedia.org/wiki/Identity_matrix)
+	 * @see {@link https://en.wikipedia.org/wiki/Identity_matrix | Identity matrix}
 	 */
 	public constructor() {
 		super(4);
@@ -518,7 +475,7 @@ export default class Matrix2
 	 * @param matrix - The other matrix.
 	 * @param out - The matrix to store the result in.
 	 * @returns The sum of the matrices.
-	 * @see [Matrix addition](https://en.wikipedia.org/wiki/Matrix_addition)
+	 * @see {@link https://en.wikipedia.org/wiki/Matrix_addition | Matrix addition}
 	 */
 	public add<T extends Matrix2Like = Matrix2>(
 		matrix: Matrix2Like,
@@ -531,7 +488,7 @@ export default class Matrix2
 	 * Calculate the adjugate of this matrix.
 	 * @param out - The matrix to store the result in.
 	 * @returns The adjugate of this matrix.
-	 * @see [Adjugate matrix](https://en.wikipedia.org/wiki/Adjugate_matrix)
+	 * @see {@link https://en.wikipedia.org/wiki/Adjugate_matrix | Adjugate matrix}
 	 */
 	public adjoint<T extends Matrix2Like = Matrix2>(
 		out: T = new Matrix2() as Matrix2 & T
@@ -561,7 +518,7 @@ export default class Matrix2
 
 	/**
 	 * Get the Frobenius norm of this matrix.
-	 * @see [Matrix norm](https://en.wikipedia.org/wiki/Matrix_norm)
+	 * @see {@link https://en.wikipedia.org/wiki/Matrix_norm | Matrix norm}
 	 */
 	public get frob(): number {
 		return frob(this);
@@ -572,7 +529,8 @@ export default class Matrix2
 	 * @param matrix - The other matrix.
 	 * @param out - The matrix to store the result in.
 	 * @returns The product of the matrices.
-	 * @see [Matrix multiplication](https://en.wikipedia.org/wiki/Matrix_multiplication)
+	 * @see {@link https://en.wikipedia.org/wiki/Matrix_multiplication | Matrix multiplication}
+	 * @public
 	 */
 	public multiply<T extends Matrix2Like = Matrix2>(
 		matrix: Matrix2Like,
@@ -586,7 +544,7 @@ export default class Matrix2
 	 * @param scalar - The scalar value.
 	 * @param out - The matrix to store the result in.
 	 * @returns The product of the matrix and the scalar value.
-	 * @see [Matrix multiplication](https://en.wikipedia.org/wiki/Matrix_multiplication)
+	 * @see {@link https://en.wikipedia.org/wiki/Matrix_multiplication | Matrix multiplication}
 	 */
 	public multiplyScalar<T extends Matrix2Like = Matrix2>(
 		scalar: number,
@@ -601,8 +559,8 @@ export default class Matrix2
 	 * @param scalar - The scalar.
 	 * @param out - The matrix to store the result in.
 	 * @returns The sum.
-	 * @see [Matrix addition](https://en.wikipedia.org/wiki/Matrix_addition)
-	 * @see [Matrix multiplication](https://en.wikipedia.org/wiki/Matrix_multiplication)
+	 * @see {@link https://en.wikipedia.org/wiki/Matrix_addition | Matrix addition}
+	 * @see {@link https://en.wikipedia.org/wiki/Matrix_multiplication | Matrix multiplication}
 	 */
 	public multiplyScalarAndAdd<T extends Matrix2Like = Matrix2>(
 		matrix: Matrix2Like,
@@ -617,7 +575,7 @@ export default class Matrix2
 	 * @param matrix - The other matrix.
 	 * @param out - The matrix to store the result in.
 	 * @returns The difference between the matrices.
-	 * @see [Matrix addition](https://en.wikipedia.org/wiki/Matrix_addition)
+	 * @see {@link https://en.wikipedia.org/wiki/Matrix_addition | Matrix addition}
 	 */
 	public subtract<T extends Matrix2Like = Matrix2>(
 		matrix: Matrix2Like,
@@ -630,7 +588,7 @@ export default class Matrix2
 	 * Transpose this matrix.
 	 * @param out - The matrix to store the result in.
 	 * @returns The transpose of this matrix.
-	 * @see [Transpose](https://en.wikipedia.org/wiki/Transpose)
+	 * @see {@link https://en.wikipedia.org/wiki/Transpose | Transpose}
 	 */
 	public transpose<T extends Matrix2Like = Matrix2>(
 		out: T = new Matrix2() as Matrix2 & T
@@ -640,7 +598,7 @@ export default class Matrix2
 
 	/**
 	 * Get the determinant of this matrix.
-	 * @see [Determinant](https://en.wikipedia.org/wiki/Determinant)
+	 * @see {@link https://en.wikipedia.org/wiki/Determinant | Determinant}
 	 */
 	public get determinant(): number {
 		return determinant(this);
@@ -649,7 +607,7 @@ export default class Matrix2
 	/**
 	 * Reset this matrix to identity.
 	 * @returns This matrix.
-	 * @see [Identity matrix](https://en.wikipedia.org/wiki/Identity_matrix)
+	 * @see {@link https://en.wikipedia.org/wiki/Identity_matrix | Identity matrix}
 	 */
 	public identity(): this {
 		return identity(this);
@@ -659,7 +617,7 @@ export default class Matrix2
 	 * Invert this matrix.
 	 * @param out - The matrix to store the result in.
 	 * @returns The inverted matrix.
-	 * @see [Invertible matrix](https://en.wikipedia.org/wiki/Invertible_matrix)
+	 * @see {@link https://en.wikipedia.org/wiki/Invertible_matrix | Invertible matrix}
 	 */
 	public invert<T extends Matrix2Like = Matrix2>(
 		out: T = new Matrix2() as Matrix2 & T
@@ -672,7 +630,7 @@ export default class Matrix2
 	 * @param r - The angle in radians.
 	 * @param out - The matrix to store the result in.
 	 * @returns The rotated matrix.
-	 * @see [Rotation matrix](https://en.wikipedia.org/wiki/Rotation_matrix)
+	 * @see {@link https://en.wikipedia.org/wiki/Rotation_matrix | Rotation matrix}
 	 */
 	public rotate<T extends Matrix2Like = Matrix2>(
 		r: number,
@@ -686,7 +644,7 @@ export default class Matrix2
 	 * @param vector - The scaling vector.
 	 * @param out - The matrix to store the result in.
 	 * @returns The scaled matrix.
-	 * @see [Transformation matrix](https://en.wikipedia.org/wiki/Transformation_matrix)
+	 * @see {@link https://en.wikipedia.org/wiki/Transformation_matrix | Transformation matrix}
 	 */
 	public scale<T extends Matrix2Like = Matrix2>(
 		vector: Vector2Like,