@math.gl/core 4.0.0-alpha.1 → 4.0.0-alpha.3

package/src/gl-matrix/wip/types.d.ts

@@ -0,0 +1,93 @@
+// @ts-nocheck
+/* eslint-disable */
+
+interface IndexedCollection extends Iterable<number> {
+  readonly length: number;
+  [index: number]: number;
+}
+
+// prettier-ignore
+declare type mat2 =
+  | [number, number, 
+     number, number]
+  | IndexedCollection;
+
+// prettier-ignore
+declare type mat2d =
+  | [number, number, 
+     number, number, 
+     number, number]
+  | IndexedCollection;
+
+// prettier-ignore
+declare type mat3 =
+  | [number, number, number, 
+     number, number, number, 
+     number, number, number]
+  | IndexedCollection;
+
+// prettier-ignore
+declare type mat4 =
+  | [number, number, number, number,
+     number, number, number, number,
+     number, number, number, number,
+     number, number, number, number]
+  | IndexedCollection;
+
+declare type quat = [number, number, number, number] | IndexedCollection;
+
+// prettier-ignore
+declare type quat2 =
+  | [number, number, number, number, 
+    number, number, number, number]
+  | IndexedCollection;
+
+declare type vec2 = [number, number] | IndexedCollection;
+declare type vec3 = [number, number, number] | IndexedCollection;
+declare type vec4 = [number, number, number, number] | IndexedCollection;
+
+// prettier-ignore
+declare type ReadonlyMat2 =
+  | readonly [
+      number, number,
+      number, number
+    ]
+  | IndexedCollection;
+
+// prettier-ignore
+declare type ReadonlyMat2d =
+  | readonly [
+      number, number,
+      number, number,
+      number, number
+    ]
+  | IndexedCollection;
+
+// prettier-ignore
+declare type ReadonlyMat3 =
+  | readonly [
+      number, number, number,
+      number, number, number,
+      number, number, number
+    ]
+  | IndexedCollection;
+
+// prettier-ignore
+declare type ReadonlyMat4 =
+  | readonly [
+      number, number, number, number,
+      number, number, number, number,
+      number, number, number, number,
+      number, number, number, number
+    ]
+  | IndexedCollection;
+
+declare type ReadonlyQuat = readonly [number, number, number, number] | IndexedCollection;
+
+declare type ReadonlyQuat2 =
+  | readonly [number, number, number, number, number, number, number, number]
+  | IndexedCollection;
+
+declare type ReadonlyVec2 = readonly [number, number] | IndexedCollection;
+declare type ReadonlyVec3 = readonly [number, number, number] | IndexedCollection;
+declare type ReadonlyVec4 = readonly [number, number, number, number] | IndexedCollection;

package/src/index.ts

@@ -3,23 +3,25 @@
 // types
 export type {TypedArray, NumericArray} from '@math.gl/types';
 
+export type {isTypedArray, isNumericArray} from '@math.gl/types';
+
 // classes
-export {default as Vector2} from './classes/vector2';
-export {default as Vector3} from './classes/vector3';
-export {default as Vector4} from './classes/vector4';
-export {default as Matrix3} from './classes/matrix3';
-export {default as Matrix4} from './classes/matrix4';
-export {default as Quaternion} from './classes/quaternion';
+export {Vector2} from './classes/vector2';
+export {Vector3} from './classes/vector3';
+export {Vector4} from './classes/vector4';
+export {Matrix3} from './classes/matrix3';
+export {Matrix4} from './classes/matrix4';
+export {Quaternion} from './classes/quaternion';
 
 // experimental
-export {default as SphericalCoordinates} from './classes/spherical-coordinates';
-export {default as Pose} from './classes/pose';
-export {default as Euler} from './classes/euler';
+export {SphericalCoordinates} from './classes/spherical-coordinates';
+export {Pose} from './classes/pose';
+export {Euler} from './classes/euler';
 
-export {default as _MathUtils} from './lib/math-utils';
+export * as _MathUtils from './lib/math-utils';
 
 // lib
