Add specific browser entry point and add method docs

Author: kgryte

lib/node_modules/@stdlib/math/base/tools/evalpoly/README.md

@@ -54,6 +54,15 @@ v = polyval( 5.0 ); // => 3*5^0 + 2*5^1 + 1*5^2
 // returns 38.0
 ```
 
+#### evalpoly.compile( c )
+
+Compiles a module `string` containing an exported function which evaluates a [polynomial][polynomial] having coefficients `c`.
+
+```javascript
+var str = evalpoly.factory( [ 3.0, 2.0, 1.0 ] );
+// returns <string>
+```
+
 </section>
 
 <!-- /.usage -->
@@ -63,6 +72,7 @@ v = polyval( 5.0 ); // => 3*5^0 + 2*5^1 + 1*5^2
 ## Notes
 
 -   For hot code paths in which coefficients are invariant, a compiled function will be more performant than `evalpoly()`.
+-   The `compile` method is intended for **non-browser** environments for the purpose of generating module files. Depending on how this package is bundled for browser environments, the `compile` method may **not** be present.
 
 </section>
 

lib/node_modules/@stdlib/math/base/tools/evalpoly/lib/browser.js

@@ -0,0 +1,40 @@
+'use strict';
+
+/**
+* Evaluate a polynomial.
+*
+* @module @stdlib/math/base/tools/evalpoly
+*
+* @example
+* var evalpoly = require( '@stdlib/math/base/tools/evalpoly' );
+*
+* var v = evalpoly( [3.0,2.0,1.0], 10.0 ); // 3*10^0 + 2*10^1 + 1*10^2
+* // returns 123.0
+*
+* @example
+* var evalpoly = require( '@stdlib/math/base/tools/evalpoly' );
+*
+* var polyval = evalpoly.factory( [3.0,2.0,1.0] );
+*
+* var v = polyval( 10.0 ); // => 3*10^0 + 2*10^1 + 1*10^2
+* // returns 123.0
+*
+* v = polyval( 5.0 ); // => 3*5^0 + 2*5^1 + 1*5^2
+* // returns 38.0
+*/
+
+// MODULES //
+
+var setReadOnly = require( '@stdlib/utils/define-read-only-property' );
+var evalpoly = require( './evalpoly.js' );
+var factory = require( './factory.js' );
+
+
+// MAIN //
+
+setReadOnly( evalpoly, 'factory', factory );
+
+
+// EXPORTS //
+
+module.exports = evalpoly;

lib/node_modules/@stdlib/math/base/tools/evalpoly/package.json

@@ -14,6 +14,7 @@
     }
   ],
   "main": "./lib",
+  "browser": "./lib/browser.js",
   "directories": {
     "benchmark": "./benchmark",
     "doc": "./docs",

lib/node_modules/@stdlib/math/base/tools/evalpoly/test/test.browser.js

@@ -0,0 +1,20 @@
+'use strict';
+
+// MODULES //
+
+var tape = require( 'tape' );
+var evalpoly = require( './../lib/browser.js' );
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+	t.ok( true, __filename );
+	t.equal( typeof evalpoly, 'function', 'main export is a function' );
+	t.end();
+});
+
+tape( 'attached to the main export is a factory method for generating `evalpoly` functions', function test( t ) {
+	t.equal( typeof evalpoly.factory, 'function', 'exports a factory method' );
+	t.end();
+});

lib/node_modules/@stdlib/math/base/tools/evalpoly/test/test.compile.js

@@ -3,23 +3,25 @@
 // MODULES //
 
 var join = require( 'path' ).join;
+var resolve = require( 'path' ).resolve;
 var tape = require( 'tape' );
 var IS_BROWSER = require( '@stdlib/assert/is-browser' );
 var readFile = require( '@stdlib/fs/read-file' ).sync;
 var Float64Array = require( '@stdlib/array/float64' );
-var compile = require( './../lib/compile.js' );
+var tryRequire = require( '@stdlib/utils/try-require' );
 
 
 // VARIABLES //
 
+var compile = tryRequire( resolve( __dirname, '..', 'lib', 'compile.js' ) );
 var opts = {
-	'skip': IS_BROWSER
+	'skip': ( IS_BROWSER || (compile instanceof Error) )
 };
 
 
 // TESTS //
 
-tape( 'main export is a function', function test( t ) {
+tape( 'main export is a function', opts, function test( t ) {
 	t.ok( true, __filename );
 	t.equal( typeof compile, 'function', 'main export is a function' );
 	t.end();

lib/node_modules/@stdlib/math/base/tools/evalpoly/test/test.js

@@ -3,9 +3,17 @@
 // MODULES //
 
 var tape = require( 'tape' );
+var IS_BROWSER = require( '@stdlib/assert/is-browser' );
 var evalpoly = require( './../lib' );
 
 
+// VARIABLES //
+
+var opts = {
+	'skip': IS_BROWSER
+};
+
+
 // TESTS //
 
 tape( 'main export is a function', function test( t ) {
@@ -19,7 +27,7 @@ tape( 'attached to the main export is a factory method for generating `evalpoly`
 	t.end();
 });
 
-tape( 'attached to the main export is a method for compiling `evalpoly` function modules', function test( t ) {
+tape( 'in non-browser environments, attached to the main export is a method for compiling `evalpoly` function modules', opts, function test( t ) {
 	t.equal( typeof evalpoly.compile, 'function', 'exports a compile method' );
 	t.end();
 });