@fi4f/hg 0.0.11 → 0.0.12

package/dist/vector3.d.ts

@@ -0,0 +1,126 @@
+export type Vector3 = [number, number, number];
+/**
+ * A collection of constants and functions for constructing and
+ * interacting with Vector3 objects.
+ */
+export declare const Vector3: {
+    /** Constant index for the x-component of a Vector3 */
+    X: 0;
+    /** Constant index for the y-component of a Vector3 */
+    Y: 1;
+    /** Constant index for the z-component of a Vector3 */
+    Z: 2;
+    /** A collection of getters for Vector3 objects */
+    Get: {
+        /** Get the x-component of a Vector3 */
+        x(a: Vector3): number;
+        /** Get the y-component of a Vector3 */
+        y(a: Vector3): number;
+        /** Get the z-component of a Vector3 */
+        z(a: Vector3): number;
+    };
+    /** A collection of setters for Vector3 objects */
+    Set: {
+        /** Set the x-component of a Vector3 */
+        x(a: Vector3, x: number): number;
+        /** Set the y-component of a Vector3 */
+        y(a: Vector3, y: number): number;
+        /** Set the z-component of a Vector3 */
+        z(a: Vector3, z: number): number;
+    };
+    /** Get or set (when `x` is defined) the x-component of a Vector3 */
+    x(a: Vector3, x?: number): number;
+    /** Get or set (when `y` is defined) the y-component of a Vector3 */
+    y(a: Vector3, y?: number): number;
+    /** Get or set (when `z` is defined) the z-component of a Vector3 */
+    z(a: Vector3, z?: number): number;
+    /**
+     * Construct a Vector3 from a variadic array of numbers.
+     *
+     * Constructs a uniform Vector3 when `a.length === 1`
+     * ```js
+     * Vector3.new(1) // [1, 1, 1]
+     * ```
+     *
+     * Otherwise constructs a standard zero-padded Vector3
+     * ```js
+     * Vector3.new(       ) // [0, 0, 0]
+     * Vector3.new(1, 2   ) // [1, 2, 0]
+     * Vector3.new(1, 2, 3) // [1, 2, 3]
+     * ```
+     */
+    "new"(...a: Array<number>): [number, number, number];
+    /**
+     * Constructs a Vector3 from a number or an array of numbers.
+     *
+     * Constructs a uniform Vector3 when `a` is a number
+     * ```js
+     * Vector3.from(1) // [1, 1, 1]
+     * ```
+     *
+     * Otherwise constructs a standard zero-padded Vector3
+     * ```js
+     * Vector3.from([       ]) // [0, 0, 0]
+     * Vector3.from([1      ]) // [1, 0, 0]
+     * Vector3.from([1, 2   ]) // [1, 2, 0]
+     * Vector3.from([1, 2, 3]) // [1, 2, 3]
+     * ```
+     */
+    from(a: number | Array<number>): [number, number, number];
+    /**
+     * Perform an element-wise operation on two Vector3 objects.
+     * Number-like arguments are promoted to uniform Vector3 objects
+     * before performing the operation. Constructs a new Vector3 when an
+     * output argument is not provided.
+     */
+    el(op: (a: number, b: number) => number, a: number | Vector3, b: number | Vector3, out?: Vector3): Vector3;
+    /**
+     * Compute the sum of two Vector3 objects. Number-like arguments are
+     * promoted to uniform Vector3 objects before performing the operation.
+     * Constructs a new Vector3 when an output argument is not provided.
+     */
+    add(a: number | Vector3, b: number | Vector3, out?: Vector3): Vector3;
+    /**
+     * Compute the difference of two Vector3 objects. Number-like arguments
+     * are promoted to uniform Vector3 objects before performing the
+     * operation. Constructs a new Vector3 when an output argument is not
+     * provided.
+     */
+    sub(a: number | Vector3, b: number | Vector3, out?: Vector3): Vector3;
+    /**
+     * Compute the hadamard (element-wise) product of two Vector3 objects.
+     * Number-like arguments are promoted to uniform Vector3 objects before
+     * performing the operation. Constructs a new Vector3 when an output
+     * argument is not provided.
+     */
+    hmul(a: number | Vector3, b: number | Vector3, out?: Vector3): Vector3;
+    /**
+     * Compute the hadamard (element-wise) quotient of two Vector3 objects.
+     * Number-like arguments are promoted to uniform Vector3 objects before
+     * performing the operation. Constructs a new Vector3 when an output
+     * argument is not provided.
+     */
+    hdiv(a: number | Vector3, b: number | Vector3, out?: Vector3): Vector3;
+    /**
+     * Compute the hadamard (element-wise) remainder of two Vector3 objects.
+     * Number-like arguments are promoted to uniform Vector3 objects before
+     * performing the operation. Constructs a new Vector3 when an output
+     * argument is not provided.
+     */
+    hmod(a: number | Vector3, b: number | Vector3, out?: Vector3): Vector3;
+    /**
+     * Compute the dot product of two Vector3 objects, or simply the
+     * dot product of `a` with itself when `b` is not defined. Number-like
+     * arguments are promoted to uniform Vector3 objects before performing
+     * the operation.
+     */
+    dot(a: number | Vector3, b?: number | Vector3): number;
+    /**
+     * Convert a Vector3 into its string representation.
+     * ```js
+     * Vector3.toString([1, 2, 3]) // "vec3<1, 2, 3>"
+     * ```
+     */
+    toString([x, y, z]: Vector3): `vec3<${number}, ${number}, ${number}>`;
+};
+//# sourceMappingURL=vector3.d.ts.map

