@fimbul-works/vec 1.0.3 → 2.0.0

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

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

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

@@ -0,0 +1,65 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Documentation for functional 3D Vector array operations.
+ * @module ArrayVector3D
+ */
+__exportStar(require("./add-3d.js"), exports);
+__exportStar(require("./angle-between-3d.js"), exports);
+__exportStar(require("./angle-x-3d.js"), exports);
+__exportStar(require("./angle-y-3d.js"), exports);
+__exportStar(require("./angle-z-3d.js"), exports);
+__exportStar(require("./clamp-3d.js"), exports);
+__exportStar(require("./clone-3d.js"), exports);
+__exportStar(require("./cross-3d.js"), exports);
+__exportStar(require("./distance-3d.js"), exports);
+__exportStar(require("./distance-chebyshev-3d.js"), exports);
+__exportStar(require("./distance-manhattan-3d.js"), exports);
+__exportStar(require("./distance-minkowski-3d.js"), exports);
+__exportStar(require("./distance-sq-3d.js"), exports);
+__exportStar(require("./divide-3d.js"), exports);
+__exportStar(require("./dot-3d.js"), exports);
+__exportStar(require("./from-cylindrical-coords-3d.js"), exports);
+__exportStar(require("./from-object-3d.js"), exports);
+__exportStar(require("./from-spherical-coords-3d.js"), exports);
+__exportStar(require("./immutable-3d.js"), exports);
+__exportStar(require("./is-equal-3d.js"), exports);
+__exportStar(require("./is-equal-approx-3d.js"), exports);
+__exportStar(require("./is-infinite-3d.js"), exports);
+__exportStar(require("./is-nan-3d.js"), exports);
+__exportStar(require("./is-opposite-3d.js"), exports);
+__exportStar(require("./is-zero-3d.js"), exports);
+__exportStar(require("./lerp-3d.js"), exports);
+__exportStar(require("./limit-max-3d.js"), exports);
+__exportStar(require("./limit-min-3d.js"), exports);
+__exportStar(require("./look-at-3d.js"), exports);
+__exportStar(require("./magnitude-3d.js"), exports);
+__exportStar(require("./magnitude-sq-3d.js"), exports);
+__exportStar(require("./multiply-3d.js"), exports);
+__exportStar(require("./negate-3d.js"), exports);
+__exportStar(require("./normalize-3d.js"), exports);
+__exportStar(require("./one-3d.js"), exports);
+__exportStar(require("./project-3d.js"), exports);
+__exportStar(require("./random-3d.js"), exports);
+__exportStar(require("./reflect-3d.js"), exports);
+__exportStar(require("./rotate-x-3d.js"), exports);
+__exportStar(require("./rotate-y-3d.js"), exports);
+__exportStar(require("./rotate-z-3d.js"), exports);
+__exportStar(require("./set-magnitude-3d.js"), exports);
+__exportStar(require("./subtract-3d.js"), exports);
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./zero-3d.js"), exports);

package/dist/cjs/3d/is-equal-3d.d.ts

@@ -0,0 +1,8 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Checks if two 3D vectors are equal.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @returns {ArrayVector3D} `true` if the vectors are equal, `false` otherwise
+ */
+export declare const isEqual3D: (xyz1: ArrayVector3D, xyz2: ArrayVector3D) => boolean;

package/dist/cjs/3d/is-equal-3d.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEqual3D = void 0;
+/**
+ * Checks if two 3D vectors are equal.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @returns {ArrayVector3D} `true` if the vectors are equal, `false` otherwise
+ */
+const isEqual3D = (xyz1, xyz2) => xyz1[0] === xyz2[0] && xyz1[1] === xyz2[1] && xyz1[2] === xyz2[2];
+exports.isEqual3D = isEqual3D;

package/dist/cjs/3d/is-equal-approx-3d.d.ts

