@thi.ng/matrices 2.2.12 → 2.2.14

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-12-09T19:12:03Z
+- **Last updated**: 2023-12-11T10:07:09Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -82,7 +82,7 @@ For Node.js REPL:
 const matrices = await import("@thi.ng/matrices");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 5.11 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 5.07 KB
 
 ## Dependencies
 

package/add.js

@@ -1,15 +1,12 @@
 import { add as _add, add4 } from "@thi.ng/vectors/add";
 import { defMath } from "./compile/emit.js";
-/**
- * Componentwise matrix addition. If `out` is not given, writes result
- * in `a`. Both input matrices MUST be of same size.
- *
- * out = a + b
- *
- * @param out -
- * @param a -
- * @param b -
- */
-export const add = _add;
-export const add22 = add4;
-export const [add23, add33, add44] = defMath(add, "+");
+const add = _add;
+const add22 = add4;
+const [add23, add33, add44] = defMath(add, "+");
+export {
+  add,
+  add22,
+  add23,
+  add33,
+  add44
+};

package/addn.js

@@ -1,15 +1,12 @@
 import { addN as _addN, addN4 } from "@thi.ng/vectors/addn";
 import { defMathN } from "./compile/emit.js";
-/**
- * Adds single scalar componentwise to matrix. If `out` is not given,
- * writes result in `mat`.
- *
- * out = mat + n
- *
- * @param out -
- * @param mat -
- * @param n -
- */
-export const addN = _addN;
-export const addN22 = addN4;
-export const [addN23, addN33, addN44] = defMathN(addN, "+");
+const addN = _addN;
+const addN22 = addN4;
+const [addN23, addN33, addN44] = defMathN(addN, "+");
+export {
+  addN,
+  addN22,
+  addN23,
+  addN33,
+  addN44
+};

package/alignment-quat.js

@@ -3,20 +3,14 @@ import { dot3 } from "@thi.ng/vectors/dot";
 import { mag } from "@thi.ng/vectors/mag";
 import { normalize3 } from "@thi.ng/vectors/normalize";
 import { quatFromAxisAngle } from "./quat-axis-angle.js";