package/dist/vector3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector3.d.ts","sourceRoot":"","sources":["../src/vector3.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE9C;;;GAGG;AACH,eAAO,MAAM,OAAO;IAClB,sDAAsD;;IAEtD,sDAAsD;;IAEtD,sDAAsD;;IAGtD,kDAAkD;;QAEhD,uCAAuC;aAClC,OAAO;QACZ,uCAAuC;aAClC,OAAO;QACZ,uCAAuC;aAClC,OAAO;;IAGd,kDAAkD;;QAEhD,uCAAuC;aAClC,OAAO,KAAK,MAAM;QACvB,uCAAuC;aAClC,OAAO,KAAK,MAAM;QACvB,uCAAuC;aAClC,OAAO,KAAK,MAAM;;IAGzB,oEAAoE;SAC/D,OAAO,MAAO,MAAM;IAKzB,oEAAoE;SAC/D,OAAO,MAAO,MAAM;IAKzB,oEAAoE;SAC/D,OAAO,MAAO,MAAM;IAKzB;;;;;;;;;;;;;;OAcG;gBACO,KAAK,CAAC,MAAM,CAAC;IAavB;;;;;;;;;;;;;;;OAeG;YACK,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAa9B;;;;;OAKG;WACI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,KAAK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAS/F;;;;OAIG;WACI,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI1D;;;;;OAKG;WACI,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI1D;;;;;OAKG;YACK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI3D;;;;;OAKG;YACK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI3D;;;;;OAKG;YACK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI3D;;;;;OAKG;WACI,MAAM,GAAG,OAAO,MAAK,MAAM,GAAG,OAAO;IAM5C;;;;;OAKG;wBACkB,OAAO;CAG7B,CAAA"}

package/dist/vector3.js

