@math.gl/types 4.0.1 → 4.1.0-alpha.1

package/dist/array-types.d.ts

@@ -11,4 +11,52 @@ export type NumericArray = TypedArray | number[];
  * TypeScript type covering all typed arrays and classic arrays consisting of numbers
  * @note alias for NumericArray
  */
-export type NumberArray = NumericArray;
+export type NumberArray = TypedArray | number[];
+/** Array with exactly 1 number */
+export type NumberArray1 = [number];
+/** Array with exactly 2 numbers */
+export type NumberArray2 = [number, number];
+/** Array with exactly 3 numbers */
+export type NumberArray3 = [number, number, number];
+/** Array with exactly 4 numbers */
+export type NumberArray4 = [number, number, number, number];
+/** Array with exactly 6 numbers */
+export type NumberArray6 = [number, number, number, number, number, number];
+/** Array with exactly 8 numbers */
+export type NumberArray8 = [number, number, number, number, number, number, number, number];
+/** Array with exactly 9 numbers */
+export type NumberArray9 = [number, number, number, number, number, number, number, number, number];
+/** Array with exactly 12 numbers */
+export type NumberArray12 = [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];
+/** Array with exactly 16 numbers */
+export type NumberArray16 = [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];

package/dist/array-types.js

@@ -1 +1,4 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 export {};

package/dist/bigint.js

@@ -1,3 +1,6 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 // BigInt compatibility layer
 // Inspired by ArrowJS (under Apache2 license)
 // https://github.com/apache/arrow/blob/master/js/src/util/compat.ts

package/dist/bounds-types.d.ts

@@ -0,0 +1,10 @@
+/** 2 dimensional bounds [[minX, minY], [maxX, maxY]] */
+export type Bounds2D = [[number, number], [number, number]];
+/** 3 dimensional bounds [[minX, minY, minZ], [maxX, maxY, maxZ]] */
+export type Bounds3D = [[number, number, number], [number, number, number]];
+/** 2 or 3 dimensional bounds [[minX, minY], [maxX, maxY]] or [[minX, minY, minZ], [maxX, maxY, maxZ]] */
+export type Bounds = [[number, number], [number, number]] | [[number, number, number], [number, number, number]];
+/** Checks if a `Bounds` is a `Bounds2D` */
+export declare function isBounds2D(bounds: Bounds): bounds is Bounds2D;
+/** Accepts 2D and 3D bounds and returns a 2D bound, truncating 3D dimension if necessary */
+export declare function getBounds2D(bounds: Bounds): Bounds2D;

package/dist/bounds-types.js

@@ -0,0 +1,16 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Checks if a `Bounds` is a `Bounds2D` */
+export function isBounds2D(bounds) {
+    return bounds.length === 2;
+}
+/** Accepts 2D and 3D bounds and returns a 2D bound, truncating 3D dimension if necessary */
+export function getBounds2D(bounds) {
+    return isBounds2D(bounds)
+        ? bounds
+        : [
+            [bounds[0][0], bounds[0][1]],
+            [bounds[1][0], bounds[1][1]]
+        ];
+}

package/dist/index.cjs

@@ -26,11 +26,11 @@ module.exports = __toCommonJS(dist_exports);
 
 // dist/is-array.js
 function isTypedArray(value) {
-  return ArrayBuffer.isView(value) && !(value instanceof DataView) ? value : null;
+  return ArrayBuffer.isView(value) && !(value instanceof DataView);
 }
 function isNumericArray(value) {
   if (Array.isArray(value)) {
-    return value.length === 0 || typeof value[0] === "number" ? value : null;
+    return value.length === 0 || typeof value[0] === "number";
   }
   return isTypedArray(value);
 }

