feat: update code, docs and tests

- feat: use default argument values
- feat: ray intersection enum
- feat: hitTestTriangle only has 4 return values (TRIANGLE_DEGENERATE, SAME_PLANE, NO_INTERSECT, INTERSECT)
- feat: add aabb.setPoints
- feat: make aabb.set return a
- feat: use aabb.includePoint in aabb.setPoints
- fix: make rect.setPosition use param width before it is changed
- fix: make rect.getCenter based on rect min (handle negative rect)
- feat: remove rect.zero
- feat: rename getWidth/getHeight/getSize/getAspectRatio/getCenter (remove get)
- feat: add rect.setPoints and rename createFromPoints to fromPoints
- feat: add rect.getPoints
- feat: add aabb.empty
- feat: rename rect.setEmpty to rect.empty
- feat: use slice in aabb.copy
- test: add mocha and write tests
- upgrade to pex-math 3+

BREAKING CHANGE: API rename and removals

Author: dmnsgn

.gitignore

@@ -2,3 +2,4 @@ node_modules
 .DS_Store
 types
 lib
+coverage

aabb.js

@@ -1,70 +1,151 @@
+/**
+ * @typedef {number[][]} aabb An axis-aligned bounding box defined by two min and max 3D points.
+ */
+
+/**
+ * Creates a new bounding box.
+ * @returns {aabb}
+ */
 export function create() {
-  const min = [Infinity, Infinity, Infinity];
-  const max = [-Infinity, -Infinity, -Infinity];
-  return [min, max];
+  // [min, max]
+  return [
+    [Infinity, Infinity, Infinity],
+    [-Infinity, -Infinity, -Infinity],
+  ];
+}
+
+/**
+ * Reset a bounding box.
+ * @param {aabb} a
+ * @returns {rect}
+ */
+export function empty(a) {
+  a[0][0] = Infinity;
+  a[0][1] = Infinity;
+  a[0][2] = Infinity;
+  a[1][0] = -Infinity;
+  a[1][1] = -Infinity;
+  a[1][2] = -Infinity;
+  return a;
 }
 
+/**
+ * Copies a bounding box.
+ * @param {aabb} a
+ * @returns {aabb}
+ */
+export function copy(a) {
+  return [a[0].slice(), a[1].slice()];
+}
+
+/**
+ * Sets a bounding box to another.
+ * @param {aabb} a
+ * @param {aabb} b
+ * @returns {aabb}
+ */
 export function set(a, b) {
   a[0][0] = b[0][0];
   a[0][1] = b[0][1];
   a[0][2] = b[0][2];
   a[1][0] = b[1][0];
   a[1][1] = b[1][1];
   a[1][2] = b[1][2];
+  return a;
 }
 
