@math.gl/types 4.2.0-alpha.3 → 4.2.0-alpha.5

package/LICENSE

@@ -22,6 +22,33 @@ THE SOFTWARE.
 
 ---
 
+Some primitive tessellation approaches were originally inspired by the TDL WebGL samples under
+the New BSD License:
+
+Copyright (c) 2011, Google Inc. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted
+provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions
+   and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of
+   conditions and the following disclaimer in the documentation and/or other materials provided
+   with the distribution.
+3. Neither the name of Google Inc. nor the names of its contributors may be used to endorse or
+   promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
 math.gl builds on docs and code from "gl-matrix", which is MIT licensed as follows:
 
 Copyright (c) 2015, Brandon Jones, Colin MacKenzie IV.
@@ -87,3 +114,27 @@ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and limitations under the License.
 
 Cesium-derived code can be found in the submodule: modules/3d-tiles
+
+---
+
+The @math.gl/geometry primitive tessellators are adapted from luma.gl under the MIT License:
+
+Copyright (c) 2020 vis.gl contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/array-types.d.ts

@@ -1,11 +1,17 @@
+/// <reference lib="es2025.float16" preserve="true" />
 /**
- * Type covering all non-big typed arrays
+ * Type covering all non-big JavaScript typed arrays, including `Float16Array`.
+ *
+ * @remarks Including `Float16Array` does not guarantee that `globalThis.Float16Array` exists.
  */
-export type TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array;
+export type TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float16Array | Float32Array | Float64Array;
 /**
- * Type covering constructors for all non-big typed arrays
+ * Type covering constructors for all non-big JavaScript typed arrays, including
+ * `Float16ArrayConstructor`.
+ *
+ * @remarks Including `Float16ArrayConstructor` does not install `globalThis.Float16Array`.
  */
-export type TypedArrayConstructor = Int8ArrayConstructor | Uint8ArrayConstructor | Uint8ClampedArrayConstructor | Int16ArrayConstructor | Uint16ArrayConstructor | Int32ArrayConstructor | Uint32ArrayConstructor | Float32ArrayConstructor | Float64ArrayConstructor;
+export type TypedArrayConstructor = Int8ArrayConstructor | Uint8ArrayConstructor | Uint8ClampedArrayConstructor | Int16ArrayConstructor | Uint16ArrayConstructor | Int32ArrayConstructor | Uint32ArrayConstructor | Float16ArrayConstructor | Float32ArrayConstructor | Float64ArrayConstructor;
 /**
  * Type covering all big typed arrays
  */

package/dist/array-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-types.d.ts","sourceRoot":"","sources":["../src/array-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"array-types.d.ts","sourceRoot":"","sources":["../src/array-types.ts"],"names":[],"mappings":"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"}

package/dist/array-types.js

@@ -1,5 +1,6 @@
 // math.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
+/// <reference lib="es2025.float16" preserve="true" />
 export {};
 //# sourceMappingURL=array-types.js.map

