Merge branch 'stdlib-js:develop' into develop

Author: SuYaSh-PaThAk04

lib/node_modules/@stdlib/_tools/eslint/rules/README.md

@@ -80,6 +80,7 @@ var eslint = rules;
 -   <span class="signature">[`no-require-index`][@stdlib/_tools/eslint/rules/no-require-index]</span><span class="delimiter">: </span><span class="description">ESLint rule disallowing `require()` calls which explicitly require `index.<ext>` files.</span>
 -   <span class="signature">[`no-self-require`][@stdlib/_tools/eslint/rules/no-self-require]</span><span class="delimiter">: </span><span class="description">ESLint rule enforcing that modules do not require themselves.</span>
 -   <span class="signature">[`no-unassigned-require`][@stdlib/_tools/eslint/rules/no-unassigned-require]</span><span class="delimiter">: </span><span class="description">ESLint rule forbidding unassigned require statements.</span>
+-   <span class="signature">[`no-unnecessary-nested-functions`][@stdlib/_tools/eslint/rules/no-unnecessary-nested-functions]</span><span class="delimiter">: </span><span class="description">ESLint rule to prevent unnecessary function nesting when inner functions don't depend on outer scope variables.</span>
 -   <span class="signature">[`repl-namespace-order`][@stdlib/_tools/eslint/rules/repl-namespace-order]</span><span class="delimiter">: </span><span class="description">ESLint rule to enforce that packages are added to a REPL namespace object in alphabetical order according to alias (namespace key).</span>
 -   <span class="signature">[`require-file-extensions`][@stdlib/_tools/eslint/rules/require-file-extensions]</span><span class="delimiter">: </span><span class="description">ESLint rule enforcing that `require()` calls of files end with a whitelisted file extension.</span>
 -   <span class="signature">[`require-globals`][@stdlib/_tools/eslint/rules/require-globals]</span><span class="delimiter">: </span><span class="description">ESLint rule enforcing that specified global variables are explicitly required.</span>
@@ -90,6 +91,7 @@ var eslint = rules;
 -   <span class="signature">[`section-header-empty-lines`][@stdlib/_tools/eslint/rules/section-header-empty-lines]</span><span class="delimiter">: </span><span class="description">ESLint rule to enforce that section header comments are padded by empty lines.</span>
 -   <span class="signature">[`section-headers`][@stdlib/_tools/eslint/rules/section-headers]</span><span class="delimiter">: </span><span class="description">ESLint rule to enforce formatting of section header comments.</span>
 -   <span class="signature">[`ternary-condition-parentheses`][@stdlib/_tools/eslint/rules/ternary-condition-parentheses]</span><span class="delimiter">: </span><span class="description">ESLint rule requiring parentheses around ternary conditions.</span>
+-   <span class="signature">[`tsdoc-declarations-doctest`][@stdlib/_tools/eslint/rules/tsdoc-declarations-doctest]</span><span class="delimiter">: </span><span class="description">ESLint rule to ensure that return annotations in TSDoc examples match the actual output in TypeScript declaration files (`*.d.ts`).</span>
 -   <span class="signature">[`uppercase-required-constants`][@stdlib/_tools/eslint/rules/uppercase-required-constants]</span><span class="delimiter">: </span><span class="description">ESLint rule enforcing that required `stdlib` constants have uppercase variable names.</span>
 -   <span class="signature">[`vars-order`][@stdlib/_tools/eslint/rules/vars-order]</span><span class="delimiter">: </span><span class="description">ESLint rule enforcing variable declarations inside of functions to be ordered by length.</span>
 
@@ -428,6 +430,8 @@ console.log( getKeys( rules ) );
 
 [@stdlib/_tools/eslint/rules/no-unassigned-require]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/_tools/eslint/rules/no-unassigned-require
 
+[@stdlib/_tools/eslint/rules/no-unnecessary-nested-functions]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/_tools/eslint/rules/no-unnecessary-nested-functions
+
 [@stdlib/_tools/eslint/rules/repl-namespace-order]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/_tools/eslint/rules/repl-namespace-order
 
 [@stdlib/_tools/eslint/rules/require-file-extensions]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/_tools/eslint/rules/require-file-extensions
@@ -448,6 +452,8 @@ console.log( getKeys( rules ) );
 
 [@stdlib/_tools/eslint/rules/ternary-condition-parentheses]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/_tools/eslint/rules/ternary-condition-parentheses
 
+[@stdlib/_tools/eslint/rules/tsdoc-declarations-doctest]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/_tools/eslint/rules/tsdoc-declarations-doctest
+
 [@stdlib/_tools/eslint/rules/uppercase-required-constants]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/_tools/eslint/rules/uppercase-required-constants
 
 [@stdlib/_tools/eslint/rules/vars-order]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/_tools/eslint/rules/vars-order

lib/node_modules/@stdlib/_tools/markdown/namespace-toc/lib/toc.js

@@ -98,7 +98,12 @@ function createTOC( contents, aliases, blacklist ) {
 		descr = RE_DESCR.exec( str )[ 1 ];
 		descr = replace( descr, RE_LINKS, '$1' );
 		descr = uncapitalizeDescription( descr );
-		pkg = str.match( RE_PKG )[ 1 ];
+		pkg = str.match( RE_PKG );
+		if ( pkg === null ) {
+			debug( 'Unable to process file: %s. Skipping...', contents[ i ].file );
+			continue;
+		}
+		pkg = pkg[ 1 ];
 		pkgs.push( pkg );
 		debug( 'Processing package %s...', pkg );
 		multiple = str.match( RE_FUN );