-/**
- * Returns quaternion describing the rotation from direction vector
- * `from` -> `to`. If `normalize` is true (default), first normalizes
- * the vectors (not modifying original).
- *
- * @param from -
- * @param to -
- * @param normalize -
- */
-export const alignmentQuat = (from, to, normalize = true) => {
-    if (normalize) {
-        from = normalize3([], from);
-        to = normalize3([], to);
-    }
-    const axis = cross3([], from, to);
-    return quatFromAxisAngle(axis, Math.atan2(mag(axis), dot3(from, to)));
+const alignmentQuat = (from, to, normalize = true) => {
+  if (normalize) {
+    from = normalize3([], from);
+    to = normalize3([], to);
+  }
+  const axis = cross3([], from, to);
+  return quatFromAxisAngle(axis, Math.atan2(mag(axis), dot3(from, to)));
+};
+export {
+  alignmentQuat
 };

package/api.js

@@ -1 +0,0 @@
-export {};

package/column.js

@@ -1,15 +1,23 @@
 import { setS2, setS3, setS4 } from "@thi.ng/vectors/sets";
 import { vop } from "@thi.ng/vectors/vop";
-/**
- * Extracts column vector from given matrix and writes result to `out`.
- * If `out` is null, creates new vector.
- *
- * @param out -
- * @param mat -
- * @param column -
- */
-export const column = vop(1);
-export const column22 = column.add(4, (out, m, n) => setS2(out, m, 0, n * 2));
-export const column23 = column.add(6, column22);
-export const column33 = column.add(9, (out, m, n) => setS3(out, m, 0, n * 3));
-export const column44 = column.add(16, (out, m, n) => setS4(out, m, 0, n * 4));
+const column = vop(1);
+const column22 = column.add(
+  4,
+  (out, m, n) => setS2(out, m, 0, n * 2)
+);
+const column23 = column.add(6, column22);
+const column33 = column.add(
+  9,
+  (out, m, n) => setS3(out, m, 0, n * 3)
+);
+const column44 = column.add(
+  16,
+  (out, m, n) => setS4(out, m, 0, n * 4)
+);
+export {
+  column,
+  column22,
+  column23,
+  column33,
+  column44
+};

package/compile/emit.js

@@ -1,5 +1,22 @@
 import { compile } from "@thi.ng/vectors/compile/emit";
-import { ARGS_VN, ARGS_VV, DEFAULT_OUT, MATH, MATH_N, } from "@thi.ng/vectors/compile/templates";
+import {
+  ARGS_VN,
+  ARGS_VV,
+  DEFAULT_OUT,
+  MATH,
+  MATH_N
+} from "@thi.ng/vectors/compile/templates";
 const DEFAULT_SIZES = [6, 9, 16];
-export const defMath = (fn, op, sizes = DEFAULT_SIZES) => sizes.map((n) => fn.add(n, compile(n, MATH(op), ARGS_VV, undefined, "o", "", DEFAULT_OUT)));
-export const defMathN = (fn, op, sizes = DEFAULT_SIZES) => sizes.map((n) => fn.add(n, compile(n, MATH_N(op), ARGS_VN, "o,a", "o", "", DEFAULT_OUT)));
+const defMath = (fn, op, sizes = DEFAULT_SIZES) => sizes.map(
+  (n) => fn.add(
+    n,
+    compile(n, MATH(op), ARGS_VV, void 0, "o", "", DEFAULT_OUT)
+  )
+);
+const defMathN = (fn, op, sizes = DEFAULT_SIZES) => sizes.map(
+  (n) => fn.add(n, compile(n, MATH_N(op), ARGS_VN, "o,a", "o", "", DEFAULT_OUT))
+);
+export {
+  defMath,
+  defMathN
+};

package/concat.js

@@ -1,12 +1,5 @@
 import { mulM } from "./mulm.js";
-/**
- * Concatenates / multiplies given matrices in left-to-right order. A
- * minimum of 2 input matrices must be given. If `out` is null, writes
- * result into `a`.
- *
- * @param out -
- * @param a -
- * @param b -
- * @param xs -
- */
-export const concat = (out, a, b, ...xs) => xs.reduce((acc, x) => mulM(acc, acc, x), mulM(out, a, b));
+const concat = (out, a, b, ...xs) => xs.reduce((acc, x) => mulM(acc, acc, x), mulM(out, a, b));
+export {
+  concat
+};

package/conjugate.js

@@ -1,2 +1,5 @@
 import { setC4 } from "@thi.ng/vectors/setc";
-export const conjugateQ = (out, a) => setC4(out || a, -a[0], -a[1], -a[2], a[3]);
+const conjugateQ = (out, a) => setC4(out || a, -a[0], -a[1], -a[2], a[3]);
+export {
+  conjugateQ
+};

package/constants.js

@@ -1,15 +1,37 @@
-export const IDENT22 = Object.freeze([1, 0, 0, 1]);
-export const IDENT23 = Object.freeze([1, 0, 0, 1, 0, 0]);
-//prettier-ignore
-export const IDENT33 = Object.freeze([
-    1, 0, 0,
-    0, 1, 0,
-    0, 0, 1
+const IDENT22 = Object.freeze([1, 0, 0, 1]);
+const IDENT23 = Object.freeze([1, 0, 0, 1, 0, 0]);
+const IDENT33 = Object.freeze([
+  1,
+  0,
+  0,
+  0,
+  1,
+  0,
+  0,
+  0,
+  1
 ]);
-//prettier-ignore
-export const IDENT44 = Object.freeze([
-    1, 0, 0, 0,
-    0, 1, 0, 0,
-    0, 0, 1, 0,
-    0, 0, 0, 1
+const IDENT44 = Object.freeze([
+  1,
+  0,
+  0,
+  0,
+  0,
+  1,
+  0,
+  0,
+  0,
+  0,
+  1,
+  0,
+  0,
+  0,
+  0,
+  1
 ]);
+export {
+  IDENT22,
+  IDENT23,
+  IDENT33,
+  IDENT44
+};

package/determinant.js

@@ -1,32 +1,56 @@
 import { dotC4, dotC6 } from "@thi.ng/vectors/dotc";
 const dp4 = dotC4;
 const dp6 = dotC6;
-export const det22 = (m) => dp4(m[0], m[3], -m[1], m[2]);
-export const det23 = det22;
-export const det33 = (m) => {
-    const [m00, m01, m02, m10, m11, m12, m20, m21, m22] = m;
-    const d01 = dp4(m22, m11, -m12, m21);
-    const d11 = dp4(m12, m20, -m22, m10);
-    const d21 = dp4(m21, m10, -m11, m20);
-    return dp6(m00, d01, m01, d11, m02, d21);
+const det22 = (m) => dp4(m[0], m[3], -m[1], m[2]);
+const det23 = det22;
+const det33 = (m) => {
+  const [m00, m01, m02, m10, m11, m12, m20, m21, m22] = m;
+  const d01 = dp4(m22, m11, -m12, m21);
+  const d11 = dp4(m12, m20, -m22, m10);
+  const d21 = dp4(m21, m10, -m11, m20);
+  return dp6(m00, d01, m01, d11, m02, d21);
 };
-export const detCoeffs44 = (m) => {
-    const [m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33,] = m;
-    return [
-        dp4(m00, m11, -m01, m10),
-        dp4(m00, m12, -m02, m10),
-        dp4(m00, m13, -m03, m10),
-        dp4(m01, m12, -m02, m11),
-        dp4(m01, m13, -m03, m11),
-        dp4(m02, m13, -m03, m12),
-        dp4(m20, m31, -m21, m30),
-        dp4(m20, m32, -m22, m30),
-        dp4(m20, m33, -m23, m30),
-        dp4(m21, m32, -m22, m31),
-        dp4(m21, m33, -m23, m31),
-        dp4(m22, m33, -m23, m32),
-    ];
+const detCoeffs44 = (m) => {
+  const [
+    m00,
+    m01,
+    m02,
+    m03,
+    m10,
+    m11,
+    m12,
+    m13,
+    m20,
+    m21,
+    m22,
+    m23,
+    m30,
+    m31,
+    m32,
+    m33
+  ] = m;
+  return [
+    dp4(m00, m11, -m01, m10),
+    dp4(m00, m12, -m02, m10),
+    dp4(m00, m13, -m03, m10),
+    dp4(m01, m12, -m02, m11),
+    dp4(m01, m13, -m03, m11),
+    dp4(m02, m13, -m03, m12),
+    dp4(m20, m31, -m21, m30),
+    dp4(m20, m32, -m22, m30),
+    dp4(m20, m33, -m23, m30),
+    dp4(m21, m32, -m22, m31),
+    dp4(m21, m33, -m23, m31),
+    dp4(m22, m33, -m23, m32)
+  ];
+};
+const det44FromCoeffs = (d) => dp6(d[0], d[11], -d[1], d[10], d[2], d[9]) + dp6(d[3], d[8], -d[4], d[7], d[5], d[6]);
+const det44 = (m) => det44FromCoeffs(detCoeffs44(m));
+export {
+  det22,
+  det23,
+  det33,
+  det44,
+  det44FromCoeffs,
+  detCoeffs44
 };
-export const det44FromCoeffs = (d) => dp6(d[0], d[11], -d[1], d[10], d[2], d[9]) +
-    dp6(d[3], d[8], -d[4], d[7], d[5], d[6]);
-export const det44 = (m) => det44FromCoeffs(detCoeffs44(m));

package/diag.js

@@ -1,13 +1,14 @@
 import { setS2, setS3, setS4 } from "@thi.ng/vectors/sets";
 import { vop } from "@thi.ng/vectors/vop";
-/**
- * Extracts matrix diagonal into `out`.
- *
- * @param out -
- * @param mat -
- */
-export const diag = vop(1);
-export const diag22 = diag.add(4, (out, m) => setS2(out, m, 0, 0, 1, 3));
-export const diag23 = diag.add(6, diag22);
-export const diag33 = diag.add(9, (out, m) => setS3(out, m, 0, 0, 1, 4));
-export const diag44 = diag.add(16, (out, m) => setS4(out, m, 0, 0, 1, 5));
+const diag = vop(1);
+const diag22 = diag.add(4, (out, m) => setS2(out, m, 0, 0, 1, 3));
+const diag23 = diag.add(6, diag22);
+const diag33 = diag.add(9, (out, m) => setS3(out, m, 0, 0, 1, 4));
+const diag44 = diag.add(16, (out, m) => setS4(out, m, 0, 0, 1, 5));
+export {
+  diag,
+  diag22,
+  diag23,
+  diag33,
+  diag44
+};

package/div.js

@@ -1,15 +1,12 @@
 import { div as _div, div4 } from "@thi.ng/vectors/div";
 import { defMath } from "./compile/emit.js";
-/**
- * Componentwise matrix division. If `out` is not given, writes result
- * in `a`. Both input matrices MUST be of same size.
- *
- * out = a / b
- *
- * @param out -
- * @param a -
- * @param b -
- */
-export const div = _div;
-export const div22 = div4;
-export const [div23, div33, div44] = defMath(div, "/");
+const div = _div;
+const div22 = div4;
+const [div23, div33, div44] = defMath(div, "/");
+export {
+  div,
+  div22,
+  div23,
+  div33,
+  div44
+};

package/divn.js

@@ -1,15 +1,12 @@
 import { divN as _divN, divN4 } from "@thi.ng/vectors/divn";
 import { defMathN } from "./compile/emit.js";
-/**
- * Componentwise matrix division by single scalar. If `out` is not
- * given, writes result in `mat`.
- *
- * out = mat / n
- *
- * @param out -
- * @param mat -
- * @param n -
- */
-export const divN = _divN;
-export const divN22 = divN4;
-export const [divN23, divN33, divN44] = defMathN(divN, "/");
+const divN = _divN;
+const divN22 = divN4;
+const [divN23, divN33, divN44] = defMathN(divN, "/");
+export {
+  divN,
+  divN22,
+  divN23,
+  divN33,
+  divN44
+};

package/fit.js

@@ -4,27 +4,19 @@ import { safeDiv2, safeDiv3 } from "@thi.ng/vectors/safe-div";
 import { concat } from "./concat.js";
 import { scale23, scale44 } from "./scale.js";
 import { translation23, translation44 } from "./translation.js";
-/**
- * Creates a 2x3 matrix which maps coordinates from a 2D source rect (defined by
- * `srcPos` and `srcSize`) to a destination rect (`destPos` & `destSize`).
- * Writes result matrix to `out` or creates new matrix if `out` is null.
- *
- * @param out
- * @param srcPos
- * @param srcSize
- * @param destPos
- * @param destSize
- */
-export const fit23 = (out, srcPos, srcSize, destPos, destSize) => concat(out, translation23(null, maddN2([], destSize, 0.5, destPos)), scale23(null, safeDiv2([], destSize, srcSize)), translation23(null, mulN2(null, maddN2([], srcSize, 0.5, srcPos), -1)));
-/**
- * Creates a 4x4 matrix which maps coordinates from a 3D source AABB (defined by
- * `srcPos` and `srcSize`) to a destination AABB (`destPos` & `destSize`).
- * Writes result matrix to `out` or creates new matrix if `out` is null.
- *
- * @param out
- * @param srcPos
- * @param srcSize
- * @param destPos
- * @param destSize
- */
-export const fit44 = (out, srcPos, srcSize, destPos, destSize) => concat(out, translation44(null, maddN3([], destSize, 0.5, destPos)), scale44(null, safeDiv3([], destSize, srcSize)), translation44(null, mulN3(null, maddN3([], srcSize, 0.5, srcPos), -1)));
+const fit23 = (out, srcPos, srcSize, destPos, destSize) => concat(
+  out,
+  translation23(null, maddN2([], destSize, 0.5, destPos)),
+  scale23(null, safeDiv2([], destSize, srcSize)),
+  translation23(null, mulN2(null, maddN2([], srcSize, 0.5, srcPos), -1))
+);
+const fit44 = (out, srcPos, srcSize, destPos, destSize) => concat(
+  out,
+  translation44(null, maddN3([], destSize, 0.5, destPos)),
+  scale44(null, safeDiv3([], destSize, srcSize)),
+  translation44(null, mulN3(null, maddN3([], srcSize, 0.5, srcPos), -1))
+);
+export {
+  fit23,
+  fit44
+};

package/frustum.js

@@ -1,32 +1,42 @@
 import { DEG2RAD } from "@thi.ng/math/api";
 import { setC } from "@thi.ng/vectors/setc";
-/**
- * Constructs a 4x4 matrix representing the given view frustum. Creates
- * new matrix if `out` is `null`.
- *
- * @param out -
- * @param left -
- * @param right -
- * @param bottom -
- * @param top -
- * @param near -
- * @param far -
- */
-export const frustum = (out, left, right, bottom, top, near, far) => {
-    const dx = 1 / (right - left);
-    const dy = 1 / (top - bottom);
-    const dz = 1 / (far - near);
-    return setC(out || [], near * 2 * dx, 0, 0, 0, 0, near * 2 * dy, 0, 0, (right + left) * dx, (top + bottom) * dy, -(far + near) * dz, -1, 0, 0, -(far * near * 2) * dz, 0);
+const frustum = (out, left, right, bottom, top, near, far) => {
+  const dx = 1 / (right - left);
+  const dy = 1 / (top - bottom);
+  const dz = 1 / (far - near);
+  return setC(
+    out || [],
+    near * 2 * dx,
+    0,
+    0,
+    0,
+    0,
+    near * 2 * dy,
+    0,
+    0,
+    (right + left) * dx,
+    (top + bottom) * dy,
+    -(far + near) * dz,
+    -1,
+    0,
+    0,
+    -(far * near * 2) * dz,
+    0
+  );
 };
-export const frustumBounds = (fovy, aspect, near, far) => {
-    const top = near * Math.tan((fovy * DEG2RAD) / 2);
-    const right = top * aspect;
-    return {
-        left: -right,
-        right,
-        bottom: -top,
-        top,
-        near,
-        far,
-    };
+const frustumBounds = (fovy, aspect, near, far) => {
+  const top = near * Math.tan(fovy * DEG2RAD / 2);
+  const right = top * aspect;
+  return {
+    left: -right,
+    right,
+    bottom: -top,
+    top,
+    near,
+    far
+  };
+};
+export {
+  frustum,
+  frustumBounds
 };

package/identity.js

@@ -1,11 +1,15 @@
 import { vop } from "@thi.ng/vectors/vop";
 import { IDENT22, IDENT23, IDENT33, IDENT44 } from "./constants.js";
 import { set } from "./set.js";
-/**
- * Writes identity matrix into given matrix.
- */
-export const identity = vop();
-export const identity22 = identity.add(4, (m) => set(m, IDENT22));
-export const identity23 = identity.add(6, (m) => set(m, IDENT23));
-export const identity33 = identity.add(9, (m) => set(m, IDENT33));
-export const identity44 = identity.add(16, (m) => set(m, IDENT44));
+const identity = vop();
+const identity22 = identity.add(4, (m) => set(m, IDENT22));
+const identity23 = identity.add(6, (m) => set(m, IDENT23));
+const identity33 = identity.add(9, (m) => set(m, IDENT33));
+const identity44 = identity.add(16, (m) => set(m, IDENT44));
+export {
+  identity,
+  identity22,
+  identity23,
+  identity33,
+  identity44
+};