@fimbul-works/vec 1.0.3 → 2.0.0

package/dist/cjs/3d/rotate-y-3d.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rotateY3D = void 0;
+/**
+ * Rotates a 3D vector around the y-axis.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @param {number} phi - Angle of rotation in radians
+ * @param {ArrayVector3D} axis - Rotation axis point (default: `[0, 0, 0]`)
+ * @returns {ArrayVector3D} The rotated vector
+ */
+const rotateY3D = (xyz, phi, axis = [0, 0, 0]) => {
+    const cosPhi = Math.cos(phi);
+    const sinPhi = Math.sin(phi);
+    if (axis[0] === 0 && axis[1] === 0 && axis[2] === 0) {
+        return [xyz[0] * cosPhi + xyz[2] * sinPhi, xyz[1], -xyz[0] * sinPhi + xyz[2] * cosPhi];
+    }
+    // Translate point to origin (relative to axis)
+    const translatedX = xyz[0] - axis[0];
+    const translatedZ = xyz[2] - axis[2];
+    // Rotate around origin
+    const rotatedX = translatedX * cosPhi + translatedZ * sinPhi;
+    const rotatedZ = -translatedX * sinPhi + translatedZ * cosPhi;
+    // Translate back
+    return [rotatedX + axis[0], xyz[1], rotatedZ + axis[2]];
+};
+exports.rotateY3D = rotateY3D;

package/dist/cjs/3d/rotate-z-3d.d.ts

@@ -0,0 +1,9 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Rotates a 3D vector around the z-axis.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @param {number} phi - Angle of rotation in radians
+ * @param {ArrayVector3D} axis - Rotation axis point (default: `[0, 0, 0]`)
+ * @returns {ArrayVector3D} The rotated vector
+ */
+export declare const rotateZ3D: (xyz: ArrayVector3D, phi: number, axis?: ArrayVector3D) => ArrayVector3D;

package/dist/cjs/3d/rotate-z-3d.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rotateZ3D = void 0;
+/**
+ * Rotates a 3D vector around the z-axis.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @param {number} phi - Angle of rotation in radians
+ * @param {ArrayVector3D} axis - Rotation axis point (default: `[0, 0, 0]`)
+ * @returns {ArrayVector3D} The rotated vector
+ */
+const rotateZ3D = (xyz, phi, axis = [0, 0, 0]) => {
+    const cosPhi = Math.cos(phi);
+    const sinPhi = Math.sin(phi);
+    if (axis[0] === 0 && axis[1] === 0 && axis[2] === 0) {
+        return [xyz[0] * cosPhi - xyz[1] * sinPhi, xyz[0] * sinPhi + xyz[1] * cosPhi, xyz[2]];
+    }
+    // Translate point to origin (relative to axis)
+    const translatedX = xyz[0] - axis[0];
+    const translatedY = xyz[1] - axis[1];
+    // Rotate around origin
+    const rotatedX = translatedX * cosPhi - translatedY * sinPhi;
+    const rotatedY = translatedX * sinPhi + translatedY * cosPhi;
+    // Translate back
+    return [rotatedX + axis[0], rotatedY + axis[1], xyz[2]];
+};
+exports.rotateZ3D = rotateZ3D;

package/dist/cjs/3d/set-magnitude-3d.d.ts

@@ -0,0 +1,9 @@
+import type { ArrayVector3D } from "./types.js";
+/**
+ * Sets the magnitude (length) of a 3D vector, maintaining its direction.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @param {number} newMagnitude - New magnitude
+ * @param {number} [m] - Optional current magnitude (default: `magnitude3D(xyz)`)
+ * @returns {ArrayVector3D} The adjusted vector
+ */
+export declare const setMagnitude3D: (xyz: ArrayVector3D, newMagnitude: number, m?: number) => ArrayVector3D;