@@ -0,0 +1,9 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Compares two 3D vectors using an epsilon value for floating-point comparison.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @param {number} epsilon - Tolerance for comparison (default: `Number.EPSILON`)
+ * @returns {boolean} `true` if the vectors are approximately equal, `false` otherwise
+ */
+export declare const isEqualApprox3D: (xyz1: ArrayVector3D, xyz2: ArrayVector3D, epsilon?: number) => boolean;

package/dist/cjs/3d/is-equal-approx-3d.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEqualApprox3D = void 0;
+/**
+ * Compares two 3D vectors using an epsilon value for floating-point comparison.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @param {number} epsilon - Tolerance for comparison (default: `Number.EPSILON`)
+ * @returns {boolean} `true` if the vectors are approximately equal, `false` otherwise
+ */
+const isEqualApprox3D = (xyz1, xyz2, epsilon = Number.EPSILON) => Math.abs(xyz1[0] - xyz2[0]) <= epsilon &&
+    Math.abs(xyz1[1] - xyz2[1]) <= epsilon &&
+    Math.abs(xyz1[2] - xyz2[2]) <= epsilon;
+exports.isEqualApprox3D = isEqualApprox3D;

package/dist/cjs/3d/is-infinite-3d.d.ts

@@ -0,0 +1,7 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Checks if a vector has infinite components.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {boolean} `true` if the vector has infinite components, `false` otherwise
+ */
+export declare const isInfinite3D: (xyz: ArrayVector3D) => boolean;

package/dist/cjs/3d/is-infinite-3d.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isInfinite3D = void 0;
+/**
+ * Checks if a vector has infinite components.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {boolean} `true` if the vector has infinite components, `false` otherwise
+ */
+const isInfinite3D = (xyz) => xyz[0] === Number.POSITIVE_INFINITY ||
+    xyz[0] === Number.NEGATIVE_INFINITY ||
+    xyz[1] === Number.POSITIVE_INFINITY ||
+    xyz[1] === Number.NEGATIVE_INFINITY ||
+    xyz[2] === Number.POSITIVE_INFINITY ||
+    xyz[2] === Number.NEGATIVE_INFINITY;
+exports.isInfinite3D = isInfinite3D;

package/dist/cjs/3d/is-nan-3d.d.ts

@@ -0,0 +1,7 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Checks if a 3D vector has NaN components.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {boolean} `true` if the vector has `NaN` components, `false` otherwise.
+ */
+export declare const isNaN3D: (xyz: ArrayVector3D) => boolean;

package/dist/cjs/3d/is-nan-3d.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNaN3D = void 0;
+/**
+ * Checks if a 3D vector has NaN components.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {boolean} `true` if the vector has `NaN` components, `false` otherwise.
+ */
+const isNaN3D = (xyz) => Number.isNaN(xyz[0]) || Number.isNaN(xyz[1]) || Number.isNaN(xyz[2]);
+exports.isNaN3D = isNaN3D;

package/dist/cjs/3d/is-opposite-3d.d.ts

@@ -0,0 +1,8 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Checks if two 3D vectors are opposite.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @returns {boolean} `true` if the vectors are opposite, `false` otherwise
+ */
+export declare const isOpposite3D: (xyz1: ArrayVector3D, xyz2: ArrayVector3D) => boolean;

package/dist/cjs/3d/is-opposite-3d.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOpposite3D = void 0;
+/**
+ * Checks if two 3D vectors are opposite.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @returns {boolean} `true` if the vectors are opposite, `false` otherwise
+ */
+const isOpposite3D = (xyz1, xyz2) => xyz1[0] === -xyz2[0] && xyz1[1] === -xyz2[1] && xyz1[2] === -xyz2[2];
+exports.isOpposite3D = isOpposite3D;

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