-export {default as assert} from './lib/assert';
+export {assert} from './lib/assert';
 
 export {
   // math.gl global utility methods
@@ -47,6 +49,6 @@ export {
 } from './lib/common';
 
 // DEPRECATED
-export {default as _SphericalCoordinates} from './classes/spherical-coordinates';
-export {default as _Pose} from './classes/pose';
-export {default as _Euler} from './classes/euler';
+export {SphericalCoordinates as _SphericalCoordinates} from './classes/spherical-coordinates';
+export {Pose as _Pose} from './classes/pose';
+export {Euler as _Euler} from './classes/euler';

package/src/lib/assert.ts

@@ -1,4 +1,4 @@
-export default function assert(condition: unknown, message?: string): void {
+export function assert(condition: unknown, message?: string): void {
   if (!condition) {
     throw new Error(`math.gl assertion ${message}`);
   }

package/src/lib/common.ts

@@ -1,8 +1,11 @@
-// Copyright (c) 2017 Uber Technologies, Inc.
-// MIT License
-import {NumericArray} from '@math.gl/types';
+// math.gl, MIT license
 
-import type MathArray from '../classes/base/math-array';
+import type {NumericArray} from '@math.gl/types';
+
+import type {MathArray} from '../classes/base/math-array';
+
+const RADIANS_TO_DEGREES = (1 / Math.PI) * 180;
+const DEGREES_TO_RADIANS = (1 / 180) * Math.PI;
 
 export type ConfigurationOptions = {
   EPSILON: number;
@@ -14,20 +17,32 @@ export type ConfigurationOptions = {
   _cartographicRadians?: boolean;
 };
 
-const RADIANS_TO_DEGREES = (1 / Math.PI) * 180;
-const DEGREES_TO_RADIANS = (1 / 180) * Math.PI;
-
-// TODO - remove
-export const config: ConfigurationOptions = {
+const DEFAULT_CONFIG: Required<ConfigurationOptions> = {
   EPSILON: 1e-12,
   debug: false,
   precision: 4,
   printTypes: false,
   printDegrees: false,
-  printRowMajor: true
+  printRowMajor: true,
+  _cartographicRadians: false
 };
 
-export function configure(options?: Partial<ConfigurationOptions>): ConfigurationOptions {
+// We use a global field to store the config
+declare global {
+  // eslint-disable-next-line no-var
+  var mathgl: {
+    config: Required<ConfigurationOptions>;
+  };
+}
+
+// Configuration is truly global as of v3.6 to ensure single config even if multiple copies of math.gl
+// Multiple copies of config can be quite tricky to debug...
+globalThis.mathgl = globalThis.mathgl || {config: {...DEFAULT_CONFIG}};
+
+export const config = globalThis.mathgl.config;
+
+export function configure(options: Partial<ConfigurationOptions>): ConfigurationOptions {
+  // Only copy existing keys
   Object.assign(config, options);
   return config;
 }
@@ -50,8 +65,8 @@ export function formatValue(
 /**
  * Check if value is an "array"
  * Returns `true` if value is either an array or a typed array
- *
  * Note: returns `false` for `ArrayBuffer` and `DataView` instances
+ * @note isTypedArray and isNumericArray are often more useful in TypeScript
  */
 export function isArray(value: unknown): boolean {
   return Array.isArray(value) || (ArrayBuffer.isView(value) && !(value instanceof DataView));
@@ -276,7 +291,8 @@ function round(value: number): number {
 // If the array has a clone function, calls it, otherwise returns a copy
 function duplicateArray(array: NumericArray): NumericArray {
   // @ts-expect-error We check for math.gl class methods
-  return array.clone ? array.clone() : (new Array(array.length) as number[]);
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+  return array.clone ? (array.clone() as NumericArray) : (new Array(array.length) as number[]);
 }
 
 // If the argument value is an array, applies the func element wise,

package/src/lib/math-utils.ts

@@ -1,30 +1,28 @@
 // NOTE: Added to make Cesium-derived test cases work
 // TODO: Determine if/how to keep
-export default {
-  EPSILON1: 1e-1,
-  EPSILON2: 1e-2,
-  EPSILON3: 1e-3,
-  EPSILON4: 1e-4,
-  EPSILON5: 1e-5,
-  EPSILON6: 1e-6,
-  EPSILON7: 1e-7,
-  EPSILON8: 1e-8,
-  EPSILON9: 1e-9,
-  EPSILON10: 1e-10,
-  EPSILON11: 1e-11,
-  EPSILON12: 1e-12,
-  EPSILON13: 1e-13,
-  EPSILON14: 1e-14,
-  EPSILON15: 1e-15,
-  EPSILON16: 1e-16,
-  EPSILON17: 1e-17,
-  EPSILON18: 1e-18,
-  EPSILON19: 1e-19,
-  EPSILON20: 1e-20,
+export const EPSILON1 = 1e-1;
+export const EPSILON2 = 1e-2;
+export const EPSILON3 = 1e-3;
+export const EPSILON4 = 1e-4;
+export const EPSILON5 = 1e-5;
+export const EPSILON6 = 1e-6;
+export const EPSILON7 = 1e-7;
+export const EPSILON8 = 1e-8;
+export const EPSILON9 = 1e-9;
+export const EPSILON10 = 1e-10;
+export const EPSILON11 = 1e-11;
+export const EPSILON12 = 1e-12;
+export const EPSILON13 = 1e-13;
+export const EPSILON14 = 1e-14;
+export const EPSILON15 = 1e-15;
+export const EPSILON16 = 1e-16;
+export const EPSILON17 = 1e-17;
+export const EPSILON18 = 1e-18;
+export const EPSILON19 = 1e-19;
+export const EPSILON20 = 1e-20;
 
-  PI_OVER_TWO: Math.PI / 2,
-  PI_OVER_FOUR: Math.PI / 4,
-  PI_OVER_SIX: Math.PI / 6,
+export const PI_OVER_TWO = Math.PI / 2;
+export const PI_OVER_FOUR = Math.PI / 4;
+export const PI_OVER_SIX = Math.PI / 6;
 
-  TWO_PI: Math.PI * 2
-};
+export const TWO_PI = Math.PI * 2;

package/src/lib/validators.ts

@@ -35,7 +35,7 @@ export function validateVector(v: NumberArray, length: number): boolean {
 
 export function checkNumber(value: unknown): number {
   if (!Number.isFinite(value)) {
-    throw new Error(`Invalid number ${value}`);
+    throw new Error(`Invalid number ${JSON.stringify(value)}`);
   }
   return value as number;
 }