package/dist/cjs/3d/set-magnitude-3d.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setMagnitude3D = void 0;
+const magnitude_3d_js_1 = require("./magnitude-3d.js");
+/**
+ * Sets the magnitude (length) of a 3D vector, maintaining its direction.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @param {number} newMagnitude - New magnitude
+ * @param {number} [m] - Optional current magnitude (default: `magnitude3D(xyz)`)
+ * @returns {ArrayVector3D} The adjusted vector
+ */
+const setMagnitude3D = (xyz, newMagnitude, m = (0, magnitude_3d_js_1.magnitude3D)(xyz)) => [(xyz[0] / m) * newMagnitude, (xyz[1] / m) * newMagnitude, (xyz[2] / m) * newMagnitude];
+exports.setMagnitude3D = setMagnitude3D;

package/dist/cjs/3d/subtract-3d.d.ts

@@ -0,0 +1,8 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Subtracts a 3D vector from another.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @returns {ArrayVector3D} The difference between the vectors
+ */
+export declare const subtract3D: (xyz1: ArrayVector3D, xyz2: ArrayVector3D) => ArrayVector3D;

package/dist/cjs/3d/subtract-3d.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subtract3D = void 0;
+/**
+ * Subtracts a 3D vector from another.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @returns {ArrayVector3D} The difference between the vectors
+ */
+const subtract3D = (xyz1, xyz2) => [
+    xyz1[0] - xyz2[0],
+    xyz1[1] - xyz2[1],
+    xyz1[2] - xyz2[2],
+];
+exports.subtract3D = subtract3D;

package/dist/cjs/3d/types.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 3D vector as an array.
+ */
+export type ArrayVector3D = [number, number, number];

package/dist/cjs/3d/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/3d/zero-3d.d.ts

@@ -0,0 +1,6 @@
+import type { ArrayVector3D } from "./types.js";
+/**
+ * Creates a zero 3D vector.
+ * @returns {ArrayVector3D} Vector `[0, 0, 0]`
+ */
+export declare const zero3D: () => ArrayVector3D;

package/dist/cjs/3d/zero-3d.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zero3D = void 0;
+/**
+ * Creates a zero 3D vector.
+ * @returns {ArrayVector3D} Vector `[0, 0, 0]`
+ */
+const zero3D = () => [0, 0, 0];
+exports.zero3D = zero3D;

package/dist/cjs/4d/add-4d.d.ts

@@ -0,0 +1,8 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Adds two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {ArrayVector4D} The sum of the vectors
+ */
+export declare const add4D: (xyzw1: ArrayVector4D, xyzw2: ArrayVector4D) => ArrayVector4D;

package/dist/cjs/4d/add-4d.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.add4D = void 0;
+/**
+ * Adds two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {ArrayVector4D} The sum of the vectors
+ */
+const add4D = (xyzw1, xyzw2) => [
+    xyzw1[0] + xyzw2[0],
+    xyzw1[1] + xyzw2[1],
+    xyzw1[2] + xyzw2[2],
+    xyzw1[3] + xyzw2[3],
+];
+exports.add4D = add4D;

package/dist/cjs/4d/angle-between-4d.d.ts

@@ -0,0 +1,10 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the angle between two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @param {number} [m1] - Optional magnitude of the first vector (default: `magnitude4D(xyzw1)`)
+ * @param {number} [m2] - Optional magnitude of the second vector (default: `magnitude4D(xyzw2)`)
+ * @returns {number} The angle in radians
+ */
+export declare const angleBetween4D: (xyzw1: ArrayVector4D, xyzw2: ArrayVector4D, m1?: number, m2?: number) => number;

package/dist/cjs/4d/angle-between-4d.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angleBetween4D = void 0;
+const dot_4d_js_1 = require("./dot-4d.js");
+const magnitude_4d_js_1 = require("./magnitude-4d.js");
+/**
+ * Calculates the angle between two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @param {number} [m1] - Optional magnitude of the first vector (default: `magnitude4D(xyzw1)`)
+ * @param {number} [m2] - Optional magnitude of the second vector (default: `magnitude4D(xyzw2)`)
+ * @returns {number} The angle in radians
+ */
+const angleBetween4D = (xyzw1, xyzw2, m1 = (0, magnitude_4d_js_1.magnitude4D)(xyzw1), m2 = (0, magnitude_4d_js_1.magnitude4D)(xyzw2)) => Math.acos((0, dot_4d_js_1.dot4D)(xyzw1, xyzw2) / (m1 * m2));
+exports.angleBetween4D = angleBetween4D;