package/dist/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["index.js", "is-array.js"],
-  "sourcesContent": ["export { isTypedArray, isNumericArray } from \"./is-array.js\";\n", "/**\n * Check is an array is a typed array\n * @param value value to be tested\n * @returns input as TypedArray, or null\n */\nexport function isTypedArray(value) {\n    return ArrayBuffer.isView(value) && !(value instanceof DataView) ? value : null;\n}\n/**\n * Check is an array is a numeric array (typed array or array of numbers)\n * @param value value to be tested\n * @returns input as NumericArray, or null\n */\nexport function isNumericArray(value) {\n    if (Array.isArray(value)) {\n        return value.length === 0 || typeof value[0] === 'number' ? value : null;\n    }\n    return isTypedArray(value);\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACKO,SAAS,aAAa,OAAO;AAChC,SAAO,YAAY,OAAO,KAAK,KAAK,EAAE,iBAAiB,YAAY,QAAQ;AAC/E;AAMO,SAAS,eAAe,OAAO;AAClC,MAAI,MAAM,QAAQ,KAAK,GAAG;AACtB,WAAO,MAAM,WAAW,KAAK,OAAO,MAAM,OAAO,WAAW,QAAQ;AAAA,EACxE;AACA,SAAO,aAAa,KAAK;AAC7B;",
+  "sourcesContent": ["// math.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\nexport { isTypedArray, isNumericArray } from \"./is-array.js\";\n", "// math.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n/**\n * Check is an array is a typed array\n * @param value value to be tested\n * @returns input as TypedArray, or null\n */\nexport function isTypedArray(value) {\n    return ArrayBuffer.isView(value) && !(value instanceof DataView);\n}\n/**\n * Check is an array is a numeric array (typed array or array of numbers)\n * @param value value to be tested\n * @returns input as NumericArray, or null\n */\nexport function isNumericArray(value) {\n    if (Array.isArray(value)) {\n        return value.length === 0 || typeof value[0] === 'number';\n    }\n    return isTypedArray(value);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACQO,SAAS,aAAa,OAAO;AAChC,SAAO,YAAY,OAAO,KAAK,KAAK,EAAE,iBAAiB;AAC3D;AAMO,SAAS,eAAe,OAAO;AAClC,MAAI,MAAM,QAAQ,KAAK,GAAG;AACtB,WAAO,MAAM,WAAW,KAAK,OAAO,MAAM,OAAO;AAAA,EACrD;AACA,SAAO,aAAa,KAAK;AAC7B;",
   "names": []
 }

package/dist/index.d.ts

@@ -1,2 +1,3 @@
-export type { TypedArray, TypedArrayConstructor, NumericArray, NumberArray } from "./array-types.js";
+export type { TypedArray, TypedArrayConstructor, NumericArray, NumberArray, NumberArray1, NumberArray2, NumberArray3, NumberArray4, NumberArray6, NumberArray8, NumberArray9, NumberArray12, NumberArray16 } from "./array-types.js";
 export { isTypedArray, isNumericArray } from "./is-array.js";
+export type { Bounds, Bounds2D, Bounds3D } from "./bounds-types.js";

package/dist/index.js

@@ -1 +1,4 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 export { isTypedArray, isNumericArray } from "./is-array.js";

package/dist/is-array.d.ts

@@ -4,10 +4,10 @@ import { TypedArray, NumericArray } from "./array-types.js";
  * @param value value to be tested
  * @returns input as TypedArray, or null
  */
-export declare function isTypedArray(value: unknown): TypedArray | null;
+export declare function isTypedArray(value: unknown): value is TypedArray;
 /**
  * Check is an array is a numeric array (typed array or array of numbers)
  * @param value value to be tested
  * @returns input as NumericArray, or null
  */
-export declare function isNumericArray(value: unknown): NumericArray | null;
+export declare function isNumericArray(value: unknown): value is NumericArray;

package/dist/is-array.js

@@ -1,10 +1,13 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 /**
  * Check is an array is a typed array
  * @param value value to be tested
  * @returns input as TypedArray, or null
  */
 export function isTypedArray(value) {
-    return ArrayBuffer.isView(value) && !(value instanceof DataView) ? value : null;
+    return ArrayBuffer.isView(value) && !(value instanceof DataView);
 }
 /**
  * Check is an array is a numeric array (typed array or array of numbers)
@@ -13,7 +16,7 @@ export function isTypedArray(value) {
  */
 export function isNumericArray(value) {
     if (Array.isArray(value)) {
-        return value.length === 0 || typeof value[0] === 'number' ? value : null;
+        return value.length === 0 || typeof value[0] === 'number';
     }
     return isTypedArray(value);
 }

package/package.json

@@ -6,7 +6,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "4.0.1",
+  "version": "4.1.0-alpha.1",
   "keywords": [
     "typescript",
     "javascript",
@@ -35,5 +35,5 @@
   "sideEffects": [
     "./src/bigint.js"
   ],
-  "gitHead": "33f369ba3a259f79acc3fa8181190c9da8841648"
+  "gitHead": "1a4dbbc6ab46271459d610411a7c644e45135c2c"
 }

package/src/array-types.ts

@@ -1,3 +1,7 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
 /**
  * TypeScript type covering all typed arrays
  */
@@ -36,4 +40,61 @@ export type NumericArray = TypedArray | number[];
  * TypeScript type covering all typed arrays and classic arrays consisting of numbers
  * @note alias for NumericArray
  */
-export type NumberArray = NumericArray;
+export type NumberArray = TypedArray | number[];
+
+/** Array with exactly 1 number */
+export type NumberArray1 = [number];
+
+/** Array with exactly 2 numbers */
+export type NumberArray2 = [number, number];
+
+/** Array with exactly 3 numbers */
+export type NumberArray3 = [number, number, number];
+
+/** Array with exactly 4 numbers */
+export type NumberArray4 = [number, number, number, number];
+
+/** Array with exactly 6 numbers */
+export type NumberArray6 = [number, number, number, number, number, number];
+
+/** Array with exactly 8 numbers */
+export type NumberArray8 = [number, number, number, number, number, number, number, number];
+
+/** Array with exactly 9 numbers */
+export type NumberArray9 = [number, number, number, number, number, number, number, number, number];
+
+/** Array with exactly 12 numbers */
+export type NumberArray12 = [
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number
+];
+
+/** Array with exactly 16 numbers */
+export type NumberArray16 = [
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number,
+  number
+];

package/src/bigint.ts

@@ -1,3 +1,7 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
 // BigInt compatibility layer
 // Inspired by ArrowJS (under Apache2 license)
 // https://github.com/apache/arrow/blob/master/js/src/util/compat.ts

package/src/bounds-types.ts

@@ -0,0 +1,29 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+/** 2 dimensional bounds [[minX, minY], [maxX, maxY]] */
+export type Bounds2D = [[number, number], [number, number]];
+
+/** 3 dimensional bounds [[minX, minY, minZ], [maxX, maxY, maxZ]] */
+export type Bounds3D = [[number, number, number], [number, number, number]];
+
+/** 2 or 3 dimensional bounds [[minX, minY], [maxX, maxY]] or [[minX, minY, minZ], [maxX, maxY, maxZ]] */
+export type Bounds =
+  | [[number, number], [number, number]]
+  | [[number, number, number], [number, number, number]];
+
+/** Checks if a `Bounds` is a `Bounds2D` */
+export function isBounds2D(bounds: Bounds): bounds is Bounds2D {
+  return bounds.length === 2;
+}
+
+/** Accepts 2D and 3D bounds and returns a 2D bound, truncating 3D dimension if necessary */
+export function getBounds2D(bounds: Bounds): Bounds2D {
+  return isBounds2D(bounds)
+    ? bounds
+    : [
+        [bounds[0][0], bounds[0][1]],
+        [bounds[1][0], bounds[1][1]]
+      ];
+}

package/src/index.ts

@@ -1,2 +1,22 @@
-export type {TypedArray, TypedArrayConstructor, NumericArray, NumberArray} from './array-types';
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+export type {
+  TypedArray,
+  TypedArrayConstructor,
+  NumericArray,
+  NumberArray,
+  NumberArray1,
+  NumberArray2,
+  NumberArray3,
+  NumberArray4,
+  NumberArray6,
+  NumberArray8,
+  NumberArray9,
+  NumberArray12,
+  NumberArray16
+} from './array-types';
 export {isTypedArray, isNumericArray} from './is-array';
+
+export type {Bounds, Bounds2D, Bounds3D} from './bounds-types';

package/src/is-array.ts

@@ -1,3 +1,7 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
 import {TypedArray, NumericArray} from './array-types';
 
 /**
@@ -5,8 +9,8 @@ import {TypedArray, NumericArray} from './array-types';
  * @param value value to be tested
  * @returns input as TypedArray, or null
  */
-export function isTypedArray(value: unknown): TypedArray | null {
-  return ArrayBuffer.isView(value) && !(value instanceof DataView) ? (value as TypedArray) : null;
+export function isTypedArray(value: unknown): value is TypedArray {
+  return ArrayBuffer.isView(value) && !(value instanceof DataView);
 }
 
 /**
@@ -14,9 +18,9 @@ export function isTypedArray(value: unknown): TypedArray | null {
  * @param value value to be tested
  * @returns input as NumericArray, or null
  */
-export function isNumericArray(value: unknown): NumericArray | null {
+export function isNumericArray(value: unknown): value is NumericArray {
   if (Array.isArray(value)) {
-    return value.length === 0 || typeof value[0] === 'number' ? (value as number[]) : null;
+    return value.length === 0 || typeof value[0] === 'number';
   }
   return isTypedArray(value);
 }