@@ -0,0 +1,190 @@
+import { add, sub, mul, div, mod } from "./el.js";
+/**
+ * A collection of constants and functions for constructing and
+ * interacting with Vector3 objects.
+ */
+export const Vector3 = {
+    /** Constant index for the x-component of a Vector3 */
+    X: 0,
+    /** Constant index for the y-component of a Vector3 */
+    Y: 1,
+    /** Constant index for the z-component of a Vector3 */
+    Z: 2,
+    /** A collection of getters for Vector3 objects */
+    Get: {
+        /** Get the x-component of a Vector3 */
+        x(a) { return a[Vector3.X]; },
+        /** Get the y-component of a Vector3 */
+        y(a) { return a[Vector3.Y]; },
+        /** Get the z-component of a Vector3 */
+        z(a) { return a[Vector3.Z]; },
+    },
+    /** A collection of setters for Vector3 objects */
+    Set: {
+        /** Set the x-component of a Vector3 */
+        x(a, x) { return a[Vector3.X] = x; },
+        /** Set the y-component of a Vector3 */
+        y(a, y) { return a[Vector3.Y] = y; },
+        /** Set the z-component of a Vector3 */
+        z(a, z) { return a[Vector3.Z] = z; },
+    },
+    /** Get or set (when `x` is defined) the x-component of a Vector3 */
+    x(a, x) {
+        if (x === undefined)
+            return Vector3.Get.x(a);
+        else
+            return Vector3.Set.x(a, x);
+    },
+    /** Get or set (when `y` is defined) the y-component of a Vector3 */
+    y(a, y) {
+        if (y === undefined)
+            return Vector3.Get.y(a);
+        else
+            return Vector3.Set.y(a, y);
+    },
+    /** Get or set (when `z` is defined) the z-component of a Vector3 */
+    z(a, z) {
+        if (z === undefined)
+            return Vector3.Get.z(a);
+        else
+            return Vector3.Set.z(a, z);
+    },
+    /**
+     * Construct a Vector3 from a variadic array of numbers.
+     *
+     * Constructs a uniform Vector3 when `a.length === 1`
+     * ```js
+     * Vector3.new(1) // [1, 1, 1]
+     * ```
+     *
+     * Otherwise constructs a standard zero-padded Vector3
+     * ```js
+     * Vector3.new(       ) // [0, 0, 0]
+     * Vector3.new(1, 2   ) // [1, 2, 0]
+     * Vector3.new(1, 2, 3) // [1, 2, 3]
+     * ```
+     */
+    new(...a) {
+        if (a.length === 1)
+            return [
+                a[Vector3.X],
+                a[Vector3.X],
+                a[Vector3.X]
+            ];
+        else
+            return [
+                a[Vector3.X] ?? 0,
+                a[Vector3.Y] ?? 0,
+                a[Vector3.Z] ?? 0
+            ];
+    },
+    /**
+     * Constructs a Vector3 from a number or an array of numbers.
+     *
+     * Constructs a uniform Vector3 when `a` is a number
+     * ```js
+     * Vector3.from(1) // [1, 1, 1]
+     * ```
+     *
+     * Otherwise constructs a standard zero-padded Vector3
+     * ```js
+     * Vector3.from([       ]) // [0, 0, 0]
+     * Vector3.from([1      ]) // [1, 0, 0]
+     * Vector3.from([1, 2   ]) // [1, 2, 0]
+     * Vector3.from([1, 2, 3]) // [1, 2, 3]
+     * ```
+     */
+    from(a) {
+        if (typeof a === "number")
+            return [
+                a,
+                a,
+                a
+            ];
+        else
+            return [
+                a[Vector3.X] ?? 0,
+                a[Vector3.Y] ?? 0,
+                a[Vector3.Z] ?? 0
+            ];
+    },
+    /**
+     * Perform an element-wise operation on two Vector3 objects.
+     * Number-like arguments are promoted to uniform Vector3 objects
+     * before performing the operation. Constructs a new Vector3 when an
+     * output argument is not provided.
+     */
+    el(op, a, b, out = Vector3.new()) {
+        const [xa, ya, za] = Vector3.from(a);
+        const [xb, yb, zb] = Vector3.from(b);
+        Vector3.Set.x(out, op(xa, xb));
+        Vector3.Set.y(out, op(ya, yb));
+        Vector3.Set.z(out, op(za, zb));
+        return out;
+    },
+    /**
+     * Compute the sum of two Vector3 objects. Number-like arguments are
+     * promoted to uniform Vector3 objects before performing the operation.
+     * Constructs a new Vector3 when an output argument is not provided.
+     */
+    add(a, b, out = Vector3.new()) {
+        return Vector3.el(add, a, b, out);
+    },
+    /**
+     * Compute the difference of two Vector3 objects. Number-like arguments
+     * are promoted to uniform Vector3 objects before performing the
+     * operation. Constructs a new Vector3 when an output argument is not
+     * provided.
+     */
+    sub(a, b, out = Vector3.new()) {
+        return Vector3.el(sub, a, b, out);
+    },
+    /**
+     * Compute the hadamard (element-wise) product of two Vector3 objects.
+     * Number-like arguments are promoted to uniform Vector3 objects before
+     * performing the operation. Constructs a new Vector3 when an output
+     * argument is not provided.
+     */
+    hmul(a, b, out = Vector3.new()) {
+        return Vector3.el(mul, a, b, out);
+    },
+    /**
+     * Compute the hadamard (element-wise) quotient of two Vector3 objects.
+     * Number-like arguments are promoted to uniform Vector3 objects before
+     * performing the operation. Constructs a new Vector3 when an output
+     * argument is not provided.
+     */
+    hdiv(a, b, out = Vector3.new()) {
+        return Vector3.el(div, a, b, out);
+    },
+    /**
+     * Compute the hadamard (element-wise) remainder of two Vector3 objects.
+     * Number-like arguments are promoted to uniform Vector3 objects before
+     * performing the operation. Constructs a new Vector3 when an output
+     * argument is not provided.
+     */
+    hmod(a, b, out = Vector3.new()) {
+        return Vector3.el(mod, a, b, out);
+    },
+    /**
+     * Compute the dot product of two Vector3 objects, or simply the
+     * dot product of `a` with itself when `b` is not defined. Number-like
+     * arguments are promoted to uniform Vector3 objects before performing
+     * the operation.
+     */
+    dot(a, b = a) {
+        const [xa, ya, za] = Vector3.from(a);
+        const [xb, yb, zb] = Vector3.from(b);
+        return xa * xb + ya * yb + za * zb;
+    },
+    /**
+     * Convert a Vector3 into its string representation.
+     * ```js
+     * Vector3.toString([1, 2, 3]) // "vec3<1, 2, 3>"
+     * ```
+     */
+    toString([x, y, z]) {
+        return `vec3<${x}, ${y}, ${z}>`;
+    }
+};
+//# sourceMappingURL=vector3.js.map