package/dist/cjs/4d/angle-w-4d.d.ts

@@ -0,0 +1,7 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the angle between a 4D vector and the positive w-axis.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {number} The angle in radians
+ */
+export declare const angleW4D: (xyzw: ArrayVector4D) => number;

package/dist/cjs/4d/angle-w-4d.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angleW4D = void 0;
+/**
+ * Calculates the angle between a 4D vector and the positive w-axis.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {number} The angle in radians
+ */
+const angleW4D = (xyzw) => Math.atan2(Math.sqrt(xyzw[0] ** 2 + xyzw[1] ** 2 + xyzw[2] ** 2), xyzw[3]);
+exports.angleW4D = angleW4D;

package/dist/cjs/4d/angle-x-4d.d.ts

@@ -0,0 +1,7 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the angle between a 4D vector and the positive x-axis.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {number} The angle in radians
+ */
+export declare const angleX4D: (xyzw: ArrayVector4D) => number;

package/dist/cjs/4d/angle-x-4d.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angleX4D = void 0;
+/**
+ * Calculates the angle between a 4D vector and the positive x-axis.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {number} The angle in radians
+ */
+const angleX4D = (xyzw) => Math.atan2(Math.sqrt(xyzw[1] ** 2 + xyzw[2] ** 2 + xyzw[3] ** 2), xyzw[0]);
+exports.angleX4D = angleX4D;

package/dist/cjs/4d/angle-y-4d.d.ts

@@ -0,0 +1,7 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the angle between a 4D vector and the positive y-axis.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {number} The angle in radians
+ */
+export declare const angleY4D: (xyzw: ArrayVector4D) => number;

package/dist/cjs/4d/angle-y-4d.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angleY4D = void 0;
+/**
+ * Calculates the angle between a 4D vector and the positive y-axis.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {number} The angle in radians
+ */
+const angleY4D = (xyzw) => Math.atan2(Math.sqrt(xyzw[2] ** 2 + xyzw[3] ** 2 + xyzw[0] ** 2), xyzw[1]);
+exports.angleY4D = angleY4D;

package/dist/cjs/4d/angle-z-4d.d.ts

@@ -0,0 +1,7 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the angle between a 4D vector and the positive z-axis.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {number} The angle in radians
+ */
+export declare const angleZ4D: (xyzw: ArrayVector4D) => number;

package/dist/cjs/4d/angle-z-4d.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angleZ4D = void 0;
+/**
+ * Calculates the angle between a 4D vector and the positive z-axis.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {number} The angle in radians
+ */
+const angleZ4D = (xyzw) => Math.atan2(Math.sqrt(xyzw[3] ** 2 + xyzw[0] ** 2 + xyzw[1] ** 2), xyzw[2]);
+exports.angleZ4D = angleZ4D;

package/dist/cjs/4d/clamp-4d.d.ts

@@ -0,0 +1,10 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Clamps the magnitude of a 4D vector between min and max.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @param {number} min - Minimum magnitude
+ * @param {number} max - Maximum magnitude
+ * @param {number} [m] - Optional current magnitude (default: `magnitude4D(xyzw)`)
+ * @returns {ArrayVector4D} The clamped vector
+ */
+export declare const clamp4D: (xyzw: ArrayVector4D, min: number, max: number, m?: number) => ArrayVector4D;

