Refactor to N-API and clean-up

Author: kgryte

lib/node_modules/@stdlib/blas/base/dasum/README.md

@@ -134,205 +134,6 @@ sum = dasum.ndarray( 3, x, -1, x.length-1 );
 // returns 15.0
 ```
 
-#### dasum.wasm( \[options] )
-
-Returns a memory managed function to compute the sum of [absolute values][@stdlib/math/base/special/abs].
-
-```javascript
-var Float64Array = require( '@stdlib/array/float64' );
-
-var wasm = dasum.wasm();
-
-// Number of data elements:
-var N = 5;
-
-// Allocate space on the heap:
-var bytes = wasm.malloc( N * 8 ); // 8 bytes per double
-
-// Create a Float64Array view:
-var view = new Float64Array( bytes.buffer, bytes.byteOffset, N );
-
-// Copy data to the heap:
-view.set( [ 1.0, -2.0, 3.0, -4.0, 5.0 ] );
-
-// Compute the sum:
-var s = wasm( N, bytes, 1 );
-// returns 15.0
-
-// Free the memory:
-wasm.free( bytes );
-```
-
-For externally defined [typed arrays][mdn-typed-array], data must be copied to the heap.
-
-```javascript
-var Uint8Array = require( '@stdlib/array/uint8' );
-var Float64Array = require( '@stdlib/array/float64' );
-
-var wasm = dasum.wasm();
-
-// Externally defined data array:
-var x = new Float64Array( [ 1.0, -2.0, 3.0, -4.0, 5.0 ] );
-
-// Allocate space on the heap:
-var bytes = wasm.malloc( x.length * x.BYTES_PER_ELEMENT );
-
-// Copy data to the heap:
-bytes.set( new Uint8Array( x.buffer ) );
-
-// Compute the sum:
-var s = wasm( x.length, bytes, 1 );
-// returns 15.0
-
-// Free the memory:
-wasm.free( bytes );
-```
-
-The method accepts the following `options`:
-
--   **memory**: total memory. If not provided a `buffer`, setting the `memory` option instructs the returned function to allocate an internal memory store of the specified size.
--   **stack**: total stack size. Must be less than the `memory` option and large enough for a program's needs. Default: `1024` bytes.
--   **buffer**: `ArrayBuffer` serving as the underlying memory store. If not provided, each returned function will allocate and manage its own memory. If provided a `memory` option, the buffer `byteLength` must equal the specified total memory.
-
-To create a function using an externally defined memory buffer, set the `buffer` option.
-
-<!-- FIXME: glue code seems to require more than just setting a `buffer` property: https://github.com/kripken/emscripten/blob/655cec1975e784985d25bc80c5438d715ac5ec13/src/preamble.js#L2155 and https://github.com/kripken/emscripten/blob/655cec1975e784985d25bc80c5438d715ac5ec13/src/preamble.js#L1141 -->
-
-<!-- run-disable -->
-
-```javascript
-var ArrayBuffer = require( '@stdlib/array/buffer' );
-var buffer = new ArrayBuffer( 16777216 ); // ~16MB
-
-var wasm = dasum.wasm({
-    'buffer': buffer
-});
-```
-
-Providing external memory can be advantageous when wanting to a) centrally manage memory allocation, b) share memory between multiple memory managed functions, and/or c) limit the total amount of allocated memory within an application or library. 
-
-##### wasm.malloc( nbytes )
-
-Allocates space on the heap and returns a bytes-wise [`typed array`][mdn-typed-array] view ([`Uint8Array`][mdn-uint8array]).
-
-```javascript
-var wasm = dasum.wasm();
-
-// Allocate 64 bytes:
-var bytes = wasm.malloc( 64 );
-```
-
-##### bytes.getValue( ptr\[, type] )
-
-Returns a value at a specific memory address (represented by a byte index). By default, the function returns a `double`. Possible types include: `'i8'`, `'i16'`, `'i32'`, `'i64'`, `'float'`, and `'double'`.
-
-```javascript
-var Float64Array = require( '@stdlib/array/float64' );
-
-var wasm = dasum.wasm();
-
-var N = 3;
-
-var bytes = wasm.malloc( N * 8 );
-var view = new Float64Array( bytes.buffer, bytes.byteOffset, N );
-
-view.set( [ 1.0, -2.0, 3.0 ] );
-
-var ptr = 1 * 8; // 8 bytes per double
-var y = bytes.getValue( ptr );
-// returns -2.0
-
-wasm.free( bytes );
-```
-
-While this method may be convenient when interacting with the bytes view directly, using a [`typed array`][mdn-typed-array] view is likely to be more performant.
-
-```javascript
-var Float64Array = require( '@stdlib/array/float64' );
-
-var wasm = dasum.wasm();
-
-var N = 3;
-
-var bytes = wasm.malloc( N * 8 );
-var view = new Float64Array( bytes.buffer, bytes.byteOffset, N );
-
-view.set( [ 1.0, -2.0, 3.0 ] );
-
-var y = view[ 1 ];
-// returns -2.0
-
-wasm.free( bytes );
-```
-
-##### bytes.setValue( ptr, value\[, type] )
-
-Sets a value at a specific memory address (represented by a byte index). By default, the function sets a `double`. Possible types include: `'i8'`, `'i16'`, `'i32'`, `'i64'`, `'float'`, and `'double'`.
-
-```javascript
-var Float64Array = require( '@stdlib/array/float64' );
-
-var wasm = dasum.wasm();
-
-var N = 3;
-
-var bytes = wasm.malloc( N * 8 );
-var view = new Float64Array( bytes.buffer, bytes.byteOffset, N );
-
-view.set( [ 1.0, -2.0, 3.0 ] );
-
-var ptr = 1 * 8; // 8 bytes per double
-var y = bytes.getValue( ptr );
-// returns -2.0
-
-bytes.setValue( ptr, -10.0 );
-
-y = bytes.getValue( ptr );
-// returns -10.0
-
-wasm.free( bytes );
-```
-
-While this method may be convenient when interacting with the bytes view directly, using a [`typed array`][mdn-typed-array] view is likely to be more performant.
-
-```javascript
-var Float64Array = require( '@stdlib/array/float64' );
-
-var wasm = dasum.wasm();
-
-var N = 3;
-
-var bytes = wasm.malloc( N * 8 );
-var view = new Float64Array( bytes.buffer, bytes.byteOffset, N );
-
-view.set( [ 1.0, -2.0, 3.0 ] );
-
-var y = view[ 1 ];
-// returns -2.0
-
-view[ 1 ] = -10.0;
-
-y = view[ 1 ];
-// returns -10.0
-
-wasm.free( bytes );
-```
-
-##### wasm.free( heap )
-
-Frees allocated space.
-
-```javascript
-var wasm = dasum.wasm();
-
-var bytes = wasm.malloc( 64 );
-
-// ...
-
-// Free the space and allow reallocation:
-wasm.free( bytes );
-```
-
 </section>
 
 <!-- /.usage -->
@@ -393,8 +194,6 @@ console.log( dasum( x.length, x, 1 ) );
 
 [mdn-typed-array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray
 
-[mdn-uint8array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array
-
 [l1norm]: http://en.wikipedia.org/wiki/Norm_%28mathematics%29
 
 [@stdlib/math/base/special/abs]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/abs

lib/node_modules/@stdlib/blas/base/dasum/benchmark/benchmark.asm.js

@@ -26,7 +26,7 @@ var isnan = require( '@stdlib/math/base/assert/is-nan' );
 var pow = require( '@stdlib/math/base/special/pow' );
 var Float64Array = require( '@stdlib/array/float64' );
 var pkg = require( './../package.json' ).name;
-var dasum = require( './../lib/main.js' );
+var dasum = require( './../lib/dasum.js' );
 
 
 // FUNCTIONS //