@fimbul-works/vec 1.0.3 → 2.0.0

package/dist/esm/3d/dot-3d.js

@@ -0,0 +1,7 @@
+/**
+ * Calculates the dot product of two 3D vectors.
+ * @param {ArrayVector3D} xyz1 - First vector as `[x, y, z]`
+ * @param {ArrayVector3D} xyz2 - Second vector as `[x, y, z]`
+ * @returns {number} Dot product
+ */
+export const dot3D = (xyz1, xyz2) => xyz1[0] * xyz2[0] + xyz1[1] * xyz2[1] + xyz1[2] * xyz2[2];

package/dist/esm/3d/from-cylindrical-coords-3d.d.ts

@@ -0,0 +1,9 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Creates a vector from cylindrical coordinates.
+ * @param {number} r - Radius
+ * @param {number} phi - Angle in radians
+ * @param {number} z - Vector z axis
+ * @returns {ArrayVector3D} Vector
+ */
+export declare const fromCylindricalCoords: (r: number, phi: number, z: number) => ArrayVector3D;

package/dist/esm/3d/from-cylindrical-coords-3d.js

@@ -0,0 +1,12 @@
+/**
+ * Creates a vector from cylindrical coordinates.
+ * @param {number} r - Radius
+ * @param {number} phi - Angle in radians
+ * @param {number} z - Vector z axis
+ * @returns {ArrayVector3D} Vector
+ */
+export const fromCylindricalCoords = (r, phi, z) => [
+    r * Math.cos(phi),
+    r * Math.sin(phi),
+    z,
+];

package/dist/esm/3d/from-object-3d.d.ts

@@ -0,0 +1,11 @@
+import type { ArrayVector3D } from "./types.js";
+/**
+ * Creates an ArrayVector3D from an object with x, y and z properties.
+ * @param {{ x: number; y: number; z: number }} vector3D - Object with x, y and z properties
+ * @returns {ArrayVector3D} Vector
+ */
+export declare const fromObject3D: ({ x, y, z }: {
+    x: number;
+    y: number;
+    z: number;
+}) => ArrayVector3D;

package/dist/esm/3d/from-object-3d.js

@@ -0,0 +1,6 @@
+/**
+ * Creates an ArrayVector3D from an object with x, y and z properties.
+ * @param {{ x: number; y: number; z: number }} vector3D - Object with x, y and z properties
+ * @returns {ArrayVector3D} Vector
+ */
+export const fromObject3D = ({ x, y, z }) => [x, y, z];

package/dist/esm/3d/from-spherical-coords-3d.d.ts

@@ -0,0 +1,9 @@
+import type { ArrayVector3D } from "./types";
+/**
+ * Creates a 3D vector from spherical coordinates.
+ * @param {number} theta - First angle
+ * @param {number} phi - Second angle
+ * @param {number} [m] - Optional magnitude (default: `1`)
+ * @returns {ArrayVector3D} Vector
+ */
+export declare const fromSphericalCoords3D: (theta: number, phi: number, m?: number) => ArrayVector3D;

package/dist/esm/3d/from-spherical-coords-3d.js

@@ -0,0 +1,12 @@
+/**
+ * Creates a 3D vector from spherical coordinates.
+ * @param {number} theta - First angle
+ * @param {number} phi - Second angle
+ * @param {number} [m] - Optional magnitude (default: `1`)
+ * @returns {ArrayVector3D} Vector
+ */
+export const fromSphericalCoords3D = (theta, phi, m = 1) => [
+    m * Math.sin(theta) * Math.cos(phi),
+    m * Math.sin(theta) * Math.sin(phi),
+    m * Math.cos(theta),
+];

package/dist/esm/3d/immutable-3d.d.ts

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

package/dist/esm/3d/immutable-3d.js

@@ -0,0 +1,6 @@
+/**
+ * Create an immutable 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {Readonly<ArrayVector3D>} The immutable vector
+ */
+export const immutable3D = (xyz) => Object.freeze([xyz[0], xyz[1], xyz[2]]);

package/dist/esm/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/esm/3d/index.js

@@ -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/esm/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/esm/3d/is-equal-3d.js