package/dist/cjs/4d/clamp-4d.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clamp4D = void 0;
+const magnitude_4d_js_1 = require("./magnitude-4d.js");
+/**
+ * Clamps the magnitude of a 4D vector between min and max.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @param {number} min - Minimum magnitude
+ * @param {number} max - Maximum magnitude
+ * @param {number} [m] - Optional current magnitude (default: `magnitude4D(xyzw)`)
+ * @returns {ArrayVector4D} The clamped vector
+ */
+const clamp4D = (xyzw, min, max, m = (0, magnitude_4d_js_1.magnitude4D)(xyzw)) => m > max
+    ? [(xyzw[0] / m) * max, (xyzw[1] / m) * max, (xyzw[2] / m) * max, (xyzw[3] / m) * max]
+    : m < min
+        ? [(xyzw[0] / m) * min, (xyzw[1] / m) * min, (xyzw[2] / m) * min, (xyzw[3] / m) * min]
+        : xyzw;
+exports.clamp4D = clamp4D;

package/dist/cjs/4d/clone-4d.d.ts

@@ -0,0 +1,7 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Clone a 4D vector.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {ArrayVector4D} The cloned vector
+ */
+export declare const clone4D: (xyzw: ArrayVector4D) => ArrayVector4D;

package/dist/cjs/4d/clone-4d.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clone4D = void 0;
+/**
+ * Clone a 4D vector.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {ArrayVector4D} The cloned vector
+ */
+const clone4D = (xyzw) => [xyzw[0], xyzw[1], xyzw[2], xyzw[3]];
+exports.clone4D = clone4D;

package/dist/cjs/4d/distance-4d.d.ts

@@ -0,0 +1,8 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the Euclidean distance between two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {number} The distance
+ */
+export declare const distance4D: (xyzw1: ArrayVector4D, xyzw2: ArrayVector4D) => number;

package/dist/cjs/4d/distance-4d.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distance4D = void 0;
+/**
+ * Calculates the Euclidean distance between two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {number} The distance
+ */
+const distance4D = (xyzw1, xyzw2) => Math.sqrt((xyzw1[0] - xyzw2[0]) ** 2 + (xyzw1[1] - xyzw2[1]) ** 2 + (xyzw1[2] - xyzw2[2]) ** 2 + (xyzw1[3] - xyzw2[3]) ** 2);
+exports.distance4D = distance4D;

package/dist/cjs/4d/distance-chebyshev-4d.d.ts

@@ -0,0 +1,8 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the Chebyshev distance between two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {number} The Chebyshev distance
+ */
+export declare const distanceChebyshev4D: (xyzw1: ArrayVector4D, xyzw2: ArrayVector4D) => number;

package/dist/cjs/4d/distance-chebyshev-4d.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distanceChebyshev4D = void 0;
+/**
+ * Calculates the Chebyshev distance between two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {number} The Chebyshev distance
+ */
+const distanceChebyshev4D = (xyzw1, xyzw2) => {
+    const absX = Math.abs(xyzw1[0] - xyzw2[0]);
+    const absY = Math.abs(xyzw1[1] - xyzw2[1]);
+    const absZ = Math.abs(xyzw1[2] - xyzw2[2]);
+    const absW = Math.abs(xyzw1[3] - xyzw2[3]);
+    return absX >= absY && absX >= absZ && absX >= absW
+        ? absX
+        : absY >= absZ && absY >= absW
+            ? absY
+            : absZ >= absW
+                ? absZ
+                : absW;
+};
+exports.distanceChebyshev4D = distanceChebyshev4D;

package/dist/cjs/4d/distance-manhattan-4d.d.ts

@@ -0,0 +1,8 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the Manhattan distance between two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {number} The Manhattan distance
+ */
+export declare const distanceManhattan4D: (xyzw1: ArrayVector4D, xyzw2: ArrayVector4D) => number;

package/dist/cjs/4d/distance-manhattan-4d.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distanceManhattan4D = void 0;
+/**
+ * Calculates the Manhattan distance between two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {number} The Manhattan distance
+ */
+const distanceManhattan4D = (xyzw1, xyzw2) => Math.abs(xyzw1[0] - xyzw2[0]) +
+    Math.abs(xyzw1[1] - xyzw2[1]) +
+    Math.abs(xyzw1[2] - xyzw2[2]) +
+    Math.abs(xyzw1[3] - xyzw2[3]);
+exports.distanceManhattan4D = distanceManhattan4D;

