npm - eslint-plugin-jsdoc - Versions diffs - 50.0.0 → 50.1.0 - Mend

eslint-plugin-jsdoc 50.0.0 → 50.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/dist/getJsdocProcessorPlugin.cjs +2 -2
package/dist/getJsdocProcessorPlugin.cjs.map +1 -1
package/dist/rules/noBadBlocks.cjs +6 -0
package/dist/rules/noBadBlocks.cjs.map +1 -1
package/dist/utils/hasReturnValue.cjs +7 -1
package/dist/utils/hasReturnValue.cjs.map +1 -1
package/package.json +22 -22
package/src/getJsdocProcessorPlugin.js +2 -2
package/src/rules/noBadBlocks.js +10 -0
package/src/utils/hasReturnValue.js +5 -2

package/dist/getJsdocProcessorPlugin.cjs CHANGED Viewed

@@ -78,7 +78,7 @@ const getLinesCols = text => {
  * @property {string} [exampleCodeRegex]
  * @property {string} [rejectExampleCodeRegex]
  * @property {"script"|"module"} [sourceType]
- * @property {import('eslint').Linter.FlatConfigParserModule} [parser]
+ * @property {import('eslint').Linter.ESTreeParser|import('eslint').Linter.NonESTreeParser} [parser]
  */
 /**
@@ -438,7 +438,7 @@ const getJsdocProcessorPlugin = (options = {}) => {
             // May be running a second time so catch and ignore
             try {
               ast = parser
-              // @ts-expect-error Ok
+              // @ts-expect-error Should be present
               ? parser.parseForESLint(text, {
                 ecmaVersion: 'latest',
                 sourceType,

package/dist/getJsdocProcessorPlugin.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"getJsdocProcessorPlugin.cjs","names":["_nodeFs","require","_nodePath","_nodeUrl","espree","_interopRequireWildcard","_jsdocUtils","_jsdoccomment","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","__dirname","dirname","fileURLToPath","pathToFileURL","__filename","toString","version","JSON","parse","readFileSync","join","likelyNestedJSDocIndentSpace","preTagSpaceLength","firstLinePrefixLength","hasCaptionRegex","escapeStringRegexp","str","replaceAll","countChars","ch","match","RegExp","length","getLinesCols","text","matchLines","colDelta","slice","lastIndexOf","getJsdocProcessorPlugin","options","exampleCodeRegex","rejectExampleCodeRegex","checkExamples","checkDefaults","checkParams","checkProperties","matchingFileName","matchingFileNameDefaults","matchingFileNameParams","matchingFileNameProperties","paddedIndent","captionRequired","sourceType","parser","undefined","exampleCodeRegExp","rejectExampleCodeRegExp","getRegexFromString","otherInfo","extraMessages","getTextsAndFileNames","jsdoc","jsFileName","commentLineCols","textsAndFileNames","checkSource","filename","ext","defaultFileName","lines","cols","skipInit","source","targetTagName","sources","tag","line","push","nonJSPrefacingCols","nonJSPrefacingLines","string","addSourceInfo","src","file","number","codeStartLine","codeStartCol","targetSource","getFilenameInfo","includes","replace","filenameInfo","forEachPreferredTag","description","trim","getTagDescription","tagName","getPreferredTagName","hasTag","matchingFilenameInfo","column","severity","message","ruleId","test","startingIndex","lastStringCount","exampleCode","lastIndex","exec","index","n0","n1","preMatch","preMatchLines","nonJSPreface","nonJSPrefaceLineCount","idx","indexOf","charsInLastLine","global","meta","name","processors","examples","preprocess","ast","parseForESLint","ecmaVersion","comment","err","jsdocComments","comments","filter","value","map","start","range","textToStart","parseComment","flatMap","Boolean","console","log","postprocess","jsMessages","messages","forEach","msg","fatal","endColumn","endLine","codeCtxLine","codeCtxColumn","startLine","startCol","ret","concat","supportsAutofix","exports"],"sources":["../src/getJsdocProcessorPlugin.js"],"sourcesContent":["// Todo: Support TS by fenced block type\n\nimport {readFileSync} from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport * as espree from 'espree';\nimport {\n getRegexFromString,\n forEachPreferredTag,\n getTagDescription,\n getPreferredTagName,\n hasTag,\n} from './jsdocUtils.js';\nimport {\n parseComment,\n} from '@es-joy/jsdoccomment';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nconst {version} = JSON.parse(\n // @ts-expect-error `Buffer` is ok for `JSON.parse`\n readFileSync(join(__dirname, '../package.json'))\n);\n\n// const zeroBasedLineIndexAdjust = -1;\nconst likelyNestedJSDocIndentSpace = 1;\nconst preTagSpaceLength = 1;\n\n// If a space is present, we should ignore it\nconst firstLinePrefixLength = preTagSpaceLength;\n\nconst hasCaptionRegex = /^\\s<caption>([\\s\\S]?)<\\/caption>/u;\n\n/*\n @param {string} str\n * @returns {string}\n /\nconst escapeStringRegexp = (str) => {\n return str.replaceAll(/[.+?^${}()\|[\\]\\\\]/gu, '\\\\$&');\n};\n\n/*\n @param {string} str\n * @param {string} ch\n * @returns {import('./iterateJsdoc.js').Integer}\n /\nconst countChars = (str, ch) => {\n return (str.match(new RegExp(escapeStringRegexp(ch), 'gu')) \|\| []).length;\n};\n\n/\n @param {string} text\n * @returns {[\n* import('./iterateJsdoc.js').Integer,\n* import('./iterateJsdoc.js').Integer\n* ]}\n/\nconst getLinesCols = (text) => {\n const matchLines = countChars(text, '\\n');\n\n const colDelta = matchLines ?\n text.slice(text.lastIndexOf('\\n') + 1).length :\n text.length;\n\n return [\n matchLines, colDelta,\n ];\n};\n\n/\n @typedef {number} Integer\n /\n\n/\n @typedef {object} JsdocProcessorOptions\n * @property {boolean} [captionRequired]\n * @property {Integer} [paddedIndent]\n * @property {boolean} [checkDefaults]\n * @property {boolean} [checkParams]\n * @property {boolean} [checkExamples]\n * @property {boolean} [checkProperties]\n * @property {string} [matchingFileName]\n * @property {string} [matchingFileNameDefaults]\n * @property {string} [matchingFileNameParams]\n * @property {string} [matchingFileNameProperties]\n * @property {string} [exampleCodeRegex]\n * @property {string} [rejectExampleCodeRegex]\n * @property {\"script\"\|\"module\"} [sourceType]\n * @property {import('eslint').Linter.FlatConfigParserModule} [parser]\n /\n\n/\n We use a function for the ability of the user to pass in a config, but\n * without requiring all users of the plugin to do so.\n * @param {JsdocProcessorOptions} [options]\n /\nexport const getJsdocProcessorPlugin = (options = {}) => {\n const {\n exampleCodeRegex = null,\n rejectExampleCodeRegex = null,\n checkExamples = true,\n checkDefaults = false,\n checkParams = false,\n checkProperties = false,\n matchingFileName = null,\n matchingFileNameDefaults = null,\n matchingFileNameParams = null,\n matchingFileNameProperties = null,\n paddedIndent = 0,\n captionRequired = false,\n sourceType = 'module',\n parser = undefined\n } = options;\n\n /* @type {RegExp} /\n let exampleCodeRegExp;\n /* @type {RegExp} /\n let rejectExampleCodeRegExp;\n\n if (exampleCodeRegex) {\n exampleCodeRegExp = getRegexFromString(exampleCodeRegex);\n }\n\n if (rejectExampleCodeRegex) {\n rejectExampleCodeRegExp = getRegexFromString(rejectExampleCodeRegex);\n }\n\n /\n @type {{\n * targetTagName: string,\n * ext: string,\n * codeStartLine: number,\n * codeStartCol: number,\n * nonJSPrefacingCols: number,\n * commentLineCols: [number, number]\n * }[]}\n /\n const otherInfo = [];\n\n /* @type {import('eslint').Linter.LintMessage[]} /\n let extraMessages = [];\n\n /\n @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} jsFileName\n * @param {[number, number]} commentLineCols\n /\n const getTextsAndFileNames = (jsdoc, jsFileName, commentLineCols) => {\n /\n @type {{\n * text: string,\n * filename: string\|null\|undefined\n * }[]}\n /\n const textsAndFileNames = [];\n\n /\n @param {{\n * filename: string\|null,\n * defaultFileName: string\|undefined,\n * source: string,\n * targetTagName: string,\n * rules?: import('eslint').Linter.RulesRecord\|undefined,\n * lines?: import('./iterateJsdoc.js').Integer,\n * cols?: import('./iterateJsdoc.js').Integer,\n * skipInit?: boolean,\n * ext: string,\n * sources?: {\n * nonJSPrefacingCols: import('./iterateJsdoc.js').Integer,\n * nonJSPrefacingLines: import('./iterateJsdoc.js').Integer,\n * string: string,\n * }[],\n * tag?: import('comment-parser').Spec & {\n * line?: import('./iterateJsdoc.js').Integer,\n * }\|{\n * line: import('./iterateJsdoc.js').Integer,\n * }\n * }} cfg\n /\n const checkSource = ({\n filename,\n ext,\n defaultFileName,\n lines = 0,\n cols = 0,\n skipInit,\n source,\n targetTagName,\n sources = [],\n tag = {\n line: 0,\n },\n }) => {\n if (!skipInit) {\n sources.push({\n nonJSPrefacingCols: cols,\n nonJSPrefacingLines: lines,\n string: source,\n });\n }\n\n /\n @param {{\n * nonJSPrefacingCols: import('./iterateJsdoc.js').Integer,\n * nonJSPrefacingLines: import('./iterateJsdoc.js').Integer,\n * string: string\n * }} cfg\n /\n const addSourceInfo = function ({\n nonJSPrefacingCols,\n nonJSPrefacingLines,\n string,\n }) {\n const src = paddedIndent ?\n string.replaceAll(new RegExp(`(^\|\\n) {${paddedIndent}}(?!$)`, 'gu'), '\\n') :\n string;\n\n // Programmatic ESLint API: https://eslint.org/docs/developer-guide/nodejs-api\n const file = filename \|\| defaultFileName;\n\n if (!('line' in tag)) {\n tag.line = tag.source[0].number;\n }\n\n // NOTE: `tag.line` can be 0 if of form `/* @tag ... /`\n const codeStartLine = /\n @type {import('comment-parser').Spec & {\n * line: import('./iterateJsdoc.js').Integer,\n * }}\n / (tag).line + nonJSPrefacingLines;\n const codeStartCol = likelyNestedJSDocIndentSpace;\n\n textsAndFileNames.push({\n text: src,\n filename: file,\n });\n otherInfo.push({\n targetTagName,\n ext,\n codeStartLine,\n codeStartCol,\n nonJSPrefacingCols,\n commentLineCols\n });\n };\n\n for (const targetSource of sources) {\n addSourceInfo(targetSource);\n }\n };\n\n /\n \n * @param {string\|null} filename\n * @param {string} [ext] Since `eslint-plugin-markdown` v2, and\n * ESLint 7, this is the default which other JS-fenced rules will used.\n * Formerly \"md\" was the default.\n * @returns {{\n * defaultFileName: string\|undefined,\n * filename: string\|null,\n * ext: string\n * }}\n /\n const getFilenameInfo = (filename, ext = 'md/.js') => {\n let defaultFileName;\n if (!filename) {\n if (typeof jsFileName === 'string' && jsFileName.includes('.')) {\n defaultFileName = jsFileName.replace(/\\.[^.]$/u, `.${ext}`);\n } else {\n defaultFileName = `dummy.${ext}`;\n }\n }\n\n return {\n ext,\n defaultFileName,\n filename,\n };\n };\n\n if (checkDefaults) {\n const filenameInfo = getFilenameInfo(matchingFileNameDefaults, 'jsdoc-defaults');\n forEachPreferredTag(jsdoc, 'default', (tag, targetTagName) => {\n if (!tag.description.trim()) {\n return;\n }\n\n checkSource({\n source: `(${getTagDescription(tag)})`,\n targetTagName,\n ...filenameInfo,\n });\n });\n }\n\n if (checkParams) {\n const filenameInfo = getFilenameInfo(matchingFileNameParams, 'jsdoc-params');\n forEachPreferredTag(jsdoc, 'param', (tag, targetTagName) => {\n if (!tag.default \|\| !tag.default.trim()) {\n return;\n }\n\n checkSource({\n source: `(${tag.default})`,\n targetTagName,\n ...filenameInfo,\n });\n });\n }\n\n if (checkProperties) {\n const filenameInfo = getFilenameInfo(matchingFileNameProperties, 'jsdoc-properties');\n forEachPreferredTag(jsdoc, 'property', (tag, targetTagName) => {\n if (!tag.default \|\| !tag.default.trim()) {\n return;\n }\n\n checkSource({\n source: `(${tag.default})`,\n targetTagName,\n ...filenameInfo,\n });\n });\n }\n\n if (!checkExamples) {\n return textsAndFileNames;\n }\n\n const tagName = /* @type {string} / (getPreferredTagName(jsdoc, {\n tagName: 'example',\n }));\n if (!hasTag(jsdoc, tagName)) {\n return textsAndFileNames;\n }\n\n const matchingFilenameInfo = getFilenameInfo(matchingFileName);\n\n forEachPreferredTag(jsdoc, 'example', (tag, targetTagName) => {\n let source = /* @type {string} / (getTagDescription(tag));\n const match = source.match(hasCaptionRegex);\n\n if (captionRequired && (!match \|\| !match[1].trim())) {\n extraMessages.push({\n line: 1 + commentLineCols[0] + (tag.line ?? tag.source[0].number),\n column: commentLineCols[1] + 1,\n severity: 2,\n message: `@${targetTagName} error - Caption is expected for examples.`,\n ruleId: 'jsdoc/example-missing-caption'\n });\n return;\n }\n\n source = source.replace(hasCaptionRegex, '');\n const [\n lines,\n cols,\n ] = match ? getLinesCols(match[0]) : [\n 0, 0,\n ];\n\n if (exampleCodeRegex && !exampleCodeRegExp.test(source) \|\|\n rejectExampleCodeRegex && rejectExampleCodeRegExp.test(source)\n ) {\n return;\n }\n\n const sources = [];\n let skipInit = false;\n if (exampleCodeRegex) {\n let nonJSPrefacingCols = 0;\n let nonJSPrefacingLines = 0;\n\n let startingIndex = 0;\n let lastStringCount = 0;\n\n let exampleCode;\n exampleCodeRegExp.lastIndex = 0;\n while ((exampleCode = exampleCodeRegExp.exec(source)) !== null) {\n const {\n index,\n '0': n0,\n '1': n1,\n } = exampleCode;\n\n // Count anything preceding user regex match (can affect line numbering)\n const preMatch = source.slice(startingIndex, index);\n\n const [\n preMatchLines,\n colDelta,\n ] = getLinesCols(preMatch);\n\n let nonJSPreface;\n let nonJSPrefaceLineCount;\n if (n1) {\n const idx = n0.indexOf(n1);\n nonJSPreface = n0.slice(0, idx);\n nonJSPrefaceLineCount = countChars(nonJSPreface, '\\n');\n } else {\n nonJSPreface = '';\n nonJSPrefaceLineCount = 0;\n }\n\n nonJSPrefacingLines += lastStringCount + preMatchLines + nonJSPrefaceLineCount;\n\n // Ignore `preMatch` delta if newlines here\n if (nonJSPrefaceLineCount) {\n const charsInLastLine = nonJSPreface.slice(nonJSPreface.lastIndexOf('\\n') + 1).length;\n\n nonJSPrefacingCols += charsInLastLine;\n } else {\n nonJSPrefacingCols += colDelta + nonJSPreface.length;\n }\n\n const string = n1 \|\| n0;\n sources.push({\n nonJSPrefacingCols,\n nonJSPrefacingLines,\n string,\n });\n startingIndex = exampleCodeRegExp.lastIndex;\n lastStringCount = countChars(string, '\\n');\n if (!exampleCodeRegExp.global) {\n break;\n }\n }\n\n skipInit = true;\n }\n\n checkSource({\n cols,\n lines,\n skipInit,\n source,\n sources,\n tag,\n targetTagName,\n ...matchingFilenameInfo,\n });\n });\n\n return textsAndFileNames;\n };\n\n // See https://eslint.org/docs/latest/extend/plugins#processors-in-plugins\n // See https://eslint.org/docs/latest/extend/custom-processors\n // From https://github.com/eslint/eslint/issues/14745#issuecomment-869457265\n /\n {\n \"files\": [\".js\", \".ts\"],\n \"processor\": \"jsdoc/example\" // a pretended value here\n },\n {\n \"files\": [\n \".js/_jsdoc-example.js\",\n \".ts/_jsdoc-example.js\",\n \".js/_jsdoc-example.ts\"\n ],\n \"rules\": {\n // specific rules for examples in jsdoc only here\n // And other rules for `.js` and `.ts` will also be enabled for them\n }\n }\n /\n return {\n meta: {\n name: 'eslint-plugin-jsdoc/processor',\n version,\n },\n processors: {\n examples: {\n meta: {\n name: 'eslint-plugin-jsdoc/preprocessor',\n version,\n },\n /\n @param {string} text\n * @param {string} filename\n /\n preprocess (text, filename) {\n try {\n let ast;\n\n // May be running a second time so catch and ignore\n try {\n ast = parser\n // @ts-expect-error Ok\n ? parser.parseForESLint(text, {\n ecmaVersion: 'latest',\n sourceType,\n comment: true\n }).ast\n : espree.parse(text, {\n ecmaVersion: 'latest',\n sourceType,\n comment: true\n });\n } catch (err) {\n return [text];\n }\n\n /* @type {[number, number][]} /\n const commentLineCols = [];\n const jsdocComments = /* @type {import('estree').Comment[]} / (\n /\n @type {import('estree').Program & {\n * comments?: import('estree').Comment[]\n * }}\n /\n (ast).comments\n ).filter((comment) => {\n return (/^\\\\s/u).test(comment.value);\n }).map((comment) => {\n /* c8 ignore next -- Unsupporting processors only? /\n const [start] = comment.range ?? [];\n const textToStart = text.slice(0, start);\n\n const [lines, cols] = getLinesCols(textToStart);\n\n // const lines = [...textToStart.matchAll(/\\n/gu)].length\n // const lastLinePos = textToStart.lastIndexOf('\\n');\n // const cols = lastLinePos === -1\n // ? 0\n // : textToStart.slice(lastLinePos).length;\n commentLineCols.push([lines, cols]);\n return parseComment(comment);\n });\n\n return [\n text,\n ...jsdocComments.flatMap((jsdoc, idx) => {\n return getTextsAndFileNames(\n jsdoc,\n filename,\n commentLineCols[idx]\n );\n }).filter(Boolean)\n ];\n / c8 ignore next 3 /\n } catch (err) {\n console.log('err', filename, err);\n }\n },\n\n /\n @param {import('eslint').Linter.LintMessage[][]} messages\n * @param {string} filename\n */\n postprocess ([jsMessages, ...messages], filename) {\n messages.forEach((message, idx) => {\n const {\n targetTagName,\n codeStartLine,\n codeStartCol,\n nonJSPrefacingCols,\n commentLineCols\n } = otherInfo[idx];\n\n message.forEach((msg) => {\n const {\n message,\n ruleId,\n severity,\n fatal,\n line,\n column,\n endColumn,\n endLine,\n\n // Todo: Make fixable\n // fix\n // fix: {range: [number, number], text: string}\n // suggestions: {desc: , messageId:, fix: }[],\n } = msg;\n\n const [codeCtxLine, codeCtxColumn] = commentLineCols;\n const startLine = codeCtxLine + codeStartLine + line;\n const startCol = 1 + // Seems to need one more now\n codeCtxColumn + codeStartCol + (\n // This might not work for line 0, but line 0 is unlikely for examples\n line <= 1 ? nonJSPrefacingCols + firstLinePrefixLength : preTagSpaceLength\n ) + column;\n\n msg.message = '@' + targetTagName + ' ' + (severity === 2 ? 'error' : 'warning') +\n (ruleId ? ' (' + ruleId + ')' : '') + ': ' +\n (fatal ? 'Fatal: ' : '') +\n message;\n msg.line = startLine;\n msg.column = startCol;\n msg.endLine = endLine ? startLine + endLine : startLine;\n // added `- column` to offset what `endColumn` already seemed to include\n msg.endColumn = endColumn ? startCol - column + endColumn : startCol;\n });\n });\n\n const ret = [...jsMessages].concat(...messages, ...extraMessages);\n extraMessages = [];\n return ret;\n },\n supportsAutofix: true\n },\n },\n };\n};\n"],"mappings":"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","ignoreList":[]}
1	+ {"version":3,"file":"getJsdocProcessorPlugin.cjs","names":["_nodeFs","require","_nodePath","_nodeUrl","espree","_interopRequireWildcard","_jsdocUtils","_jsdoccomment","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","__dirname","dirname","fileURLToPath","pathToFileURL","__filename","toString","version","JSON","parse","readFileSync","join","likelyNestedJSDocIndentSpace","preTagSpaceLength","firstLinePrefixLength","hasCaptionRegex","escapeStringRegexp","str","replaceAll","countChars","ch","match","RegExp","length","getLinesCols","text","matchLines","colDelta","slice","lastIndexOf","getJsdocProcessorPlugin","options","exampleCodeRegex","rejectExampleCodeRegex","checkExamples","checkDefaults","checkParams","checkProperties","matchingFileName","matchingFileNameDefaults","matchingFileNameParams","matchingFileNameProperties","paddedIndent","captionRequired","sourceType","parser","undefined","exampleCodeRegExp","rejectExampleCodeRegExp","getRegexFromString","otherInfo","extraMessages","getTextsAndFileNames","jsdoc","jsFileName","commentLineCols","textsAndFileNames","checkSource","filename","ext","defaultFileName","lines","cols","skipInit","source","targetTagName","sources","tag","line","push","nonJSPrefacingCols","nonJSPrefacingLines","string","addSourceInfo","src","file","number","codeStartLine","codeStartCol","targetSource","getFilenameInfo","includes","replace","filenameInfo","forEachPreferredTag","description","trim","getTagDescription","tagName","getPreferredTagName","hasTag","matchingFilenameInfo","column","severity","message","ruleId","test","startingIndex","lastStringCount","exampleCode","lastIndex","exec","index","n0","n1","preMatch","preMatchLines","nonJSPreface","nonJSPrefaceLineCount","idx","indexOf","charsInLastLine","global","meta","name","processors","examples","preprocess","ast","parseForESLint","ecmaVersion","comment","err","jsdocComments","comments","filter","value","map","start","range","textToStart","parseComment","flatMap","Boolean","console","log","postprocess","jsMessages","messages","forEach","msg","fatal","endColumn","endLine","codeCtxLine","codeCtxColumn","startLine","startCol","ret","concat","supportsAutofix","exports"],"sources":["../src/getJsdocProcessorPlugin.js"],"sourcesContent":["// Todo: Support TS by fenced block type\n\nimport {readFileSync} from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport * as espree from 'espree';\nimport {\n getRegexFromString,\n forEachPreferredTag,\n getTagDescription,\n getPreferredTagName,\n hasTag,\n} from './jsdocUtils.js';\nimport {\n parseComment,\n} from '@es-joy/jsdoccomment';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nconst {version} = JSON.parse(\n // @ts-expect-error `Buffer` is ok for `JSON.parse`\n readFileSync(join(__dirname, '../package.json'))\n);\n\n// const zeroBasedLineIndexAdjust = -1;\nconst likelyNestedJSDocIndentSpace = 1;\nconst preTagSpaceLength = 1;\n\n// If a space is present, we should ignore it\nconst firstLinePrefixLength = preTagSpaceLength;\n\nconst hasCaptionRegex = /^\\s<caption>([\\s\\S]?)<\\/caption>/u;\n\n/*\n @param {string} str\n * @returns {string}\n /\nconst escapeStringRegexp = (str) => {\n return str.replaceAll(/[.+?^${}()\|[\\]\\\\]/gu, '\\\\$&');\n};\n\n/*\n @param {string} str\n * @param {string} ch\n * @returns {import('./iterateJsdoc.js').Integer}\n /\nconst countChars = (str, ch) => {\n return (str.match(new RegExp(escapeStringRegexp(ch), 'gu')) \|\| []).length;\n};\n\n/\n @param {string} text\n * @returns {[\n* import('./iterateJsdoc.js').Integer,\n* import('./iterateJsdoc.js').Integer\n* ]}\n/\nconst getLinesCols = (text) => {\n const matchLines = countChars(text, '\\n');\n\n const colDelta = matchLines ?\n text.slice(text.lastIndexOf('\\n') + 1).length :\n text.length;\n\n return [\n matchLines, colDelta,\n ];\n};\n\n/\n @typedef {number} Integer\n /\n\n/\n @typedef {object} JsdocProcessorOptions\n * @property {boolean} [captionRequired]\n * @property {Integer} [paddedIndent]\n * @property {boolean} [checkDefaults]\n * @property {boolean} [checkParams]\n * @property {boolean} [checkExamples]\n * @property {boolean} [checkProperties]\n * @property {string} [matchingFileName]\n * @property {string} [matchingFileNameDefaults]\n * @property {string} [matchingFileNameParams]\n * @property {string} [matchingFileNameProperties]\n * @property {string} [exampleCodeRegex]\n * @property {string} [rejectExampleCodeRegex]\n * @property {\"script\"\|\"module\"} [sourceType]\n * @property {import('eslint').Linter.ESTreeParser\|import('eslint').Linter.NonESTreeParser} [parser]\n /\n\n/\n We use a function for the ability of the user to pass in a config, but\n * without requiring all users of the plugin to do so.\n * @param {JsdocProcessorOptions} [options]\n /\nexport const getJsdocProcessorPlugin = (options = {}) => {\n const {\n exampleCodeRegex = null,\n rejectExampleCodeRegex = null,\n checkExamples = true,\n checkDefaults = false,\n checkParams = false,\n checkProperties = false,\n matchingFileName = null,\n matchingFileNameDefaults = null,\n matchingFileNameParams = null,\n matchingFileNameProperties = null,\n paddedIndent = 0,\n captionRequired = false,\n sourceType = 'module',\n parser = undefined\n } = options;\n\n /* @type {RegExp} /\n let exampleCodeRegExp;\n /* @type {RegExp} /\n let rejectExampleCodeRegExp;\n\n if (exampleCodeRegex) {\n exampleCodeRegExp = getRegexFromString(exampleCodeRegex);\n }\n\n if (rejectExampleCodeRegex) {\n rejectExampleCodeRegExp = getRegexFromString(rejectExampleCodeRegex);\n }\n\n /\n @type {{\n * targetTagName: string,\n * ext: string,\n * codeStartLine: number,\n * codeStartCol: number,\n * nonJSPrefacingCols: number,\n * commentLineCols: [number, number]\n * }[]}\n /\n const otherInfo = [];\n\n /* @type {import('eslint').Linter.LintMessage[]} /\n let extraMessages = [];\n\n /\n @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} jsFileName\n * @param {[number, number]} commentLineCols\n /\n const getTextsAndFileNames = (jsdoc, jsFileName, commentLineCols) => {\n /\n @type {{\n * text: string,\n * filename: string\|null\|undefined\n * }[]}\n /\n const textsAndFileNames = [];\n\n /\n @param {{\n * filename: string\|null,\n * defaultFileName: string\|undefined,\n * source: string,\n * targetTagName: string,\n * rules?: import('eslint').Linter.RulesRecord\|undefined,\n * lines?: import('./iterateJsdoc.js').Integer,\n * cols?: import('./iterateJsdoc.js').Integer,\n * skipInit?: boolean,\n * ext: string,\n * sources?: {\n * nonJSPrefacingCols: import('./iterateJsdoc.js').Integer,\n * nonJSPrefacingLines: import('./iterateJsdoc.js').Integer,\n * string: string,\n * }[],\n * tag?: import('comment-parser').Spec & {\n * line?: import('./iterateJsdoc.js').Integer,\n * }\|{\n * line: import('./iterateJsdoc.js').Integer,\n * }\n * }} cfg\n /\n const checkSource = ({\n filename,\n ext,\n defaultFileName,\n lines = 0,\n cols = 0,\n skipInit,\n source,\n targetTagName,\n sources = [],\n tag = {\n line: 0,\n },\n }) => {\n if (!skipInit) {\n sources.push({\n nonJSPrefacingCols: cols,\n nonJSPrefacingLines: lines,\n string: source,\n });\n }\n\n /\n @param {{\n * nonJSPrefacingCols: import('./iterateJsdoc.js').Integer,\n * nonJSPrefacingLines: import('./iterateJsdoc.js').Integer,\n * string: string\n * }} cfg\n /\n const addSourceInfo = function ({\n nonJSPrefacingCols,\n nonJSPrefacingLines,\n string,\n }) {\n const src = paddedIndent ?\n string.replaceAll(new RegExp(`(^\|\\n) {${paddedIndent}}(?!$)`, 'gu'), '\\n') :\n string;\n\n // Programmatic ESLint API: https://eslint.org/docs/developer-guide/nodejs-api\n const file = filename \|\| defaultFileName;\n\n if (!('line' in tag)) {\n tag.line = tag.source[0].number;\n }\n\n // NOTE: `tag.line` can be 0 if of form `/* @tag ... /`\n const codeStartLine = /\n @type {import('comment-parser').Spec & {\n * line: import('./iterateJsdoc.js').Integer,\n * }}\n / (tag).line + nonJSPrefacingLines;\n const codeStartCol = likelyNestedJSDocIndentSpace;\n\n textsAndFileNames.push({\n text: src,\n filename: file,\n });\n otherInfo.push({\n targetTagName,\n ext,\n codeStartLine,\n codeStartCol,\n nonJSPrefacingCols,\n commentLineCols\n });\n };\n\n for (const targetSource of sources) {\n addSourceInfo(targetSource);\n }\n };\n\n /\n \n * @param {string\|null} filename\n * @param {string} [ext] Since `eslint-plugin-markdown` v2, and\n * ESLint 7, this is the default which other JS-fenced rules will used.\n * Formerly \"md\" was the default.\n * @returns {{\n * defaultFileName: string\|undefined,\n * filename: string\|null,\n * ext: string\n * }}\n /\n const getFilenameInfo = (filename, ext = 'md/.js') => {\n let defaultFileName;\n if (!filename) {\n if (typeof jsFileName === 'string' && jsFileName.includes('.')) {\n defaultFileName = jsFileName.replace(/\\.[^.]$/u, `.${ext}`);\n } else {\n defaultFileName = `dummy.${ext}`;\n }\n }\n\n return {\n ext,\n defaultFileName,\n filename,\n };\n };\n\n if (checkDefaults) {\n const filenameInfo = getFilenameInfo(matchingFileNameDefaults, 'jsdoc-defaults');\n forEachPreferredTag(jsdoc, 'default', (tag, targetTagName) => {\n if (!tag.description.trim()) {\n return;\n }\n\n checkSource({\n source: `(${getTagDescription(tag)})`,\n targetTagName,\n ...filenameInfo,\n });\n });\n }\n\n if (checkParams) {\n const filenameInfo = getFilenameInfo(matchingFileNameParams, 'jsdoc-params');\n forEachPreferredTag(jsdoc, 'param', (tag, targetTagName) => {\n if (!tag.default \|\| !tag.default.trim()) {\n return;\n }\n\n checkSource({\n source: `(${tag.default})`,\n targetTagName,\n ...filenameInfo,\n });\n });\n }\n\n if (checkProperties) {\n const filenameInfo = getFilenameInfo(matchingFileNameProperties, 'jsdoc-properties');\n forEachPreferredTag(jsdoc, 'property', (tag, targetTagName) => {\n if (!tag.default \|\| !tag.default.trim()) {\n return;\n }\n\n checkSource({\n source: `(${tag.default})`,\n targetTagName,\n ...filenameInfo,\n });\n });\n }\n\n if (!checkExamples) {\n return textsAndFileNames;\n }\n\n const tagName = /* @type {string} / (getPreferredTagName(jsdoc, {\n tagName: 'example',\n }));\n if (!hasTag(jsdoc, tagName)) {\n return textsAndFileNames;\n }\n\n const matchingFilenameInfo = getFilenameInfo(matchingFileName);\n\n forEachPreferredTag(jsdoc, 'example', (tag, targetTagName) => {\n let source = /* @type {string} / (getTagDescription(tag));\n const match = source.match(hasCaptionRegex);\n\n if (captionRequired && (!match \|\| !match[1].trim())) {\n extraMessages.push({\n line: 1 + commentLineCols[0] + (tag.line ?? tag.source[0].number),\n column: commentLineCols[1] + 1,\n severity: 2,\n message: `@${targetTagName} error - Caption is expected for examples.`,\n ruleId: 'jsdoc/example-missing-caption'\n });\n return;\n }\n\n source = source.replace(hasCaptionRegex, '');\n const [\n lines,\n cols,\n ] = match ? getLinesCols(match[0]) : [\n 0, 0,\n ];\n\n if (exampleCodeRegex && !exampleCodeRegExp.test(source) \|\|\n rejectExampleCodeRegex && rejectExampleCodeRegExp.test(source)\n ) {\n return;\n }\n\n const sources = [];\n let skipInit = false;\n if (exampleCodeRegex) {\n let nonJSPrefacingCols = 0;\n let nonJSPrefacingLines = 0;\n\n let startingIndex = 0;\n let lastStringCount = 0;\n\n let exampleCode;\n exampleCodeRegExp.lastIndex = 0;\n while ((exampleCode = exampleCodeRegExp.exec(source)) !== null) {\n const {\n index,\n '0': n0,\n '1': n1,\n } = exampleCode;\n\n // Count anything preceding user regex match (can affect line numbering)\n const preMatch = source.slice(startingIndex, index);\n\n const [\n preMatchLines,\n colDelta,\n ] = getLinesCols(preMatch);\n\n let nonJSPreface;\n let nonJSPrefaceLineCount;\n if (n1) {\n const idx = n0.indexOf(n1);\n nonJSPreface = n0.slice(0, idx);\n nonJSPrefaceLineCount = countChars(nonJSPreface, '\\n');\n } else {\n nonJSPreface = '';\n nonJSPrefaceLineCount = 0;\n }\n\n nonJSPrefacingLines += lastStringCount + preMatchLines + nonJSPrefaceLineCount;\n\n // Ignore `preMatch` delta if newlines here\n if (nonJSPrefaceLineCount) {\n const charsInLastLine = nonJSPreface.slice(nonJSPreface.lastIndexOf('\\n') + 1).length;\n\n nonJSPrefacingCols += charsInLastLine;\n } else {\n nonJSPrefacingCols += colDelta + nonJSPreface.length;\n }\n\n const string = n1 \|\| n0;\n sources.push({\n nonJSPrefacingCols,\n nonJSPrefacingLines,\n string,\n });\n startingIndex = exampleCodeRegExp.lastIndex;\n lastStringCount = countChars(string, '\\n');\n if (!exampleCodeRegExp.global) {\n break;\n }\n }\n\n skipInit = true;\n }\n\n checkSource({\n cols,\n lines,\n skipInit,\n source,\n sources,\n tag,\n targetTagName,\n ...matchingFilenameInfo,\n });\n });\n\n return textsAndFileNames;\n };\n\n // See https://eslint.org/docs/latest/extend/plugins#processors-in-plugins\n // See https://eslint.org/docs/latest/extend/custom-processors\n // From https://github.com/eslint/eslint/issues/14745#issuecomment-869457265\n /\n {\n \"files\": [\".js\", \".ts\"],\n \"processor\": \"jsdoc/example\" // a pretended value here\n },\n {\n \"files\": [\n \".js/_jsdoc-example.js\",\n \".ts/_jsdoc-example.js\",\n \".js/_jsdoc-example.ts\"\n ],\n \"rules\": {\n // specific rules for examples in jsdoc only here\n // And other rules for `.js` and `.ts` will also be enabled for them\n }\n }\n /\n return {\n meta: {\n name: 'eslint-plugin-jsdoc/processor',\n version,\n },\n processors: {\n examples: {\n meta: {\n name: 'eslint-plugin-jsdoc/preprocessor',\n version,\n },\n /\n @param {string} text\n * @param {string} filename\n /\n preprocess (text, filename) {\n try {\n let ast;\n\n // May be running a second time so catch and ignore\n try {\n ast = parser\n // @ts-expect-error Should be present\n ? parser.parseForESLint(text, {\n ecmaVersion: 'latest',\n sourceType,\n comment: true\n }).ast\n : espree.parse(text, {\n ecmaVersion: 'latest',\n sourceType,\n comment: true\n });\n } catch (err) {\n return [text];\n }\n\n /* @type {[number, number][]} /\n const commentLineCols = [];\n const jsdocComments = /* @type {import('estree').Comment[]} / (\n /\n @type {import('estree').Program & {\n * comments?: import('estree').Comment[]\n * }}\n /\n (ast).comments\n ).filter((comment) => {\n return (/^\\\\s/u).test(comment.value);\n }).map((comment) => {\n /* c8 ignore next -- Unsupporting processors only? /\n const [start] = comment.range ?? [];\n const textToStart = text.slice(0, start);\n\n const [lines, cols] = getLinesCols(textToStart);\n\n // const lines = [...textToStart.matchAll(/\\n/gu)].length\n // const lastLinePos = textToStart.lastIndexOf('\\n');\n // const cols = lastLinePos === -1\n // ? 0\n // : textToStart.slice(lastLinePos).length;\n commentLineCols.push([lines, cols]);\n return parseComment(comment);\n });\n\n return [\n text,\n ...jsdocComments.flatMap((jsdoc, idx) => {\n return getTextsAndFileNames(\n jsdoc,\n filename,\n commentLineCols[idx]\n );\n }).filter(Boolean)\n ];\n / c8 ignore next 3 /\n } catch (err) {\n console.log('err', filename, err);\n }\n },\n\n /\n @param {import('eslint').Linter.LintMessage[][]} messages\n * @param {string} filename\n */\n postprocess ([jsMessages, ...messages], filename) {\n messages.forEach((message, idx) => {\n const {\n targetTagName,\n codeStartLine,\n codeStartCol,\n nonJSPrefacingCols,\n commentLineCols\n } = otherInfo[idx];\n\n message.forEach((msg) => {\n const {\n message,\n ruleId,\n severity,\n fatal,\n line,\n column,\n endColumn,\n endLine,\n\n // Todo: Make fixable\n // fix\n // fix: {range: [number, number], text: string}\n // suggestions: {desc: , messageId:, fix: }[],\n } = msg;\n\n const [codeCtxLine, codeCtxColumn] = commentLineCols;\n const startLine = codeCtxLine + codeStartLine + line;\n const startCol = 1 + // Seems to need one more now\n codeCtxColumn + codeStartCol + (\n // This might not work for line 0, but line 0 is unlikely for examples\n line <= 1 ? nonJSPrefacingCols + firstLinePrefixLength : preTagSpaceLength\n ) + column;\n\n msg.message = '@' + targetTagName + ' ' + (severity === 2 ? 'error' : 'warning') +\n (ruleId ? ' (' + ruleId + ')' : '') + ': ' +\n (fatal ? 'Fatal: ' : '') +\n message;\n msg.line = startLine;\n msg.column = startCol;\n msg.endLine = endLine ? startLine + endLine : startLine;\n // added `- column` to offset what `endColumn` already seemed to include\n msg.endColumn = endColumn ? startCol - column + endColumn : startCol;\n });\n });\n\n const ret = [...jsMessages].concat(...messages, ...extraMessages);\n extraMessages = [];\n return ret;\n },\n supportsAutofix: true\n },\n },\n };\n};\n"],"mappings":"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","ignoreList":[]}

package/dist/rules/noBadBlocks.cjs CHANGED Viewed

@@ -24,6 +24,12 @@ var _default = exports.default = (0, _iterateJsdoc.default)(({
   let extraAsterisks = false;
   const nonJsdocNodes = /** @type {import('estree').Node[]} */allComments.filter(comment => {
     const commentText = sourceCode.getText(comment);
+    const initialText = commentText.replace(commentRegexp, '').trimStart();
+    if (['eslint'].some(directive => {
+      return initialText.startsWith(directive);
+    })) {
+      return false;
+    }
     let sliceIndex = 2;
     if (!commentRegexp.test(commentText)) {
       var _extraAsteriskComment;

package/dist/rules/noBadBlocks.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"noBadBlocks.cjs","names":["_iterateJsdoc","_interopRequireDefault","require","_commentParser","e","__esModule","default","commentRegexp","extraAsteriskCommentRegexp","_default","exports","iterateJsdoc","context","sourceCode","allComments","makeReport","ignore","preventAllMultiAsteriskBlocks","options","extraAsterisks","nonJsdocNodes","filter","comment","commentText","getText","sliceIndex","test","_extraAsteriskComment","multiline","exec","length","tags","commentParser","slice","~~some","~~tag","includes","node","report","fix","fixer","text","replaceText","~~replace","~~checkFile","meta","docs","description","url","fixable","schema","additionalProperties","properties","items","type","module"],"sources":["../../src/rules/noBadBlocks.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\nimport {\n parse as commentParser,\n} from 'comment-parser';\n\n// Neither a single nor 3+ asterisks are valid jsdoc per\n// https://jsdoc.app/about-getting-started.html#adding-documentation-comments-to-your-code\nconst commentRegexp = /^\\/\\(?!\\)/u;\nconst extraAsteriskCommentRegexp = /^\\/\\{3,}/u;\n\nexport default iterateJsdoc(({\n context,\n sourceCode,\n allComments,\n makeReport,\n}) => {\n const [\n {\n ignore = [\n 'ts-check',\n 'ts-expect-error',\n 'ts-ignore',\n 'ts-nocheck',\n ],\n preventAllMultiAsteriskBlocks = false,\n } = {},\n ] = context.options;\n\n let extraAsterisks = false;\n const nonJsdocNodes = /* @type {import('estree').Node[]} / (\n allComments\n ).filter((comment) => {\n const commentText = sourceCode.getText(comment);\n let sliceIndex = 2;\n if (!commentRegexp.test(commentText)) {\n const multiline = extraAsteriskCommentRegexp.exec(commentText)?.[0];\n if (!multiline) {\n return false;\n }\n\n sliceIndex = multiline.length;\n extraAsterisks = true;\n if (preventAllMultiAsteriskBlocks) {\n return true;\n }\n }\n\n const tags = (commentParser(\n `${commentText.slice(0, 2)}${commentText.slice(sliceIndex)}`,\n )[0] \|\| {}).tags ?? [];\n\n return tags.length && !tags.some(({\n tag,\n }) => {\n return ignore.includes(tag);\n });\n });\n\n if (!nonJsdocNodes.length) {\n return;\n }\n\n for (const node of nonJsdocNodes) {\n const report = /** @type {import('../iterateJsdoc.js').MakeReport} / (\n makeReport\n )(context, node);\n\n // eslint-disable-next-line no-loop-func\n const fix = /* @type {import('eslint').Rule.ReportFixer} / (fixer) => {\n const text = sourceCode.getText(node);\n\n return fixer.replaceText(\n node,\n extraAsterisks ?\n text.replace(extraAsteriskCommentRegexp, '/') :\n text.replace('/', '/**'),\n );\n };\n\n report('Expected JSDoc-like comment to begin with two asterisks.', fix);\n }\n}, {\n checkFile: true,\n meta: {\n docs: {\n description: 'This rule checks for multi-line-style comments which fail to meet the criteria of a jsdoc block.',\n url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/no-bad-blocks.md#repos-sticky-header',\n },\n fixable: 'code',\n schema: [\n {\n additionalProperties: false,\n properties: {\n ignore: {\n items: {\n type: 'string',\n },\n type: 'array',\n },\n preventAllMultiAsteriskBlocks: {\n type: 'boolean',\n },\n },\n type: 'object',\n },\n ],\n type: 'layout',\n },\n});\n"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,cAAA,GAAAD,OAAA;AAEwB,SAAAD,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAExB;AACA;AACA,MAAMG,aAAa,GAAG,cAAc;AACpC,MAAMC,0BAA0B,GAAG,YAAY;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAJ,OAAA,GAEjC,IAAAK,qBAAY,EAAC,CAAC;EAC3BC,OAAO;EACPC,UAAU;EACVC,WAAW;EACXC;AACF,CAAC,KAAK;EACJ,MAAM,CACJ;IACEC,MAAM,GAAG,CACP,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,YAAY,CACb;IACDC,6BAA6B,GAAG;EAClC,CAAC,GAAG,CAAC,CAAC,CACP,GAAGL,OAAO,CAACM,OAAO;EAEnB,IAAIC,cAAc,GAAG,KAAK;EAC1B,MAAMC,aAAa,GAAG,sCACpBN,WAAW,CACXO,MAAM,CAAEC,OAAO,IAAK;IACpB,MAAMC,WAAW,GAAGV,UAAU,CAACW,OAAO,CAACF,OAAO,CAAC;~~IAC~~/C,~~IAAIG~~,UAAU,GAAG,CAAC;IAClB,IAAI,~~CAAClB~~,aAAa,~~CAACmB~~,IAAI,~~CAACH~~,WAAW,CAAC,EAAE;MAAA,~~IAAAI~~,qBAAA;MACpC,MAAMC,SAAS,IAAAD,qBAAA,~~GAAGnB~~,0BAA0B,~~CAACqB~~,IAAI,~~CAACN~~,WAAW,CAAC,~~cAAAI~~,qBAAA,uBAA5CA,qBAAA,CAA+C,CAAC,CAAC;MACnE,IAAI,CAACC,SAAS,EAAE;QACd,OAAO,KAAK;MACd;MAEAH,UAAU,GAAGG,SAAS,CAACE,MAAM;~~MAC7BX~~,cAAc,GAAG,IAAI;MACrB,IAAIF,6BAA6B,EAAE;QACjC,OAAO,IAAI;MACb;IACF;IAEA,~~MAAMc~~,IAAI,GAAG,CAAC,IAAAC,oBAAa,EACzB,~~GAAGT~~,WAAW,~~CAACU~~,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,~~IAAIV~~,WAAW,~~CAACU~~,KAAK,CAACR,UAAU,CAAC,EAC7D,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAEM,IAAI,IAAI,EAAE;IAEtB,OAAOA,IAAI,CAACD,MAAM,IAAI,CAACC,IAAI,~~CAACG~~,IAAI,CAAC,CAAC;~~MAChCC~~;IACF,CAAC,KAAK;MACJ,~~OAAOnB~~,MAAM,~~CAACoB~~,QAAQ,CAACD,GAAG,CAAC;IAC7B,CAAC,CAAC;EACJ,CAAC,CAAC;EAEF,IAAI,~~CAACf~~,aAAa,~~CAACU~~,MAAM,EAAE;IACzB;EACF;EAEA,KAAK,~~MAAMO~~,IAAI,~~IAAIjB~~,aAAa,EAAE;IAChC,~~MAAMkB~~,MAAM,GAAG,~~sDACbvB~~,UAAU,CACVH,OAAO,~~EAAEyB~~,IAAI,CAAC;;IAEhB;IACA,MAAME,GAAG,GAAG,gDAAkDC,KAAK,IAAK;MACtE,MAAMC,IAAI,~~GAAG5B~~,UAAU,CAACW,OAAO,~~CAACa~~,IAAI,CAAC;MAErC,OAAOG,KAAK,CAACE,WAAW,CACtBL,IAAI,~~EACJlB~~,cAAc,~~GACZsB~~,IAAI,~~CAACE~~,OAAO,~~CAACnC~~,0BAA0B,EAAE,KAAK,CAAC,GAC/~~CiC~~,IAAI,~~CAACE~~,OAAO,CAAC,IAAI,EAAE,KAAK,CAC5B,CAAC;IACH,CAAC;~~IAEDL~~,MAAM,CAAC,0DAA0D,EAAEC,GAAG,CAAC;EACzE;AACF,CAAC,EAAE;~~EACDK~~,SAAS,EAAE,IAAI;EACfC,IAAI,EAAE;IACJC,IAAI,EAAE;MACJC,WAAW,EAAE,kGAAkG;MAC/GC,GAAG,EAAE;IACP,CAAC;IACDC,OAAO,EAAE,MAAM;IACfC,MAAM,EAAE,CACN;MACEC,oBAAoB,EAAE,KAAK;MAC3BC,UAAU,EAAE;~~QACVpC~~,MAAM,EAAE;~~UACNqC~~,KAAK,EAAE;YACLC,IAAI,EAAE;UACR,CAAC;UACDA,IAAI,EAAE;QACR,CAAC;~~QACDrC~~,6BAA6B,EAAE;~~UAC7BqC~~,IAAI,EAAE;QACR;MACF,CAAC;MACDA,IAAI,EAAE;IACR,CAAC,CACF;IACDA,IAAI,EAAE;EACR;AACF,CAAC,CAAC;AAAAC,MAAA,~~CAAA7C~~,OAAA,GAAAA,OAAA,CAAAJ,OAAA","ignoreList":[]}
1	+ {"version":3,"file":"noBadBlocks.cjs","names":["_iterateJsdoc","_interopRequireDefault","require","_commentParser","e","__esModule","default","commentRegexp","extraAsteriskCommentRegexp","_default","exports","iterateJsdoc","context","sourceCode","allComments","makeReport","ignore","preventAllMultiAsteriskBlocks","options","extraAsterisks","nonJsdocNodes","filter","comment","commentText","getText","initialText","replace","trimStart","some","directive","startsWith","sliceIndex","test","_extraAsteriskComment","multiline","exec","length","tags","commentParser","slice","tag","includes","node","report","fix","fixer","text","replaceText","checkFile","meta","docs","description","url","fixable","schema","additionalProperties","properties","items","type","module"],"sources":["../../src/rules/noBadBlocks.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\nimport {\n parse as commentParser,\n} from 'comment-parser';\n\n// Neither a single nor 3+ asterisks are valid jsdoc per\n// https://jsdoc.app/about-getting-started.html#adding-documentation-comments-to-your-code\nconst commentRegexp = /^\\/\\(?!\\)/u;\nconst extraAsteriskCommentRegexp = /^\\/\\{3,}/u;\n\nexport default iterateJsdoc(({\n context,\n sourceCode,\n allComments,\n makeReport,\n}) => {\n const [\n {\n ignore = [\n 'ts-check',\n 'ts-expect-error',\n 'ts-ignore',\n 'ts-nocheck',\n ],\n preventAllMultiAsteriskBlocks = false,\n } = {},\n ] = context.options;\n\n let extraAsterisks = false;\n const nonJsdocNodes = /* @type {import('estree').Node[]} / (\n allComments\n ).filter((comment) => {\n const commentText = sourceCode.getText(comment);\n\n const initialText = commentText.replace(commentRegexp, '').trimStart();\n if ([\n 'eslint'\n ].some((directive) => {\n return initialText.startsWith(directive);\n })) {\n return false;\n }\n\n let sliceIndex = 2;\n if (!commentRegexp.test(commentText)) {\n const multiline = extraAsteriskCommentRegexp.exec(commentText)?.[0];\n if (!multiline) {\n return false;\n }\n\n sliceIndex = multiline.length;\n extraAsterisks = true;\n if (preventAllMultiAsteriskBlocks) {\n return true;\n }\n }\n\n const tags = (commentParser(\n `${commentText.slice(0, 2)}${commentText.slice(sliceIndex)}`,\n )[0] \|\| {}).tags ?? [];\n\n return tags.length && !tags.some(({\n tag,\n }) => {\n return ignore.includes(tag);\n });\n });\n\n if (!nonJsdocNodes.length) {\n return;\n }\n\n for (const node of nonJsdocNodes) {\n const report = /** @type {import('../iterateJsdoc.js').MakeReport} / (\n makeReport\n )(context, node);\n\n // eslint-disable-next-line no-loop-func\n const fix = /* @type {import('eslint').Rule.ReportFixer} / (fixer) => {\n const text = sourceCode.getText(node);\n\n return fixer.replaceText(\n node,\n extraAsterisks ?\n text.replace(extraAsteriskCommentRegexp, '/') :\n text.replace('/', '/**'),\n );\n };\n\n report('Expected JSDoc-like comment to begin with two asterisks.', fix);\n }\n}, {\n checkFile: true,\n meta: {\n docs: {\n description: 'This rule checks for multi-line-style comments which fail to meet the criteria of a jsdoc block.',\n url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/no-bad-blocks.md#repos-sticky-header',\n },\n fixable: 'code',\n schema: [\n {\n additionalProperties: false,\n properties: {\n ignore: {\n items: {\n type: 'string',\n },\n type: 'array',\n },\n preventAllMultiAsteriskBlocks: {\n type: 'boolean',\n },\n },\n type: 'object',\n },\n ],\n type: 'layout',\n },\n});\n"],"mappings":"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","ignoreList":[]}

package/dist/utils/hasReturnValue.cjs CHANGED Viewed

@@ -26,7 +26,13 @@ const isNewPromiseExpression = node => {
 const isVoidPromise = node => {
   var _node$typeArguments, _node$typeParameters;
   return /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */(node === null || node === void 0 || (_node$typeArguments = node.typeArguments) === null || _node$typeArguments === void 0 || (_node$typeArguments = _node$typeArguments.params) === null || _node$typeArguments === void 0 || (_node$typeArguments = _node$typeArguments[0]) === null || _node$typeArguments === void 0 ? void 0 : _node$typeArguments.type) === 'TSVoidKeyword'
-  /* c8 ignore next */ || /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */(node === null || node === void 0 || (_node$typeParameters = node.typeParameters) === null || _node$typeParameters === void 0 || (_node$typeParameters = _node$typeParameters.params) === null || _node$typeParameters === void 0 || (_node$typeParameters = _node$typeParameters[0]) === null || _node$typeParameters === void 0 ? void 0 : _node$typeParameters.type) === 'TSVoidKeyword';
+  /* c8 ignore next 4 */ || /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */(node
+  // @ts-expect-error Ok
+  === null || node
+  // @ts-expect-error Ok
+  === void 0 || (_node$typeParameters = node
+  // @ts-expect-error Ok
+  .typeParameters) === null || _node$typeParameters === void 0 || (_node$typeParameters = _node$typeParameters.params) === null || _node$typeParameters === void 0 || (_node$typeParameters = _node$typeParameters[0]) === null || _node$typeParameters === void 0 ? void 0 : _node$typeParameters.type) === 'TSVoidKeyword';
 };
 const undefinedKeywords = new Set(['TSVoidKeyword', 'TSUndefinedKeyword', 'TSNeverKeyword']);

package/dist/utils/hasReturnValue.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"hasReturnValue.cjs","names":["isNewPromiseExpression","node","type","callee","name","isVoidPromise","_node$typeArguments","_node$typeParameters","typeArguments","params","typeParameters","undefinedKeywords","Set","hasReturnValue","throwOnNullReturn","promFilter","_node$returnType","returnType","typeAnnotation","has","value","expression","body","some","bodyNode","consequent","alternate","block","handler","finalizer","cases","someCase","nde","argument","Error","exports","allBrancheshaveReturnValues","_node$returnType2","lastBodyNode","slice","test","error","message","every","consNode","hasNonEmptyResolverCall","resolverName","arguments","length","undefined","_node$params$","elements","element","right","left","expressions","subExpression","properties","property","decorators","decorator","computed","key","declarations","id","init","quasi","object","source","hasValueOrExecutorHasNonEmptyResolveValue","anyPromiseAsReturn","allBranches","hasReturnMethod","promiseFilter","hasReturn","Boolean","prom"],"sources":["../../src/utils/hasReturnValue.js"],"sourcesContent":["/*\n @typedef {import('estree').Node\|\n * import('@typescript-eslint/types').TSESTree.Node} ESTreeOrTypeScriptNode\n /\n\n/\n Checks if a node is a promise but has no resolve value or an empty value.\n * An `undefined` resolve does not count.\n * @param {ESTreeOrTypeScriptNode\|undefined\|null} node\n * @returns {boolean\|undefined\|null}\n /\nconst isNewPromiseExpression = (node) => {\n return node && node.type === 'NewExpression' && node.callee.type === 'Identifier' &&\n node.callee.name === 'Promise';\n};\n\n/\n @param {ESTreeOrTypeScriptNode\|null\|undefined} node\n * @returns {boolean}\n /\nconst isVoidPromise = (node) => {\n return /* @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} / (node)?.typeArguments?.params?.[0]?.type === 'TSVoidKeyword'\n / c8 ignore next /\n \|\| /* @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} / (node)?.typeParameters?.params?.[0]?.type === 'TSVoidKeyword';\n};\n\nconst undefinedKeywords = new Set([\n 'TSVoidKeyword', 'TSUndefinedKeyword', 'TSNeverKeyword',\n]);\n\n/\n Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode\|undefined\|null} node\n * @param {boolean} [throwOnNullReturn]\n * @param {PromiseFilter} [promFilter]\n * @returns {boolean\|undefined}\n /\n// eslint-disable-next-line complexity\nconst hasReturnValue = (node, throwOnNullReturn, promFilter) => {\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n case 'TSDeclareFunction':\n case 'TSFunctionType':\n case 'TSMethodSignature': {\n const type = node?.returnType?.typeAnnotation?.type;\n return type && !undefinedKeywords.has(type);\n }\n\n case 'MethodDefinition':\n return hasReturnValue(node.value, throwOnNullReturn, promFilter);\n case 'FunctionExpression':\n case 'FunctionDeclaration':\n case 'ArrowFunctionExpression': {\n return 'expression' in node && node.expression && (!isNewPromiseExpression(\n node.body,\n ) \|\| !isVoidPromise(node.body)) \|\|\n hasReturnValue(node.body, throwOnNullReturn, promFilter);\n }\n\n case 'BlockStatement': {\n return node.body.some((bodyNode) => {\n return bodyNode.type !== 'FunctionDeclaration' && hasReturnValue(bodyNode, throwOnNullReturn, promFilter);\n });\n }\n\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'DoWhileStatement':\n case 'ForStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n case 'WithStatement': {\n return hasReturnValue(node.body, throwOnNullReturn, promFilter);\n }\n\n case 'IfStatement': {\n return hasReturnValue(node.consequent, throwOnNullReturn, promFilter) \|\|\n hasReturnValue(node.alternate, throwOnNullReturn, promFilter);\n }\n\n case 'TryStatement': {\n return hasReturnValue(node.block, throwOnNullReturn, promFilter) \|\|\n hasReturnValue(node.handler && node.handler.body, throwOnNullReturn, promFilter) \|\|\n hasReturnValue(node.finalizer, throwOnNullReturn, promFilter);\n }\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasReturnValue(nde, throwOnNullReturn, promFilter);\n });\n },\n );\n }\n\n case 'ReturnStatement': {\n // void return does not count.\n if (node.argument === null) {\n if (throwOnNullReturn) {\n throw new Error('Null return');\n }\n\n return false;\n }\n\n if (promFilter && isNewPromiseExpression(node.argument)) {\n // Let caller decide how to filter, but this is, at the least,\n // a return of sorts and truthy\n return promFilter(node.argument);\n }\n\n return true;\n }\n\n default: {\n return false;\n }\n }\n};\n\n/\n Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode\|null\|undefined} node\n * @param {PromiseFilter} promFilter\n * @returns {undefined\|boolean\|ESTreeOrTypeScriptNode}\n /\n// eslint-disable-next-line complexity\nconst allBrancheshaveReturnValues = (node, promFilter) => {\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n case 'TSDeclareFunction':\n case 'TSFunctionType':\n case 'TSMethodSignature': {\n const type = node?.returnType?.typeAnnotation?.type;\n return type && !undefinedKeywords.has(type);\n }\n\n // case 'MethodDefinition':\n // return allBrancheshaveReturnValues(node.value, promFilter);\n case 'FunctionExpression':\n case 'FunctionDeclaration':\n case 'ArrowFunctionExpression': {\n return 'expression' in node && node.expression && (!isNewPromiseExpression(node.body) \|\| !isVoidPromise(node.body)) \|\|\n allBrancheshaveReturnValues(node.body, promFilter) \|\|\n /* @type {import('@typescript-eslint/types').TSESTree.BlockStatement} /\n (node.body).body.some((nde) => {\n return nde.type === 'ReturnStatement';\n });\n }\n\n case 'BlockStatement': {\n const lastBodyNode = node.body.slice(-1)[0];\n return allBrancheshaveReturnValues(lastBodyNode, promFilter);\n }\n\n case 'WhileStatement':\n case 'DoWhileStatement':\n if (\n /\n @type {import('@typescript-eslint/types').TSESTree.Literal}\n /\n (node.test).value === true\n ) {\n // If this is an infinite loop, we assume only one branch\n // is needed to provide a return\n return hasReturnValue(node.body, false, promFilter);\n }\n\n // Fallthrough\n case 'LabeledStatement':\n case 'ForStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n case 'WithStatement': {\n return allBrancheshaveReturnValues(node.body, promFilter);\n }\n\n case 'IfStatement': {\n return allBrancheshaveReturnValues(node.consequent, promFilter) &&\n allBrancheshaveReturnValues(node.alternate, promFilter);\n }\n\n case 'TryStatement': {\n // If `finally` returns, all return\n return node.finalizer && allBrancheshaveReturnValues(node.finalizer, promFilter) \|\|\n // Return in `try`/`catch` may still occur despite `finally`\n allBrancheshaveReturnValues(node.block, promFilter) &&\n (!node.handler \|\|\n allBrancheshaveReturnValues(node.handler && node.handler.body, promFilter)) &&\n (!node.finalizer \|\| (() => {\n try {\n hasReturnValue(node.finalizer, true, promFilter);\n } catch (error) {\n if (/* @type {Error} / (error).message === 'Null return') {\n return false;\n }\n / c8 ignore next 2 /\n throw error;\n }\n\n // As long as not an explicit empty return, then return true\n return true;\n })());\n }\n\n case 'SwitchStatement': {\n return /* @type {import('@typescript-eslint/types').TSESTree.SwitchStatement} / (node).cases.every(\n (someCase) => {\n return !someCase.consequent.some((consNode) => {\n return consNode.type === 'BreakStatement' \|\|\n consNode.type === 'ReturnStatement' && consNode.argument === null;\n });\n },\n );\n }\n\n case 'ThrowStatement': {\n return true;\n }\n\n case 'ReturnStatement': {\n // void return does not count.\n if (node.argument === null) {\n return false;\n }\n\n if (promFilter && isNewPromiseExpression(node.argument)) {\n // Let caller decide how to filter, but this is, at the least,\n // a return of sorts and truthy\n return promFilter(node.argument);\n }\n\n return true;\n }\n\n default: {\n return false;\n }\n }\n};\n\n/\n @callback PromiseFilter\n * @param {ESTreeOrTypeScriptNode\|undefined} node\n * @returns {boolean}\n /\n\n/\n Avoids further checking child nodes if a nested function shadows the\n * resolver, but otherwise, if name is used (by call or passed in as an\n * argument to another function), will be considered as non-empty.\n \n This could check for redeclaration of the resolver, but as such is\n * unlikely, we avoid the performance cost of checking everywhere for\n * (re)declarations or assignments.\n * @param {import('@typescript-eslint/types').TSESTree.Node\|null\|undefined} node\n * @param {string} resolverName\n * @returns {boolean}\n /\n// eslint-disable-next-line complexity\nconst hasNonEmptyResolverCall = (node, resolverName) => {\n if (!node) {\n return false;\n }\n\n // Arrow function without block\n switch (node.type) {\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'OptionalCallExpression':\n case 'CallExpression':\n return /* @type {import('@typescript-eslint/types').TSESTree.Identifier} / (\n node.callee\n ).name === resolverName && (\n\n // Implicit or explicit undefined\n node.arguments.length > 1 \|\| node.arguments[0] !== undefined\n ) \|\|\n node.arguments.some((nde) => {\n // Being passed in to another function (which might invoke it)\n return nde.type === 'Identifier' && nde.name === resolverName \|\|\n\n // Handle nested items\n hasNonEmptyResolverCall(nde, resolverName);\n });\n case 'ChainExpression':\n case 'Decorator':\n case 'ExpressionStatement':\n return hasNonEmptyResolverCall(node.expression, resolverName);\n case 'ClassBody':\n case 'BlockStatement':\n return node.body.some((bodyNode) => {\n return hasNonEmptyResolverCall(bodyNode, resolverName);\n });\n case 'FunctionExpression':\n case 'FunctionDeclaration':\n case 'ArrowFunctionExpression': {\n // Shadowing\n if (/* @type {import('@typescript-eslint/types').TSESTree.Identifier} / (\n node.params[0]\n )?.name === resolverName) {\n return false;\n }\n\n return hasNonEmptyResolverCall(node.body, resolverName);\n }\n\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'DoWhileStatement':\n case 'ForStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n case 'WithStatement': {\n return hasNonEmptyResolverCall(node.body, resolverName);\n }\n\n case 'ConditionalExpression':\n case 'IfStatement': {\n return hasNonEmptyResolverCall(node.test, resolverName) \|\|\n hasNonEmptyResolverCall(node.consequent, resolverName) \|\|\n hasNonEmptyResolverCall(node.alternate, resolverName);\n }\n\n case 'TryStatement': {\n return hasNonEmptyResolverCall(node.block, resolverName) \|\|\n hasNonEmptyResolverCall(node.handler && node.handler.body, resolverName) \|\|\n hasNonEmptyResolverCall(node.finalizer, resolverName);\n }\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n },\n );\n }\n\n case 'ArrayPattern':\n case 'ArrayExpression':\n return node.elements.some((element) => {\n return hasNonEmptyResolverCall(element, resolverName);\n });\n\n case 'AssignmentPattern':\n return hasNonEmptyResolverCall(node.right, resolverName);\n\n case 'AssignmentExpression':\n case 'BinaryExpression':\n case 'LogicalExpression': {\n return hasNonEmptyResolverCall(node.left, resolverName) \|\|\n hasNonEmptyResolverCall(node.right, resolverName);\n }\n\n // Comma\n case 'SequenceExpression':\n case 'TemplateLiteral':\n return node.expressions.some((subExpression) => {\n return hasNonEmptyResolverCall(subExpression, resolverName);\n });\n\n case 'ObjectPattern':\n case 'ObjectExpression':\n return node.properties.some((property) => {\n return hasNonEmptyResolverCall(property, resolverName);\n });\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'ClassMethod':\n case 'MethodDefinition':\n return node.decorators && node.decorators.some((decorator) => {\n return hasNonEmptyResolverCall(decorator, resolverName);\n }) \|\|\n node.computed && hasNonEmptyResolverCall(node.key, resolverName) \|\|\n hasNonEmptyResolverCall(node.value, resolverName);\n\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'ObjectProperty':\n / eslint-disable no-fallthrough /\n / c8 ignore next -- In Babel? /\n case 'PropertyDefinition':\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'ClassProperty':\n case 'Property':\n / eslint-enable no-fallthrough /\n return node.computed && hasNonEmptyResolverCall(node.key, resolverName) \|\|\n hasNonEmptyResolverCall(node.value, resolverName);\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'ObjectMethod':\n / c8 ignore next 6 -- In Babel? /\n // @ts-expect-error\n return node.computed && hasNonEmptyResolverCall(node.key, resolverName) \|\|\n // @ts-expect-error\n node.arguments.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n\n case 'ClassExpression':\n case 'ClassDeclaration':\n return hasNonEmptyResolverCall(node.body, resolverName);\n\n case 'AwaitExpression':\n case 'SpreadElement':\n case 'UnaryExpression':\n case 'YieldExpression':\n return hasNonEmptyResolverCall(node.argument, resolverName);\n\n case 'VariableDeclaration': {\n return node.declarations.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n }\n\n case 'VariableDeclarator': {\n return hasNonEmptyResolverCall(node.id, resolverName) \|\|\n hasNonEmptyResolverCall(node.init, resolverName);\n }\n\n case 'TaggedTemplateExpression':\n return hasNonEmptyResolverCall(node.quasi, resolverName);\n\n // ?.\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'OptionalMemberExpression':\n case 'MemberExpression':\n return hasNonEmptyResolverCall(node.object, resolverName) \|\|\n hasNonEmptyResolverCall(node.property, resolverName);\n\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'Import':\n case 'ImportExpression':\n return hasNonEmptyResolverCall(node.source, resolverName);\n\n case 'ReturnStatement': {\n if (node.argument === null) {\n return false;\n }\n\n return hasNonEmptyResolverCall(node.argument, resolverName);\n }\n\n /\n // Shouldn't need to parse literals/literal components, etc.\n\n case 'Identifier':\n case 'TemplateElement':\n case 'Super':\n // Exports not relevant in this context\n /\n default:\n return false;\n }\n};\n\n/\n Checks if a Promise executor has no resolve value or an empty value.\n * An `undefined` resolve does not count.\n * @param {ESTreeOrTypeScriptNode} node\n * @param {boolean} anyPromiseAsReturn\n * @param {boolean} [allBranches]\n * @returns {boolean}\n /\nconst hasValueOrExecutorHasNonEmptyResolveValue = (node, anyPromiseAsReturn, allBranches) => {\n const hasReturnMethod = allBranches ?\n /\n @param {ESTreeOrTypeScriptNode} nde\n * @param {PromiseFilter} promiseFilter\n * @returns {boolean}\n /\n (nde, promiseFilter) => {\n let hasReturn;\n try {\n hasReturn = hasReturnValue(nde, true, promiseFilter);\n } catch (error) {\n // c8 ignore else\n if (/* @type {Error} / (error).message === 'Null return') {\n return false;\n }\n / c8 ignore next 2 /\n throw error;\n }\n\n // `hasReturn` check needed since `throw` treated as valid return by\n // `allBrancheshaveReturnValues`\n return Boolean(hasReturn && allBrancheshaveReturnValues(nde, promiseFilter));\n } :\n /\n @param {ESTreeOrTypeScriptNode} nde\n * @param {PromiseFilter} promiseFilter\n * @returns {boolean}\n /\n (nde, promiseFilter) => {\n return Boolean(hasReturnValue(nde, false, promiseFilter));\n };\n\n return hasReturnMethod(node, (prom) => {\n if (anyPromiseAsReturn) {\n return true;\n }\n\n if (isVoidPromise(prom)) {\n return false;\n }\n\n const {\n params,\n body,\n } =\n /\n @type {import('@typescript-eslint/types').TSESTree.FunctionExpression\|\n * import('@typescript-eslint/types').TSESTree.ArrowFunctionExpression}\n / (\n /* @type {import('@typescript-eslint/types').TSESTree.NewExpression} / (\n prom\n ).arguments[0]\n ) \|\| {};\n\n if (!params?.length) {\n return false;\n }\n\n const {\n name: resolverName,\n } = /* @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n params[0]\n );\n\n return hasNonEmptyResolverCall(body, resolverName);\n });\n};\n\nexport {\n hasReturnValue,\n hasValueOrExecutorHasNonEmptyResolveValue,\n};\n"],"mappings":"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","ignoreList":[]}
1	+ {"version":3,"file":"hasReturnValue.cjs","names":["isNewPromiseExpression","node","type","callee","name","isVoidPromise","_node$typeArguments","_node$typeParameters","typeArguments","params","typeParameters","undefinedKeywords","Set","hasReturnValue","throwOnNullReturn","promFilter","_node$returnType","returnType","typeAnnotation","has","value","expression","body","some","bodyNode","consequent","alternate","block","handler","finalizer","cases","someCase","nde","argument","Error","exports","allBrancheshaveReturnValues","_node$returnType2","lastBodyNode","slice","test","error","message","every","consNode","hasNonEmptyResolverCall","resolverName","arguments","length","undefined","_node$params$","elements","element","right","left","expressions","subExpression","properties","property","decorators","decorator","computed","key","declarations","id","init","quasi","object","source","hasValueOrExecutorHasNonEmptyResolveValue","anyPromiseAsReturn","allBranches","hasReturnMethod","promiseFilter","hasReturn","Boolean","prom"],"sources":["../../src/utils/hasReturnValue.js"],"sourcesContent":["/*\n @typedef {import('estree').Node\|\n * import('@typescript-eslint/types').TSESTree.Node} ESTreeOrTypeScriptNode\n /\n\n/\n Checks if a node is a promise but has no resolve value or an empty value.\n * An `undefined` resolve does not count.\n * @param {ESTreeOrTypeScriptNode\|undefined\|null} node\n * @returns {boolean\|undefined\|null}\n /\nconst isNewPromiseExpression = (node) => {\n return node && node.type === 'NewExpression' && node.callee.type === 'Identifier' &&\n node.callee.name === 'Promise';\n};\n\n/\n @param {ESTreeOrTypeScriptNode\|null\|undefined} node\n * @returns {boolean}\n /\nconst isVoidPromise = (node) => {\n return /* @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} / (node)?.typeArguments?.params?.[0]?.type === 'TSVoidKeyword'\n / c8 ignore next 4 /\n \|\| /* @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} / (\n node\n // @ts-expect-error Ok\n )?.typeParameters?.params?.[0]?.type === 'TSVoidKeyword';\n};\n\nconst undefinedKeywords = new Set([\n 'TSVoidKeyword', 'TSUndefinedKeyword', 'TSNeverKeyword',\n]);\n\n/\n Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode\|undefined\|null} node\n * @param {boolean} [throwOnNullReturn]\n * @param {PromiseFilter} [promFilter]\n * @returns {boolean\|undefined}\n /\n// eslint-disable-next-line complexity\nconst hasReturnValue = (node, throwOnNullReturn, promFilter) => {\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n case 'TSDeclareFunction':\n case 'TSFunctionType':\n case 'TSMethodSignature': {\n const type = node?.returnType?.typeAnnotation?.type;\n return type && !undefinedKeywords.has(type);\n }\n\n case 'MethodDefinition':\n return hasReturnValue(node.value, throwOnNullReturn, promFilter);\n case 'FunctionExpression':\n case 'FunctionDeclaration':\n case 'ArrowFunctionExpression': {\n return 'expression' in node && node.expression && (!isNewPromiseExpression(\n node.body,\n ) \|\| !isVoidPromise(node.body)) \|\|\n hasReturnValue(node.body, throwOnNullReturn, promFilter);\n }\n\n case 'BlockStatement': {\n return node.body.some((bodyNode) => {\n return bodyNode.type !== 'FunctionDeclaration' && hasReturnValue(bodyNode, throwOnNullReturn, promFilter);\n });\n }\n\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'DoWhileStatement':\n case 'ForStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n case 'WithStatement': {\n return hasReturnValue(node.body, throwOnNullReturn, promFilter);\n }\n\n case 'IfStatement': {\n return hasReturnValue(node.consequent, throwOnNullReturn, promFilter) \|\|\n hasReturnValue(node.alternate, throwOnNullReturn, promFilter);\n }\n\n case 'TryStatement': {\n return hasReturnValue(node.block, throwOnNullReturn, promFilter) \|\|\n hasReturnValue(node.handler && node.handler.body, throwOnNullReturn, promFilter) \|\|\n hasReturnValue(node.finalizer, throwOnNullReturn, promFilter);\n }\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasReturnValue(nde, throwOnNullReturn, promFilter);\n });\n },\n );\n }\n\n case 'ReturnStatement': {\n // void return does not count.\n if (node.argument === null) {\n if (throwOnNullReturn) {\n throw new Error('Null return');\n }\n\n return false;\n }\n\n if (promFilter && isNewPromiseExpression(node.argument)) {\n // Let caller decide how to filter, but this is, at the least,\n // a return of sorts and truthy\n return promFilter(node.argument);\n }\n\n return true;\n }\n\n default: {\n return false;\n }\n }\n};\n\n/\n Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode\|null\|undefined} node\n * @param {PromiseFilter} promFilter\n * @returns {undefined\|boolean\|ESTreeOrTypeScriptNode}\n /\n// eslint-disable-next-line complexity\nconst allBrancheshaveReturnValues = (node, promFilter) => {\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n case 'TSDeclareFunction':\n case 'TSFunctionType':\n case 'TSMethodSignature': {\n const type = node?.returnType?.typeAnnotation?.type;\n return type && !undefinedKeywords.has(type);\n }\n\n // case 'MethodDefinition':\n // return allBrancheshaveReturnValues(node.value, promFilter);\n case 'FunctionExpression':\n case 'FunctionDeclaration':\n case 'ArrowFunctionExpression': {\n return 'expression' in node && node.expression && (!isNewPromiseExpression(node.body) \|\| !isVoidPromise(node.body)) \|\|\n allBrancheshaveReturnValues(node.body, promFilter) \|\|\n /* @type {import('@typescript-eslint/types').TSESTree.BlockStatement} /\n (node.body).body.some((nde) => {\n return nde.type === 'ReturnStatement';\n });\n }\n\n case 'BlockStatement': {\n const lastBodyNode = node.body.slice(-1)[0];\n return allBrancheshaveReturnValues(lastBodyNode, promFilter);\n }\n\n case 'WhileStatement':\n case 'DoWhileStatement':\n if (\n /\n @type {import('@typescript-eslint/types').TSESTree.Literal}\n /\n (node.test).value === true\n ) {\n // If this is an infinite loop, we assume only one branch\n // is needed to provide a return\n return hasReturnValue(node.body, false, promFilter);\n }\n\n // Fallthrough\n case 'LabeledStatement':\n case 'ForStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n case 'WithStatement': {\n return allBrancheshaveReturnValues(node.body, promFilter);\n }\n\n case 'IfStatement': {\n return allBrancheshaveReturnValues(node.consequent, promFilter) &&\n allBrancheshaveReturnValues(node.alternate, promFilter);\n }\n\n case 'TryStatement': {\n // If `finally` returns, all return\n return node.finalizer && allBrancheshaveReturnValues(node.finalizer, promFilter) \|\|\n // Return in `try`/`catch` may still occur despite `finally`\n allBrancheshaveReturnValues(node.block, promFilter) &&\n (!node.handler \|\|\n allBrancheshaveReturnValues(node.handler && node.handler.body, promFilter)) &&\n (!node.finalizer \|\| (() => {\n try {\n hasReturnValue(node.finalizer, true, promFilter);\n } catch (error) {\n if (/* @type {Error} / (error).message === 'Null return') {\n return false;\n }\n / c8 ignore next 2 /\n throw error;\n }\n\n // As long as not an explicit empty return, then return true\n return true;\n })());\n }\n\n case 'SwitchStatement': {\n return /* @type {import('@typescript-eslint/types').TSESTree.SwitchStatement} / (node).cases.every(\n (someCase) => {\n return !someCase.consequent.some((consNode) => {\n return consNode.type === 'BreakStatement' \|\|\n consNode.type === 'ReturnStatement' && consNode.argument === null;\n });\n },\n );\n }\n\n case 'ThrowStatement': {\n return true;\n }\n\n case 'ReturnStatement': {\n // void return does not count.\n if (node.argument === null) {\n return false;\n }\n\n if (promFilter && isNewPromiseExpression(node.argument)) {\n // Let caller decide how to filter, but this is, at the least,\n // a return of sorts and truthy\n return promFilter(node.argument);\n }\n\n return true;\n }\n\n default: {\n return false;\n }\n }\n};\n\n/\n @callback PromiseFilter\n * @param {ESTreeOrTypeScriptNode\|undefined} node\n * @returns {boolean}\n /\n\n/\n Avoids further checking child nodes if a nested function shadows the\n * resolver, but otherwise, if name is used (by call or passed in as an\n * argument to another function), will be considered as non-empty.\n \n This could check for redeclaration of the resolver, but as such is\n * unlikely, we avoid the performance cost of checking everywhere for\n * (re)declarations or assignments.\n * @param {import('@typescript-eslint/types').TSESTree.Node\|null\|undefined} node\n * @param {string} resolverName\n * @returns {boolean}\n /\n// eslint-disable-next-line complexity\nconst hasNonEmptyResolverCall = (node, resolverName) => {\n if (!node) {\n return false;\n }\n\n // Arrow function without block\n switch (node.type) {\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'OptionalCallExpression':\n case 'CallExpression':\n return /* @type {import('@typescript-eslint/types').TSESTree.Identifier} / (\n node.callee\n ).name === resolverName && (\n\n // Implicit or explicit undefined\n node.arguments.length > 1 \|\| node.arguments[0] !== undefined\n ) \|\|\n node.arguments.some((nde) => {\n // Being passed in to another function (which might invoke it)\n return nde.type === 'Identifier' && nde.name === resolverName \|\|\n\n // Handle nested items\n hasNonEmptyResolverCall(nde, resolverName);\n });\n case 'ChainExpression':\n case 'Decorator':\n case 'ExpressionStatement':\n return hasNonEmptyResolverCall(node.expression, resolverName);\n case 'ClassBody':\n case 'BlockStatement':\n return node.body.some((bodyNode) => {\n return hasNonEmptyResolverCall(bodyNode, resolverName);\n });\n case 'FunctionExpression':\n case 'FunctionDeclaration':\n case 'ArrowFunctionExpression': {\n // Shadowing\n if (/* @type {import('@typescript-eslint/types').TSESTree.Identifier} / (\n node.params[0]\n )?.name === resolverName) {\n return false;\n }\n\n return hasNonEmptyResolverCall(node.body, resolverName);\n }\n\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'DoWhileStatement':\n case 'ForStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n case 'WithStatement': {\n return hasNonEmptyResolverCall(node.body, resolverName);\n }\n\n case 'ConditionalExpression':\n case 'IfStatement': {\n return hasNonEmptyResolverCall(node.test, resolverName) \|\|\n hasNonEmptyResolverCall(node.consequent, resolverName) \|\|\n hasNonEmptyResolverCall(node.alternate, resolverName);\n }\n\n case 'TryStatement': {\n return hasNonEmptyResolverCall(node.block, resolverName) \|\|\n hasNonEmptyResolverCall(node.handler && node.handler.body, resolverName) \|\|\n hasNonEmptyResolverCall(node.finalizer, resolverName);\n }\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n },\n );\n }\n\n case 'ArrayPattern':\n case 'ArrayExpression':\n return node.elements.some((element) => {\n return hasNonEmptyResolverCall(element, resolverName);\n });\n\n case 'AssignmentPattern':\n return hasNonEmptyResolverCall(node.right, resolverName);\n\n case 'AssignmentExpression':\n case 'BinaryExpression':\n case 'LogicalExpression': {\n return hasNonEmptyResolverCall(node.left, resolverName) \|\|\n hasNonEmptyResolverCall(node.right, resolverName);\n }\n\n // Comma\n case 'SequenceExpression':\n case 'TemplateLiteral':\n return node.expressions.some((subExpression) => {\n return hasNonEmptyResolverCall(subExpression, resolverName);\n });\n\n case 'ObjectPattern':\n case 'ObjectExpression':\n return node.properties.some((property) => {\n return hasNonEmptyResolverCall(property, resolverName);\n });\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'ClassMethod':\n case 'MethodDefinition':\n return node.decorators && node.decorators.some((decorator) => {\n return hasNonEmptyResolverCall(decorator, resolverName);\n }) \|\|\n node.computed && hasNonEmptyResolverCall(node.key, resolverName) \|\|\n hasNonEmptyResolverCall(node.value, resolverName);\n\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'ObjectProperty':\n / eslint-disable no-fallthrough /\n / c8 ignore next -- In Babel? /\n case 'PropertyDefinition':\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'ClassProperty':\n case 'Property':\n / eslint-enable no-fallthrough /\n return node.computed && hasNonEmptyResolverCall(node.key, resolverName) \|\|\n hasNonEmptyResolverCall(node.value, resolverName);\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'ObjectMethod':\n / c8 ignore next 6 -- In Babel? /\n // @ts-expect-error\n return node.computed && hasNonEmptyResolverCall(node.key, resolverName) \|\|\n // @ts-expect-error\n node.arguments.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n\n case 'ClassExpression':\n case 'ClassDeclaration':\n return hasNonEmptyResolverCall(node.body, resolverName);\n\n case 'AwaitExpression':\n case 'SpreadElement':\n case 'UnaryExpression':\n case 'YieldExpression':\n return hasNonEmptyResolverCall(node.argument, resolverName);\n\n case 'VariableDeclaration': {\n return node.declarations.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n }\n\n case 'VariableDeclarator': {\n return hasNonEmptyResolverCall(node.id, resolverName) \|\|\n hasNonEmptyResolverCall(node.init, resolverName);\n }\n\n case 'TaggedTemplateExpression':\n return hasNonEmptyResolverCall(node.quasi, resolverName);\n\n // ?.\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'OptionalMemberExpression':\n case 'MemberExpression':\n return hasNonEmptyResolverCall(node.object, resolverName) \|\|\n hasNonEmptyResolverCall(node.property, resolverName);\n\n / c8 ignore next 2 -- In Babel? /\n // @ts-expect-error Babel?\n case 'Import':\n case 'ImportExpression':\n return hasNonEmptyResolverCall(node.source, resolverName);\n\n case 'ReturnStatement': {\n if (node.argument === null) {\n return false;\n }\n\n return hasNonEmptyResolverCall(node.argument, resolverName);\n }\n\n /\n // Shouldn't need to parse literals/literal components, etc.\n\n case 'Identifier':\n case 'TemplateElement':\n case 'Super':\n // Exports not relevant in this context\n /\n default:\n return false;\n }\n};\n\n/\n Checks if a Promise executor has no resolve value or an empty value.\n * An `undefined` resolve does not count.\n * @param {ESTreeOrTypeScriptNode} node\n * @param {boolean} anyPromiseAsReturn\n * @param {boolean} [allBranches]\n * @returns {boolean}\n /\nconst hasValueOrExecutorHasNonEmptyResolveValue = (node, anyPromiseAsReturn, allBranches) => {\n const hasReturnMethod = allBranches ?\n /\n @param {ESTreeOrTypeScriptNode} nde\n * @param {PromiseFilter} promiseFilter\n * @returns {boolean}\n /\n (nde, promiseFilter) => {\n let hasReturn;\n try {\n hasReturn = hasReturnValue(nde, true, promiseFilter);\n } catch (error) {\n // c8 ignore else\n if (/* @type {Error} / (error).message === 'Null return') {\n return false;\n }\n / c8 ignore next 2 /\n throw error;\n }\n\n // `hasReturn` check needed since `throw` treated as valid return by\n // `allBrancheshaveReturnValues`\n return Boolean(hasReturn && allBrancheshaveReturnValues(nde, promiseFilter));\n } :\n /\n @param {ESTreeOrTypeScriptNode} nde\n * @param {PromiseFilter} promiseFilter\n * @returns {boolean}\n /\n (nde, promiseFilter) => {\n return Boolean(hasReturnValue(nde, false, promiseFilter));\n };\n\n return hasReturnMethod(node, (prom) => {\n if (anyPromiseAsReturn) {\n return true;\n }\n\n if (isVoidPromise(prom)) {\n return false;\n }\n\n const {\n params,\n body,\n } =\n /\n @type {import('@typescript-eslint/types').TSESTree.FunctionExpression\|\n * import('@typescript-eslint/types').TSESTree.ArrowFunctionExpression}\n / (\n /* @type {import('@typescript-eslint/types').TSESTree.NewExpression} / (\n prom\n ).arguments[0]\n ) \|\| {};\n\n if (!params?.length) {\n return false;\n }\n\n const {\n name: resolverName,\n } = /* @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n params[0]\n );\n\n return hasNonEmptyResolverCall(body, resolverName);\n });\n};\n\nexport {\n hasReturnValue,\n hasValueOrExecutorHasNonEmptyResolveValue,\n};\n"],"mappings":"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","ignoreList":[]}

package/package.json CHANGED Viewed

@@ -5,10 +5,10 @@
     "url": "http://gajus.com"
   },
   "dependencies": {
-    "@es-joy/jsdoccomment": "~0.46.0",
+    "@es-joy/jsdoccomment": "~0.48.0",
     "are-docs-informative": "^0.0.2",
     "comment-parser": "1.4.1",
-    "debug": "^4.3.5",
+    "debug": "^4.3.6",
     "escape-string-regexp": "^4.0.0",
     "espree": "^10.1.0",
     "esquery": "^1.6.0",
@@ -20,31 +20,31 @@
   "description": "JSDoc linting rules for ESLint.",
   "devDependencies": {
     "@babel/cli": "^7.24.8",
-    "@babel/core": "^7.24.9",
-    "@babel/eslint-parser": "^7.24.8",
-    "@babel/node": "^7.24.8",
+    "@babel/core": "^7.25.2",
+    "@babel/eslint-parser": "^7.25.1",
+    "@babel/node": "^7.25.0",
     "@babel/plugin-syntax-class-properties": "^7.12.13",
-    "@babel/plugin-transform-flow-strip-types": "^7.24.7",
-    "@babel/preset-env": "^7.24.8",
+    "@babel/plugin-transform-flow-strip-types": "^7.25.2",
+    "@babel/preset-env": "^7.25.3",
     "@es-joy/escodegen": "^3.5.1",
     "@es-joy/jsdoc-eslint-parser": "^0.21.1",
-    "@hkdobrev/run-if-changed": "^0.3.1",
+    "@hkdobrev/run-if-changed": "^0.6.0",
     "@semantic-release/commit-analyzer": "^13.0.0",
-    "@semantic-release/github": "^10.1.0",
+    "@semantic-release/github": "^10.1.4",
     "@semantic-release/npm": "^12.0.1",
-    "@types/chai": "^4.3.16",
+    "@types/chai": "^4.3.17",
     "@types/debug": "^4.1.12",
-    "@types/eslint": "^8.56.10",
+    "@types/eslint": "^9.6.0",
     "@types/espree": "^10.1.0",
     "@types/esquery": "^1.5.4",
     "@types/estree": "^1.0.5",
     "@types/json-schema": "^7.0.15",
     "@types/lodash.defaultsdeep": "^4.6.9",
     "@types/mocha": "^10.0.7",
-    "@types/node": "^20.14.11",
+    "@types/node": "^22.2.0",
     "@types/semver": "^7.5.8",
     "@types/spdx-expression-parse": "^3.0.5",
-    "@typescript-eslint/types": "^7.16.1",
+    "@typescript-eslint/types": "^8.1.0",
     "babel-plugin-add-module-exports": "^1.0.4",
     "babel-plugin-istanbul": "^7.0.0",
     "babel-plugin-transform-import-meta": "^2.2.1",
@@ -53,23 +53,23 @@
     "chai": "^5.1.1",
     "cross-env": "^7.0.3",
     "decamelize": "^6.0.0",
-    "eslint": "9.7.0",
-    "eslint-config-canonical": "~43.0.14",
+    "eslint": "9.9.0",
+    "eslint-config-canonical": "~43.0.15",
     "gitdown": "^4.1.1",
     "glob": "^10.4.2",
-    "globals": "^15.8.0",
-    "husky": "^9.1.1",
-    "jsdoc-type-pratt-parser": "^4.0.0",
+    "globals": "^15.9.0",
+    "husky": "^9.1.4",
+    "jsdoc-type-pratt-parser": "^4.1.0",
     "json-schema": "^0.4.0",
-    "lint-staged": "^15.2.7",
+    "lint-staged": "^15.2.9",
     "lodash.defaultsdeep": "^4.6.1",
-    "mocha": "^10.6.0",
+    "mocha": "^10.7.3",
     "open-editor": "^5.0.0",
     "replace": "^1.2.2",
     "rimraf": "^5.0.7",
     "semantic-release": "^24.0.0",
     "typescript": "5.5.x",
-    "typescript-eslint": "^8.0.0-alpha.34"
+    "typescript-eslint": "^8.1.0"
   },
   "engines": {
     "node": ">=18"
@@ -152,5 +152,5 @@
     "test-cov": "cross-env TIMING=1 c8 --reporter text npm run test-no-cov",
     "test-index": "npm run test-no-cov -- test/rules/index.js"
   },
-  "version": "50.0.0"
+  "version": "50.1.0"
 }

package/src/getJsdocProcessorPlugin.js CHANGED Viewed

@@ -86,7 +86,7 @@ const getLinesCols = (text) => {
  * @property {string} [exampleCodeRegex]
  * @property {string} [rejectExampleCodeRegex]
  * @property {"script"|"module"} [sourceType]
- * @property {import('eslint').Linter.FlatConfigParserModule} [parser]
+ * @property {import('eslint').Linter.ESTreeParser|import('eslint').Linter.NonESTreeParser} [parser]
  */
 /**
@@ -486,7 +486,7 @@ export const getJsdocProcessorPlugin = (options = {}) => {
             // May be running a second time so catch and ignore
             try {
               ast = parser
-                // @ts-expect-error Ok
+                // @ts-expect-error Should be present
                 ? parser.parseForESLint(text, {
                   ecmaVersion: 'latest',
                   sourceType,

package/src/rules/noBadBlocks.js CHANGED Viewed

@@ -31,6 +31,16 @@ export default iterateJsdoc(({
     allComments
   ).filter((comment) => {
     const commentText = sourceCode.getText(comment);
+    const initialText = commentText.replace(commentRegexp, '').trimStart();
+    if ([
+      'eslint'
+    ].some((directive) => {
+      return initialText.startsWith(directive);
+    })) {
+      return false;
+    }
     let sliceIndex = 2;
     if (!commentRegexp.test(commentText)) {
       const multiline = extraAsteriskCommentRegexp.exec(commentText)?.[0];

package/src/utils/hasReturnValue.js CHANGED Viewed

@@ -20,8 +20,11 @@ const isNewPromiseExpression = (node) => {
  */
 const isVoidPromise = (node) => {
   return /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (node)?.typeArguments?.params?.[0]?.type === 'TSVoidKeyword'
-    /* c8 ignore next */
-    || /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (node)?.typeParameters?.params?.[0]?.type === 'TSVoidKeyword';
+    /* c8 ignore next 4 */
+    || /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (
+      node
+    // @ts-expect-error Ok
+    )?.typeParameters?.params?.[0]?.type === 'TSVoidKeyword';
 };
 const undefinedKeywords = new Set([