@stdlib/complex-float32 0.2.1 → 0.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 @license Apache-2.0
 
-Copyright (c) 2018 The Stdlib Authors.
+Copyright (c) 2024 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.
@@ -33,17 +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] -->
 
-> 64-bit complex number.
-
-<!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
-
-<section class="intro">
-
-</section>
-
-<!-- /.intro -->
-
-<!-- Package usage documentation. -->
+> Single-precision complex floating-point number functions.
 
 <section class="installation">
 
@@ -60,478 +50,83 @@ npm install @stdlib/complex-float32
 ## Usage
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-```
-
-#### Complex64( real, imag )
-
-64-bit complex number constructor, where `real` and `imag` are the **real** and **imaginary** components, respectively.
-
-```javascript
-var z = new Complex64( 5.0, 3.0 );
-// returns <Complex64>
-```
-
-* * *
-
-## Properties
-
-#### Complex64.BYTES_PER_ELEMENT
-
-Size (in bytes) of each component.
-
-```javascript
-var nbytes = Complex64.BYTES_PER_ELEMENT;
-// returns 4
-```
-
-#### Complex64.prototype.BYTES_PER_ELEMENT
-
-Size (in bytes) of each component.
-
-```javascript
-var z = new Complex64( 5.0, 3.0 );
-
-var nbytes = z.BYTES_PER_ELEMENT;
-// returns 4
-```
-
-#### Complex64.prototype.byteLength
-
-Length (in bytes) of a complex number.
-
-```javascript
-var z = new Complex64( 5.0, 3.0 );
-
-var nbytes = z.byteLength;
-// returns 8
-```
-
-### Instance
-
-A `Complex64` instance has the following properties...
-
-#### re
-
-A **read-only** property returning the **real** component.
-
-```javascript
-var z = new Complex64( 5.0, 3.0 );
-
-var re = z.re;
-// returns 5.0
+var complex = require( '@stdlib/complex-float32' );
 ```
 
-#### im
+#### complex
 
-A **read-only** property returning the **imaginary** component.
+Namespace containing single-precision complex floating-point number functions.
 
 ```javascript
-var z = new Complex64( 5.0, -3.0 );
-
-var im = z.im;
-// returns -3.0
+var ns = complex;
+// returns {...}
 ```
 
-* * *
+The namespace contains the following sub-namespaces:
 
-## Methods
+<!-- <toc pattern="+(base)"> -->
 
-### Accessor Methods
+<div class="namespace-toc">
 
-These methods do **not** mutate a `Complex64` instance and, instead, return a complex number representation.
+-   <span class="signature">[`base`][@stdlib/complex/float32/base]</span><span class="delimiter">: </span><span class="description">base (i.e., lower-level) single-precision complex floating-point number functions.</span>
 
-#### Complex64.prototype.toString()
+</div>
 
-Returns a `string` representation of a `Complex64` instance.
+<!-- </toc> -->
 
-```javascript
-var z = new Complex64( 5.0, 3.0 );
-var str = z.toString();
-// returns '5 + 3i'
+The namespace contains the following functions:
 