@@ -0,0 +1,7 @@
+/**
+ * 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 const isEqual3D = (xyz1, xyz2) => xyz1[0] === xyz2[0] && xyz1[1] === xyz2[1] && xyz1[2] === xyz2[2];

package/dist/esm/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/esm/3d/is-equal-approx-3d.js

@@ -0,0 +1,10 @@
+/**
+ * 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 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;

package/dist/esm/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/esm/3d/is-infinite-3d.js

@@ -0,0 +1,11 @@
+/**
+ * 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 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;

package/dist/esm/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/esm/3d/is-nan-3d.js

@@ -0,0 +1,6 @@
+/**
+ * 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 const isNaN3D = (xyz) => Number.isNaN(xyz[0]) || Number.isNaN(xyz[1]) || Number.isNaN(xyz[2]);

package/dist/esm/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/esm/3d/is-opposite-3d.js

@@ -0,0 +1,7 @@
+/**
+ * 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 const isOpposite3D = (xyz1, xyz2) => xyz1[0] === -xyz2[0] && xyz1[1] === -xyz2[1] && xyz1[2] === -xyz2[2];

package/dist/esm/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/esm/3d/is-zero-3d.js

@@ -0,0 +1,6 @@
+/**
+ * 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 const isZero3D = (xyz) => xyz[0] === 0 && xyz[1] === 0 && xyz[2] === 0;

package/dist/esm/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/esm/3d/lerp-3d.js

@@ -0,0 +1,12 @@
+/**
+ * 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 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,
+];

package/dist/esm/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/esm/3d/limit-max-3d.js

@@ -0,0 +1,9 @@
+import { magnitude3D } from "./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
+ */
+export const limitMax3D = (xyz, max, m = magnitude3D(xyz)) => m > max ? [(xyz[0] / m) * max, (xyz[1] / m) * max, (xyz[2] / m) * max] : xyz;

package/dist/esm/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/esm/3d/limit-min-3d.js

@@ -0,0 +1,9 @@
+import { magnitude3D } from "./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
+ */
+export const limitMin3D = (xyz, min, m = magnitude3D(xyz)) => m < min ? [(xyz[0] / m) * min, (xyz[1] / m) * min, (xyz[2] / m) * min] : xyz;

package/dist/esm/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/esm/3d/look-at-3d.js

@@ -0,0 +1,10 @@
+import { magnitude3D } from "./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
+ */
+export const lookAt3D = (xyz1, xyz2, m1 = magnitude3D(xyz1), m2 = magnitude3D(xyz2)) => [(xyz2[0] / m2) * m1, (xyz2[1] / m2) * m1, (xyz2[2] / m2) * m1];

package/dist/esm/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/esm/3d/magnitude-3d.js

@@ -0,0 +1,6 @@
+/**
+ * Calculates the magnitude of a 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {number} Magnitude of the vector
+ */
+export const magnitude3D = (xyz) => Math.sqrt(xyz[0] ** 2 + xyz[1] ** 2 + xyz[2] ** 2);

package/dist/esm/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/esm/3d/magnitude-sq-3d.js

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

package/dist/esm/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/esm/3d/multiply-3d.js

@@ -0,0 +1,11 @@
+/**
+ * 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 const multiply3D = (xyz1, xyz2) => [
+    xyz1[0] * xyz2[0],
+    xyz1[1] * xyz2[1],
+    xyz1[2] * xyz2[2],
+];

package/dist/esm/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/esm/3d/negate-3d.js

@@ -0,0 +1,6 @@
+/**
+ * Negates a 3D vector.
+ * @param {ArrayVector3D} xyz - Vector as `[x, y, z]`
+ * @returns {ArrayVector3D} The negated vector
+ */
+export const negate3D = (xyz) => [-xyz[0], -xyz[1], -xyz[2]];

package/dist/esm/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/esm/3d/normalize-3d.js

@@ -0,0 +1,8 @@
+import { magnitude3D } from "./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
+ */
+export const normalize3D = (xyz, m = magnitude3D(xyz)) => m === 0 ? [0, 0, 0] : [xyz[0] / m, xyz[1] / m, xyz[2] / m];

package/dist/esm/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/esm/3d/one-3d.js

@@ -0,0 +1,5 @@
+/**
+ * Creates a 3D vector with all components to to 1.0.
+ * @returns {ArrayVector3D} Vector `[1, 1, 1]`
+ */
+export const one3D = () => [1, 1, 1];

package/dist/esm/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/esm/3d/project-3d.js

@@ -0,0 +1,13 @@
+import { magnitude3D } from "./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
+ */
+export const project3D = (xyz1, xyz2, m1 = magnitude3D(xyz1), m2 = 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];
+};

package/dist/esm/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/esm/3d/random-3d.js

@@ -0,0 +1,7 @@
+import { fromSphericalCoords3D } from "./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
+ */
+export const random3D = (random = Math.random) => fromSphericalCoords3D(Math.acos(2 * random() - 1), random() * Math.PI * 2, 1);

package/dist/esm/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/esm/3d/reflect-3d.js

@@ -0,0 +1,12 @@
+import { dot3D } from "./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
+ */
+export const reflect3D = (xyz, normal) => {
+    const dot = dot3D(xyz, normal);
+    return [xyz[0] - 2 * dot * normal[0], xyz[1] - 2 * dot * normal[1], xyz[2] - 2 * dot * normal[2]];
+};

package/dist/esm/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/esm/3d/rotate-x-3d.js

@@ -0,0 +1,22 @@
+/**
+ * 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 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]];
+};

package/dist/esm/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;