@ohos-ports/stdlib-process-read-stdin 0.0.0-stage → 0.2.3-beta.1

package/node_modules/@stdlib/utils-native-class/README.md

@@ -0,0 +1,349 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2018 The Stdlib Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+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.
+
+-->
+
+
+<details>
+  <summary>
+    About stdlib...
+  </summary>
+  <p>We believe in a future in which the web is a preferred environment for numerical computation. To help realize this future, we've built stdlib. stdlib is a standard library, with an emphasis on numerical and scientific computation, written in JavaScript (and C) for execution in browsers and in Node.js.</p>
+  <p>The library is fully decomposable, being architected in such a way that you can swap out and mix and match APIs and functionality to cater to your exact preferences and use cases.</p>
+  <p>When you use stdlib, you can be absolutely certain that you are using the most thorough, rigorous, well-written, studied, documented, tested, measured, and high-quality code out there.</p>
+  <p>To join us in bringing numerical computing to the web, get started by checking us out on <a href="https://github.com/stdlib-js/stdlib">GitHub</a>, and please consider <a href="https://opencollective.com/stdlib">financially supporting stdlib</a>. We greatly appreciate your continued support!</p>
+</details>
+
+# Native Class
+
+[![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
+
+> Determine the specification defined classification of an object.
+
+<section class="installation">
+
+## Installation
+
+```bash
+npm install @stdlib/utils-native-class
+```
+
+</section>
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var nativeClass = require( '@stdlib/utils-native-class' );
+```
+
+#### nativeClass( value )
+
+Returns a `string` value indicating a [specification defined][object-to-string] classification of an `object`.
+
+```javascript
+var str = nativeClass( 'a' );
+// returns '[object String]'
+
+str = nativeClass( 5 );
+// returns '[object Number]'
+
+function Beep() {
+    return this;
+}
+str = nativeClass( new Beep() );
+// returns '[object Object]'
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="notes">
+
+## Notes
+
+-   The function is **not** robust for ES2015+ environments. In ES2015+, [`Symbol.toStringTag`][mdn-symbol-tostringtag] allows overriding the default description of an object.
+
+    ```javascript
+    var toStr = Object.prototype.toString;
+
+    var str = toStr.call( false );
+    // returns '[object Boolean]'
+
+    var o = {};
+    str = toStr.call( o );
+    // returns '[object Object]'
+
+    // Mask the default description:
+    o[ Symbol.toStringTag ] = 'Boolean';
+
+    str = toStr.call( o );
+    // returns '[object Boolean]'
+    ```
+
+    While measures are taken to uncover the default description, such measures can be thwarted. While this function remains useful for type-checking, be aware that value impersonation is possible. Prefer functions tailored to checking for particular value types, as specialized functions are better equipped to address [`Symbol.toStringTag`][mdn-symbol-tostringtag].
+
+</section>
+
+<!-- /.notes -->
+
+<section class="examples">
+
+## Examples
+
+<!-- eslint-disable no-restricted-syntax, no-empty-function -->
+
+<!-- eslint no-undef: "error" -->
+
+```javascript
+var Float32Array = require( '@stdlib/array-float32' );
+var Float64Array = require( '@stdlib/array-float64' );
+var Int8Array = require( '@stdlib/array-int8' );
+var Int16Array = require( '@stdlib/array-int16' );
+var Int32Array = require( '@stdlib/array-int32' );
+var Uint8Array = require( '@stdlib/array-uint8' );
+var Uint8ClampedArray = require( '@stdlib/array-uint8c' );
+var Uint16Array = require( '@stdlib/array-uint16' );
+var Uint32Array = require( '@stdlib/array-uint32' );
+var ArrayBuffer = require( '@stdlib/array-buffer' );
+var Symbol = require( '@stdlib/symbol-ctor' );
+var nativeClass = require( '@stdlib/utils-native-class' );
+
+var str = nativeClass( 'a' );
+// returns '[object String]'
+
+str = nativeClass( 5 );
+// returns '[object Number]'
+
+str = nativeClass( NaN );
+// returns '[object Number]'
+
+str = nativeClass( null );
+// returns '[object Null]'
+
+str = nativeClass( void 0 );
+// returns '[object Undefined]'
+
+str = nativeClass( true );
+// returns '[object Boolean]'
+
+str = nativeClass( false );
+// returns '[object Boolean]'
+
+str = nativeClass( {} );
+// returns '[object Object]'
+
+str = nativeClass( [] );
+// returns '[object Array]'
+
+str = nativeClass( function noop() {} );
+// returns '[object Function]'
+
+str = nativeClass( /./ );
+// returns '[object RegExp]'
+
+str = nativeClass( new Date() );
+// returns '[object Date]'
+
+str = nativeClass( new Map() );
+// returns '[object Map]'
+
+str = nativeClass( new WeakMap() );
+// returns '[object WeakMap]'
+
+str = nativeClass( new Set() );
+// returns '[object Set]'
+
+str = nativeClass( new WeakSet() );
+// returns '[object WeakSet]'
+
+str = nativeClass( Symbol( 'beep' ) );
+// returns '[object Symbol]'
+
+str = nativeClass( new Error() );
+// returns '[object Error]'
+
+str = nativeClass( new TypeError() );
+// returns '[object Error]'
+
+str = nativeClass( new SyntaxError() );
+// returns '[object Error]'
+
+str = nativeClass( new URIError() );
+// returns '[object Error]'
+
+str = nativeClass( new RangeError() );
+// returns '[object Error]'
+
+str = nativeClass( new ReferenceError() );
+// returns '[object Error]'
+
+str = nativeClass( new EvalError() );
+// returns '[object Error]'
+
+str = nativeClass( new Int8Array() );
+// returns '[object Int8Array]'
+
+str = nativeClass( new Uint8Array() );
+// returns '[object Uint8Array]'
+
+str = nativeClass( new Uint8ClampedArray() );
+// returns '[object Uint8ClampedArray]'
+
+str = nativeClass( new Int16Array() );
+// returns '[object Int16Array]'
+
+str = nativeClass( new Uint16Array() );
+// returns '[object Uint16Array]'
+
+str = nativeClass( new Int32Array() );
+// returns '[object Int32Array]'
+
+str = nativeClass( new Uint32Array() );
+// returns '[object Uint32Array]'
+
+str = nativeClass( new Float32Array() );
+// returns '[object Float32Array]'
+
+str = nativeClass( new Float64Array() );
+// returns '[object Float64Array]'
+
+str = nativeClass( new ArrayBuffer() );
+// returns '[object ArrayBuffer]'
+
+str = nativeClass( Math );
+// returns '[object Math]'
+
+str = nativeClass( JSON );
+// returns '[object JSON]'
+
+function Person() {
+    return this;
+}
+str = nativeClass( new Person() );
+// returns '[object Object]'
+```
+
+</section>
+
+<!-- /.examples -->
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+* * *
+
+## See Also
+
+-   <span class="package-name">[`@stdlib/utils-constructor-name`][@stdlib/utils/constructor-name]</span><span class="delimiter">: </span><span class="description">determine the name of a value's constructor.</span>
+-   <span class="package-name">[`@stdlib/utils-type-of`][@stdlib/utils/type-of]</span><span class="delimiter">: </span><span class="description">determine a value's type.</span>
+
+</section>
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+
+<section class="main-repo" >
+
+* * *
+
+## Notice
+
+This package is part of [stdlib][stdlib], a standard library for JavaScript and Node.js, with an emphasis on numerical and scientific computing. The library provides a collection of robust, high performance libraries for mathematics, statistics, streams, utilities, and more.
+
+For more information on the project, filing bug reports and feature requests, and guidance on how to develop [stdlib][stdlib], see the main project [repository][stdlib].
+
+#### Community
+
+[![Chat][chat-image]][chat-url]
+
+---
+
+## License
+
+See [LICENSE][stdlib-license].
+
+
+## Copyright
+
+Copyright &copy; 2016-2026. The Stdlib [Authors][stdlib-authors].
+
+</section>
+
+<!-- /.stdlib -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="links">
+
+[npm-image]: http://img.shields.io/npm/v/@stdlib/utils-native-class.svg
+[npm-url]: https://npmjs.org/package/@stdlib/utils-native-class
+
+[test-image]: https://github.com/stdlib-js/utils-native-class/actions/workflows/test.yml/badge.svg?branch=v0.2.3
+[test-url]: https://github.com/stdlib-js/utils-native-class/actions/workflows/test.yml?query=branch:v0.2.3
+
+[coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/utils-native-class/main.svg
+[coverage-url]: https://codecov.io/github/stdlib-js/utils-native-class?branch=main
+
+<!--
+
+[dependencies-image]: https://img.shields.io/david/stdlib-js/utils-native-class.svg
+[dependencies-url]: https://david-dm.org/stdlib-js/utils-native-class/main
+
+-->
+
+[chat-image]: https://img.shields.io/badge/zulip-join_chat-brightgreen.svg
+[chat-url]: https://stdlib.zulipchat.com
+
+[stdlib]: https://github.com/stdlib-js/stdlib
+
+[stdlib-authors]: https://github.com/stdlib-js/stdlib/graphs/contributors
+
+[umd]: https://github.com/umdjs/umd
+[es-module]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules
+
+[deno-url]: https://github.com/stdlib-js/utils-native-class/tree/deno
+[deno-readme]: https://github.com/stdlib-js/utils-native-class/blob/deno/README.md
+[umd-url]: https://github.com/stdlib-js/utils-native-class/tree/umd
+[umd-readme]: https://github.com/stdlib-js/utils-native-class/blob/umd/README.md
+[esm-url]: https://github.com/stdlib-js/utils-native-class/tree/esm
+[esm-readme]: https://github.com/stdlib-js/utils-native-class/blob/esm/README.md
+[branches-url]: https://github.com/stdlib-js/utils-native-class/blob/main/branches.md
+
+[stdlib-license]: https://raw.githubusercontent.com/stdlib-js/utils-native-class/main/LICENSE
+
+[object-to-string]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString
+
+[mdn-symbol-tostringtag]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag
+
+<!-- <related-links> -->
+
+[@stdlib/utils/constructor-name]: https://www.npmjs.com/package/@stdlib/utils-constructor-name
+
+[@stdlib/utils/type-of]: https://www.npmjs.com/package/@stdlib/utils-type-of
+
+<!-- </related-links> -->
+
+</section>
+
+<!-- /.links -->

package/node_modules/@stdlib/utils-native-class/SECURITY.md

@@ -0,0 +1,5 @@
+# Security
+
+> Policy for reporting security vulnerabilities.
+
+See the security policy [in the main project repository](https://github.com/stdlib-js/stdlib/security).

package/node_modules/@stdlib/utils-native-class/dist/index.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="../docs/types/index.d.ts" />
+import nativeClass from '../docs/types/index';
+export = nativeClass;

package/node_modules/@stdlib/utils-native-class/dist/index.js

@@ -0,0 +1,11 @@
+"use strict";var i=function(r,t){return function(){return t||r((t={exports:{}}).exports,t),t.exports}};var a=i(function(P,l){
+var x=Object.prototype.toString;l.exports=x
+});var p=i(function(k,c){
+var y=a();function T(r){return y.call(r)}c.exports=T
+});var S=i(function(z,v){
+var g=require('@stdlib/symbol-ctor/dist'),b=typeof g=="function"?g.toStringTag:"";v.exports=b
+});var q=i(function(A,f){
+var d=require('@stdlib/assert-has-own-property/dist'),e=S(),o=a();function h(r){var t,u,n;if(r==null)return o.call(r);u=r[e],t=d(r,e);try{r[e]=void 0}catch(C){return o.call(r)}return n=o.call(r),t?r[e]=u:delete r[e],n}f.exports=h
+});var O=require('@stdlib/assert-has-tostringtag-support/dist'),m=p(),w=q(),s;O()?s=w:s=m;module.exports=s;
+/** @license Apache-2.0 */
+//# sourceMappingURL=index.js.map

package/node_modules/@stdlib/utils-native-class/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../lib/tostring.js", "../lib/main.js", "../lib/tostringtag.js", "../lib/polyfill.js", "../lib/index.js"],
+  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MAIN //\n\nvar toStr = Object.prototype.toString;\n\n\n// EXPORTS //\n\nmodule.exports = toStr;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar toStr = require( './tostring.js' );\n\n\n// MAIN //\n\n/**\n* Returns a string value indicating a specification defined classification (via the internal property `[[Class]]`) of an object.\n*\n* @param {*} v - input value\n* @returns {string} string value indicating a specification defined classification of the input value\n*\n* @example\n* var str = nativeClass( 'a' );\n* // returns '[object String]'\n*\n* @example\n* var str = nativeClass( 5 );\n* // returns '[object Number]'\n*\n* @example\n* function Beep() {\n*     return this;\n* }\n* var str = nativeClass( new Beep() );\n* // returns '[object Object]'\n*/\nfunction nativeClass( v ) {\n\treturn toStr.call( v );\n}\n\n\n// EXPORTS //\n\nmodule.exports = nativeClass;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar Symbol = require( '@stdlib/symbol-ctor' );\n\n\n// MAIN //\n\nvar toStrTag = ( typeof Symbol === 'function' ) ? Symbol.toStringTag : '';\n\n\n// EXPORTS //\n\nmodule.exports = toStrTag;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar hasOwnProp = require( '@stdlib/assert-has-own-property' );\nvar toStringTag = require( './tostringtag.js' );\nvar toStr = require( './tostring.js' );\n\n\n// MAIN //\n\n/**\n* Returns a string value indicating a specification defined classification of an object in environments supporting `Symbol.toStringTag`.\n*\n* @param {*} v - input value\n* @returns {string} string value indicating a specification defined classification of the input value\n*\n* @example\n* var str = nativeClass( 'a' );\n* // returns '[object String]'\n*\n* @example\n* var str = nativeClass( 5 );\n* // returns '[object Number]'\n*\n* @example\n* function Beep() {\n*     return this;\n* }\n* var str = nativeClass( new Beep() );\n* // returns '[object Object]'\n*/\nfunction nativeClass( v ) {\n\tvar isOwn;\n\tvar tag;\n\tvar out;\n\n\tif ( v === null || v === void 0 ) {\n\t\treturn toStr.call( v );\n\t}\n\ttag = v[ toStringTag ];\n\tisOwn = hasOwnProp( v, toStringTag );\n\n\t// Attempt to override the `toStringTag` property. For built-ins having a `Symbol.toStringTag` property (e.g., `JSON`, `Math`, etc), the `Symbol.toStringTag` property is read-only (e.g., , so we need to wrap in a `try/catch`.\n\ttry {\n\t\tv[ toStringTag ] = void 0;\n\t} catch ( err ) { // eslint-disable-line no-unused-vars\n\t\treturn toStr.call( v );\n\t}\n\tout = toStr.call( v );\n\n\tif ( isOwn ) {\n\t\tv[ toStringTag ] = tag;\n\t} else {\n\t\tdelete v[ toStringTag ];\n\t}\n\treturn out;\n}\n\n\n// EXPORTS //\n\nmodule.exports = nativeClass;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n/**\n* Return a string value indicating a specification defined classification of an object.\n*\n* @module @stdlib/utils-native-class\n*\n* @example\n* var nativeClass = require( '@stdlib/utils-native-class' );\n*\n* var str = nativeClass( 'a' );\n* // returns '[object String]'\n*\n* str = nativeClass( 5 );\n* // returns '[object Number]'\n*\n* function Beep() {\n*     return this;\n* }\n* str = nativeClass( new Beep() );\n* // returns '[object Object]'\n*/\n\n// MODULES //\n\nvar hasToStringTag = require( '@stdlib/assert-has-tostringtag-support' );\nvar builtin = require( './main.js' );\nvar polyfill = require( './polyfill.js' );\n\n\n// MAIN //\n\nvar main;\nif ( hasToStringTag() ) {\n\tmain = polyfill;\n} else {\n\tmain = builtin;\n}\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
+  "mappings": "uGAAA,IAAAA,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAQ,OAAO,UAAU,SAK7BD,EAAO,QAAUC,IC3BjB,IAAAC,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAQ,IA0BZ,SAASC,EAAaC,EAAI,CACzB,OAAOF,EAAM,KAAME,CAAE,CACtB,CAKAH,EAAO,QAAUE,ICvDjB,IAAAE,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAS,QAAS,qBAAsB,EAKxCC,EAAa,OAAOD,GAAW,WAAeA,EAAO,YAAc,GAKvED,EAAO,QAAUE,IChCjB,IAAAC,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAa,QAAS,iCAAkC,EACxDC,EAAc,IACdC,EAAQ,IA0BZ,SAASC,EAAaC,EAAI,CACzB,IAAIC,EACAC,EACAC,EAEJ,GAAKH,GAAM,KACV,OAAOF,EAAM,KAAME,CAAE,EAEtBE,EAAMF,EAAGH,CAAY,EACrBI,EAAQL,EAAYI,EAAGH,CAAY,EAGnC,GAAI,CACHG,EAAGH,CAAY,EAAI,MACpB,OAAUO,EAAM,CACf,OAAON,EAAM,KAAME,CAAE,CACtB,CACA,OAAAG,EAAML,EAAM,KAAME,CAAE,EAEfC,EACJD,EAAGH,CAAY,EAAIK,EAEnB,OAAOF,EAAGH,CAAY,EAEhBM,CACR,CAKAR,EAAO,QAAUI,ICrCjB,IAAIM,EAAiB,QAAS,wCAAyC,EACnEC,EAAU,IACVC,EAAW,IAKXC,EACCH,EAAe,EACnBG,EAAOD,EAEPC,EAAOF,EAMR,OAAO,QAAUE",
+  "names": ["require_tostring", "__commonJSMin", "exports", "module", "toStr", "require_main", "__commonJSMin", "exports", "module", "toStr", "nativeClass", "v", "require_tostringtag", "__commonJSMin", "exports", "module", "Symbol", "toStrTag", "require_polyfill", "__commonJSMin", "exports", "module", "hasOwnProp", "toStringTag", "toStr", "nativeClass", "v", "isOwn", "tag", "out", "err", "hasToStringTag", "builtin", "polyfill", "main"]
+}

package/node_modules/@stdlib/utils-native-class/docs/types/index.d.ts

@@ -0,0 +1,51 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2019 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* 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.
+*/
+
+// TypeScript Version: 4.1
+
+/**
+* Returns a string value indicating a specification defined classification (via the internal property `[[Class]]`) of an object.
+*
+* ## Notes
+*
+* -   The function is *not* robust for ES2015+ environments. In ES2015+, `Symbol.toStringTag` allows overriding the default description of an object. While measures are taken to uncover the default description, such measures can be thwarted. While this function remains useful for type-checking, be aware that value impersonation is possible. Where possible, prefer functions tailored to checking for particular value types, as specialized functions are better equipped to address `Symbol.toStringTag`.
+*
+* @param v - input value
+* @returns string value indicating a specification defined classification of the input value
+*
+* @example
+* var str = nativeClass( 'a' );
+* // returns '[object String]'
+*
+* @example
+* var str = nativeClass( 5 );
+* // returns '[object Number]'
+*
+* @example
+* function Beep() {
+*     return this;
+* }
+* var str = nativeClass( new Beep() );
+* // returns '[object Object]'
+*/
+declare function nativeClass( v: any ): string;
+
+
+// EXPORTS //
+
+export = nativeClass;

package/node_modules/@stdlib/utils-native-class/lib/index.js

@@ -0,0 +1,61 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* 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.
+*/
+
+'use strict';
+
+/**
+* Return a string value indicating a specification defined classification of an object.
+*
+* @module @stdlib/utils-native-class
+*
+* @example
+* var nativeClass = require( '@stdlib/utils-native-class' );
+*
+* var str = nativeClass( 'a' );
+* // returns '[object String]'
+*
+* str = nativeClass( 5 );
+* // returns '[object Number]'
+*
+* function Beep() {
+*     return this;
+* }
+* str = nativeClass( new Beep() );
+* // returns '[object Object]'
+*/
+
+// MODULES //
+
+var hasToStringTag = require( '@stdlib/assert-has-tostringtag-support' );
+var builtin = require( './main.js' );
+var polyfill = require( './polyfill.js' );
+
+
+// MAIN //
+
+var main;
+if ( hasToStringTag() ) {
+	main = polyfill;
+} else {
+	main = builtin;
+}
+
+
+// EXPORTS //
+
+module.exports = main;

package/node_modules/@stdlib/utils-native-class/lib/main.js

@@ -0,0 +1,56 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* 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.
+*/
+
+'use strict';
+
+// MODULES //
+
+var toStr = require( './tostring.js' );
+
+
+// MAIN //
+
+/**
+* Returns a string value indicating a specification defined classification (via the internal property `[[Class]]`) of an object.
+*
+* @param {*} v - input value
+* @returns {string} string value indicating a specification defined classification of the input value
+*
+* @example
+* var str = nativeClass( 'a' );
+* // returns '[object String]'
+*
+* @example
+* var str = nativeClass( 5 );
+* // returns '[object Number]'
+*
+* @example
+* function Beep() {
+*     return this;
+* }
+* var str = nativeClass( new Beep() );
+* // returns '[object Object]'
+*/
+function nativeClass( v ) {
+	return toStr.call( v );
+}
+
+
+// EXPORTS //
+
+module.exports = nativeClass;

package/node_modules/@stdlib/utils-native-class/lib/polyfill.js

@@ -0,0 +1,81 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* 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.
+*/
+
+'use strict';
+
+// MODULES //
+
+var hasOwnProp = require( '@stdlib/assert-has-own-property' );
+var toStringTag = require( './tostringtag.js' );
+var toStr = require( './tostring.js' );
+
+
+// MAIN //
+
+/**
+* Returns a string value indicating a specification defined classification of an object in environments supporting `Symbol.toStringTag`.
+*
+* @param {*} v - input value
+* @returns {string} string value indicating a specification defined classification of the input value
+*
+* @example
+* var str = nativeClass( 'a' );
+* // returns '[object String]'
+*
+* @example
+* var str = nativeClass( 5 );
+* // returns '[object Number]'
+*
+* @example
+* function Beep() {
+*     return this;
+* }
+* var str = nativeClass( new Beep() );
+* // returns '[object Object]'
+*/
+function nativeClass( v ) {
+	var isOwn;
+	var tag;
+	var out;
+
+	if ( v === null || v === void 0 ) {
+		return toStr.call( v );
+	}
+	tag = v[ toStringTag ];
+	isOwn = hasOwnProp( v, toStringTag );
+
+	// Attempt to override the `toStringTag` property. For built-ins having a `Symbol.toStringTag` property (e.g., `JSON`, `Math`, etc), the `Symbol.toStringTag` property is read-only (e.g., , so we need to wrap in a `try/catch`.
+	try {
+		v[ toStringTag ] = void 0;
+	} catch ( err ) { // eslint-disable-line no-unused-vars
+		return toStr.call( v );
+	}
+	out = toStr.call( v );
+
+	if ( isOwn ) {
+		v[ toStringTag ] = tag;
+	} else {
+		delete v[ toStringTag ];
+	}
+	return out;
+}
+
+
+// EXPORTS //
+
+module.exports = nativeClass;

package/node_modules/@stdlib/utils-native-class/lib/tostring.js

@@ -0,0 +1,28 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* 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.
+*/
+
+'use strict';
+
+// MAIN //
+
+var toStr = Object.prototype.toString;
+
+
+// EXPORTS //
+
+module.exports = toStr;