-z = new Complex64( -5.0, -3.0 );
-str = z.toString();
-// returns '-5 - 3i'
-```
+<!-- <toc pattern="*"> -->
 
-#### Complex64.prototype.toJSON()
+<div class="namespace-toc">
 
-Returns a [JSON][json] representation of a `Complex64` instance. [`JSON.stringify()`][mdn-json-stringify] implicitly calls this method when stringifying a `Complex64` instance.
+-   <span class="signature">[`conj( z )`][@stdlib/complex/float32/conj]</span><span class="delimiter">: </span><span class="description">return the complex conjugate of a single-precision complex floating-point number.</span>
+-   <span class="signature">[`Complex64( real, imag )`][@stdlib/complex/float32/ctor]</span><span class="delimiter">: </span><span class="description">64-bit complex number.</span>
+-   <span class="signature">[`imag( z )`][@stdlib/complex/float32/imag]</span><span class="delimiter">: </span><span class="description">return the imaginary component of a single-precision complex floating-point number.</span>
+-   <span class="signature">[`parseComplex64( str )`][@stdlib/complex/float32/parse]</span><span class="delimiter">: </span><span class="description">parse a string representation of a 64-bit complex number.</span>
+-   <span class="signature">[`real( z )`][@stdlib/complex/float32/real]</span><span class="delimiter">: </span><span class="description">return the real component of a single-precision complex floating-point number.</span>
+-   <span class="signature">[`reim( z )`][@stdlib/complex/float32/reim]</span><span class="delimiter">: </span><span class="description">return the real and imaginary components of a single-precision complex floating-point number.</span>
+-   <span class="signature">[`reviveComplex64( key, value )`][@stdlib/complex/float32/reviver]</span><span class="delimiter">: </span><span class="description">revive a JSON-serialized 64-bit complex number.</span>
 
-```javascript
-var z = new Complex64( 5.0, -3.0 );
-
-var o = z.toJSON();
-/*
-  {
-    "type": "Complex64",
-    "re": 5.0,
-    "im": -3.0
-  }
-*/
-```
+</div>
 
-To [revive][mdn-json-parse] a `Complex64` number from a [JSON][json] `string`, see [@stdlib/complex/reviver-float32][@stdlib/complex/reviver-float32].
+<!-- </toc> -->
 
 </section>
 
 <!-- /.usage -->
 
-* * *
-
-<!-- Package usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+<!-- Package notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
 
 <section class="notes">
 
-## Notes
-
--   Both the **real** and **imaginary** components are stored as single-precision floating-point numbers.
-
 </section>
 
 <!-- /.notes -->
 
-* * *
-
-<!-- Package usage examples. -->
-
 <section class="examples">
 
 ## Examples
 
+<!-- TODO: better examples -->
+
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var Complex64 = require( '@stdlib/complex-float32' );
-
-var z = new Complex64( 3.0, -2.0 );
+var objectKeys = require( '@stdlib/utils-keys' );
+var ns = require( '@stdlib/complex-float32' );
 
-console.log( 'type: %s', typeof z );
-// => 'type: object'
-
-console.log( 'str: %s', z );
-// => 'str: 3 - 2i'
-
-console.log( 'real: %d', z.re );
-// => 'real: 3'
-
-console.log( 'imag: %d', z.im );
-// => 'imag: -2'
-
-console.log( 'JSON: %s', JSON.stringify( z ) );
-// => 'JSON: {"type":"Complex64","re":3,"im":-2}'
+console.log( objectKeys( ns ) );
 ```
 
 </section>
 
 <!-- /.examples -->
 