-export function copy(b) {
-  const a = create();
-  set(a, b);
-  return a;
+/**
+ * Checks if a bounding box is empty.
+ * @param {aabb} aabb
+ * @returns {boolean}
+ */
+export function isEmpty(a) {
+  return a[0][0] > a[1][0] || a[0][1] > a[1][1] || a[0][2] > a[1][2];
 }
 
+/**
+ * Creates a bounding box from a list of points.
+ * @param {import("pex-math").vec3[]} points
+ * @returns {aabb}
+ */
 export function fromPoints(points) {
-  const aabb = create();
-  const min = aabb[0];
-  const max = aabb[1];
+  return setPoints(create(), points);
+}
 
-  for (let i = 0, len = points.length; i < len; i++) {
-    const p = points[i];
-    min[0] = Math.min(min[0], p[0]);
-    min[1] = Math.min(min[1], p[1]);
-    min[2] = Math.min(min[2], p[2]);
-    max[0] = Math.max(max[0], p[0]);
-    max[1] = Math.max(max[1], p[1]);
-    max[2] = Math.max(max[2], p[2]);
+/**
+ * Updates a bounding box from a list of points.
+ * @param {aabb} a
+ * @param {import("pex-math").vec3[]} points
+ * @returns {aabb}
+ */
+export function setPoints(a, points) {
+  for (let i = 0; i < points.length; i++) {
+    includePoint(a, points[i]);
   }
 
-  return aabb;
+  return a;
 }
 
-export function center(aabb, out) {
-  if (out === undefined) {
-    out = [0, 0, 0];
-  }
-  out[0] = (aabb[0][0] + aabb[1][0]) / 2;
-  out[1] = (aabb[0][1] + aabb[1][1]) / 2;
-  out[2] = (aabb[0][2] + aabb[1][2]) / 2;
-  return out;
+/**
+ * @private
+ */
+function setVec3(v = [], x, y, z) {
+  v[0] = x;
+  v[1] = y;
+  v[2] = z;
+  return v;
 }
 
-export function size(aabb, out) {
-  if (out === undefined) {
-    out = [0, 0, 0];
-  }
-  out[0] = Math.abs(aabb[1][0] - aabb[0][0]);
-  out[1] = Math.abs(aabb[1][1] - aabb[0][1]);
-  out[2] = Math.abs(aabb[1][2] - aabb[0][2]);
+/**
+ * Returns a list of 8 points from a bounding box.
+ * @param {aabb} aabb
+ * @param {import("pex-math").vec3[]} points
+ * @returns
+ */
+export function getPoints(a, points = []) {
+  points[0] = setVec3(points[0], a[0][0], a[0][1], a[0][2]);
+  points[1] = setVec3(points[1], a[1][0], a[0][1], a[0][2]);
+  points[2] = setVec3(points[2], a[1][0], a[0][1], a[1][2]);
+  points[3] = setVec3(points[3], a[0][0], a[0][1], a[1][2]);
+  points[4] = setVec3(points[4], a[0][0], a[1][1], a[0][2]);
+  points[5] = setVec3(points[5], a[1][0], a[1][1], a[0][2]);
+  points[6] = setVec3(points[6], a[1][0], a[1][1], a[1][2]);
+  points[7] = setVec3(points[7], a[0][0], a[1][1], a[1][2]);
+  return points;
+}
+
+/**
+ * Returns the center of a bounding box.
+ * @param {aabb} a
+ * @param {import("pex-math").vec3} out
+ * @returns {import("pex-math").vec3}
+ */
+export function center(a, out = [0, 0, 0]) {
+  out[0] = (a[0][0] + a[1][0]) / 2;
+  out[1] = (a[0][1] + a[1][1]) / 2;
+  out[2] = (a[0][2] + a[1][2]) / 2;
   return out;
 }
 
-export function isEmpty(aabb) {
-  return (
-    aabb[0][0] > aabb[1][0] ||
-    aabb[0][1] > aabb[1][1] ||
-    aabb[0][2] > aabb[1][2]
-  );
+/**
+ * Returns the size of a bounding box.
+ * @param {aabb} a
+ * @param {import("pex-math").vec3} out
+ * @returns {import("pex-math").vec3}
+ */
+export function size(a, out = [0, 0, 0]) {
+  out[0] = Math.abs(a[1][0] - a[0][0]);
+  out[1] = Math.abs(a[1][1] - a[0][1]);
+  out[2] = Math.abs(a[1][2] - a[0][2]);
+  return out;
 }
 
+/**
+ * Includes a bounding box in another.
+ * @param {aabb} a
+ * @param {aabb} b
+ * @returns {aabb}
+ */
 export function includeAABB(a, b) {
   if (isEmpty(a)) {
     set(a, b);
@@ -82,6 +163,12 @@ export function includeAABB(a, b) {
   return a;
 }
 
+/**
+ * Includes a point in a bounding box.
+ * @param {aabb} a
+ * @param {import("pex-math").vec3} p
+ * @returns {import("pex-math").vec3}
+ */
 export function includePoint(a, p) {
   a[0][0] = Math.min(a[0][0], p[0]);
   a[0][1] = Math.min(a[0][1], p[1]);