@@ -0,0 +1,7 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Checks if a 3D vector is zero.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {boolean} `true` if the vector is zero, `false` otherwise
+ */
+export declare const isZero3D: (xyz: ArrayVector3D) => boolean;

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isZero3D = void 0;
+/**
+ * Checks if a 3D vector is zero.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {boolean} `true` if the vector is zero, `false` otherwise
+ */
+const isZero3D = (xyz) => xyz[0] === 0 && xyz[1] === 0 && xyz[2] === 0;
+exports.isZero3D = isZero3D;

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

@@ -0,0 +1,9 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Performs linear interpolation between two vectors.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @param {number} t - Interpolation parameter
+ * @returns {ArrayVector3D} The interpolated vector
+ */
+export declare const lerp3D: (xyz1: ArrayVector3D, xyz2: ArrayVector3D, t: number) => ArrayVector3D;

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lerp3D = void 0;
+/**
+ * Performs linear interpolation between two vectors.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @param {number} t - Interpolation parameter
+ * @returns {ArrayVector3D} The interpolated vector
+ */
+const lerp3D = (xyz1, xyz2, t) => [
+    xyz1[0] + (xyz2[0] - xyz1[0]) * t,
+    xyz1[1] + (xyz2[1] - xyz1[1]) * t,
+    xyz1[2] + (xyz2[2] - xyz1[2]) * t,
+];
+exports.lerp3D = lerp3D;

package/dist/cjs/3d/limit-max-3d.d.ts

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

package/dist/cjs/3d/limit-max-3d.js

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

package/dist/cjs/3d/limit-min-3d.d.ts

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

package/dist/cjs/3d/limit-min-3d.js

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

package/dist/cjs/3d/look-at-3d.d.ts

@@ -0,0 +1,10 @@
+import type { ArrayVector3D } from "./types.js";
+/**
+ * Creates a vector pointing from the first vector to the second vector, maintaining the magnitude of the first vector.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]` (source direction)
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]` (target direction)
+ * @param {number} [m1] - Optional current magnitude of the first vector (default: `magnitude3D(xyz1)`)
+ * @param {number} [m2] - Optional current magnitude of the second vector (default: `magnitude3D(xyz2)`)
+ * @returns {ArrayVector3D} The look-at vector
+ */
+export declare const lookAt3D: (xyz1: ArrayVector3D, xyz2: ArrayVector3D, m1?: number, m2?: number) => ArrayVector3D;

package/dist/cjs/3d/look-at-3d.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookAt3D = void 0;
+const magnitude_3d_js_1 = require("./magnitude-3d.js");
+/**
+ * Creates a vector pointing from the first vector to the second vector, maintaining the magnitude of the first vector.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]` (source direction)
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]` (target direction)
+ * @param {number} [m1] - Optional current magnitude of the first vector (default: `magnitude3D(xyz1)`)
+ * @param {number} [m2] - Optional current magnitude of the second vector (default: `magnitude3D(xyz2)`)
+ * @returns {ArrayVector3D} The look-at vector
+ */
+const lookAt3D = (xyz1, xyz2, m1 = (0, magnitude_3d_js_1.magnitude3D)(xyz1), m2 = (0, magnitude_3d_js_1.magnitude3D)(xyz2)) => [(xyz2[0] / m2) * m1, (xyz2[1] / m2) * m1, (xyz2[2] / m2) * m1];
+exports.lookAt3D = lookAt3D;

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

@@ -0,0 +1,7 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Calculates the magnitude of a 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {number} Magnitude of the vector
+ */
+export declare const magnitude3D: (xyz: ArrayVector3D) => number;

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.magnitude3D = void 0;
+/**
+ * Calculates the magnitude of a 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {number} Magnitude of the vector
+ */
+const magnitude3D = (xyz) => Math.sqrt(xyz[0] ** 2 + xyz[1] ** 2 + xyz[2] ** 2);
+exports.magnitude3D = magnitude3D;

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