package/dist/vector3.js.map

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

package/dist/vector4.d.ts

@@ -0,0 +1,135 @@
+export type Vector4 = [number, number, number, number];
+/**
+ * A collection of constants and functions for constructing and
+ * interacting with Vector4 objects.
+ */
+export declare const Vector4: {
+    /** Constant index for the x-component of a Vector4 */
+    X: 0;
+    /** Constant index for the y-component of a Vector4 */
+    Y: 1;
+    /** Constant index for the z-component of a Vector4 */
+    Z: 2;
+    /** Constant index for the w-component of a Vector4 */
+    W: 3;
+    /** A collection of getters for Vector4 objects */
+    Get: {
+        /** Get the x-component of a Vector4 */
+        x(a: Vector4): number;
+        /** Get the y-component of a Vector4 */
+        y(a: Vector4): number;
+        /** Get the z-component of a Vector4 */
+        z(a: Vector4): number;
+        /** Get the w-component of a Vector4 */
+        w(a: Vector4): number;
+    };
+    Set: {
+        /** Set the x-component of a Vector4 */
+        x(a: Vector4, x: number): number;
+        /** Set the y-component of a Vector4 */
+        y(a: Vector4, y: number): number;
+        /** Set the z-component of a Vector4 */
+        z(a: Vector4, z: number): number;
+        /** Set the w-component of a Vector4 */
+        w(a: Vector4, w: number): number;
+    };
+    /** Get or set (when `x` is defined) the x-component of a Vector4 */
+    x(a: Vector4, x?: number): number;
+    /** Get or set (when `y` is defined) the y-component of a Vector4 */
+    y(a: Vector4, y?: number): number;
+    /** Get or set (when `z` is defined) the z-component of a Vector4 */
+    z(a: Vector4, z?: number): number;
+    /** Get or set (when `w` is defined) the w-component of a Vector4 */
+    w(a: Vector4, w?: number): number;
+    /**
+     * Construct a Vector4 from a variadic array of numbers.
+     *
+     * Constructs a uniform Vector4 when `a.length === 1`
+     * ```js
+     * Vector4.new(1) // [1, 1, 1, 1]
+     * ```
+     *
+     * Otherwise constructs a standard zero-padded Vector4
+     * ```js
+     * Vector4.new(          ) // [0, 0, 0, 0]
+     * Vector4.new(1, 2      ) // [1, 2, 0, 0]
+     * Vector4.new(1, 2, 3   ) // [1, 2, 3, 0]
+     * Vector4.new(1, 2, 3, 4) // [1, 2, 3, 4]
+     * ```
+     */
+    "new"(...a: Array<number>): [number, number, number, number];
+    /**
+     * Constructs a Vector4 from a number or an array of numbers.
+     *
+     * Constructs a uniform Vector4 when `a` is a number
+     * ```js
+     * Vector4.from(1) // [1, 1, 1, 1]
+     * ```
+     *
+     * Otherwise constructs a standard zero-padded Vector4
+     * ```js
+     * Vector4.from([          ]) // [0, 0, 0, 0]
+     * Vector4.from([1         ]) // [1, 0, 0, 0]
+     * Vector4.from([1, 2      ]) // [1, 2, 0, 0]
+     * Vector4.from([1, 2, 3   ]) // [1, 2, 3, 0]
+     * Vector4.from([1, 2, 3, 4]) // [1, 2, 3, 4]
+     * ```
+     */
+    from(a: number | Array<number>): [number, number, number, number];
+    /**
+     * Perform an element-wise operation on two Vector4 objects.
+     * Number-like arguments are promoted to uniform Vector4 objects
+     * before performing the operation. Constructs a new Vector4 when an
+     * output argument is not provided.
+     */
+    el(op: (a: number, b: number) => number, a: number | Vector4, b: number | Vector4, out?: Vector4): Vector4;
+    /**
+     * Compute the sum of two Vector4 objects. Number-like arguments are
+     * promoted to uniform Vector4 objects before performing the operation.
+     * Constructs a new Vector4 when an output argument is not provided.
+     */
+    add(a: number | Vector4, b: number | Vector4, out?: Vector4): Vector4;
+    /**
+     * Compute the difference of two Vector4 objects. Number-like arguments
+     * are promoted to uniform Vector4 objects before performing the
+     * operation. Constructs a new Vector4 when an output argument is not
+     * provided.
+     */
+    sub(a: number | Vector4, b: number | Vector4, out?: Vector4): Vector4;
+    /**
+     * Compute the hadamard (element-wise) product of two Vector4 objects.
+     * Number-like arguments are promoted to uniform Vector4 objects before
+     * performing the operation. Constructs a new Vector4 when an output
+     * argument is not provided.
+     */
+    hmul(a: number | Vector4, b: number | Vector4, out?: Vector4): Vector4;
+    /**
+     * Compute the hadamard (element-wise) quotient of two Vector4 objects.
+     * Number-like arguments are promoted to uniform Vector4 objects before
+     * performing the operation. Constructs a new Vector4 when an output
+     * argument is not provided.
+     */
+    hdiv(a: number | Vector4, b: number | Vector4, out?: Vector4): Vector4;
+    /**
+     * Compute the hadamard (element-wise) remainder of two Vector4 objects.
+     * Number-like arguments are promoted to uniform Vector4 objects before
+     * performing the operation. Constructs a new Vector4 when an output
+     * argument is not provided.
+     */
+    hmod(a: number | Vector4, b: number | Vector4, out?: Vector4): Vector4;
+    /**
+     * Compute the dot product of two Vector4 objects, or simply the
+     * dot product of `a` with itself when `b` is not defined. Number-like
+     * arguments are promoted to uniform Vector4 objects before performing
+     * the operation.
+     */
+    dot(a: number | Vector4, b?: number | Vector4): number;
+    /**
+     * Convert a Vector4 into its string representation.
+     * ```js
+     * Vector4.toString([1, 2, 3, 4]) // "vec4<1, 2, 3, 4>"
+     * ```
+     */
+    toString([x, y, z, w]: Vector4): `vec4<${number}, ${number}, ${number}, ${number}>`;
+};
+//# sourceMappingURL=vector4.d.ts.map

