@oliversalzburg/js-utils 0.6.0 → 0.7.0

package/lib/math/vector4.js

@@ -1,302 +0,0 @@
-/**
- * A vector with 4 components, labeled: `X`, `Y`, `Z`, `W`.
- */
-export class Vector4 {
-    /**
-     * The components of the vector.
-     */
-    k = [0, 0, 0, 0];
-    /**
-     * Get the X component of the vector.
-     * @returns The X component of the vector.
-     */
-    get x() {
-        return this.k[0];
-    }
-    /**
-     * Set the X component of the vector.
-     */
-    set x(value) {
-        this.k[0] = value;
-    }
-    /**
-     * Get the Y component of the vector.
-     * @returns The Y component of the vector.
-     */
-    get y() {
-        return this.k[1];
-    }
-    /**
-     * Set the Y component of the vector.
-     */
-    set y(value) {
-        this.k[1] = value;
-    }
-    /**
-     * Get the Z component of the vector.
-     * @returns The Z component of the vector.
-     */
-    get z() {
-        return this.k[2];
-    }
-    /**
-     * Set the Z component of the vector.
-     */
-    set z(value) {
-        this.k[2] = value;
-    }
-    /**
-     * Get the W component of the vector.
-     * @returns The W component of the vector.
-     */
-    get w() {
-        return this.k[3];
-    }
-    /**
-     * Set the W component of the vector.
-     */
-    set w(value) {
-        this.k[3] = value;
-    }
-    /**
-     * 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, y, z, w) {
-        this.x = x;
-        this.y = y;
-        this.z = z;
-        this.w = w;
-    }
-    /**
-     * Creates a copy of another {@linkcode Vector4}.
-     * @param vector - The vector to copy.
-     * @returns A new vector.
-     */
-    static fromVector4(vector) {
-        return new Vector4(vector.x, vector.y, vector.z, vector.w);
-    }
-    /**
-     * Sets the vector to new coordinates.
-     * @param vector - The coordinates to set the vector to.
-     * @returns This instance.
-     */
-    set(vector) {
-        return this.setXYZW(vector.x, vector.y, vector.z, vector.w);
-    }
-    /**
-     * 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, y, z, w) {
-        this.x = x;
-        this.y = y;
-        this.z = z;
-        this.w = w;
-        return 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) {
-        return this.add3XYZ(vector.x, vector.y, vector.z);
-    }
-    /**
-     * 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, y, z) {
-        this.x += x;
-        this.y += y;
-        this.z += z;
-        return 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, scale) {
-        return this.addMultiply3XYZ(vector.x, vector.y, vector.z, scale);
-    }
-    /**
-     * 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, y, z, scale) {
-        this.x += x * scale;
-        this.y += y * scale;
-        this.z += z * scale;
-        return 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) {
-        return this.subtract3XYZ(vector.x, vector.y, vector.z);
-    }
-    /**
-     * 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, y, z) {
-        this.x -= x;
-        this.y -= y;
-        this.z -= z;
-        return 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) {
-        return this.multiply3XYZ(vector.x, vector.y, vector.z);
-    }
-    /**
-     * 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, y, z) {
-        this.x *= x;
-        this.y *= y;
-        this.z *= z;
-        return 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) {
-        this.x *= scale;
-        this.y *= scale;
-        this.z *= scale;
-        return 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) {
-        return this.divide3XYZ(vector.x, vector.y, vector.z);
-    }
-    /**
-     * 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, y, z) {
-        this.x /= x;
-        this.y /= y;
-        this.z /= z;
-        return 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) {
-        this.x /= scale;
-        this.y /= scale;
-        this.z /= scale;
-        return this;
-    }
-    /**
-     * Inverts the direction of the vector.
-     * @returns This instance.
-     */
-    invertAdd3() {
-        this.x = -this.x;
-        this.y = -this.y;
-        this.z = -this.z;
-        return this;
-    }
-    /**
-     * Inverts the vectors scale.
-     * @returns This instance.
-     */
-    invertMultiply3() {
-        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;
-        }
-        if (this.w < floor) {
-            this.w = floor;
-        }
-        if (this.w > ceil) {
-            this.w = ceil;
-        }
-        return 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, 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;
-        this.w = this.z * tn + vector.w * t;
-        return this;
-    }
-}
-//# sourceMappingURL=vector4.js.map

package/lib/math/vector4.js.map

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

package/lib/measurement/performance.d.ts

@@ -1,13 +0,0 @@
-import { AnyAsyncFunctionReturning, AnyFunctionReturning } from "../core.js";
-/**
- * Executes the given function and measures how long the execution takes.
- * @param context - The function of which the execution speed should be measured.
- * @returns A tuple with the result of the function, and the execution time in milliseconds.
- */
-export declare const measure: <TReturn>(context: AnyFunctionReturning<TReturn>) => [TReturn, number];
-/**
- * Executes the given async function and measures how long the execution takes.
- * @param context - The async function of which the execution speed should be measured.
- * @returns A tuple with the result of the function, and the execution time in milliseconds.
- */
-export declare const measureAsync: <TReturn>(context: AnyAsyncFunctionReturning<TReturn>) => Promise<[TReturn, number]>;

package/lib/measurement/performance.js

@@ -1,19 +0,0 @@
-/**
- * Executes the given function and measures how long the execution takes.
- * @param context - The function of which the execution speed should be measured.
- * @returns A tuple with the result of the function, and the execution time in milliseconds.
- */
-export const measure = (context) => {
-    const entry = performance.now();
-    return [context(), performance.now() - entry];
-};
-/**
- * Executes the given async function and measures how long the execution takes.
- * @param context - The async function of which the execution speed should be measured.
- * @returns A tuple with the result of the function, and the execution time in milliseconds.
- */
-export const measureAsync = async (context) => {
-    const entry = performance.now();
-    return [await context(), performance.now() - entry];
-};
-//# sourceMappingURL=performance.js.map

package/lib/measurement/performance.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../source/measurement/performance.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAU,OAAsC,EAAqB,EAAE;IAC5F,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,OAAO,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,OAA2C,EACf,EAAE;IAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,OAAO,CAAC,MAAM,OAAO,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;AACtD,CAAC,CAAC"}