fix: update lint rule to handle main JSDoc module comments with module tag

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: Planeshifter

lib/node_modules/@stdlib/_tools/eslint/rules/jsdoc-doctest/lib/main.js

@@ -48,6 +48,7 @@ var windowShim = require( './window.js' );
 var debug = logger( 'jsdoc-doctest' );
 var RE_ANNOTATION = /(?:\n|^)(?:var|let|const)? ?([a-zA-Z0-9._]+) ?=?[^;]*;\n\/\/ ?(returns|([A-Za-z][A-Za-z_0-9]*)? ?=>|throws) {0,1}([\s\S]*?)(\n|$)/g;
 var RE_CONSOLE = /console\.(?:dir|error|log)/;
+var RE_MODULE_TAG = /\* @module[^\n]*\n/g;
 var NODE_SHEBANG = /#!\/usr\/bin\/env node/;
 var DOPTS = {
 	'sloppy': true,
@@ -220,6 +221,7 @@ function main( context ) {
 	* @param {ASTNode} node - node to examine
 	*/
 	function validate( node ) {
+		var wrapped;
 		var jsdoc;
 		var ast;
 
@@ -229,7 +231,14 @@ function main( context ) {
 		}
 		jsdoc = findJSDoc( source, node );
 		if ( isObject( jsdoc ) ) {
-			ast = parseJSDoc( jsdoc.value, DOPTS );
+			if ( contains( jsdoc.value, '@module' ) ) {
+				// Wrap with /** */ and strip @module tag for proper parsing with `doctrine`:
+				wrapped = '/**' + jsdoc.value + '*/';
+				wrapped = replace( wrapped, RE_MODULE_TAG, '' );
+				ast = parseJSDoc( wrapped, DOPTS );
+			} else {
+				ast = parseJSDoc( jsdoc.value, DOPTS );
+			}
 			processTags( jsdoc, ast.tags );
 		}
 	}