@oliversalzburg/js-utils 0.7.0 → 0.8.0

package/lib/math/vector3.js

@@ -0,0 +1,492 @@
+/**
+ * A vector with 3 components, labeled: `X`, `Y`, `Z`.
+ */
+export class Vector3 {
+    /**
+     * The X component of the vector.
+     */
+    x;
+    /**
+     * The Y component of the vector.
+     */
+    y;
+    /**
+     * The Z component of the vector.
+     */
+    z;
+    /**
+     * Constructs a new {@linkcode Vector3}.
+     * @param x - The X component.
+     * @param y - The Y component.
+     * @param z - The Z component.
+     */
+    constructor(x = 0, y = 0, z = 0) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+    /**
+     * Creates a copy of another {@linkcode Vector3}.
+     * @param vector - The vector to copy.
+     * @returns A new vector.
+     */
+    static fromVector3(vector) {
+        return new Vector3(vector.x, vector.y, vector.z);
+    }
+    /**
+     * Sets the vector to new coordinates.
+     * @param vector - The coordinates to set the vector to.
+     * @returns This instance.
+     */
+    set(vector) {
+        return this.setXYZ(vector.x, vector.y, vector.z);
+    }
+    /**
+     * Sets the vector to new coordinates.
+     * @param x - The new X component for the vector.
+     * @param y - The new Y component for the vector.
+     * @param z - The new Z component for the vector.
+     * @returns This instance.
+     */
+    setXYZ(x, y, z) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+        return this;
+    }
+    /**
+     * Adds another vector to this vector.
+     * @param vector - The vector to add to this vector.
+     * @returns This instance.
+     */
+    add(vector) {
+        return this.addXYZ(vector.x, vector.y, vector.z);
+    }
+    /**
+     * Adds another vector to this vector.
+     * @param x - The value to add to the X component.
+     * @param y - The value to add to the Y component.
+     * @param z - The value to add to the Z component.
+     * @returns This instance.
+     */
+    addXYZ(x, y, z) {
+        this.x += x;
+        this.y += y;
+        this.z += z;
+        return this;
+    }
+    /**
+     * Scales another vector and adds it to this vector.
+     * @param vector - The vector to add to this vector.
+     * @param scale - The scaling to apply to the input vector.
+     * @returns This instance.
+     */
+    addMultiply(vector, scale) {
+        return this.addMultiplyXYZ(vector.x, vector.y, vector.z, scale);
+    }
+    /**
+     * Scales another vector and adds it to this vector.
+     * @param x - The value to add to the X component.
+     * @param y - The value to add to the Y component.
+     * @param z - The value to add to the Z component.
+     * @param scale - The scaling to apply to the input vector.
+     * @returns This instance.
+     */
+    addMultiplyXYZ(x, y, z, scale) {
+        this.x += x * scale;
+        this.y += y * scale;
+        this.z += z * scale;
+        return this;
+    }
+    /**
+     * Subtracts another vector from this vector.
+     * @param vector - The vector to subtract from this vector.
+     * @returns This instance.
+     */
+    subtract(vector) {
+        return this.subtractXYZ(vector.x, vector.y, vector.z);
+    }
+    /**
+     * Subtracts another vector from this vector.
+     * @param x - The value to subtract from the X component.
+     * @param y - The value to subtract from the Y component.
+     * @param z - The value to subtract from the Z component.
+     * @returns This instance.
+     */
+    subtractXYZ(x, y, z) {
+        this.x -= x;
+        this.y -= y;
+        this.z -= z;
+        return this;
+    }
+    /**
+     * Multiplies this vector by another vector.
+     * @param vector - The vector to multiply with this vector.
+     * @returns This instance.
+     */
+    multiply(vector) {
+        return this.multiplyXYZ(vector.x, vector.y, vector.z);
+    }
+    /**
+     * Multiplies this vector by another vector.
+     * @param x - The value to multiply with the X component.
+     * @param y - The value to multiply with the Y component.
+     * @param z - The value to multiply with the Z component.
+     * @returns This instance.
+     */
+    multiplyXYZ(x, y, z) {
+        this.x *= x;
+        this.y *= y;
+        this.z *= z;
+        return this;
+    }
+    /**
+     * Multiplies the vector by the given scale.
+     * @param scale - The scaling to apply to the vector.
+     * @returns This instance.
+     */
+    multiplyScale(scale) {
+        this.x *= scale;
+        this.y *= scale;
+        this.z *= scale;
+        return this;
+    }
+    /**
+     * Divides this vector by another vector.
+     * @param vector - The vector to divide this vector with.
+     * @returns This instance.
+     */
+    divide(vector) {
+        return this.divideXYZ(vector.x, vector.y, vector.z);
+    }
+    /**
+     * Divides this vector by another vector.
+     * @param x - The value to divide the X component with.
+     * @param y - The value to divide the Y component with.
+     * @param z - The value to divide the Z component with.
+     * @returns This instance.
+     */
+    divideXYZ(x, y, z) {
+        this.x /= x;
+        this.y /= y;
+        this.z /= z;
+        return this;
+    }
+    /**
+     * Divides the vector by the given scale.
+     * @param scale - The scaling to apply to the vector.
+     * @returns This instance.
+     */
+    divideScale(scale) {
+        this.x /= scale;
+        this.y /= scale;
+        this.z /= scale;
+        return this;
+    }
+    /**
+     * Inverts the direction of the vector.
+     * @returns This instance.
+     */
+    invertAdd() {
+        this.x = -this.x;
+        this.y = -this.y;
+        this.z = -this.z;
+        return this;
+    }
+    /**
+     * Inverts the vectors scale.
+     * @returns This instance.
+     */
+    invertMultiply() {
+        this.x = 1 / this.x;
+        this.y = 1 / this.y;
+        this.z = 1 / this.z;
+        return this;
+    }
+    /**
+     * Clamps the components of the vector at the given boundary.
+     * @param floor - The lowest value to allow.
+     * @param ceil - The largest value to allow.
+     * @returns This instance.
+     */
+    clamp(floor, ceil) {
+        if (this.x < floor) {
+            this.x = floor;
+        }
+        if (this.x > ceil) {
+            this.x = ceil;
+        }
+        if (this.y < floor) {
+            this.y = floor;
+        }
+        if (this.y > ceil) {
+            this.y = ceil;
+        }
+        if (this.z < floor) {
+            this.z = floor;
+        }
+        if (this.z > ceil) {
+            this.z = ceil;
+        }
+        return this;
+    }
+    /**
+     * Calculates the length of the vector.
+     * @returns The length of the vector.
+     */
+    length() {
+        return Math.sqrt(this.x * this.x + this.y * this.y + this.z * this.z);
+    }
+    /**
+     * Normalizes the vector.
+     * @returns This instance.
+     */
+    normalize() {
+        const length = this.length();
+        if (length === 0) {
+            return this;
+        }
+        this.x /= length;
+        this.y /= length;
+        this.z /= length;
+        return this;
+    }
+    /**
+     * Compares two vectors.
+     * @param vector - The vector to compare this vector to.
+     * @returns `true` if the vectors are idently, `false` otherwise.
+     */
+    compare(vector) {
+        return vector.x === this.x && vector.y === this.y && vector.z === this.z;
+    }
+    /**
+     * Linearly moves this vector towards a target vector.
+     * @param vector - The target vector.
+     * @param t - The location on the scale, from `0` to `1`.
+     * @returns This instance.
+     */
+    lerp(vector, t) {
+        const tn = 1 - t;
+        this.x = this.x * tn + vector.x * t;
+        this.y = this.y * tn + vector.y * t;
+        this.z = this.z * tn + vector.z * t;
+        return this;
+    }
+    /**
+     * Rotates the vector by the given rotation matrix.
+     * @param matrix - The rotation matrix to apply to the vector.
+     * @returns This instance.
+     */
+    rotate(matrix) {
+        const xn = this.x;
+        const yn = this.y;
+        const zn = this.z;
+        this.x = xn * matrix.m00 + yn * matrix.m10 + zn * matrix.m20;
+        this.y = xn * matrix.m01 + yn * matrix.m11 + zn * matrix.m21;
+        this.z = xn * matrix.m02 + yn * matrix.m12 + zn * matrix.m22;
+        return this;
+    }
+    /**
+     * Inversely rotates the vector by the given rotation matrix.
+     * @param matrix - The rotation matrix to apply to the vector.
+     * @returns This instance.
+     */
+    rotateInverse(matrix) {
+        const xn = this.x;
+        const yn = this.y;
+        const zn = this.z;
+        this.x = xn * matrix.m00 + yn * matrix.m01 + zn * matrix.m02;
+        this.y = xn * matrix.m10 + yn * matrix.m11 + zn * matrix.m12;
+        this.z = xn * matrix.m20 + yn * matrix.m21 + zn * matrix.m22;
+        return this;
+    }
+    /**
+     * Rotates the vector by the given rotation matrix around the given center.
+     * @param center - The center around which to rotate the vector.
+     * @param matrix - The rotation matrix to apply to the vector.
+     * @returns This instance.
+     */
+    rotateAround(center, matrix) {
+        const xn = this.x - center.x;
+        const yn = this.y - center.y;
+        const zn = this.z - center.z;
+        this.x = xn * matrix.m00 + yn * matrix.m10 + zn * matrix.m20 + center.x;
+        this.y = xn * matrix.m01 + yn * matrix.m11 + zn * matrix.m21 + center.y;
+        this.z = xn * matrix.m02 + yn * matrix.m12 + zn * matrix.m22 + center.z;
+        return this;
+    }
+    /**
+     * Inversely rotates the vector by the given rotation matrix around the given center.
+     * @param center - The center around which to rotate the vector.
+     * @param matrix - The rotation matrix to apply to the vector.
+     * @returns This instance.
+     */
+    rotateAroundInverse(center, matrix) {
+        const xn = this.x - center.x;
+        const yn = this.y - center.y;
+        const zn = this.z - center.z;
+        this.x = xn * matrix.m00 + yn * matrix.m01 + zn * matrix.m02 + center.x;
+        this.y = xn * matrix.m10 + yn * matrix.m11 + zn * matrix.m12 + center.y;
+        this.z = xn * matrix.m20 + yn * matrix.m21 + zn * matrix.m22 + center.z;
+        return this;
+    }
+    /**
+     * Transform the vector with a {@linkcode Transformation}.
+     * @param transformation - The transformation to apply.
+     * @returns This instance.
+     */
+    transform(transformation) {
+        return this.multiply(transformation.scale)
+            .rotate(transformation.rotation)
+            .add(transformation.position);
+    }
+    /**
+     * Inversely transform the vector with a {@linkcode Transformation}.
+     * @param transformation - The transformation to apply.
+     * @returns This instance.
+     */
+    transformInverse(transformation) {
+        return this.subtract(transformation.position)
+            .rotateInverse(transformation.rotation)
+            .divide(transformation.scale);
+    }
+    /**
+     * Returns the dot product between two vectors.
+     * @param vector - The other vector.
+     * @returns The dot product between the two vectors.
+     */
+    dot(vector) {
+        return this.dotXYZ(vector.x, vector.y, vector.z);
+    }
+    /**
+     * Returns the dot product between two vectors.
+     * @param x - The X component of the other vector.
+     * @param y - The Y component of the other vector.
+     * @param z - The Z component of the other vector.
+     * @returns The dot product between the two vectors.
+     */
+    dotXYZ(x, y, z) {
+        return this.x * x + this.y * y + this.z * z;
+    }
+    /**
+     * Calculates the dot product of this vector and another vector, and then
+     * sets this vector to the result.
+     * @param vector - The other vector.
+     * @returns This instance.
+     */
+    cross(vector) {
+        const xn = this.z * vector.y - this.y * vector.z;
+        const yn = this.x * vector.z - this.z * vector.x;
+        const zn = this.y * vector.x - this.x * vector.y;
+        this.x = xn;
+        this.y = yn;
+        this.z = zn;
+        return this;
+    }
+    /**
+     * Makes this vector perpendicular to the other 3 vectors.
+     * @param vector0 - The first vector.
+     * @param vector1 - The second vector.
+     * @param vector2 - The third vector.
+     * @returns This instance.
+     */
+    perpendicular(vector0, vector1, vector2) {
+        const px = vector2.x - vector1.x;
+        const py = vector2.y - vector1.y;
+        const pz = vector2.z - vector1.z;
+        const qx = vector0.x - vector1.x;
+        const qy = vector0.y - vector1.y;
+        const qz = vector0.z - vector1.z;
+        this.x = pz * qy - py * qz;
+        this.y = px * qz - pz * qx;
+        this.z = py * qx - px * qy;
+        return this;
+    }
+    /**
+     * Reflects this vector against the given normal and sets this vector to
+     * the result.
+     * @param normal - The normal against which to reflect.
+     * @returns This instance.
+     */
+    reflect(normal) {
+        const c = this.dot(normal) * 2;
+        this.x = this.x - c * normal.x;
+        this.y = this.y - c * normal.y;
+        this.z = this.z - c * normal.z;
+        return this;
+    }
+    /**
+     * Calculates the reflection of this vector, based on the angle of incident
+     * into a material with the given refractive index, according to Snell's law.
+     * This vector is then set to the result.
+     * @param normal - The normal against which to reflect.
+     * @param index - The refractive index of the material.
+     * @returns This instance.
+     */
+    fraction(normal, index) {
+        let c = -this.dot(normal);
+        const r = 1 + index * index * (c * c - 1);
+        if (r < 0)
+            return this.reflect(normal);
+        c = index * c - Math.sqrt(r);
+        this.x = index * this.x + c * normal.x;
+        this.y = index * this.y + c * normal.y;
+        this.z = index * this.z + c * normal.z;
+        return this;
+    }
+    /**
+     * Return the components of this vector as an array.
+     * @returns The components of this vector as an array.
+     */
+    asArray() {
+        return [this.x, this.y, this.z];
+    }
+}
+/**
+ * Adds two vectors and returns a new vector with the result.
+ * @param a - The first input vector.
+ * @param b - The second input vector.
+ * @returns A new {@linkcode Vector3}.
+ */
+export const addVector3 = (a, b) => {
+    return new Vector3(a.x * b.x, a.y * b.y, a.z + b.z);
+};
+/**
+ * Multiplies two vectors and returns a new vector with the result.
+ * @param a - The first input vector.
+ * @param b - The second input vector.
+ * @returns A new {@linkcode Vector3}.
+ */
+export const multiplyVector3 = (a, b) => {
+    return new Vector3(a.x * b.x, a.y * b.y, a.z * b.z);
+};
+/**
+ * Subtracts two vectors and returns a new vector with the result.
+ * @param a - The first input vector.
+ * @param b - The second input vector.
+ * @returns A new {@linkcode Vector3}.
+ */
+export const subtractVector3 = (a, b) => {
+    return new Vector3(a.x - b.x, a.y - b.y, a.z - b.z);
+};
+/**
+ * Calculates the cross product between two vectors and returns a new vector with the result.
+ * @param a - The first input vector.
+ * @param b - The second input vector.
+ * @returns A new vector, which is the cross product of the two input vectors.
+ */
+export const crossVector3 = (a, b) => {
+    const c = Vector3.fromVector3(a);
+    return c.cross(b);
+};
+/**
+ * Calculates the dot product between two vectors.
+ * @param a - The first input vector.
+ * @param b - The second input vector.
+ * @returns The dot product between the two vectors.
+ */
+export const dotVector3 = (a, b) => {
+    const c = Vector3.fromVector3(a);
+    return c.dot(b);
+};
+//# sourceMappingURL=vector3.js.map

