Add TypeScript definition file

lib/node_modules/@stdlib/math/base/special/log1mexp/docs/types/index.d.ts

@@ -0,0 +1,44 @@
+/*
+* @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: 2.0
+
+/**
+* Computes the natural logarithm of \\( 1-\exp(-|x|) \\).
+*
+* @param x - input value
+* @returns function value
+*
+* @example
+* var v = log1mexp( 1.1 );
+* // returns ~-0.40477
+*
+* @example
+* var v = log1mexp( 0.0 );
+* // returns -Infinity
+*
+* @example
+* var v = log1mexp( NaN );
+* // returns NaN
+*/
+declare function log1mexp( x: number ): number;
+
+
+// EXPORTS //
+
+export = log1mexp;

lib/node_modules/@stdlib/math/base/special/log1mexp/docs/types/test.ts

@@ -0,0 +1,45 @@
+/*
+* @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.
+*/
+
+import log1mexp = require( './index' );
+
+
+// TESTS //
+
+// The function returns a number...
+{
+	log1mexp( 8 ); // $ExpectType number
+}
+
+// The function does not compile if provided a value other than an a number...
+{
+	log1mexp( true ); // $ExpectError
+	log1mexp( false ); // $ExpectError
+	log1mexp( '5' ); // $ExpectError
+	log1mexp( [] ); // $ExpectError
+	log1mexp( {} ); // $ExpectError
+	log1mexp( ( x ) => x ); // $ExpectError
+}
+
+// The function does not compile if provided insufficient arguments...
+{
+	log1mexp(); // $ExpectError
+}
+
+
+log1mexp( )

lib/node_modules/@stdlib/math/base/special/log1mexp/lib/main.js

@@ -37,6 +37,18 @@ var NINF = require( '@stdlib/constants/math/float64-ninf' );
 *
 * @param {number} x - input value
 * @returns {number} function value
+*
+* @example
+* var v = log1mexp( 1.1 );
+* // returns ~-0.40477
+*
+* @example
+* var v = log1mexp( 0.0 );
+* // returns -Infinity
+*
+* @example
+* var v = log1mexp( NaN );
+* // returns NaN
 */
 function log1mexp( x ) {
 	var ax;

lib/node_modules/@stdlib/math/base/special/log1mexp/package.json

@@ -22,6 +22,7 @@
     "test": "./test"
   },
   "scripts": {},
+  "types": "./docs/types",
   "homepage": "https://github.com/stdlib-js/stdlib",
   "repository": {
     "type": "git",