Update JSDOC for better DX

Author: Antoni Kepinski

src/cashify.ts

@@ -3,12 +3,29 @@ import convert from './convert';
 import parse from './utils/parser';
 
 export default class Cashify {
+	/**
+	* @constructor
+	* @param {Object} [options] Conversion options.
+	*/
 	constructor(public readonly options: Partial<Options>) { }
 
 	/**
-	* @param amount Amount of money you want to convert.
-	* @param options Conversion options.
-	* @return Conversion result.
+	* Function, which converts currencies based on provided rates.
+	*
+	* @param {number | string} amount - Amount of money you want to convert.
+	* @param {Object} [options] - Conversion options.
+	* @return {number} Conversion result.
+	*
+	* @example
+	* const rates = {
+	* 	GBP: 0.92,
+	* 	EUR: 1.00,
+	* 	USD: 1.12
+	* };
+	*
+	* const cashify = new Cashify({base: 'EUR', rates});
+	*
+	* cashify.convert(10, {from: 'EUR', to: 'GBP'}); //=> 9.2
 	*/
 	convert(amount: number | string, options?: Partial<Options>): number {
 		// If provided `amount` is a string, use parsing

src/convert.ts

@@ -3,10 +3,21 @@ import {Options} from './lib/options';
 import parse from './utils/parser';
 
 /**
-* @param amount Amount of money you want to convert.
-* @param options Conversion options.
-* @return Conversion result.
-*/
+ * Function, which converts currencies based on provided rates.
+ *
+ * @param {number | string} amount - Amount of money you want to convert.
+ * @param {Object} options - Conversion options.
+ * @return {number} Conversion result.
+ *
+ * @example
+ * const rates = {
+ * 	GBP: 0.92,
+ * 	EUR: 1.00,
+ * 	USD: 1.12
+ * };
+ *
+ * convert(10, {from: 'EUR', to: 'GBP', base: 'EUR', rates}); //=> 9.2
+ */
 export default function convert(amount: number | string, {from, to, base, rates}: Options): number {
 	// If provided `amount` is a string, use parsing
 	if (typeof amount === 'string') {

src/utils/parser.ts

@@ -6,8 +6,12 @@ interface Options {
 
 /**
 * Expression parser
-* @param expression Expression you want to parse, ex. `10 usd to pln` or `€1.23 eur`
-* @return Object with parsing results
+*
+* @param {string} expression - Expression you want to parse, ex. `10 usd to pln` or `€1.23 eur`
+* @return {Object} Object with parsing results
+*
+* @example
+* parse('10 EUR to GBP'); //=> {amount: 10, from: 'EUR', to: 'GBP'}
 */
 export default function parse(expression: string): Options {
 	const amount = Number.parseFloat(expression.replace(/[^\d-.]/g, '')) || undefined;