Auto-generated commit

stdlib-bot · stdlib-bot · commit dbf41e1a1910 · 2026-05-12T03:51:18.000Z
diff --git a/.github/.keepalive b/.github/.keepalive
diff --git a/.gitignore b/.gitignore
@@ -25,6 +25,7 @@ package.json.copy
 ###############
 build/
 downloads/
+plans/
 reports/
 tmp/
 
@@ -175,6 +176,10 @@ acs-*.bib
 *.ind
 *.ist
 
+# Git #
+#######
+.worktrees
+
 # Visual Studio #
 #################
 .vscode/
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,14 +4,15 @@
 
 <section class="release" id="unreleased">
 
-## Unreleased (2026-04-22)
+## Unreleased (2026-05-12)
 
 <section class="commits">
 
 ### Commits
 
 <details>
 
+-   [`26e94d6`](https://github.com/stdlib-js/stdlib/commit/26e94d6c922b95b2df87e603009c8de1d6f5e773) - **refactor:** update to avoid usage of global symbol _(by Athan Reines)_
 -   [`67c0a20`](https://github.com/stdlib-js/stdlib/commit/67c0a2044e515ea6733765a48be54f09ea749d8f) - **bench:** refactor to use string interpolation in `@stdlib/assert` [(#11398)](https:-/github.com/stdlib-js/stdlib/pull/11398) _(by Karan Anand)_
 
 </details>
@@ -24,8 +25,9 @@
 
 ### Contributors
 
-A total of 1 person contributed to this release. Thank you to this contributor:
+A total of 2 people contributed to this release. Thank you to the following contributors:
 
+-   Athan Reines
 -   Karan Anand
 
 </section>
diff --git a/README.md b/README.md
@@ -33,7 +33,7 @@ limitations under the License.
 
 [![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
 
-> Test if a value is a [Float16Array][mdn-float16array].
+> Test if a value is a [Float16Array][@stdlib/array/float16].
 
 <section class="installation">
 
@@ -65,13 +65,13 @@ var isFloat16Array = require( '@stdlib/assert-is-float16array' );
 
 #### isFloat16Array( value )
 
-Tests if a value is a [`Float16Array`][mdn-float16array].
-
-<!-- TODO: update example once `array/float16` is added -->
+Tests if a value is a [`Float16Array`][@stdlib/array/float16].
 
 ```javascript
-var bool = isFloat16Array( [] );
-// returns false
+var Float16Array = require( '@stdlib/array-float16' );
+
+var bool = isFloat16Array( new Float16Array( 10 ) );
+// returns true
 ```
 
 </section>
@@ -92,11 +92,15 @@ var Int16Array = require( '@stdlib/array-int16' );
 var Uint16Array = require( '@stdlib/array-uint16' );
 var Int32Array = require( '@stdlib/array-int32' );
 var Uint32Array = require( '@stdlib/array-uint32' );
+var Float16Array = require( '@stdlib/array-float16' );
 var Float32Array = require( '@stdlib/array-float32' );
 var Float64Array = require( '@stdlib/array-float64' );
 var isFloat16Array = require( '@stdlib/assert-is-float16array' );
 
-var bool = isFloat16Array( new Int8Array( 10 ) );
+var bool = isFloat16Array( new Float16Array( 10 ) );
+// returns true
+
+bool = isFloat16Array( new Int8Array( 10 ) );
 // returns false
 
 bool = isFloat16Array( new Uint8Array( 10 ) );
@@ -217,7 +221,7 @@ Copyright &copy; 2016-2026. The Stdlib [Authors][stdlib-authors].
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/assert-is-float16array/main/LICENSE
 
-[mdn-float16array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float16Array
+[@stdlib/array/float16]: https://github.com/stdlib-js/array-float16
 
 </section>
 
diff --git a/benchmark/benchmark.js b/benchmark/benchmark.js
@@ -28,6 +28,7 @@ var Int16Array = require( '@stdlib/array-int16' );
 var Uint16Array = require( '@stdlib/array-uint16' );
 var Int32Array = require( '@stdlib/array-int32' );
 var Uint32Array = require( '@stdlib/array-uint32' );
+var Float16Array = require( '@stdlib/array-float16' );
 var Float32Array = require( '@stdlib/array-float32' );
 var Float64Array = require( '@stdlib/array-float64' );
 var isBoolean = require( '@stdlib/assert-is-boolean' ).isPrimitive;
@@ -36,15 +37,6 @@ var pkg = require( './../package.json' ).name;
 var isFloat16Array = require( './../lib' );
 
 
-// VARIABLES //
-
-// TODO: remove once `array/float16` is added
-var Float16Array = ( typeof Float16Array === 'function' ) ? Float16Array : null; // eslint-disable-line no-use-before-define
-var opts = {
-	'skip': ( Float16Array === null )
-};
-
-
 // MAIN //
 
 bench( pkg, function benchmark( b ) {
@@ -79,7 +71,7 @@ bench( pkg, function benchmark( b ) {
 	b.end();
 });
 
-bench( format( '%s::true', pkg ), opts, function benchmark( b ) {
+bench( format( '%s::true', pkg ), function benchmark( b ) {
 	var values;
 	var bool;
 	var i;
diff --git a/dist/index.js b/dist/index.js
diff --git a/dist/index.js.map b/dist/index.js.map
diff --git a/docs/repl.txt b/docs/repl.txt
@@ -14,9 +14,8 @@
 
     Examples
     --------
-    // TODO: update to use `array/float16` once added
-    > var bool = {{alias}}( new {{alias:@stdlib/array/float32}}( 10 ) )
-    false
+    > var bool = {{alias}}( new {{alias:@stdlib/array/float16}}( 10 ) )
+    true
     > bool = {{alias}}( [] )
     false
 
diff --git a/docs/types/index.d.ts b/docs/types/index.d.ts
@@ -18,6 +18,10 @@
 
 // TypeScript Version: 4.1
 
+/// <reference types="@stdlib/types"/>
+
+import { Float16Array } from '@stdlib/types/array';
+
 /**
 * Tests if a value is a Float16Array.
 *
@@ -34,7 +38,7 @@
 * var bool = isFloat16Array( [] );
 * // returns false
 */
-declare function isFloat16Array( value: any ): boolean; // TODO: replace with `value is Float16Array` once `array/float16` added
+declare function isFloat16Array( value: any ): value is Float16Array;
 
 
 // EXPORTS //
diff --git a/examples/index.js b/examples/index.js
@@ -25,13 +25,16 @@ var Int16Array = require( '@stdlib/array-int16' );
 var Uint16Array = require( '@stdlib/array-uint16' );
 var Int32Array = require( '@stdlib/array-int32' );
 var Uint32Array = require( '@stdlib/array-uint32' );
+var Float16Array = require( '@stdlib/array-float16' );
 var Float32Array = require( '@stdlib/array-float32' );
 var Float64Array = require( '@stdlib/array-float64' );
 var isFloat16Array = require( './../lib' );
 
-// TODO: add example with Float16Array once `array/float16` is added
+var bool = isFloat16Array( new Float16Array( 10 ) );
+console.log( bool );
+// => true
 
-var bool = isFloat16Array( new Int8Array( 10 ) );
+bool = isFloat16Array( new Int8Array( 10 ) );
 console.log( bool );
 // => false
 
diff --git a/lib/main.js b/lib/main.js
@@ -16,18 +16,12 @@
 * limitations under the License.
 */
 
-/* eslint-disable no-undef, stdlib/jsdoc-doctest */ // TODO: remove once `array/float16` added; consider refactoring similar to `assert/is-complex128array`
-
 'use strict';
 
 // MODULES //
 
-var nativeClass = require( '@stdlib/utils-native-class' );
-
-
-// VARIABLES //
-
-var hasFloat16Array = ( typeof Float16Array === 'function' ); // eslint-disable-line stdlib/require-globals
+var Float16Array = require( '@stdlib/array-float16' );
+var constructorName = require( '@stdlib/utils-constructor-name' );
 
 
 // MAIN //
@@ -50,8 +44,8 @@ var hasFloat16Array = ( typeof Float16Array === 'function' ); // eslint-disable-
 */
 function isFloat16Array( value ) {
 	return (
-		( hasFloat16Array && value instanceof Float16Array ) || // eslint-disable-line stdlib/require-globals
-		nativeClass( value ) === '[object Float16Array]'
+		value instanceof Float16Array ||
+		constructorName( value ) === 'Float16Array'
 	);
 }
 
diff --git a/package.json b/package.json
@@ -37,7 +37,9 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/utils-native-class": "^0.2.3"
+    "@stdlib/array-float16": "github:stdlib-js/array-float16#main",
+    "@stdlib/types": "^0.4.3",
+    "@stdlib/utils-constructor-name": "^0.2.3"
   },
   "devDependencies": {
     "@stdlib/array-float32": "^0.2.3",
diff --git a/test/test.js b/test/test.js
@@ -28,6 +28,7 @@ var Int16Array = require( '@stdlib/array-int16' );
 var Uint16Array = require( '@stdlib/array-uint16' );
 var Int32Array = require( '@stdlib/array-int32' );
 var Uint32Array = require( '@stdlib/array-uint32' );
+var Float16Array = require( '@stdlib/array-float16' );
 var Float32Array = require( '@stdlib/array-float32' );
 var Float64Array = require( '@stdlib/array-float64' );
 var isFloat16Array = require( './../lib' );
@@ -41,7 +42,19 @@ tape( 'main export is a function', function test( t ) {
 	t.end();
 });
 
-// TODO: add positive assertion test once `array/float16` is added
+tape( 'the function returns `true` if provided a Float16Array', function test( t ) {
+	var values;
+	var i;
+
+	values = [
+		new Float16Array( 10 )
+	];
+
+	for ( i = 0; i < values.length; i++ ) {
+		t.strictEqual( isFloat16Array( values[i] ), true, 'returns expected value when provided ' + values[i] );
+	}
+	t.end();
+});
 
 tape( 'the function returns `false` if not provided a Float16Array', function test( t ) {
 	var values;
@@ -70,7 +83,7 @@ tape( 'the function returns `false` if not provided a Float16Array', function te
 	];
 
 	for ( i = 0; i < values.length; i++ ) {
-		t.strictEqual( isFloat16Array( values[i] ), false, 'returns false when provided ' + values[i] );
+		t.strictEqual( isFloat16Array( values[i] ), false, 'returns expected value when provided ' + values[i] );
 	}
 	t.end();
 });