@@ -0,0 +1,7 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Calculate the squared magnitude of a 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {number} Squared magnitude
+ */
+export declare const magnitudeSq3D: (xyz: ArrayVector3D) => number;

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.magnitudeSq3D = void 0;
+/**
+ * Calculate the squared magnitude of a 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {number} Squared magnitude
+ */
+const magnitudeSq3D = (xyz) => xyz[0] ** 2 + xyz[1] ** 2 + xyz[2] ** 2;
+exports.magnitudeSq3D = magnitudeSq3D;

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

@@ -0,0 +1,8 @@
+import type { ArrayVector3D } from "./types.js";
+/**
+ * Multiplies one 3D vector with another component-wise.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @returns {ArrayVector3D} The multiplied value
+ */
+export declare const multiply3D: (xyz1: ArrayVector3D, xyz2: ArrayVector3D) => ArrayVector3D;

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.multiply3D = void 0;
+/**
+ * Multiplies one 3D vector with another component-wise.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @returns {ArrayVector3D} The multiplied value
+ */
+const multiply3D = (xyz1, xyz2) => [
+    xyz1[0] * xyz2[0],
+    xyz1[1] * xyz2[1],
+    xyz1[2] * xyz2[2],
+];
+exports.multiply3D = multiply3D;

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

@@ -0,0 +1,7 @@
+import type { ArrayVector3D } from "./types.js";
+/**
+ * Negates a 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {ArrayVector3D} The negated vector
+ */
+export declare const negate3D: (xyz: ArrayVector3D) => ArrayVector3D;

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.negate3D = void 0;
+/**
+ * Negates a 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {ArrayVector3D} The negated vector
+ */
+const negate3D = (xyz) => [-xyz[0], -xyz[1], -xyz[2]];
+exports.negate3D = negate3D;

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

@@ -0,0 +1,8 @@
+import type { ArrayVector3D } from "./types.js";
+/**
+ * Normalize a 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @param {number} [m] - Optional current magnitude (default: `magnitude3D(xyz)`)
+ * @returns {ArrayVector3D} The normalized vector
+ */
+export declare const normalize3D: (xyz: ArrayVector3D, m?: number) => ArrayVector3D;

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

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalize3D = void 0;
+const magnitude_3d_js_1 = require("./magnitude-3d.js");
+/**
+ * Normalize a 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @param {number} [m] - Optional current magnitude (default: `magnitude3D(xyz)`)
+ * @returns {ArrayVector3D} The normalized vector
+ */
+const normalize3D = (xyz, m = (0, magnitude_3d_js_1.magnitude3D)(xyz)) => m === 0 ? [0, 0, 0] : [xyz[0] / m, xyz[1] / m, xyz[2] / m];
+exports.normalize3D = normalize3D;

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

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

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

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

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

@@ -0,0 +1,10 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Projects one 3D vector onto the second.
+ * @param {ArrayVector3D} xyz1 - Vector to project
+ * @param {ArrayVector3D} xyz2 - Vector to project onto
+ * @param {number} [m1] - Optional magnitude of the vector to project (default: `magnitude3D(xyz1)`)
+ * @param {number} [m2] - Optional magnitude of the vector to project onto (default: `magnitude3D(xyz2)`)
+ * @returns {ArrayVector3D} The projected vector
+ */
+export declare const project3D: (xyz1: ArrayVector3D, xyz2: ArrayVector3D, m1?: number, m2?: number) => ArrayVector3D;

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.project3D = void 0;
+const magnitude_3d_1 = require("./magnitude-3d");
+/**
+ * Projects one 3D vector onto the second.
+ * @param {ArrayVector3D} xyz1 - Vector to project
+ * @param {ArrayVector3D} xyz2 - Vector to project onto
+ * @param {number} [m1] - Optional magnitude of the vector to project (default: `magnitude3D(xyz1)`)
+ * @param {number} [m2] - Optional magnitude of the vector to project onto (default: `magnitude3D(xyz2)`)
+ * @returns {ArrayVector3D} The projected vector
+ */
+const project3D = (xyz1, xyz2, m1 = (0, magnitude_3d_1.magnitude3D)(xyz1), m2 = (0, magnitude_3d_1.magnitude3D)(xyz2)) => {
+    const f = m1 * Math.cos(Math.acos((xyz1[0] * xyz2[0] + xyz1[1] * xyz2[1] + xyz1[2] * xyz2[2]) / (m1 * m2)));
+    return [(xyz2[0] / m2) * f, (xyz2[1] / m2) * f, (xyz2[2] / m2) * f];
+};
+exports.project3D = project3D;

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