package/dist/vector4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector4.d.ts","sourceRoot":"","sources":["../src/vector4.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAEtD;;;GAGG;AACH,eAAO,MAAM,OAAO;IAClB,sDAAsD;;IAEtD,sDAAsD;;IAEtD,sDAAsD;;IAEtD,sDAAsD;;IAGtD,kDAAkD;;QAEhD,uCAAuC;aAClC,OAAO;QACZ,uCAAuC;aAClC,OAAO;QACZ,uCAAuC;aAClC,OAAO;QACZ,uCAAuC;aAClC,OAAO;;;QAIZ,uCAAuC;aAClC,OAAO,KAAK,MAAM;QACvB,uCAAuC;aAClC,OAAO,KAAK,MAAM;QACvB,uCAAuC;aAClC,OAAO,KAAK,MAAM;QACvB,uCAAuC;aAClC,OAAO,KAAK,MAAM;;IAGzB,oEAAoE;SAC/D,OAAO,MAAO,MAAM;IAKzB,oEAAoE;SAC/D,OAAO,MAAO,MAAM;IAKzB,oEAAoE;SAC/D,OAAO,MAAO,MAAM;IAKzB,oEAAoE;SAC/D,OAAO,MAAO,MAAM;IAKzB;;;;;;;;;;;;;;;OAeG;gBACO,KAAK,CAAC,MAAM,CAAE;IAexB;;;;;;;;;;;;;;;;OAgBG;YACK,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAe9B;;;;;OAKG;WACI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,KAAK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAU/F;;;;OAIG;WACI,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI1D;;;;;OAKG;WACI,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI1D;;;;;OAKG;YACK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI3D;;;;;OAKG;YACK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI3D;;;;;OAKG;YACK,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,OAAO,QAAO,OAAO;IAI3D;;;;;OAKG;WACI,MAAM,GAAG,OAAO,MAAK,MAAM,GAAG,OAAO;IAM5C;;;;;OAKG;2BACqB,OAAO;CAGhC,CAAA"}