-<!-- C interface documentation. -->
-
-* * *
-
-<section class="c">
-
-## C APIs
-
-<!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
-
-<section class="intro">
-
-</section>
-
-<!-- /.intro -->
-
-<!-- C usage documentation. -->
-
-<section class="usage">
-
-### Usage
-
-```c
-#include "stdlib/complex/float32.h"
-```
-
-#### stdlib_complex64_t
-
-An opaque type definition for a single-precision complex floating-point number.
-
-```c
-stdlib_complex64_t z = stdlib_complex64( 5.0f, 2.0f );
-```
-
-#### stdlib_complex64_parts_t
-
-An opaque type definition for a union for accessing the real and imaginary parts of a single-precision complex floating-point number.
-
-```c
-float realf( const stdlib_complex64_t z ) {
-    stdlib_complex64_parts_t v;
-
-    // Assign a single-precision complex floating-point number:
-    v.value = z;
-
-    // Extract the real component:
-    float re = v.parts[ 0 ];
-
-    return re;
-}
-
-// ...
-
-// Create a complex number:
-stdlib_complex64_t z = stdlib_complex64( 5.0f, 2.0f );
-
-// ...
-
-// Access the real component:
-float re = realf( z );
-// returns 5.0f
-```
-
-The union has the following members:
-
--   **value**: `stdlib_complex64_t` single-precision complex floating-point number.
-
--   **parts**: `float[]` array having the following elements:
-
-    -   **0**: `float` real component.
-    -   **1**: `float` imaginary component.
-
-#### stdlib_complex64( real, imag )
-
-Returns a single-precision complex floating-point number.
-
-```c
-stdlib_complex64_t z = stdlib_complex64( 5.0f, 2.0f );
-```
-
-The function accepts the following arguments:
-
--   **real**: `[in] float` real component.
--   **imag**: `[in] float` imaginary component.
-
-```c
-stdlib_complex64_t stdlib_complex64( const float real, const float imag );
-```
-
-#### stdlib_complex64_from_float32( real )
-
-Converts a single-precision floating-point number to a single-precision complex floating-point number.
-
-```c
-stdlib_complex64_t z = stdlib_complex64_from_float32( 5.0f );
-```
-
-The function accepts the following arguments:
-
--   **real**: `[in] float` real component.
-
-```c
-stdlib_complex64_t stdlib_complex64_from_float32( const float real );
-```
-
-#### stdlib_complex64_from_float64( real )
-
-Converts a double-precision floating-point number to a single-precision complex floating-point number.
-
-```c
-stdlib_complex64_t z = stdlib_complex64_from_float64( 5.0 );
-```
-
-The function accepts the following arguments:
-
--   **real**: `[in] double` real component.
-
-```c
-stdlib_complex64_t stdlib_complex64_from_float64( const double real );
-```
-
-#### stdlib_complex64_from_complex64( z )
-
-Converts (copies) a single-precision complex floating-point number to a single-precision complex floating-point number.
-
-```c
-stdlib_complex64_t z1 = stdlib_complex64( 5.0f, 3.0f );
-stdlib_complex64_t z2 = stdlib_complex64_from_complex64( z1 );
-```
-
-The function accepts the following arguments:
-
--   **z**: `[in] stdlib_complex64_t` single-precision complex floating-point number.
-
-```c
-stdlib_complex64_t stdlib_complex64_from_complex64( const stdlib_complex64_t z );
-```
-
-#### stdlib_complex64_from_int8( real )
-
-Converts a signed 8-bit integer to a single-precision complex floating-point number.
-
-```c
-stdlib_complex64_t z = stdlib_complex64_from_int8( 5 );
-```
-
-The function accepts the following arguments:
-
--   **real**: `[in] int8_t` real component.
-
-```c
-stdlib_complex64_t stdlib_complex64_from_int8( const int8_t real );
-```
-
-#### stdlib_complex64_from_uint8( real )
-
-Converts an unsigned 8-bit integer to a single-precision complex floating-point number.
-
-```c
-stdlib_complex64_t z = stdlib_complex64_from_uint8( 5 );
-```
-
-The function accepts the following arguments:
-
--   **real**: `[in] uint8_t` real component.
-
-```c
-stdlib_complex64_t stdlib_complex64_from_uint8( const uint8_t real );
-```
-
-#### stdlib_complex64_from_int16( real )
-
-Converts a signed 16-bit integer to a single-precision complex floating-point number.
-
-```c
-stdlib_complex64_t z = stdlib_complex64_from_int16( 5 );
-```
-
-The function accepts the following arguments:
-
--   **real**: `[in] int16_t` real component.
-
-```c
-stdlib_complex64_t stdlib_complex64_from_int16( const int16_t real );
-```
-
-#### stdlib_complex64_from_uint16( real )
-
-Converts an unsigned 16-bit integer to a single-precision complex floating-point number.
-
-```c
-stdlib_complex64_t z = stdlib_complex64_from_uint16( 5 );
-```
-
-The function accepts the following arguments:
-
--   **real**: `[in] uint16_t` real component.
-
-```c
-stdlib_complex64_t stdlib_complex64_from_uint16( const uint16_t real );
-```
-
-</section>
-
-<!-- /.usage -->
-
-<!-- C API usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
-
-<section class="notes">
-
-</section>
-
-<!-- /.notes -->
-
-<!-- C API usage examples. -->
-
-<section class="examples">
-
-### Examples
-
-```c
-#include "stdlib/complex/float32.h"
-#include <stdint.h>
-#include <stdio.h>
-
-/**
-* Return the real component of a single-precision complex floating-point number.
-*
-* @param z    complex number
-* @return     real component
-*/
-static float real( const stdlib_complex64_t z ) {
-    stdlib_complex64_parts_t v;
-
-    // Assign a single-precision complex floating-point number:
-    v.value = z;
-
-    // Extract the real component:
-    float re = v.parts[ 0 ];
-
-    return re;
-}
-
-/**
-* Return the imaginary component of a single-precision complex floating-point number.
-*
-* @param z    complex number
-* @return     imaginary component
-*/
-static float imag( const stdlib_complex64_t z ) {
-    stdlib_complex64_parts_t v;
-
-    // Assign a single-precision complex floating-point number:
-    v.value = z;
-
-    // Extract the imaginary component:
-    float im = v.parts[ 1 ];
-
-    return im;
-}
-
-int main( void ) {
-    const stdlib_complex64_t x[] = {
-        stdlib_complex64( 5.0f, 2.0f ),
-        stdlib_complex64( -2.0f, 1.0f ),
-        stdlib_complex64( 0.0f, -0.0f ),
-        stdlib_complex64( 0.0f/0.0f, 0.0f/0.0f )
-    };
-
-    stdlib_complex64_t v;
-    int i;
-    for ( i = 0; i < 4; i++ ) {
-        v = x[ i ];
-        printf( "%f + %fi\n", real( v ), imag( v ) );
-    }
-}
-```
-
-</section>
-
-<!-- /.examples -->
-
-</section>
-
-<!-- /.c -->
-
-<!-- Section to include cited references. If references are included, add a horizontal rule *before* the section. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
-
-<section class="references">
-
-</section>
-
-<!-- /.references -->
-
 <!-- 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/complex-cmplx`][@stdlib/complex/cmplx]</span><span class="delimiter">: </span><span class="description">create a complex number.</span>
--   <span class="package-name">[`@stdlib/complex-float64`][@stdlib/complex/float64]</span><span class="delimiter">: </span><span class="description">128-bit complex number.</span>
-
 </section>
 
 <!-- /.related -->
@@ -575,8 +170,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/complex-float32.svg
 [npm-url]: https://npmjs.org/package/@stdlib/complex-float32
 
-[test-image]: https://github.com/stdlib-js/complex-float32/actions/workflows/test.yml/badge.svg?branch=v0.2.1
-[test-url]: https://github.com/stdlib-js/complex-float32/actions/workflows/test.yml?query=branch:v0.2.1
+[test-image]: https://github.com/stdlib-js/complex-float32/actions/workflows/test.yml/badge.svg?branch=v0.3.0
+[test-url]: https://github.com/stdlib-js/complex-float32/actions/workflows/test.yml?query=branch:v0.3.0
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/complex-float32/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/complex-float32?branch=main
@@ -608,21 +203,25 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/complex-float32/main/LICENSE
 
-[json]: http://www.json.org/
+<!-- <toc-links> -->
+
+[@stdlib/complex/float32/conj]: https://www.npmjs.com/package/@stdlib/complex-float32-conj
+
+[@stdlib/complex/float32/ctor]: https://www.npmjs.com/package/@stdlib/complex-float32-ctor
 
-[mdn-json-stringify]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify
+[@stdlib/complex/float32/imag]: https://www.npmjs.com/package/@stdlib/complex-float32-imag
 
-[mdn-json-parse]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse
+[@stdlib/complex/float32/parse]: https://www.npmjs.com/package/@stdlib/complex-float32-parse
 
-[@stdlib/complex/reviver-float32]: https://www.npmjs.com/package/@stdlib/complex-reviver-float32
+[@stdlib/complex/float32/real]: https://www.npmjs.com/package/@stdlib/complex-float32-real
 
-<!-- <related-links> -->
+[@stdlib/complex/float32/reim]: https://www.npmjs.com/package/@stdlib/complex-float32-reim
 
-[@stdlib/complex/cmplx]: https://www.npmjs.com/package/@stdlib/complex-cmplx
+[@stdlib/complex/float32/reviver]: https://www.npmjs.com/package/@stdlib/complex-float32-reviver
 
-[@stdlib/complex/float64]: https://www.npmjs.com/package/@stdlib/complex-float64
+[@stdlib/complex/float32/base]: https://www.npmjs.com/package/@stdlib/complex-float32-base
 
-<!-- </related-links> -->
+<!-- </toc-links> -->
 
 </section>
 

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,9 +1,3 @@
-"use strict";var o=function(e,r){return function(){return r||e((r={exports:{}}).exports,r),r.exports}};var a=o(function(S,n){
-function c(){var e=""+this.re;return this.im<0?e+=" - "+-this.im:e+=" + "+this.im,e+="i",e}n.exports=c
-});var u=o(function(T,s){
-function b(){var e={};return e.type="Complex64",e.re=this.re,e.im=this.im,e}s.exports=b
-});var h=o(function(d,v){
-var l=require('@stdlib/assert-is-number/dist').isPrimitive,m=require('@stdlib/utils-define-property/dist'),i=require('@stdlib/utils-define-nonenumerable-read-only-property/dist'),p=require('@stdlib/number-float64-base-to-float32/dist'),f=require('@stdlib/error-tools-fmtprodmsg/dist'),y=a(),E=u();function t(e,r){if(!(this instanceof t))throw new TypeError(f('0Gp0G'));if(!l(e))throw new TypeError(f('0Gp3e',e));if(!l(r))throw new TypeError(f('0Gp3f',r));return m(this,"re",{configurable:!1,enumerable:!0,writable:!1,value:p(e)}),m(this,"im",{configurable:!1,enumerable:!0,writable:!1,value:p(r)}),this}i(t,"BYTES_PER_ELEMENT",4);i(t.prototype,"BYTES_PER_ELEMENT",4);i(t.prototype,"byteLength",8);i(t.prototype,"toString",y);i(t.prototype,"toJSON",E);v.exports=t
-});var w=h();module.exports=w;
+"use strict";var r=require('@stdlib/utils-define-read-only-property/dist'),e={};r(e,"base",require('@stdlib/complex-float32-base/dist'));r(e,"conj",require('@stdlib/complex-float32-conj/dist'));r(e,"Complex64",require('@stdlib/complex-float32-ctor/dist'));r(e,"imag",require('@stdlib/complex-float32-imag/dist'));r(e,"parseComplex64",require('@stdlib/complex-float32-parse/dist'));r(e,"real",require('@stdlib/complex-float32-real/dist'));r(e,"reim",require('@stdlib/complex-float32-reim/dist'));r(e,"reviveComplex64",require('@stdlib/complex-float32-reviver/dist'));module.exports=e;
 /** @license Apache-2.0 */
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../lib/tostring.js", "../lib/tojson.js", "../lib/main.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/**\n* Serializes a complex number as a string.\n*\n* @private\n* @returns {string} serialized complex number\n*/\nfunction toString() { // eslint-disable-line stdlib/no-redeclare\n\t/* eslint-disable no-invalid-this */\n\tvar str = '' + this.re;\n\tif ( this.im < 0 ) {\n\t\tstr += ' - ' + (-this.im);\n\t} else {\n\t\tstr += ' + ' + this.im;\n\t}\n\tstr += 'i';\n\treturn str;\n}\n\n\n// EXPORTS //\n\nmodule.exports = toString;\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* Serializes a complex number as a JSON object.\n*\n* @private\n* @returns {Object} JSON representation\n*/\nfunction toJSON() {\n\t/* eslint-disable no-invalid-this */\n\tvar out = {};\n\tout.type = 'Complex64';\n\tout.re = this.re;\n\tout.im = this.im;\n\treturn out;\n}\n\n\n// EXPORTS //\n\nmodule.exports = toJSON;\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 isNumber = require( '@stdlib/assert-is-number' ).isPrimitive;\nvar defineProperty = require( '@stdlib/utils-define-property' );\nvar setReadOnly = require( '@stdlib/utils-define-nonenumerable-read-only-property' );\nvar float64ToFloat32 = require( '@stdlib/number-float64-base-to-float32' );\nvar format = require( '@stdlib/string-format' );\nvar toStr = require( './tostring.js' );\nvar toJSON = require( './tojson.js' );\n\n\n// MAIN //\n\n/**\n* 64-bit complex number constructor.\n*\n* @constructor\n* @param {number} real - real component\n* @param {number} imag - imaginary component\n* @throws {TypeError} must invoke using the `new` keyword\n* @throws {TypeError} real component must be a number\n* @throws {TypeError} imaginary component must be a number\n* @returns {Complex64} 64-bit complex number\n*\n* @example\n* var z = new Complex64( 5.0, 3.0 );\n* // returns <Complex64>\n*/\nfunction Complex64( real, imag ) {\n\tif ( !( this instanceof Complex64 ) ) {\n\t\tthrow new TypeError( 'invalid invocation. Constructor must be called with the `new` keyword.' );\n\t}\n\tif ( !isNumber( real ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. Real component must be a number. Value: `%s`.', real ) );\n\t}\n\tif ( !isNumber( imag ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. Imaginary component must be a number. Value: `%s`.', imag ) );\n\t}\n\tdefineProperty( this, 're', {\n\t\t'configurable': false,\n\t\t'enumerable': true,\n\t\t'writable': false,\n\t\t'value': float64ToFloat32( real )\n\t});\n\tdefineProperty( this, 'im', {\n\t\t'configurable': false,\n\t\t'enumerable': true,\n\t\t'writable': false,\n\t\t'value': float64ToFloat32( imag )\n\t});\n\treturn this;\n}\n\n/**\n* Size (in bytes) of each component.\n*\n* @name BYTES_PER_ELEMENT\n* @memberof Complex64\n* @type {integer}\n* @returns {integer} size of each component\n*\n* @example\n* var nbytes = Complex64.BYTES_PER_ELEMENT;\n* // returns 4\n*/\nsetReadOnly( Complex64, 'BYTES_PER_ELEMENT', 4 );\n\n/**\n* Size (in bytes) of each component.\n*\n* @name BYTES_PER_ELEMENT\n* @memberof Complex64.prototype\n* @type {integer}\n* @returns {integer} size of each component\n*\n* @example\n* var z = new Complex64( 5.0, 3.0 );\n*\n* var nbytes = z.BYTES_PER_ELEMENT;\n* // returns 4\n*/\nsetReadOnly( Complex64.prototype, 'BYTES_PER_ELEMENT', 4 );\n\n/**\n* Length (in bytes) of a complex number.\n*\n* @name byteLength\n* @memberof Complex64.prototype\n* @type {integer}\n* @returns {integer} byte length\n*\n* @example\n* var z = new Complex64( 5.0, 3.0 );\n*\n* var nbytes = z.byteLength;\n* // returns 8\n*/\nsetReadOnly( Complex64.prototype, 'byteLength', 8 );\n\n/**\n* Serializes a complex number as a string.\n*\n* @name toString\n* @memberof Complex64.prototype\n* @type {Function}\n* @returns {string} serialized complex number\n*\n* @example\n* var z = new Complex64( 5.0, 3.0 );\n*\n* var str = z.toString();\n* // returns '5 + 3i'\n*/\nsetReadOnly( Complex64.prototype, 'toString', toStr );\n\n/**\n* Serializes a complex number as a JSON object.\n*\n* ## Notes\n*\n* -   `JSON.stringify()` implicitly calls this method when stringifying a `Complex64` instance.\n*\n* @name toJSON\n* @memberof Complex64.prototype\n* @type {Function}\n* @returns {Object} serialized complex number\n*\n* @example\n* var z = new Complex64( 5.0, 3.0 );\n*\n* var obj = z.toJSON();\n* // returns { 'type': 'Complex64', 're': 5.0, 'im': 3.0 }\n*/\nsetReadOnly( Complex64.prototype, 'toJSON', toJSON );\n\n\n// EXPORTS //\n\nmodule.exports = Complex64;\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* 64-bit complex number constructor.\n*\n* @module @stdlib/complex-float32\n*\n* @example\n* var Complex64 = require( '@stdlib/complex-float32' );\n*\n* var z = new Complex64( 5.0, 3.0 );\n* // returns <Complex64>\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
-  "mappings": "uGAAA,IAAAA,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cA0BA,SAASC,GAAW,CAEnB,IAAIC,EAAM,GAAK,KAAK,GACpB,OAAK,KAAK,GAAK,EACdA,GAAO,MAAS,CAAC,KAAK,GAEtBA,GAAO,MAAQ,KAAK,GAErBA,GAAO,IACAA,CACR,CAKAF,EAAO,QAAUC,ICzCjB,IAAAE,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cA0BA,SAASC,GAAS,CAEjB,IAAIC,EAAM,CAAC,EACX,OAAAA,EAAI,KAAO,YACXA,EAAI,GAAK,KAAK,GACdA,EAAI,GAAK,KAAK,GACPA,CACR,CAKAF,EAAO,QAAUC,ICtCjB,IAAAE,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAW,QAAS,0BAA2B,EAAE,YACjDC,EAAiB,QAAS,+BAAgC,EAC1DC,EAAc,QAAS,uDAAwD,EAC/EC,EAAmB,QAAS,wCAAyC,EACrEC,EAAS,QAAS,uBAAwB,EAC1CC,EAAQ,IACRC,EAAS,IAoBb,SAASC,EAAWC,EAAMC,EAAO,CAChC,GAAK,EAAG,gBAAgBF,GACvB,MAAM,IAAI,UAAW,wEAAyE,EAE/F,GAAK,CAACP,EAAUQ,CAAK,EACpB,MAAM,IAAI,UAAWJ,EAAQ,kEAAmEI,CAAK,CAAE,EAExG,GAAK,CAACR,EAAUS,CAAK,EACpB,MAAM,IAAI,UAAWL,EAAQ,uEAAwEK,CAAK,CAAE,EAE7G,OAAAR,EAAgB,KAAM,KAAM,CAC3B,aAAgB,GAChB,WAAc,GACd,SAAY,GACZ,MAASE,EAAkBK,CAAK,CACjC,CAAC,EACDP,EAAgB,KAAM,KAAM,CAC3B,aAAgB,GAChB,WAAc,GACd,SAAY,GACZ,MAASE,EAAkBM,CAAK,CACjC,CAAC,EACM,IACR,CAcAP,EAAaK,EAAW,oBAAqB,CAAE,EAgB/CL,EAAaK,EAAU,UAAW,oBAAqB,CAAE,EAgBzDL,EAAaK,EAAU,UAAW,aAAc,CAAE,EAgBlDL,EAAaK,EAAU,UAAW,WAAYF,CAAM,EAoBpDH,EAAaK,EAAU,UAAW,SAAUD,CAAO,EAKnDP,EAAO,QAAUQ,IC5HjB,IAAIG,EAAO,IAKX,OAAO,QAAUA",
-  "names": ["require_tostring", "__commonJSMin", "exports", "module", "toString", "str", "require_tojson", "__commonJSMin", "exports", "module", "toJSON", "out", "require_main", "__commonJSMin", "exports", "module", "isNumber", "defineProperty", "setReadOnly", "float64ToFloat32", "format", "toStr", "toJSON", "Complex64", "real", "imag", "main"]
+  "sources": ["../lib/index.js"],
+  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2024 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* When adding modules to the namespace, ensure that they are added in alphabetical order according to module name.\n*/\n\n// MODULES //\n\nvar setReadOnly = require( '@stdlib/utils-define-read-only-property' );\n\n\n// MAIN //\n\n/**\n* Top-level namespace.\n*\n* @namespace ns\n*/\nvar ns = {};\n\n/**\n* @name base\n* @memberof ns\n* @readonly\n* @type {Namespace}\n* @see {@link module:@stdlib/complex/float32/base}\n*/\nsetReadOnly( ns, 'base', require( '@stdlib/complex-float32-base' ) );\n\n/**\n* @name conj\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/complex/float32/conj}\n*/\nsetReadOnly( ns, 'conj', require( '@stdlib/complex-float32-conj' ) );\n\n/**\n* @name Complex64\n* @memberof ns\n* @readonly\n* @constructor\n* @see {@link module:@stdlib/complex/float32/ctor}\n*/\nsetReadOnly( ns, 'Complex64', require( '@stdlib/complex-float32-ctor' ) );\n\n/**\n* @name imag\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/complex/float32/imag}\n*/\nsetReadOnly( ns, 'imag', require( '@stdlib/complex-float32-imag' ) );\n\n/**\n* @name parseComplex64\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/complex/float32/parse}\n*/\nsetReadOnly( ns, 'parseComplex64', require( '@stdlib/complex-float32-parse' ) );\n\n/**\n* @name real\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/complex/float32/real}\n*/\nsetReadOnly( ns, 'real', require( '@stdlib/complex-float32-real' ) );\n\n/**\n* @name reim\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/complex/float32/reim}\n*/\nsetReadOnly( ns, 'reim', require( '@stdlib/complex-float32-reim' ) );\n\n/**\n* @name reviveComplex64\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/complex/float32/reviver}\n*/\nsetReadOnly( ns, 'reviveComplex64', require( '@stdlib/complex-float32-reviver' ) );\n\n\n// EXPORTS //\n\nmodule.exports = ns;\n"],
+  "mappings": "aA0BA,IAAIA,EAAc,QAAS,yCAA0C,EAUjEC,EAAK,CAAC,EASVD,EAAaC,EAAI,OAAQ,QAAS,8BAA+B,CAAE,EASnED,EAAaC,EAAI,OAAQ,QAAS,8BAA+B,CAAE,EASnED,EAAaC,EAAI,YAAa,QAAS,8BAA+B,CAAE,EASxED,EAAaC,EAAI,OAAQ,QAAS,8BAA+B,CAAE,EASnED,EAAaC,EAAI,iBAAkB,QAAS,+BAAgC,CAAE,EAS9ED,EAAaC,EAAI,OAAQ,QAAS,8BAA+B,CAAE,EASnED,EAAaC,EAAI,OAAQ,QAAS,8BAA+B,CAAE,EASnED,EAAaC,EAAI,kBAAmB,QAAS,iCAAkC,CAAE,EAKjF,OAAO,QAAUA",
+  "names": ["setReadOnly", "ns"]
 }