@@ -0,0 +1,7 @@
+import type { ArrayVector3D } from "./types.js";
+/**
+ * Creates a random unit 3D vector.
+ * @param {() => number} random - A function that returns a random number between 0 and 1 (default: `Math.random`)
+ * @returns {ArrayVector3D} Random unit vector
+ */
+export declare const random3D: (random?: () => number) => ArrayVector3D;

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

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.random3D = void 0;
+const from_spherical_coords_3d_js_1 = require("./from-spherical-coords-3d.js");
+/**
+ * Creates a random unit 3D vector.
+ * @param {() => number} random - A function that returns a random number between 0 and 1 (default: `Math.random`)
+ * @returns {ArrayVector3D} Random unit vector
+ */
+const random3D = (random = Math.random) => (0, from_spherical_coords_3d_js_1.fromSphericalCoords3D)(Math.acos(2 * random() - 1), random() * Math.PI * 2, 1);
+exports.random3D = random3D;

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

@@ -0,0 +1,9 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Reflects a vector across a normal vector.
+ * The normal vector should be normalized (unit length).
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]` to reflect
+ * @param {ArrayVector3D} normal - Normal vector to reflect across (must be normalized)
+ * @returns {ArrayVector3D} The reflected vector
+ */
+export declare const reflect3D: (xyz: ArrayVector3D, normal: ArrayVector3D) => ArrayVector3D;

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reflect3D = void 0;
+const dot_3d_1 = require("./dot-3d");
+/**
+ * Reflects a vector across a normal vector.
+ * The normal vector should be normalized (unit length).
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]` to reflect
+ * @param {ArrayVector3D} normal - Normal vector to reflect across (must be normalized)
+ * @returns {ArrayVector3D} The reflected vector
+ */
+const reflect3D = (xyz, normal) => {
+    const dot = (0, dot_3d_1.dot3D)(xyz, normal);
+    return [xyz[0] - 2 * dot * normal[0], xyz[1] - 2 * dot * normal[1], xyz[2] - 2 * dot * normal[2]];
+};
+exports.reflect3D = reflect3D;

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

@@ -0,0 +1,9 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Rotates a 3D vector around the x-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 rotateX3D: (xyz: ArrayVector3D, phi: number, axis?: ArrayVector3D) => ArrayVector3D;

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rotateX3D = void 0;
+/**
+ * Rotates a 3D vector around the x-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 rotateX3D = (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], xyz[1] * cosPhi - xyz[2] * sinPhi, xyz[1] * sinPhi + xyz[2] * cosPhi];
+    }
+    // Translate point to origin (relative to axis)
+    const translatedY = xyz[1] - axis[1];
+    const translatedZ = xyz[2] - axis[2];
+    // Rotate around origin
+    const rotatedY = translatedY * cosPhi - translatedZ * sinPhi;
+    const rotatedZ = translatedY * sinPhi + translatedZ * cosPhi;
+    // Translate back
+    return [xyz[0], rotatedY + axis[1], rotatedZ + axis[2]];
+};
+exports.rotateX3D = rotateX3D;

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

@@ -0,0 +1,9 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * 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
+ */
+export declare const rotateY3D: (xyz: ArrayVector3D, phi: number, axis?: ArrayVector3D) => ArrayVector3D;