docs(index): improve JSDoc in index.d.ts and index.js

Author: remarkablemark

index.d.ts

@@ -15,12 +15,11 @@ export interface HTMLReactParserOptions {
 }
 
 /**
- * Convert HTML string to React elements.
+ * Converts HTML string to React elements.
  *
- * @param - Raw string of HTML to parse.
- * @param options - Options to use when converting to react.
- * @returns ReactElement on successful parse or string when `html` cannot be
- * parsed as HTML
+ * @param  html    - The HTML string to parse to React.
+ * @param  options - The parser options.
+ * @return         - When parsed with HTML string, returns React elements; otherwise, returns string or empty array.
  */
 declare function HTMLReactParser(
   html: string,

index.js

@@ -5,12 +5,12 @@ var htmlToDOM = require('html-dom-parser');
 var domParserOptions = { decodeEntities: true, lowerCaseAttributeNames: false };
 
 /**
- * Convert HTML string to React elements.
+ * Converts HTML string to React elements.
  *
- * @param  {String}   html              - The HTML string.
- * @param  {Object}   [options]         - The additional options.
+ * @param  {String}   html              - The HTML string to parse to React.
+ * @param  {Object}   [options]         - The parser options.
  * @param  {Function} [options.replace] - The replace method.
- * @return {ReactElement|Array}
+ * @return {ReactElement|Array|String}  - When parsed with HTML string, returns React elements; otherwise, returns string or empty array.
  */
 function HTMLReactParser(html, options) {
   if (typeof html !== 'string') {