package/dist/vector4.js

@@ -0,0 +1,209 @@
+import { add, sub, mul, div, mod } from "./el.js";
+/**
+ * A collection of constants and functions for constructing and
+ * interacting with Vector4 objects.
+ */
+export const Vector4 = {
+    /** Constant index for the x-component of a Vector4 */
+    X: 0,
+    /** Constant index for the y-component of a Vector4 */
+    Y: 1,
+    /** Constant index for the z-component of a Vector4 */
+    Z: 2,
+    /** Constant index for the w-component of a Vector4 */
+    W: 3,
+    /** A collection of getters for Vector4 objects */
+    Get: {
+        /** Get the x-component of a Vector4 */
+        x(a) { return a[Vector4.X]; },
+        /** Get the y-component of a Vector4 */
+        y(a) { return a[Vector4.Y]; },
+        /** Get the z-component of a Vector4 */
+        z(a) { return a[Vector4.Z]; },
+        /** Get the w-component of a Vector4 */
+        w(a) { return a[Vector4.W]; },
+    },
+    Set: {
+        /** Set the x-component of a Vector4 */
+        x(a, x) { return a[Vector4.X] = x; },
+        /** Set the y-component of a Vector4 */
+        y(a, y) { return a[Vector4.Y] = y; },
+        /** Set the z-component of a Vector4 */
+        z(a, z) { return a[Vector4.Z] = z; },
+        /** Set the w-component of a Vector4 */
+        w(a, w) { return a[Vector4.W] = w; },
+    },
+    /** Get or set (when `x` is defined) the x-component of a Vector4 */
+    x(a, x) {
+        if (x === undefined)
+            return Vector4.Get.x(a);
+        else
+            return Vector4.Set.x(a, x);
+    },
+    /** Get or set (when `y` is defined) the y-component of a Vector4 */
+    y(a, y) {
+        if (y === undefined)
+            return Vector4.Get.y(a);
+        else
+            return Vector4.Set.y(a, y);
+    },
+    /** Get or set (when `z` is defined) the z-component of a Vector4 */
+    z(a, z) {
+        if (z === undefined)
+            return Vector4.Get.z(a);
+        else
+            return Vector4.Set.z(a, z);
+    },
+    /** Get or set (when `w` is defined) the w-component of a Vector4 */
+    w(a, w) {
+        if (w === undefined)
+            return Vector4.Get.w(a);
+        else
+            return Vector4.Set.w(a, w);
+    },
+    /**
+     * Construct a Vector4 from a variadic array of numbers.
+     *
+     * Constructs a uniform Vector4 when `a.length === 1`
+     * ```js
+     * Vector4.new(1) // [1, 1, 1, 1]
+     * ```
+     *
+     * Otherwise constructs a standard zero-padded Vector4
+     * ```js
+     * Vector4.new(          ) // [0, 0, 0, 0]
+     * Vector4.new(1, 2      ) // [1, 2, 0, 0]
+     * Vector4.new(1, 2, 3   ) // [1, 2, 3, 0]
+     * Vector4.new(1, 2, 3, 4) // [1, 2, 3, 4]
+     * ```
+     */
+    new(...a) {
+        if (a.length === 1)
+            return [
+                a[Vector4.X],
+                a[Vector4.X],
+                a[Vector4.X],
+                a[Vector4.X]
+            ];
+        else
+            return [
+                a[Vector4.X] ?? 0,
+                a[Vector4.Y] ?? 0,
+                a[Vector4.Z] ?? 0,
+                a[Vector4.W] ?? 0
+            ];
+    },
+    /**
+     * Constructs a Vector4 from a number or an array of numbers.
+     *
+     * Constructs a uniform Vector4 when `a` is a number
+     * ```js
+     * Vector4.from(1) // [1, 1, 1, 1]
+     * ```
+     *
+     * Otherwise constructs a standard zero-padded Vector4
+     * ```js
+     * Vector4.from([          ]) // [0, 0, 0, 0]
+     * Vector4.from([1         ]) // [1, 0, 0, 0]
+     * Vector4.from([1, 2      ]) // [1, 2, 0, 0]
+     * Vector4.from([1, 2, 3   ]) // [1, 2, 3, 0]
+     * Vector4.from([1, 2, 3, 4]) // [1, 2, 3, 4]
+     * ```
+     */
+    from(a) {
+        if (typeof a === "number")
+            return [
+                a,
+                a,
+                a,
+                a
+            ];
+        else
+            return [
+                a[Vector4.X] ?? 0,
+                a[Vector4.Y] ?? 0,
+                a[Vector4.Z] ?? 0,
+                a[Vector4.W] ?? 0
+            ];
+    },
+    /**
+     * Perform an element-wise operation on two Vector4 objects.
+     * Number-like arguments are promoted to uniform Vector4 objects
+     * before performing the operation. Constructs a new Vector4 when an
+     * output argument is not provided.
+     */
+    el(op, a, b, out = Vector4.new()) {
+        const [xa, ya, za, wa] = Vector4.from(a);
+        const [xb, yb, zb, wb] = Vector4.from(b);
+        Vector4.Set.x(out, op(xa, xb));
+        Vector4.Set.y(out, op(ya, yb));
+        Vector4.Set.z(out, op(za, zb));
+        Vector4.Set.w(out, op(wa, wb));
+        return out;
+    },
+    /**
+     * Compute the sum of two Vector4 objects. Number-like arguments are
+     * promoted to uniform Vector4 objects before performing the operation.
+     * Constructs a new Vector4 when an output argument is not provided.
+     */
+    add(a, b, out = Vector4.new()) {
+        return Vector4.el(add, a, b, out);
+    },
+    /**
+     * Compute the difference of two Vector4 objects. Number-like arguments
+     * are promoted to uniform Vector4 objects before performing the
+     * operation. Constructs a new Vector4 when an output argument is not
+     * provided.
+     */
+    sub(a, b, out = Vector4.new()) {
+        return Vector4.el(sub, a, b, out);
+    },
+    /**
+     * Compute the hadamard (element-wise) product of two Vector4 objects.
+     * Number-like arguments are promoted to uniform Vector4 objects before
+     * performing the operation. Constructs a new Vector4 when an output
+     * argument is not provided.
+     */
+    hmul(a, b, out = Vector4.new()) {
+        return Vector4.el(mul, a, b, out);
+    },
+    /**
+     * Compute the hadamard (element-wise) quotient of two Vector4 objects.
+     * Number-like arguments are promoted to uniform Vector4 objects before
+     * performing the operation. Constructs a new Vector4 when an output
+     * argument is not provided.
+     */
+    hdiv(a, b, out = Vector4.new()) {
+        return Vector4.el(div, a, b, out);
+    },
+    /**
+     * Compute the hadamard (element-wise) remainder of two Vector4 objects.
+     * Number-like arguments are promoted to uniform Vector4 objects before
+     * performing the operation. Constructs a new Vector4 when an output
+     * argument is not provided.
+     */
+    hmod(a, b, out = Vector4.new()) {
+        return Vector4.el(mod, a, b, out);
+    },
+    /**
+     * Compute the dot product of two Vector4 objects, or simply the
+     * dot product of `a` with itself when `b` is not defined. Number-like
+     * arguments are promoted to uniform Vector4 objects before performing
+     * the operation.
+     */
+    dot(a, b = a) {
+        const [xa, ya, za, wa] = Vector4.from(a);
+        const [xb, yb, zb, wb] = Vector4.from(b);
+        return xa * xb + ya * yb + za * zb + wa * wb;
+    },
+    /**
+     * Convert a Vector4 into its string representation.
+     * ```js
+     * Vector4.toString([1, 2, 3, 4]) // "vec4<1, 2, 3, 4>"
+     * ```
+     */
+    toString([x, y, z, w]) {
+        return `vec4<${x}, ${y}, ${z}, ${w}>`;
+    }
+};
+//# sourceMappingURL=vector4.js.map