package/dist/cjs/4d/distance-minkowski-4d.d.ts

@@ -0,0 +1,9 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the Minkowski distance between two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @param {number} p - The order of the Minkowski distance
+ * @returns {number} The Minkowski distance
+ */
+export declare const distanceMinkowski4D: (xyzw1: ArrayVector4D, xyzw2: ArrayVector4D, p: number) => number;

package/dist/cjs/4d/distance-minkowski-4d.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distanceMinkowski4D = void 0;
+/**
+ * Calculates the Minkowski distance between two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @param {number} p - The order of the Minkowski distance
+ * @returns {number} The Minkowski distance
+ */
+const distanceMinkowski4D = (xyzw1, xyzw2, p) => (Math.abs(xyzw1[0] - xyzw2[0]) ** p +
+    Math.abs(xyzw1[1] - xyzw2[1]) ** p +
+    Math.abs(xyzw1[2] - xyzw2[2]) ** p +
+    Math.abs(xyzw1[3] - xyzw2[3]) ** p) **
+    (1 / p);
+exports.distanceMinkowski4D = distanceMinkowski4D;

package/dist/cjs/4d/distance-sq-4d.d.ts

@@ -0,0 +1,9 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the squared Euclidean distance between two 4D vectors.
+ * Faster than distance for comparisons.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {number} The squared distance
+ */
+export declare const distanceSq4D: (xyzw1: ArrayVector4D, xyzw2: ArrayVector4D) => number;

package/dist/cjs/4d/distance-sq-4d.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.distanceSq4D = void 0;
+/**
+ * Calculates the squared Euclidean distance between two 4D vectors.
+ * Faster than distance for comparisons.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {number} The squared distance
+ */
+const distanceSq4D = (xyzw1, xyzw2) => (xyzw1[0] - xyzw2[0]) ** 2 + (xyzw1[1] - xyzw2[1]) ** 2 + (xyzw1[2] - xyzw2[2]) ** 2 + (xyzw1[3] - xyzw2[3]) ** 2;
+exports.distanceSq4D = distanceSq4D;

package/dist/cjs/4d/divide-4d.d.ts

@@ -0,0 +1,8 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Divides two 4D vectors component-wise.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {ArrayVector4D} The divided vector
+ */
+export declare const divide4D: (xyzw1: ArrayVector4D, xyzw2: ArrayVector4D) => ArrayVector4D;

package/dist/cjs/4d/divide-4d.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.divide4D = void 0;
+/**
+ * Divides two 4D vectors component-wise.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {ArrayVector4D} The divided vector
+ */
+const divide4D = (xyzw1, xyzw2) => [
+    xyzw2[0] === 0 ? Number.POSITIVE_INFINITY : xyzw1[0] / xyzw2[0],
+    xyzw2[1] === 0 ? Number.POSITIVE_INFINITY : xyzw1[1] / xyzw2[1],
+    xyzw2[2] === 0 ? Number.POSITIVE_INFINITY : xyzw1[2] / xyzw2[2],
+    xyzw2[3] === 0 ? Number.POSITIVE_INFINITY : xyzw1[3] / xyzw2[3],
+];
+exports.divide4D = divide4D;

package/dist/cjs/4d/dot-4d.d.ts

@@ -0,0 +1,8 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Calculates the dot product of two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {number} The dot product
+ */
+export declare const dot4D: (xyzw1: ArrayVector4D, xyzw2: ArrayVector4D) => number;

