@math.gl/core 4.2.0-alpha.5 → 4.2.0-alpha.6

package/dist/index.cjs

@@ -5635,46 +5635,72 @@ var SphericalCoordinates = class _SphericalCoordinates {
 // dist/classes/euler.js
 var ERR_UNKNOWN_ORDER = "Unknown Euler angle order";
 var ALMOST_ONE = 0.99999;
-var RotationOrder;
-(function(RotationOrder2) {
-  RotationOrder2[RotationOrder2["ZYX"] = 0] = "ZYX";
-  RotationOrder2[RotationOrder2["YXZ"] = 1] = "YXZ";
-  RotationOrder2[RotationOrder2["XZY"] = 2] = "XZY";
-  RotationOrder2[RotationOrder2["ZXY"] = 3] = "ZXY";
-  RotationOrder2[RotationOrder2["YZX"] = 4] = "YZX";
-  RotationOrder2[RotationOrder2["XYZ"] = 5] = "XYZ";
-})(RotationOrder || (RotationOrder = {}));
-var Euler = class _Euler extends MathArray {
+var RotationOrderIndex;
+(function(RotationOrderIndex2) {
+  RotationOrderIndex2[RotationOrderIndex2["ZYX"] = 0] = "ZYX";
+  RotationOrderIndex2[RotationOrderIndex2["YXZ"] = 1] = "YXZ";
+  RotationOrderIndex2[RotationOrderIndex2["XZY"] = 2] = "XZY";
+  RotationOrderIndex2[RotationOrderIndex2["ZXY"] = 3] = "ZXY";
+  RotationOrderIndex2[RotationOrderIndex2["YZX"] = 4] = "YZX";
+  RotationOrderIndex2[RotationOrderIndex2["XYZ"] = 5] = "XYZ";
+})(RotationOrderIndex || (RotationOrderIndex = {}));
+var ROTATION_ORDER_INDICES = {
+  zyx: RotationOrderIndex.ZYX,
+  yxz: RotationOrderIndex.YXZ,
+  xzy: RotationOrderIndex.XZY,
+  zxy: RotationOrderIndex.ZXY,
+  yzx: RotationOrderIndex.YZX,
+  xyz: RotationOrderIndex.XYZ
+};
+var ROTATION_ORDERS = {
+  ZYX: "zyx",
+  YXZ: "yxz",
+  XZY: "xzy",
+  ZXY: "zxy",
+  YZX: "yzx",
+  XYZ: "xyz"
+};
+var Euler = class extends MathArray {
   // Constants
+  /** @deprecated Pass the string `'zyx'` directly. */
   static get ZYX() {
-    return RotationOrder.ZYX;
+    return "zyx";
   }
+  /** @deprecated Pass the string `'yxz'` directly. */
   static get YXZ() {
-    return RotationOrder.YXZ;
+    return "yxz";
   }
+  /** @deprecated Pass the string `'xzy'` directly. */
   static get XZY() {
-    return RotationOrder.XZY;
+    return "xzy";
   }
+  /** @deprecated Pass the string `'zxy'` directly. */
   static get ZXY() {
-    return RotationOrder.ZXY;
+    return "zxy";
   }
+  /** @deprecated Pass the string `'yzx'` directly. */
   static get YZX() {
-    return RotationOrder.YZX;
+    return "yzx";
   }
+  /** @deprecated Pass the string `'xyz'` directly. */
   static get XYZ() {
-    return RotationOrder.XYZ;
+    return "xyz";
   }
+  /** @deprecated Pass the string `'zyx'` directly. */
   static get RollPitchYaw() {
-    return RotationOrder.ZYX;
+    return "zyx";
   }
+  /** @deprecated Pass the string `'zyx'` directly. */
   static get DefaultOrder() {
-    return RotationOrder.ZYX;
+    return "zyx";
   }
+  /** @deprecated Pass an {@link EulerRotationOrder} string directly. */
   static get RotationOrders() {
-    return RotationOrder;
+    return ROTATION_ORDERS;
   }
+  /** @deprecated Euler rotation orders are already represented as strings. */
   static rotationOrder(order) {
-    return RotationOrder[order];
+    return order;
   }
   get ELEMENTS() {
     return 4;
@@ -5686,7 +5712,7 @@ var Euler = class _Euler extends MathArray {
    * @param {Number=} [z]
    * @param {Number=} [order]
    */
-  constructor(x = 0, y = 0, z = 0, order = _Euler.DefaultOrder) {
+  constructor(x = 0, y = 0, z = 0, order = "zyx") {
     super(-0, -0, -0, -0);
     if (arguments.length > 0 && Array.isArray(arguments[0])) {
       this.fromVector3(...arguments);
@@ -5707,7 +5733,7 @@ var Euler = class _Euler extends MathArray {
     const roll = Math.atan2(t3, t4);
     const pitch = Math.asin(t2);
     const yaw = Math.atan2(t1, t0);
-    return this.set(roll, pitch, yaw, _Euler.RollPitchYaw);
+    return this.set(roll, pitch, yaw, "zyx");
   }
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   fromObject(object) {
@@ -5722,7 +5748,9 @@ var Euler = class _Euler extends MathArray {
     this[0] = array[0];
     this[1] = array[1];
     this[2] = array[2];
-    this[3] = Number.isFinite(array[3]) || this.order;
+    if (Number.isFinite(array[3]) && validateOrder(array[3])) {
+      this[3] = array[3];
+    }
     return this.check();
   }
   // Sets the three angles, and optionally sets the rotation order
@@ -5731,7 +5759,7 @@ var Euler = class _Euler extends MathArray {
     this[0] = x;
     this[1] = y;
     this[2] = z;
-    this[3] = Number.isFinite(order) ? order : this[3];
+    this[3] = order ? checkOrder(order) : this[3];
     return this.check();
   }
   validate() {
@@ -5837,14 +5865,14 @@ var Euler = class _Euler extends MathArray {
   }
   // rotation order, in all three angle notations
   get order() {
-    return this[3];
+    return getOrder(this[3]);
   }
   set order(value) {
     this[3] = checkOrder(value);
   }
   // Constructors
-  fromVector3(v, order) {
-    return this.set(v[0], v[1], v[2], Number.isFinite(order) ? order : this[3]);
+  fromVector3(v, order = this.order) {
+    return this.set(v[0], v[1], v[2], order);
   }
   // TODO - with and without 4th element
   fromArray(array, offset = 0) {
@@ -5858,9 +5886,9 @@ var Euler = class _Euler extends MathArray {
   }
   // Common ZYX rotation order
   fromRollPitchYaw(roll, pitch, yaw) {
-    return this.set(roll, pitch, yaw, RotationOrder.ZYX);
+    return this.set(roll, pitch, yaw, "zyx");
   }
-  fromRotationMatrix(m, order = _Euler.DefaultOrder) {
+  fromRotationMatrix(m, order = "zyx") {
     this._fromRotationMatrix(m, order);
     return this.check();
   }
@@ -5872,17 +5900,17 @@ var Euler = class _Euler extends MathArray {
   getQuaternion() {
     const q = new Quaternion();
     switch (this[3]) {
-      case RotationOrder.XYZ:
+      case RotationOrderIndex.XYZ:
         return q.rotateX(this[0]).rotateY(this[1]).rotateZ(this[2]);
-      case RotationOrder.YXZ:
+      case RotationOrderIndex.YXZ:
         return q.rotateY(this[1]).rotateX(this[0]).rotateZ(this[2]);
-      case RotationOrder.ZXY:
+      case RotationOrderIndex.ZXY:
         return q.rotateZ(this[2]).rotateX(this[0]).rotateY(this[1]);
-      case RotationOrder.ZYX:
+      case RotationOrderIndex.ZYX:
         return q.rotateZ(this[2]).rotateY(this[1]).rotateX(this[0]);
-      case RotationOrder.YZX:
+      case RotationOrderIndex.YZX:
         return q.rotateY(this[1]).rotateZ(this[2]).rotateX(this[0]);
-      case RotationOrder.XZY:
+      case RotationOrderIndex.XZY:
         return q.rotateX(this[0]).rotateZ(this[2]).rotateY(this[1]);
       default:
         throw new Error(ERR_UNKNOWN_ORDER);
@@ -5896,13 +5924,13 @@ var Euler = class _Euler extends MathArray {
   //   const q = new Quaternion().setFromEuler(this);
   //   return this.setFromQuaternion(q, newOrder);
   /* eslint-disable complexity, max-statements, one-var */
-  _fromRotationMatrix(m, order = _Euler.DefaultOrder) {
+  _fromRotationMatrix(m, order = "zyx") {
     const m11 = m[0], m12 = m[4], m13 = m[8];
     const m21 = m[1], m22 = m[5], m23 = m[9];
     const m31 = m[2], m32 = m[6], m33 = m[10];
-    order = order || this[3];
-    switch (order) {
-      case _Euler.XYZ:
+    const orderIndex = order ? checkOrder(order) : this[3];
+    switch (orderIndex) {
+      case RotationOrderIndex.XYZ:
         this[1] = Math.asin(clamp(m13, -1, 1));
         if (Math.abs(m13) < ALMOST_ONE) {
           this[0] = Math.atan2(-m23, m33);
@@ -5912,7 +5940,7 @@ var Euler = class _Euler extends MathArray {
           this[2] = 0;
         }
         break;
-      case _Euler.YXZ:
+      case RotationOrderIndex.YXZ:
         this[0] = Math.asin(-clamp(m23, -1, 1));
         if (Math.abs(m23) < ALMOST_ONE) {
           this[1] = Math.atan2(m13, m33);
@@ -5922,7 +5950,7 @@ var Euler = class _Euler extends MathArray {
           this[2] = 0;
         }
         break;
-      case _Euler.ZXY:
+      case RotationOrderIndex.ZXY:
         this[0] = Math.asin(clamp(m32, -1, 1));
         if (Math.abs(m32) < ALMOST_ONE) {
           this[1] = Math.atan2(-m31, m33);
@@ -5932,7 +5960,7 @@ var Euler = class _Euler extends MathArray {
           this[2] = Math.atan2(m21, m11);
         }
         break;
-      case _Euler.ZYX:
+      case RotationOrderIndex.ZYX:
         this[1] = Math.asin(-clamp(m31, -1, 1));
         if (Math.abs(m31) < ALMOST_ONE) {
           this[0] = Math.atan2(m32, m33);
@@ -5942,7 +5970,7 @@ var Euler = class _Euler extends MathArray {
           this[2] = Math.atan2(-m12, m22);
         }
         break;
-      case _Euler.YZX:
+      case RotationOrderIndex.YZX:
         this[2] = Math.asin(clamp(m21, -1, 1));
         if (Math.abs(m21) < ALMOST_ONE) {
           this[0] = Math.atan2(-m23, m22);
@@ -5952,7 +5980,7 @@ var Euler = class _Euler extends MathArray {
           this[1] = Math.atan2(m13, m33);
         }
         break;
-      case _Euler.XZY:
+      case RotationOrderIndex.XZY:
         this[2] = Math.asin(-clamp(m12, -1, 1));
         if (Math.abs(m12) < ALMOST_ONE) {
           this[0] = Math.atan2(m32, m22);
@@ -5965,7 +5993,7 @@ var Euler = class _Euler extends MathArray {
       default:
         throw new Error(ERR_UNKNOWN_ORDER);
     }
-    this[3] = order;
+    this[3] = orderIndex;
     return this;
   }
   _getRotationMatrix(result) {
@@ -5978,7 +6006,7 @@ var Euler = class _Euler extends MathArray {
     const d = Math.sin(y);
     const f = Math.sin(z);
     switch (this[3]) {
-      case _Euler.XYZ: {
+      case RotationOrderIndex.XYZ: {
         const ae = a * e, af = a * f, be = b * e, bf = b * f;
         te[0] = c * e;
         te[4] = -c * f;
@@ -5991,7 +6019,7 @@ var Euler = class _Euler extends MathArray {
         te[10] = a * c;
         break;
       }
-      case _Euler.YXZ: {
+      case RotationOrderIndex.YXZ: {
         const ce = c * e, cf = c * f, de = d * e, df = d * f;
         te[0] = ce + df * b;
         te[4] = de * b - cf;
@@ -6004,7 +6032,7 @@ var Euler = class _Euler extends MathArray {
         te[10] = a * c;
         break;
       }
-      case _Euler.ZXY: {
+      case RotationOrderIndex.ZXY: {
         const ce = c * e, cf = c * f, de = d * e, df = d * f;
         te[0] = ce - df * b;
         te[4] = -a * f;
@@ -6017,7 +6045,7 @@ var Euler = class _Euler extends MathArray {
         te[10] = a * c;
         break;
       }
-      case _Euler.ZYX: {
+      case RotationOrderIndex.ZYX: {
         const ae = a * e, af = a * f, be = b * e, bf = b * f;
         te[0] = c * e;
         te[4] = be * d - af;
@@ -6030,7 +6058,7 @@ var Euler = class _Euler extends MathArray {
         te[10] = a * c;
         break;
       }
-      case _Euler.YZX: {
+      case RotationOrderIndex.YZX: {
         const ac = a * c, ad = a * d, bc = b * c, bd = b * d;
         te[0] = c * e;
         te[4] = bd - ac * f;
@@ -6043,7 +6071,7 @@ var Euler = class _Euler extends MathArray {
         te[10] = ac - bd * f;
         break;
       }
-      case _Euler.XZY: {
+      case RotationOrderIndex.XZY: {
         const ac = a * c, ad = a * d, bc = b * c, bd = b * d;
         te[0] = c * e;
         te[4] = -f;
@@ -6086,10 +6114,29 @@ function validateOrder(value) {
   return value >= 0 && value < 6;
 }
 function checkOrder(value) {
-  if (value < 0 && value >= 6) {
+  const order = ROTATION_ORDER_INDICES[value];
+  if (order === void 0) {
     throw new Error(ERR_UNKNOWN_ORDER);
   }
-  return value;
+  return order;
+}
+function getOrder(value) {
+  switch (value) {
+    case RotationOrderIndex.ZYX:
+      return "zyx";
+    case RotationOrderIndex.YXZ:
+      return "yxz";
+    case RotationOrderIndex.XZY:
+      return "xzy";
+    case RotationOrderIndex.ZXY:
+      return "zxy";
+    case RotationOrderIndex.YZX:
+      return "yzx";
+    case RotationOrderIndex.XYZ:
+      return "xyz";
+    default:
+      throw new Error(ERR_UNKNOWN_ORDER);
+  }
 }
 
 // dist/classes/pose.js
@@ -6101,9 +6148,9 @@ var Pose = class {
       this.position = new Vector3(x, y, z);
     }
     if (Array.isArray(orientation) && orientation.length === 4) {
-      this.orientation = new Euler(orientation, orientation[3]);
+      this.orientation = new Euler().fromArray(orientation);
     } else {
-      this.orientation = new Euler(roll, pitch, yaw, Euler.RollPitchYaw);
+      this.orientation = new Euler(roll, pitch, yaw, "zyx");
     }
   }
   get x() {