@oliversalzburg/js-utils 0.0.18 → 0.0.19-dev.1

package/{lib/math → math}/vector3.d.ts

@@ -19,112 +19,112 @@ export declare class Vector3 {
     z: number;
     /**
      * Constructs a new {@linkcode Vector3}.
-     * @param x The X component.
-     * @param y The Y component.
-     * @param z The Z component.
+     * @param x - The X component.
+     * @param y - The Y component.
+     * @param z - The Z component.
      */
     constructor(x?: number, y?: number, z?: number);
     /**
      * Creates a copy of another {@linkcode Vector3}.
-     * @param vector The vector to copy.
+     * @param vector - The vector to copy.
      * @returns A new vector.
      */
     static fromVector3(vector: Readonly<Vector3>): Vector3;
     /**
      * Sets the vector to new coordinates.
-     * @param vector The coordinates to set the vector to.
+     * @param vector - The coordinates to set the vector to.
      * @returns This instance.
      */
     set(vector: Readonly<Vector3>): 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 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: number, y: number, z: number): this;
     /**
      * Adds another vector to this vector.
-     * @param vector The vector to add to this vector.
+     * @param vector - The vector to add to this vector.
      * @returns This instance.
      */
     add(vector: Readonly<Vector3>): this;
     /**
      * 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.
+     * @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: number, y: number, z: number): 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.
+     * @param vector - The vector to add to this vector.
+     * @param scale - The scaling to apply to the input vector.
      * @returns This instance.
      */
     addMultiply(vector: Readonly<Vector3>, scale: number): this;
     /**
      * 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.
+     * @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: number, y: number, z: number, scale: number): this;
     /**
      * Subtracts another vector from this vector.
-     * @param vector The vector to subtract from this vector.
+     * @param vector - The vector to subtract from this vector.
      * @returns This instance.
      */
     subtract(vector: Vector3): this;
     /**
      * 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.
+     * @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: number, y: number, z: number): this;
     /**
      * Multiplies this vector by another vector.
-     * @param vector The vector to multiply with this vector.
+     * @param vector - The vector to multiply with this vector.
      * @returns This instance.
      */
     multiply(vector: Readonly<Vector3>): this;
     /**
      * 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.
+     * @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: number, y: number, z: number): this;
     /**
      * Multiplies the vector by the given scale.
-     * @param scale The scaling to apply to the vector.
+     * @param scale - The scaling to apply to the vector.
      * @returns This instance.
      */
     multiplyScale(scale: number): this;
     /**
      * Divides this vector by another vector.
-     * @param vector The vector to divide this vector with.
+     * @param vector - The vector to divide this vector with.
      * @returns This instance.
      */
     divide(vector: Readonly<Vector3>): this;
     /**
      * 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.
+     * @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: number, y: number, z: number): this;
     /**
      * Divides the vector by the given scale.
-     * @param scale The scaling to apply to the vector.
+     * @param scale - The scaling to apply to the vector.
      * @returns This instance.
      */
     divideScale(scale: number): this;