package/lib/math/vector3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3.js","sourceRoot":"","sources":["../../source/math/vector3.ts"],"names":[],"mappings":"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"}

package/lib/math/vector4.d.ts

@@ -0,0 +1,182 @@
+/**
+ * A vector with 4 components, labeled: `X`, `Y`, `Z`, `W`.
+ */
+export declare class Vector4 {
+    /**
+     * The components of the vector.
+     */
+    k: number[];
+    /**
+     * Get the X component of the vector.
+     * @returns The X component of the vector.
+     */
+    get x(): number;
+    /**
+     * Set the X component of the vector.
+     */
+    set x(value: number);
+    /**
+     * Get the Y component of the vector.
+     * @returns The Y component of the vector.
+     */
+    get y(): number;
+    /**
+     * Set the Y component of the vector.
+     */
+    set y(value: number);
+    /**
+     * Get the Z component of the vector.
+     * @returns The Z component of the vector.
+     */
+    get z(): number;
+    /**
+     * Set the Z component of the vector.
+     */
+    set z(value: number);
+    /**
+     * Get the W component of the vector.
+     * @returns The W component of the vector.
+     */
+    get w(): number;
+    /**
+     * Set the W component of the vector.
+     */
+    set w(value: number);
+    /**
+     * Constructs a new {@linkcode Vector4}.
+     * @param x - The X component.
+     * @param y - The Y component.
+     * @param z - The Z component.
+     * @param w - The W component.
+     */
+    constructor(x: number, y: number, z: number, w: number);
+    /**
+     * Creates a copy of another {@linkcode Vector4}.
+     * @param vector - The vector to copy.
+     * @returns A new vector.
+     */
+    static fromVector4(vector: Readonly<Vector4>): Vector4;
+    /**
+     * Sets the vector to new coordinates.
+     * @param vector - The coordinates to set the vector to.
+     * @returns This instance.
+     */
+    set(vector: Readonly<Vector4>): this;
+    /**
+     * Sets the vector to new coordinates.
+     * @param x - The new X component for the vector.
+     * @param y - The new Y component for the vector.
+     * @param z - The new Z component for the vector.
+     * @param w - The new W component for the vector.
+     * @returns This instance.
+     */
+    setXYZW(x: number, y: number, z: number, w: number): this;
+    /**
+     * Adds the XYZ components of another vector to this vector.
+     * @param vector - The vector to add to this vector.
+     * @returns This instance.
+     */
+    add3(vector: Readonly<Vector4>): this;
+    /**
+     * Adds the XYZ components of another vector to this vector.
+     * @param x - The value to add to the X component.
+     * @param y - The value to add to the Y component.
+     * @param z - The value to add to the Z component.
+     * @returns This instance.
+     */
+    add3XYZ(x: number, y: number, z: number): this;
+    /**
+     * Scales another vector and adds its XYZ components to this vector.
+     * @param vector - The vector to add to this vector.
+     * @param scale - The scaling to apply to the input vector.
+     * @returns This instance.
+     */
+    addMultiply3(vector: Readonly<Vector4>, scale: number): this;
+    /**
+     * Scales another vector and adds its XYZ components to this vector.
+     * @param x - The value to add to the X component.
+     * @param y - The value to add to the Y component.
+     * @param z - The value to add to the Z component.
+     * @param scale - The scaling to apply to the input vector.
+     * @returns This instance.
+     */
+    addMultiply3XYZ(x: number, y: number, z: number, scale: number): this;
+    /**
+     * Subtracts the XYZ components of another vector from this vector.
+     * @param vector - The vector to subtract from this vector.
+     * @returns This instance.
+     */
+    subtract3(vector: Readonly<Vector4>): this;
+    /**
+     * Subtracts the XYZ components of another vector from this vector.
+     * @param x - The value to subtract from the X component.
+     * @param y - The value to subtract from the Y component.
+     * @param z - The value to subtract from the Z component.
+     * @returns This instance.
+     */
+    subtract3XYZ(x: number, y: number, z: number): this;
+    /**
+     * Multiplies the XYZ components of this vector by another vector.
+     * @param vector - The vector to multiply with this vector.
+     * @returns This instance.
+     */
+    multiply3(vector: Readonly<Vector4>): this;
+    /**
+     * Multiplies the XYZ components of this vector by another vector.
+     * @param x - The value to multiply with the X component.
+     * @param y - The value to multiply with the Y component.
+     * @param z - The value to multiply with the Z component.
+     * @returns This instance.
+     */
+    multiply3XYZ(x: number, y: number, z: number): this;
+    /**
+     * Multiplies the XYZ components of the vector by the given scale.
+     * @param scale - The scaling to apply to the vector.
+     * @returns This instance.
+     */
+    multiply3Scale(scale: number): this;
+    /**
+     * Divides the XYZ components of this vector by another vector.
+     * @param vector - The vector to divide this vector with.
+     * @returns This instance.
+     */
+    divide3(vector: Readonly<Vector4>): this;
+    /**
+     * Divides the XYZ components of this vector by another vector.
+     * @param x - The value to divide the X component with.
+     * @param y - The value to divide the Y component with.
+     * @param z - The value to divide the Z component with.
+     * @returns This instance.
+     */
+    divide3XYZ(x: number, y: number, z: number): this;
+    /**
+     * Divides the XYZ components of the vector by the given scale.
+     * @param scale - The scaling to apply to the vector.
+     * @returns This instance.
+     */
+    divide3Scale(scale: number): this;
+    /**
+     * Inverts the direction of the vector.
+     * @returns This instance.
+     */
+    invertAdd3(): this;
+    /**
+     * Inverts the vectors scale.
+     * @returns This instance.
+     */
+    invertMultiply3(): this;
+    /**
+     * Clamps the components of the vector at the given boundary.
+     * @param floor - The lowest value to allow.
+     * @param ceil - The largest value to allow.
+     * @returns This instance.
+     */
+    clamp(floor: number, ceil: number): this;
+    /**
+     * Linearly moves this vector towards a target vector.
+     * @param vector - The target vector.
+     * @param t - The location on the scale, from `0` to `1`.
+     * @returns This instance.
+     */
+    lerp(vector: Readonly<Vector4>, t: number): this;
+}