package/dist/cjs/4d/dot-4d.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dot4D = void 0;
+/**
+ * Calculates the dot product of two 4D vectors.
+ * @param {ArrayVector4D} xyzw1 - First vector as `[x, y, z, w]`
+ * @param {ArrayVector4D} xyzw2 - Second vector as `[x, y, z, w]`
+ * @returns {number} The dot product
+ */
+const dot4D = (xyzw1, xyzw2) => xyzw1[0] * xyzw2[0] + xyzw1[1] * xyzw2[1] + xyzw1[2] * xyzw2[2] + xyzw1[3] * xyzw2[3];
+exports.dot4D = dot4D;

package/dist/cjs/4d/from-object-4d.d.ts

@@ -0,0 +1,12 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Creates a 4D vector from an object with x, y, z, w properties.
+ * @param {{ x: number; y: number; z: number; w: number }} obj - Object with x, y, z, w properties
+ * @returns {ArrayVector4D} 4D vector
+ */
+export declare const fromObject4D: ({ x, y, z, w }: {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}) => ArrayVector4D;

package/dist/cjs/4d/from-object-4d.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromObject4D = void 0;
+/**
+ * Creates a 4D vector from an object with x, y, z, w properties.
+ * @param {{ x: number; y: number; z: number; w: number }} obj - Object with x, y, z, w properties
+ * @returns {ArrayVector4D} 4D vector
+ */
+const fromObject4D = ({ x, y, z, w }) => [
+    x,
+    y,
+    z,
+    w,
+];
+exports.fromObject4D = fromObject4D;

package/dist/cjs/4d/immutable-4d.d.ts

@@ -0,0 +1,7 @@
+import type { ArrayVector4D } from "./types.js";
+/**
+ * Create an immutable 4D vector.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {Readonly<ArrayVector4D>} The immutable vector
+ */
+export declare const immutable4D: (xyzw: ArrayVector4D) => Readonly<ArrayVector4D>;

package/dist/cjs/4d/immutable-4d.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.immutable4D = void 0;
+/**
+ * Create an immutable 4D vector.
+ * @param {ArrayVector4D} xyzw - Vector as `[x, y, z, w]`
+ * @returns {Readonly<ArrayVector4D>} The immutable vector
+ */
+const immutable4D = (xyzw) => Object.freeze([xyzw[0], xyzw[1], xyzw[2], xyzw[3]]);
+exports.immutable4D = immutable4D;

package/dist/cjs/4d/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Documentation for functional 4D Vector array operations.
+ * @module ArrayVector4D
+ */
+export * from "./add-4d.js";
+export * from "./angle-between-4d.js";
+export * from "./angle-w-4d.js";
+export * from "./angle-x-4d.js";
+export * from "./angle-y-4d.js";
+export * from "./angle-z-4d.js";
+export * from "./clamp-4d.js";
+export * from "./clone-4d.js";
+export * from "./distance-4d.js";
+export * from "./distance-chebyshev-4d.js";
+export * from "./distance-manhattan-4d.js";
+export * from "./distance-minkowski-4d.js";
+export * from "./distance-sq-4d.js";
+export * from "./divide-4d.js";
+export * from "./dot-4d.js";
+export * from "./from-object-4d.js";
+export * from "./immutable-4d.js";
+export * from "./is-equal-4d.js";
+export * from "./is-equal-approx-4d.js";
+export * from "./is-infinite-4d.js";
+export * from "./is-nan-4d.js";
+export * from "./is-opposite-4d.js";
+export * from "./is-zero-4d.js";
+export * from "./lerp-4d.js";
+export * from "./limit-max-4d.js";
+export * from "./limit-min-4d.js";
+export * from "./look-at-4d.js";
+export * from "./magnitude-4d.js";
+export * from "./magnitude-sq-4d.js";
+export * from "./multiply-4d.js";
+export * from "./negate-4d.js";
+export * from "./normalize-4d.js";
+export * from "./one-4d.js";
+export * from "./project-4d.js";
+export * from "./random-4d.js";
+export * from "./reflect-4d.js";
+export * from "./set-magnitude-4d.js";
+export * from "./subtract-4d.js";
+export * from "./types.js";
+export * from "./zero-4d.js";