@@ -140,8 +140,8 @@ export declare class Vector3 {
     invertMultiply(): 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.
+     * @param floor - The lowest value to allow.
+     * @param ceil - The largest value to allow.
      * @returns This instance.
      */
     clamp(floor: number, ceil: number): this;
@@ -157,88 +157,88 @@ export declare class Vector3 {
     normalize(): this;
     /**
      * Compares two vectors.
-     * @param vector The vector to compare this vector to.
+     * @param vector - The vector to compare this vector to.
      * @returns `true` if the vectors are idently, `false` otherwise.
      */
     compare(vector: Readonly<Vector3>): boolean;
     /**
      * Linearly moves this vector towards a target vector.
-     * @param vector The target vector.
-     * @param t The location on the scale, from `0` to `1`.
+     * @param vector - The target vector.
+     * @param t - The location on the scale, from `0` to `1`.
      * @returns This instance.
      */
     lerp(vector: Readonly<Vector3>, t: number): this;
     /**
      * Rotates the vector by the given rotation matrix.
-     * @param matrix The rotation matrix to apply to the vector.
+     * @param matrix - The rotation matrix to apply to the vector.
      * @returns This instance.
      */
     rotate(matrix: Readonly<Matrix3>): this;
     /**
      * Inversely rotates the vector by the given rotation matrix.
-     * @param matrix The rotation matrix to apply to the vector.
+     * @param matrix - The rotation matrix to apply to the vector.
      * @returns This instance.
      */
     rotateInverse(matrix: Readonly<Matrix3>): 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.
+     * @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: Readonly<Vector3>, matrix: Readonly<Matrix3>): 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.
+     * @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: Readonly<Vector3>, matrix: Readonly<Matrix3>): this;
     /**
      * Transform the vector with a {@linkcode Transformation}.
-     * @param transformation The transformation to apply.
+     * @param transformation - The transformation to apply.
      * @returns This instance.
      */
     transform(transformation: Readonly<Transformation>): this;
     /**
      * Inversely transform the vector with a {@linkcode Transformation}.
-     * @param transformation The transformation to apply.
+     * @param transformation - The transformation to apply.
      * @returns This instance.
      */
     transformInverse(transformation: Readonly<Transformation>): this;
     /**
      * Returns the dot product between two vectors.
-     * @param vector The other vector.
+     * @param vector - The other vector.
      * @returns The dot product between the two vectors.
      */
     dot(vector: Readonly<Vector3>): number;
     /**
      * 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.
+     * @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: number, y: number, z: number): number;
     /**
      * Calculates the dot product of this vector and another vector, and then
      * sets this vector to the result.
-     * @param vector The other vector.
+     * @param vector - The other vector.
      * @returns This instance.
      */
     cross(vector: Readonly<Vector3>): 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.
+     * @param vector0 - The first vector.
+     * @param vector1 - The second vector.
+     * @param vector2 - The third vector.
      * @returns This instance.
      */
     perpendicular(vector0: Readonly<Vector3>, vector1: Readonly<Vector3>, vector2: Readonly<Vector3>): this;
     /**
      * Reflects this vector against the given normal and sets this vector to
      * the result.
-     * @param normal The normal against which to reflect.
+     * @param normal - The normal against which to reflect.
      * @returns This instance.
      */
     reflect(normal: Readonly<Vector3>): this;
@@ -246,8 +246,8 @@ export declare class Vector3 {
      * 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.
+     * @param normal - The normal against which to reflect.
+     * @param index - The refractive index of the material.
      * @returns This instance.
      */
     fraction(normal: Readonly<Vector3>, index: number): this;
@@ -259,40 +259,40 @@ export declare class Vector3 {
 }
 /**
  * Adds two vectors and returns a new vector with the result.
- * @param a The first input vector.
- * @param b The second input vector.
+ * @param a - The first input vector.
+ * @param b - The second input vector.
  * @returns A new {@linkcode Vector3}.
  * @group Math
  */
 export declare const addVector3: (a: Readonly<Vector3>, b: Readonly<Vector3>) => Vector3;
 /**
  * Multiplies two vectors and returns a new vector with the result.
- * @param a The first input vector.
- * @param b The second input vector.
+ * @param a - The first input vector.
+ * @param b - The second input vector.
  * @returns A new {@linkcode Vector3}.
  * @group Math
  */
 export declare const multiplyVector3: (a: Readonly<Vector3>, b: Readonly<Vector3>) => Vector3;
 /**
  * Subtracts two vectors and returns a new vector with the result.
- * @param a The first input vector.
- * @param b The second input vector.
+ * @param a - The first input vector.
+ * @param b - The second input vector.
  * @returns A new {@linkcode Vector3}.
  * @group Math
  */
 export declare const subtractVector3: (a: Readonly<Vector3>, b: Readonly<Vector3>) => Vector3;
 /**
  * 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.
+ * @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.
  * @group Math
  */
 export declare const crossVector3: (a: Readonly<Vector3>, b: Readonly<Vector3>) => Vector3;
 /**
  * Calculates the dot product between two vectors.
- * @param a The first input vector.
- * @param b The second input vector.
+ * @param a - The first input vector.
+ * @param b - The second input vector.
  * @returns The dot product between the two vectors.
  * @group Math
  */