package/dist/array-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-types.js","sourceRoot":"","sources":["../src/array-types.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC"}
+{"version":3,"file":"array-types.js","sourceRoot":"","sources":["../src/array-types.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAKpC,sDAAsD"}

package/dist/float16.d.ts

@@ -0,0 +1,26 @@
+import type { TypedArrayConstructor } from "./array-types.js";
+/**
+ * The native `Float16Array` constructor exposed by the current JavaScript runtime.
+ *
+ * @remarks This is `undefined` when the runtime does not provide `Float16Array`. The value is
+ * captured when this module is evaluated, so a polyfill must be installed before importing
+ * `@math.gl/types`.
+ */
+export declare const NativeFloat16ArrayConstructor: TypedArrayConstructor | undefined;
+/**
+ * Returns the typed array constructor used for half-precision storage.
+ *
+ * @returns The native `Float16Array` constructor when available, otherwise `Uint16Array`.
+ * @remarks The `Uint16Array` fallback stores encoded IEEE 754 binary16 bit patterns. Unlike a
+ * native `Float16Array`, it does not encode numeric assignments or decode values when read.
+ */
+export declare function getFloat16ArrayConstructor(): TypedArrayConstructor;
+/**
+ * Checks whether a value is the native `Float16Array` constructor for the current runtime.
+ *
+ * @param value The value to test.
+ * @returns `true` when `value` matches `NativeFloat16ArrayConstructor`. Returns `false` for the
+ * `Uint16Array` fallback.
+ */
+export declare function isFloat16ArrayConstructor(value: unknown): boolean;
+//# sourceMappingURL=float16.d.ts.map

package/dist/float16.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"float16.d.ts","sourceRoot":"","sources":["../src/float16.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,qBAAqB,EAAC,yBAAsB;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,EAAE,qBAAqB,GAAG,SAC3C,CAAC;AAE1B;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,qBAAqB,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEjE"}

package/dist/float16.js

@@ -0,0 +1,32 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * The native `Float16Array` constructor exposed by the current JavaScript runtime.
+ *
+ * @remarks This is `undefined` when the runtime does not provide `Float16Array`. The value is
+ * captured when this module is evaluated, so a polyfill must be installed before importing
+ * `@math.gl/types`.
+ */
+export const NativeFloat16ArrayConstructor = globalThis.Float16Array;
+/**
+ * Returns the typed array constructor used for half-precision storage.
+ *
+ * @returns The native `Float16Array` constructor when available, otherwise `Uint16Array`.
+ * @remarks The `Uint16Array` fallback stores encoded IEEE 754 binary16 bit patterns. Unlike a
+ * native `Float16Array`, it does not encode numeric assignments or decode values when read.
+ */
+export function getFloat16ArrayConstructor() {
+    return NativeFloat16ArrayConstructor ?? Uint16Array;
+}
+/**
+ * Checks whether a value is the native `Float16Array` constructor for the current runtime.
+ *
+ * @param value The value to test.
+ * @returns `true` when `value` matches `NativeFloat16ArrayConstructor`. Returns `false` for the
+ * `Uint16Array` fallback.
+ */
+export function isFloat16ArrayConstructor(value) {
+    return Boolean(NativeFloat16ArrayConstructor && value === NativeFloat16ArrayConstructor);
+}
+//# sourceMappingURL=float16.js.map

package/dist/float16.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"float16.js","sourceRoot":"","sources":["../src/float16.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAIpC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,UAAU,CAAC,YAAY,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,6BAA6B,IAAI,WAAW,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,OAAO,OAAO,CAAC,6BAA6B,IAAI,KAAK,KAAK,6BAA6B,CAAC,CAAC;AAC3F,CAAC"}

package/dist/index.cjs

@@ -17,13 +17,16 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // dist/index.js
-var dist_exports = {};
-__export(dist_exports, {
+var index_exports = {};
+__export(index_exports, {
+  NativeFloat16ArrayConstructor: () => NativeFloat16ArrayConstructor,
+  getFloat16ArrayConstructor: () => getFloat16ArrayConstructor,
+  isFloat16ArrayConstructor: () => isFloat16ArrayConstructor,
   isNumberArray: () => isNumberArray,
   isNumericArray: () => isNumericArray,
   isTypedArray: () => isTypedArray
 });
-module.exports = __toCommonJS(dist_exports);
+module.exports = __toCommonJS(index_exports);
 
 // dist/is-array.js
 function isTypedArray(value) {
@@ -38,4 +41,13 @@ function isNumberArray(value) {
 function isNumericArray(value) {
   return isTypedArray(value) || isNumberArray(value);
 }
+
+// dist/float16.js
+var NativeFloat16ArrayConstructor = globalThis.Float16Array;
+function getFloat16ArrayConstructor() {
+  return NativeFloat16ArrayConstructor ?? Uint16Array;
+}
+function isFloat16ArrayConstructor(value) {
+  return Boolean(NativeFloat16ArrayConstructor && value === NativeFloat16ArrayConstructor);
+}
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1,7 +1,6 @@
 {
   "version": 3,
-  "sources": ["../src/index.ts", "../src/is-array.ts"],
-  "sourcesContent": ["// math.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nexport type {\n  // typed arrays\n  TypedArray,\n  TypedArrayConstructor,\n  BigTypedArray,\n  BigTypedArrayConstructor,\n  // numeric arrays (sized number arrays)\n  NumberArray,\n  NumberArray1,\n  NumberArray2,\n  NumberArray3,\n  NumberArray4,\n  NumberArray6,\n  NumberArray8,\n  NumberArray9,\n  NumberArray12,\n  NumberArray16,\n  // numeric arrays (sized number arrays or typed arrays)\n  NumericArray,\n  NumericArray1,\n  NumericArray2,\n  NumericArray3,\n  NumericArray4,\n  NumericArray6,\n  NumericArray8,\n  NumericArray9,\n  NumericArray12,\n  NumericArray16\n} from './array-types';\n\nexport {isTypedArray, isNumberArray, isNumericArray} from './is-array';\n\nexport type {Bounds, Bounds2D, Bounds3D} from './bounds-types';\n", "// math.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport {TypedArray, NumericArray, NumberArray} from './array-types';\n\n/**\n * Check is an array is a typed array\n * @param value value to be tested\n * @returns input with type narrowed to TypedArray, or null\n */\nexport function isTypedArray(value: unknown): value is TypedArray {\n  return ArrayBuffer.isView(value) && !(value instanceof DataView);\n}\n\n/**\n * Check is an array is an array of numbers)\n * @param value value to be tested\n * @returns input with type narrowed to NumberArray, or null\n */\nexport function isNumberArray(value: unknown): value is NumberArray {\n  if (Array.isArray(value)) {\n    return value.length === 0 || typeof value[0] === 'number';\n  }\n  return false;\n}\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 with type narrowed to NumericArray, or null\n */\nexport function isNumericArray(value: unknown): value is NumericArray {\n  return isTypedArray(value) || isNumberArray(value);\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;ACWM,SAAU,aAAa,OAAc;AACzC,SAAO,YAAY,OAAO,KAAK,KAAK,EAAE,iBAAiB;AACzD;AAOM,SAAU,cAAc,OAAc;AAC1C,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,WAAW,KAAK,OAAO,MAAM,CAAC,MAAM;EACnD;AACA,SAAO;AACT;AAOM,SAAU,eAAe,OAAc;AAC3C,SAAO,aAAa,KAAK,KAAK,cAAc,KAAK;AACnD;",
+  "sources": ["../src/index.ts", "../src/is-array.ts", "../src/float16.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;ACWM,SAAU,aAAa,OAAc;AACzC,SAAO,YAAY,OAAO,KAAK,KAAK,EAAE,iBAAiB;AACzD;AAOM,SAAU,cAAc,OAAc;AAC1C,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,WAAW,KAAK,OAAO,MAAM,CAAC,MAAM;EACnD;AACA,SAAO;AACT;AAOM,SAAU,eAAe,OAAc;AAC3C,SAAO,aAAa,KAAK,KAAK,cAAc,KAAK;AACnD;;;ACrBO,IAAM,gCACX,WAAW;AASP,SAAU,6BAA0B;AACxC,SAAO,iCAAiC;AAC1C;AASM,SAAU,0BAA0B,OAAc;AACtD,SAAO,QAAQ,iCAAiC,UAAU,6BAA6B;AACzF;",
   "names": []
 }

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export type { TypedArray, TypedArrayConstructor, BigTypedArray, BigTypedArrayConstructor, NumberArray, NumberArray1, NumberArray2, NumberArray3, NumberArray4, NumberArray6, NumberArray8, NumberArray9, NumberArray12, NumberArray16, NumericArray, NumericArray1, NumericArray2, NumericArray3, NumericArray4, NumericArray6, NumericArray8, NumericArray9, NumericArray12, NumericArray16 } from "./array-types.js";
 export { isTypedArray, isNumberArray, isNumericArray } from "./is-array.js";
+export { NativeFloat16ArrayConstructor, getFloat16ArrayConstructor, isFloat16ArrayConstructor } from "./float16.js";
 export type { Bounds, Bounds2D, Bounds3D } from "./bounds-types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAEV,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EAExB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EAEb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACf,yBAAsB;AAEvB,OAAO,EAAC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAC,sBAAmB;AAEvE,YAAY,EAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAC,0BAAuB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAEV,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EAExB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EAEb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACf,yBAAsB;AAEvB,OAAO,EAAC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAC,sBAAmB;AACvE,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EAC1B,qBAAkB;AAEnB,YAAY,EAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAC,0BAAuB"}

package/dist/index.js

@@ -2,4 +2,5 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 export { isTypedArray, isNumberArray, isNumericArray } from "./is-array.js";
+export { NativeFloat16ArrayConstructor, getFloat16ArrayConstructor, isFloat16ArrayConstructor } from "./float16.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAgCpC,OAAO,EAAC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAC,sBAAmB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAgCpC,OAAO,EAAC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAC,sBAAmB;AACvE,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EAC1B,qBAAkB"}

package/package.json

@@ -6,7 +6,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "4.2.0-alpha.3",
+  "version": "4.2.0-alpha.5",
   "keywords": [
     "typescript",
     "javascript",
@@ -35,5 +35,5 @@
   "sideEffects": [
     "./src/bigint.js"
   ],
-  "gitHead": "4238aa95fb38da43a65c6e5f2b8343a875666d92"
+  "gitHead": "9c13785761867748e2edb167b5f2749dce803039"
 }

package/src/array-types.ts

@@ -2,8 +2,15 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
+// Float16Array is declared in a separate TypeScript library. Preserve this reference so
+// published declarations remain self-contained without changing the target or emitting runtime code.
+// eslint-disable-next-line spaced-comment
+/// <reference lib="es2025.float16" preserve="true" />
+
 /**
- * Type covering all non-big typed arrays
+ * Type covering all non-big JavaScript typed arrays, including `Float16Array`.
+ *
+ * @remarks Including `Float16Array` does not guarantee that `globalThis.Float16Array` exists.
  */
 export type TypedArray =
   | Int8Array
@@ -13,11 +20,15 @@ export type TypedArray =
   | Uint16Array
   | Int32Array
   | Uint32Array
+  | Float16Array
   | Float32Array
   | Float64Array;
 
 /**
- * Type covering constructors for all non-big typed arrays
+ * Type covering constructors for all non-big JavaScript typed arrays, including
+ * `Float16ArrayConstructor`.
+ *
+ * @remarks Including `Float16ArrayConstructor` does not install `globalThis.Float16Array`.
  */
 export type TypedArrayConstructor =
   | Int8ArrayConstructor
@@ -27,6 +38,7 @@ export type TypedArrayConstructor =
   | Uint16ArrayConstructor
   | Int32ArrayConstructor
   | Uint32ArrayConstructor
+  | Float16ArrayConstructor
   | Float32ArrayConstructor
   | Float64ArrayConstructor;
 

package/src/float16.ts

@@ -0,0 +1,37 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {TypedArrayConstructor} from './array-types';
+
+/**
+ * The native `Float16Array` constructor exposed by the current JavaScript runtime.
+ *
+ * @remarks This is `undefined` when the runtime does not provide `Float16Array`. The value is
+ * captured when this module is evaluated, so a polyfill must be installed before importing
+ * `@math.gl/types`.
+ */
+export const NativeFloat16ArrayConstructor: TypedArrayConstructor | undefined =
+  globalThis.Float16Array;
+
+/**
+ * Returns the typed array constructor used for half-precision storage.
+ *
+ * @returns The native `Float16Array` constructor when available, otherwise `Uint16Array`.
+ * @remarks The `Uint16Array` fallback stores encoded IEEE 754 binary16 bit patterns. Unlike a
+ * native `Float16Array`, it does not encode numeric assignments or decode values when read.
+ */
+export function getFloat16ArrayConstructor(): TypedArrayConstructor {
+  return NativeFloat16ArrayConstructor ?? Uint16Array;
+}
+
+/**
+ * Checks whether a value is the native `Float16Array` constructor for the current runtime.
+ *
+ * @param value The value to test.
+ * @returns `true` when `value` matches `NativeFloat16ArrayConstructor`. Returns `false` for the
+ * `Uint16Array` fallback.
+ */
+export function isFloat16ArrayConstructor(value: unknown): boolean {
+  return Boolean(NativeFloat16ArrayConstructor && value === NativeFloat16ArrayConstructor);
+}

package/src/index.ts

@@ -33,5 +33,10 @@ export type {
 } from './array-types';
 
 export {isTypedArray, isNumberArray, isNumericArray} from './is-array';
+export {
+  NativeFloat16ArrayConstructor,
+  getFloat16ArrayConstructor,
+  isFloat16ArrayConstructor
+} from './float16';
 
 export type {Bounds, Bounds2D, Bounds3D} from './bounds-types';