eslint-plugin-jsdoc 52.0.4 → 53.0.0

package/dist/rules/requireReturns.cjs

@@ -1,209 +1,131 @@
-"use strict";
+const require_iterateJsdoc = require('../iterateJsdoc.cjs');
+const require_exportParser = require('../exportParser.cjs');
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-var _exportParser = _interopRequireDefault(require("../exportParser.cjs"));
-var _iterateJsdoc = _interopRequireDefault(require("../iterateJsdoc.cjs"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+//#region src/rules/requireReturns.js
 /**
- * We can skip checking for a return value, in case the documentation is inherited
- * or the method is either a constructor or an abstract method.
- *
- * In either of these cases the return value is optional or not defined.
- * @param {import('../iterateJsdoc.js').Utils} utils
- *   a reference to the utils which are used to probe if a tag is present or not.
- * @returns {boolean}
- *   true in case deep checking can be skipped; otherwise false.
- */
-const canSkip = utils => {
-  return utils.hasATag([
-  // inheritdoc implies that all documentation is inherited
-  // see https://jsdoc.app/tags-inheritdoc.html
-  //
-  // Abstract methods are by definition incomplete,
-  // so it is not an error if it declares a return value but does not implement it.
-  'abstract', 'virtual',
-  // Constructors do not have a return value by definition (https://jsdoc.app/tags-class.html)
-  // So we can bail out here, too.
-  'class', 'constructor',
-  // Return type is specified by type in @type
-  'type',
-  // This seems to imply a class as well
-  'interface']) || utils.avoidDocs();
+* We can skip checking for a return value, in case the documentation is inherited
+* or the method is either a constructor or an abstract method.
+*
+* In either of these cases the return value is optional or not defined.
+* @param {import('../iterateJsdoc.js').Utils} utils
+*   a reference to the utils which are used to probe if a tag is present or not.
+* @returns {boolean}
+*   true in case deep checking can be skipped; otherwise false.
+*/
+const canSkip = (utils) => {
+	return utils.hasATag([
+		"abstract",
+		"virtual",
+		"class",
+		"constructor",
+		"type",
+		"interface"
+	]) || utils.avoidDocs();
 };
-var _default = exports.default = (0, _iterateJsdoc.default)(({
-  context,
-  info: {
-    comment
-  },
-  node,
-  report,
-  settings,
-  utils
-}) => {
-  const {
-    contexts,
-    enableFixer = false,
-    forceRequireReturn = false,
-    forceReturnsWithAsync = false,
-    publicOnly = false
-  } = context.options[0] || {};
-
-  // A preflight check. We do not need to run a deep check
-  // in case the @returns comment is optional or undefined.
-  if (canSkip(utils)) {
-    return;
-  }
-
-  /** @type {boolean|undefined} */
-  let forceRequireReturnContext;
-  if (contexts) {
-    const {
-      foundContext
-    } = utils.findContext(contexts, comment);
-    if (typeof foundContext === 'object') {
-      forceRequireReturnContext = foundContext.forceRequireReturn;
-    }
-  }
-  const tagName = /** @type {string} */utils.getPreferredTagName({
-    tagName: 'returns'
-  });
-  if (!tagName) {
-    return;
-  }
-  const tags = utils.getTags(tagName);
-  if (tags.length > 1) {
-    report(`Found more than one @${tagName} declaration.`);
-  }
-  const iteratingFunction = utils.isIteratingFunction();
-
-  // In case the code returns something, we expect a return value in JSDoc.
-  const [tag] = tags;
-  const missingReturnTag = typeof tag === 'undefined' || tag === null;
-  const shouldReport = () => {
-    if (!missingReturnTag) {
-      return false;
-    }
-    if (publicOnly) {
-      /** @type {import('./requireJsdoc.js').RequireJsdocOpts} */
-      const opt = {
-        ancestorsOnly: Boolean(publicOnly?.ancestorsOnly ?? false),
-        esm: Boolean(publicOnly?.esm ?? true),
-        initModuleExports: Boolean(publicOnly?.cjs ?? true),
-        initWindow: Boolean(publicOnly?.window ?? false)
-      };
-      /* c8 ignore next -- Fallback to deprecated method */
-      const {
-        sourceCode = context.getSourceCode()
-      } = context;
-      const exported = _exportParser.default.isUncommentedExport(/** @type {import('eslint').Rule.Node} */node, sourceCode, opt, settings);
-      if (!exported) {
-        return false;
-      }
-    }
-    if ((forceRequireReturn || forceRequireReturnContext) && (iteratingFunction || utils.isVirtualFunction())) {
-      return true;
-    }
-    const isAsync = !iteratingFunction && utils.hasTag('async') || iteratingFunction && utils.isAsync();
-    if (forceReturnsWithAsync && isAsync) {
-      return true;
-    }
-    return iteratingFunction && utils.hasValueOrExecutorHasNonEmptyResolveValue(forceReturnsWithAsync);
-  };
-  if (shouldReport()) {
-    utils.reportJSDoc(`Missing JSDoc @${tagName} declaration.`, null, enableFixer ? () => {
-      utils.addTag(tagName);
-    } : null);
-  }
+var requireReturns_default = require_iterateJsdoc.default(({ context, info: { comment }, node, report, settings, utils }) => {
+	const { contexts, enableFixer = false, forceRequireReturn = false, forceReturnsWithAsync = false, publicOnly = false } = context.options[0] || {};
+	if (canSkip(utils)) return;
+	/** @type {boolean|undefined} */
+	let forceRequireReturnContext;
+	if (contexts) {
+		const { foundContext } = utils.findContext(contexts, comment);
+		if (typeof foundContext === "object") forceRequireReturnContext = foundContext.forceRequireReturn;
+	}
+	const tagName = utils.getPreferredTagName({ tagName: "returns" });
+	if (!tagName) return;
+	const tags = utils.getTags(tagName);
+	if (tags.length > 1) report(`Found more than one @${tagName} declaration.`);
+	const iteratingFunction = utils.isIteratingFunction();
+	const [tag] = tags;
+	const missingReturnTag = typeof tag === "undefined" || tag === null;
+	const shouldReport = () => {
+		if (!missingReturnTag) return false;
+		if (publicOnly) {
+			/** @type {import('./requireJsdoc.js').RequireJsdocOpts} */
+			const opt = {
+				ancestorsOnly: Boolean(publicOnly?.ancestorsOnly ?? false),
+				esm: Boolean(publicOnly?.esm ?? true),
+				initModuleExports: Boolean(publicOnly?.cjs ?? true),
+				initWindow: Boolean(publicOnly?.window ?? false)
+			};
+			/* c8 ignore next -- Fallback to deprecated method */
+			const { sourceCode = context.getSourceCode() } = context;
+			const exported = require_exportParser.default.isUncommentedExport(node, sourceCode, opt, settings);
+			if (!exported) return false;
+		}
+		if ((forceRequireReturn || forceRequireReturnContext) && (iteratingFunction || utils.isVirtualFunction())) return true;
+		const isAsync = !iteratingFunction && utils.hasTag("async") || iteratingFunction && utils.isAsync();
+		if (forceReturnsWithAsync && isAsync) return true;
+		return iteratingFunction && utils.hasValueOrExecutorHasNonEmptyResolveValue(forceReturnsWithAsync);
+	};
+	if (shouldReport()) utils.reportJSDoc(`Missing JSDoc @${tagName} declaration.`, null, enableFixer ? () => {
+		utils.addTag(tagName);
+	} : null);
 }, {
-  contextDefaults: true,
-  meta: {
-    docs: {
-      description: 'Requires that returns are documented.',
-      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns.md#repos-sticky-header'
-    },
-    fixable: 'code',
-    schema: [{
-      additionalProperties: false,
-      properties: {
-        checkConstructors: {
-          default: false,
-          type: 'boolean'
-        },
-        checkGetters: {
-          default: true,
-          type: 'boolean'
-        },
-        contexts: {
-          items: {
-            anyOf: [{
-              type: 'string'
-            }, {
-              additionalProperties: false,
-              properties: {
-                comment: {
-                  type: 'string'
-                },
-                context: {
-                  type: 'string'
-                },
-                forceRequireReturn: {
-                  type: 'boolean'
-                }
-              },
-              type: 'object'
-            }]
-          },
-          type: 'array'
-        },
-        enableFixer: {
-          type: 'boolean'
-        },
-        exemptedBy: {
-          items: {
-            type: 'string'
-          },
-          type: 'array'
-        },
-        forceRequireReturn: {
-          default: false,
-          type: 'boolean'
-        },
-        forceReturnsWithAsync: {
-          default: false,
-          type: 'boolean'
-        },
-        publicOnly: {
-          oneOf: [{
-            default: false,
-            type: 'boolean'
-          }, {
-            additionalProperties: false,
-            default: {},
-            properties: {
-              ancestorsOnly: {
-                type: 'boolean'
-              },
-              cjs: {
-                type: 'boolean'
-              },
-              esm: {
-                type: 'boolean'
-              },
-              window: {
-                type: 'boolean'
-              }
-            },
-            type: 'object'
-          }]
-        }
-      },
-      type: 'object'
-    }],
-    type: 'suggestion'
-  }
+	contextDefaults: true,
+	meta: {
+		docs: {
+			description: "Requires that returns are documented.",
+			url: "https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns.md#repos-sticky-header"
+		},
+		fixable: "code",
+		schema: [{
+			additionalProperties: false,
+			properties: {
+				checkConstructors: {
+					default: false,
+					type: "boolean"
+				},
+				checkGetters: {
+					default: true,
+					type: "boolean"
+				},
+				contexts: {
+					items: { anyOf: [{ type: "string" }, {
+						additionalProperties: false,
+						properties: {
+							comment: { type: "string" },
+							context: { type: "string" },
+							forceRequireReturn: { type: "boolean" }
+						},
+						type: "object"
+					}] },
+					type: "array"
+				},
+				enableFixer: { type: "boolean" },
+				exemptedBy: {
+					items: { type: "string" },
+					type: "array"
+				},
+				forceRequireReturn: {
+					default: false,
+					type: "boolean"
+				},
+				forceReturnsWithAsync: {
+					default: false,
+					type: "boolean"
+				},
+				publicOnly: { oneOf: [{
+					default: false,
+					type: "boolean"
+				}, {
+					additionalProperties: false,
+					default: {},
+					properties: {
+						ancestorsOnly: { type: "boolean" },
+						cjs: { type: "boolean" },
+						esm: { type: "boolean" },
+						window: { type: "boolean" }
+					},
+					type: "object"
+				}] }
+			},
+			type: "object"
+		}],
+		type: "suggestion"
+	}
 });
-module.exports = exports.default;
+
+//#endregion
+exports.default = requireReturns_default;
 //# sourceMappingURL=requireReturns.cjs.map

package/dist/rules/requireReturns.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"requireReturns.cjs","names":["_exportParser","_interopRequireDefault","require","_iterateJsdoc","e","__esModule","default","canSkip","utils","hasATag","avoidDocs","_default","exports","iterateJsdoc","context","info","comment","node","report","settings","contexts","enableFixer","forceRequireReturn","forceReturnsWithAsync","publicOnly","options","forceRequireReturnContext","foundContext","findContext","tagName","getPreferredTagName","tags","getTags","length","iteratingFunction","isIteratingFunction","tag","missingReturnTag","shouldReport","opt","ancestorsOnly","Boolean","esm","initModuleExports","cjs","initWindow","window","sourceCode","getSourceCode","exported","exportParser","isUncommentedExport","isVirtualFunction","isAsync","hasTag","hasValueOrExecutorHasNonEmptyResolveValue","reportJSDoc","addTag","contextDefaults","meta","docs","description","url","fixable","schema","additionalProperties","properties","checkConstructors","type","checkGetters","items","anyOf","exemptedBy","oneOf","module"],"sources":["../../src/rules/requireReturns.js"],"sourcesContent":["import exportParser from '../exportParser.js';\nimport iterateJsdoc from '../iterateJsdoc.js';\n\n/**\n * We can skip checking for a return value, in case the documentation is inherited\n * or the method is either a constructor or an abstract method.\n *\n * In either of these cases the return value is optional or not defined.\n * @param {import('../iterateJsdoc.js').Utils} utils\n *   a reference to the utils which are used to probe if a tag is present or not.\n * @returns {boolean}\n *   true in case deep checking can be skipped; otherwise false.\n */\nconst canSkip = (utils) => {\n  return utils.hasATag([\n    // inheritdoc implies that all documentation is inherited\n    // see https://jsdoc.app/tags-inheritdoc.html\n    //\n    // Abstract methods are by definition incomplete,\n    // so it is not an error if it declares a return value but does not implement it.\n    'abstract',\n    'virtual',\n\n    // Constructors do not have a return value by definition (https://jsdoc.app/tags-class.html)\n    // So we can bail out here, too.\n    'class',\n    'constructor',\n\n    // Return type is specified by type in @type\n    'type',\n\n    // This seems to imply a class as well\n    'interface',\n  ]) ||\n    utils.avoidDocs();\n};\n\nexport default iterateJsdoc(({\n  context,\n  info: {\n    comment,\n  },\n  node,\n  report,\n  settings,\n  utils,\n}) => {\n  const {\n    contexts,\n    enableFixer = false,\n    forceRequireReturn = false,\n    forceReturnsWithAsync = false,\n    publicOnly = false,\n  } = context.options[0] || {};\n\n  // A preflight check. We do not need to run a deep check\n  // in case the @returns comment is optional or undefined.\n  if (canSkip(utils)) {\n    return;\n  }\n\n  /** @type {boolean|undefined} */\n  let forceRequireReturnContext;\n  if (contexts) {\n    const {\n      foundContext,\n    } = utils.findContext(contexts, comment);\n    if (typeof foundContext === 'object') {\n      forceRequireReturnContext = foundContext.forceRequireReturn;\n    }\n  }\n\n  const tagName = /** @type {string} */ (utils.getPreferredTagName({\n    tagName: 'returns',\n  }));\n  if (!tagName) {\n    return;\n  }\n\n  const tags = utils.getTags(tagName);\n\n  if (tags.length > 1) {\n    report(`Found more than one @${tagName} declaration.`);\n  }\n\n  const iteratingFunction = utils.isIteratingFunction();\n\n  // In case the code returns something, we expect a return value in JSDoc.\n  const [\n    tag,\n  ] = tags;\n  const missingReturnTag = typeof tag === 'undefined' || tag === null;\n\n  const shouldReport = () => {\n    if (!missingReturnTag) {\n      return false;\n    }\n\n    if (publicOnly) {\n      /** @type {import('./requireJsdoc.js').RequireJsdocOpts} */\n      const opt = {\n        ancestorsOnly: Boolean(publicOnly?.ancestorsOnly ?? false),\n        esm: Boolean(publicOnly?.esm ?? true),\n        initModuleExports: Boolean(publicOnly?.cjs ?? true),\n        initWindow: Boolean(publicOnly?.window ?? false),\n      };\n      /* c8 ignore next -- Fallback to deprecated method */\n      const {\n        sourceCode = context.getSourceCode(),\n      } = context;\n      const exported = exportParser.isUncommentedExport(\n        /** @type {import('eslint').Rule.Node} */ (node), sourceCode, opt, settings,\n      );\n\n      if (!exported) {\n        return false;\n      }\n    }\n\n    if ((forceRequireReturn || forceRequireReturnContext) && (\n      iteratingFunction || utils.isVirtualFunction()\n    )) {\n      return true;\n    }\n\n    const isAsync = !iteratingFunction && utils.hasTag('async') ||\n      iteratingFunction && utils.isAsync();\n\n    if (forceReturnsWithAsync && isAsync) {\n      return true;\n    }\n\n    return iteratingFunction && utils.hasValueOrExecutorHasNonEmptyResolveValue(\n      forceReturnsWithAsync,\n    );\n  };\n\n  if (shouldReport()) {\n    utils.reportJSDoc(`Missing JSDoc @${tagName} declaration.`, null, enableFixer ? () => {\n      utils.addTag(tagName);\n    } : null);\n  }\n}, {\n  contextDefaults: true,\n  meta: {\n    docs: {\n      description: 'Requires that returns are documented.',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns.md#repos-sticky-header',\n    },\n    fixable: 'code',\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          checkConstructors: {\n            default: false,\n            type: 'boolean',\n          },\n          checkGetters: {\n            default: true,\n            type: 'boolean',\n          },\n          contexts: {\n            items: {\n              anyOf: [\n                {\n                  type: 'string',\n                },\n                {\n                  additionalProperties: false,\n                  properties: {\n                    comment: {\n                      type: 'string',\n                    },\n                    context: {\n                      type: 'string',\n                    },\n                    forceRequireReturn: {\n                      type: 'boolean',\n                    },\n                  },\n                  type: 'object',\n                },\n              ],\n            },\n            type: 'array',\n          },\n          enableFixer: {\n            type: 'boolean',\n          },\n          exemptedBy: {\n            items: {\n              type: 'string',\n            },\n            type: 'array',\n          },\n          forceRequireReturn: {\n            default: false,\n            type: 'boolean',\n          },\n          forceReturnsWithAsync: {\n            default: false,\n            type: 'boolean',\n          },\n          publicOnly: {\n            oneOf: [\n              {\n                default: false,\n                type: 'boolean',\n              },\n              {\n                additionalProperties: false,\n                default: {},\n                properties: {\n                  ancestorsOnly: {\n                    type: 'boolean',\n                  },\n                  cjs: {\n                    type: 'boolean',\n                  },\n                  esm: {\n                    type: 'boolean',\n                  },\n                  window: {\n                    type: 'boolean',\n                  },\n                },\n                type: 'object',\n              },\n            ],\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"requireReturns.cjs","names":["iterateJsdoc","exportParser"],"sources":["../../src/rules/requireReturns.js"],"sourcesContent":["import exportParser from '../exportParser.js';\nimport iterateJsdoc from '../iterateJsdoc.js';\n\n/**\n * We can skip checking for a return value, in case the documentation is inherited\n * or the method is either a constructor or an abstract method.\n *\n * In either of these cases the return value is optional or not defined.\n * @param {import('../iterateJsdoc.js').Utils} utils\n *   a reference to the utils which are used to probe if a tag is present or not.\n * @returns {boolean}\n *   true in case deep checking can be skipped; otherwise false.\n */\nconst canSkip = (utils) => {\n  return utils.hasATag([\n    // inheritdoc implies that all documentation is inherited\n    // see https://jsdoc.app/tags-inheritdoc.html\n    //\n    // Abstract methods are by definition incomplete,\n    // so it is not an error if it declares a return value but does not implement it.\n    'abstract',\n    'virtual',\n\n    // Constructors do not have a return value by definition (https://jsdoc.app/tags-class.html)\n    // So we can bail out here, too.\n    'class',\n    'constructor',\n\n    // Return type is specified by type in @type\n    'type',\n\n    // This seems to imply a class as well\n    'interface',\n  ]) ||\n    utils.avoidDocs();\n};\n\nexport default iterateJsdoc(({\n  context,\n  info: {\n    comment,\n  },\n  node,\n  report,\n  settings,\n  utils,\n}) => {\n  const {\n    contexts,\n    enableFixer = false,\n    forceRequireReturn = false,\n    forceReturnsWithAsync = false,\n    publicOnly = false,\n  } = context.options[0] || {};\n\n  // A preflight check. We do not need to run a deep check\n  // in case the @returns comment is optional or undefined.\n  if (canSkip(utils)) {\n    return;\n  }\n\n  /** @type {boolean|undefined} */\n  let forceRequireReturnContext;\n  if (contexts) {\n    const {\n      foundContext,\n    } = utils.findContext(contexts, comment);\n    if (typeof foundContext === 'object') {\n      forceRequireReturnContext = foundContext.forceRequireReturn;\n    }\n  }\n\n  const tagName = /** @type {string} */ (utils.getPreferredTagName({\n    tagName: 'returns',\n  }));\n  if (!tagName) {\n    return;\n  }\n\n  const tags = utils.getTags(tagName);\n\n  if (tags.length > 1) {\n    report(`Found more than one @${tagName} declaration.`);\n  }\n\n  const iteratingFunction = utils.isIteratingFunction();\n\n  // In case the code returns something, we expect a return value in JSDoc.\n  const [\n    tag,\n  ] = tags;\n  const missingReturnTag = typeof tag === 'undefined' || tag === null;\n\n  const shouldReport = () => {\n    if (!missingReturnTag) {\n      return false;\n    }\n\n    if (publicOnly) {\n      /** @type {import('./requireJsdoc.js').RequireJsdocOpts} */\n      const opt = {\n        ancestorsOnly: Boolean(publicOnly?.ancestorsOnly ?? false),\n        esm: Boolean(publicOnly?.esm ?? true),\n        initModuleExports: Boolean(publicOnly?.cjs ?? true),\n        initWindow: Boolean(publicOnly?.window ?? false),\n      };\n      /* c8 ignore next -- Fallback to deprecated method */\n      const {\n        sourceCode = context.getSourceCode(),\n      } = context;\n      const exported = exportParser.isUncommentedExport(\n        /** @type {import('eslint').Rule.Node} */ (node), sourceCode, opt, settings,\n      );\n\n      if (!exported) {\n        return false;\n      }\n    }\n\n    if ((forceRequireReturn || forceRequireReturnContext) && (\n      iteratingFunction || utils.isVirtualFunction()\n    )) {\n      return true;\n    }\n\n    const isAsync = !iteratingFunction && utils.hasTag('async') ||\n      iteratingFunction && utils.isAsync();\n\n    if (forceReturnsWithAsync && isAsync) {\n      return true;\n    }\n\n    return iteratingFunction && utils.hasValueOrExecutorHasNonEmptyResolveValue(\n      forceReturnsWithAsync,\n    );\n  };\n\n  if (shouldReport()) {\n    utils.reportJSDoc(`Missing JSDoc @${tagName} declaration.`, null, enableFixer ? () => {\n      utils.addTag(tagName);\n    } : null);\n  }\n}, {\n  contextDefaults: true,\n  meta: {\n    docs: {\n      description: 'Requires that returns are documented.',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns.md#repos-sticky-header',\n    },\n    fixable: 'code',\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          checkConstructors: {\n            default: false,\n            type: 'boolean',\n          },\n          checkGetters: {\n            default: true,\n            type: 'boolean',\n          },\n          contexts: {\n            items: {\n              anyOf: [\n                {\n                  type: 'string',\n                },\n                {\n                  additionalProperties: false,\n                  properties: {\n                    comment: {\n                      type: 'string',\n                    },\n                    context: {\n                      type: 'string',\n                    },\n                    forceRequireReturn: {\n                      type: 'boolean',\n                    },\n                  },\n                  type: 'object',\n                },\n              ],\n            },\n            type: 'array',\n          },\n          enableFixer: {\n            type: 'boolean',\n          },\n          exemptedBy: {\n            items: {\n              type: 'string',\n            },\n            type: 'array',\n          },\n          forceRequireReturn: {\n            default: false,\n            type: 'boolean',\n          },\n          forceReturnsWithAsync: {\n            default: false,\n            type: 'boolean',\n          },\n          publicOnly: {\n            oneOf: [\n              {\n                default: false,\n                type: 'boolean',\n              },\n              {\n                additionalProperties: false,\n                default: {},\n                properties: {\n                  ancestorsOnly: {\n                    type: 'boolean',\n                  },\n                  cjs: {\n                    type: 'boolean',\n                  },\n                  esm: {\n                    type: 'boolean',\n                  },\n                  window: {\n                    type: 'boolean',\n                  },\n                },\n                type: 'object',\n              },\n            ],\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAM,UAAU,CAAC,UAAU;AACzB,QAAO,MAAM,QAAQ;EAMnB;EACA;EAIA;EACA;EAGA;EAGA;CACD,EAAC,IACA,MAAM,WAAW;AACpB;AAED,6BAAeA,6BAAa,CAAC,EAC3B,SACA,MAAM,EACJ,SACD,EACD,MACA,QACA,UACA,OACD,KAAK;CACJ,MAAM,EACJ,UACA,cAAc,OACd,qBAAqB,OACrB,wBAAwB,OACxB,aAAa,OACd,GAAG,QAAQ,QAAQ,MAAM,CAAE;AAI5B,KAAI,QAAQ,MAAM,CAChB;;CAIF,IAAI;AACJ,KAAI,UAAU;EACZ,MAAM,EACJ,cACD,GAAG,MAAM,YAAY,UAAU,QAAQ;AACxC,MAAI,OAAO,iBAAiB,UAC1B,4BAA4B,aAAa;CAE5C;CAED,MAAM,UAAiC,MAAM,oBAAoB,EAC/D,SAAS,UACV,EAAC;AACF,KAAI,CAAC,QACH;CAGF,MAAM,OAAO,MAAM,QAAQ,QAAQ;AAEnC,KAAI,KAAK,SAAS,GAChB,OAAO,CAAC,qBAAqB,EAAE,QAAQ,aAAa,CAAC,CAAC;CAGxD,MAAM,oBAAoB,MAAM,qBAAqB;CAGrD,MAAM,CACJ,IACD,GAAG;CACJ,MAAM,mBAAmB,OAAO,QAAQ,eAAe,QAAQ;CAE/D,MAAM,eAAe,MAAM;AACzB,MAAI,CAAC,iBACH,QAAO;AAGT,MAAI,YAAY;;GAEd,MAAM,MAAM;IACV,eAAe,QAAQ,YAAY,iBAAiB,MAAM;IAC1D,KAAK,QAAQ,YAAY,OAAO,KAAK;IACrC,mBAAmB,QAAQ,YAAY,OAAO,KAAK;IACnD,YAAY,QAAQ,YAAY,UAAU,MAAM;GACjD;;GAED,MAAM,EACJ,aAAa,QAAQ,eAAe,EACrC,GAAG;GACJ,MAAM,WAAWC,6BAAa,oBACe,MAAO,YAAY,KAAK,SACpE;AAED,OAAI,CAAC,SACH,QAAO;EAEV;AAED,OAAK,sBAAsB,+BACzB,qBAAqB,MAAM,mBAAmB,EAE9C,QAAO;EAGT,MAAM,UAAU,CAAC,qBAAqB,MAAM,OAAO,QAAQ,IACzD,qBAAqB,MAAM,SAAS;AAEtC,MAAI,yBAAyB,QAC3B,QAAO;AAGT,SAAO,qBAAqB,MAAM,0CAChC,sBACD;CACF;AAED,KAAI,cAAc,EAChB,MAAM,YAAY,CAAC,eAAe,EAAE,QAAQ,aAAa,CAAC,EAAE,MAAM,cAAc,MAAM;EACpF,MAAM,OAAO,QAAQ;CACtB,IAAG,KAAK;AAEZ,GAAE;CACD,iBAAiB;CACjB,MAAM;EACJ,MAAM;GACJ,aAAa;GACb,KAAK;EACN;EACD,SAAS;EACT,QAAQ,CACN;GACE,sBAAsB;GACtB,YAAY;IACV,mBAAmB;KACjB,SAAS;KACT,MAAM;IACP;IACD,cAAc;KACZ,SAAS;KACT,MAAM;IACP;IACD,UAAU;KACR,OAAO,EACL,OAAO,CACL,EACE,MAAM,SACP,GACD;MACE,sBAAsB;MACtB,YAAY;OACV,SAAS,EACP,MAAM,SACP;OACD,SAAS,EACP,MAAM,SACP;OACD,oBAAoB,EAClB,MAAM,UACP;MACF;MACD,MAAM;KACP,CACF,EACF;KACD,MAAM;IACP;IACD,aAAa,EACX,MAAM,UACP;IACD,YAAY;KACV,OAAO,EACL,MAAM,SACP;KACD,MAAM;IACP;IACD,oBAAoB;KAClB,SAAS;KACT,MAAM;IACP;IACD,uBAAuB;KACrB,SAAS;KACT,MAAM;IACP;IACD,YAAY,EACV,OAAO,CACL;KACE,SAAS;KACT,MAAM;IACP,GACD;KACE,sBAAsB;KACtB,SAAS,CAAE;KACX,YAAY;MACV,eAAe,EACb,MAAM,UACP;MACD,KAAK,EACH,MAAM,UACP;MACD,KAAK,EACH,MAAM,UACP;MACD,QAAQ,EACN,MAAM,UACP;KACF;KACD,MAAM;IACP,CACF,EACF;GACF;GACD,MAAM;EACP,CACF;EACD,MAAM;CACP;AACF,EAAC"}

package/dist/rules/requireReturns.js

@@ -0,0 +1,131 @@
+import iterateJsdoc from "../iterateJsdoc.js";
+import exportParser_default from "../exportParser.js";
+
+//#region src/rules/requireReturns.js
+/**
+* We can skip checking for a return value, in case the documentation is inherited
+* or the method is either a constructor or an abstract method.
+*
+* In either of these cases the return value is optional or not defined.
+* @param {import('../iterateJsdoc.js').Utils} utils
+*   a reference to the utils which are used to probe if a tag is present or not.
+* @returns {boolean}
+*   true in case deep checking can be skipped; otherwise false.
+*/
+const canSkip = (utils) => {
+	return utils.hasATag([
+		"abstract",
+		"virtual",
+		"class",
+		"constructor",
+		"type",
+		"interface"
+	]) || utils.avoidDocs();
+};
+var requireReturns_default = iterateJsdoc(({ context, info: { comment }, node, report, settings, utils }) => {
+	const { contexts, enableFixer = false, forceRequireReturn = false, forceReturnsWithAsync = false, publicOnly = false } = context.options[0] || {};
+	if (canSkip(utils)) return;
+	/** @type {boolean|undefined} */
+	let forceRequireReturnContext;
+	if (contexts) {
+		const { foundContext } = utils.findContext(contexts, comment);
+		if (typeof foundContext === "object") forceRequireReturnContext = foundContext.forceRequireReturn;
+	}
+	const tagName = utils.getPreferredTagName({ tagName: "returns" });
+	if (!tagName) return;
+	const tags = utils.getTags(tagName);
+	if (tags.length > 1) report(`Found more than one @${tagName} declaration.`);
+	const iteratingFunction = utils.isIteratingFunction();
+	const [tag] = tags;
+	const missingReturnTag = typeof tag === "undefined" || tag === null;
+	const shouldReport = () => {
+		if (!missingReturnTag) return false;
+		if (publicOnly) {
+			/** @type {import('./requireJsdoc.js').RequireJsdocOpts} */
+			const opt = {
+				ancestorsOnly: Boolean(publicOnly?.ancestorsOnly ?? false),
+				esm: Boolean(publicOnly?.esm ?? true),
+				initModuleExports: Boolean(publicOnly?.cjs ?? true),
+				initWindow: Boolean(publicOnly?.window ?? false)
+			};
+			/* c8 ignore next -- Fallback to deprecated method */
+			const { sourceCode = context.getSourceCode() } = context;
+			const exported = exportParser_default.isUncommentedExport(node, sourceCode, opt, settings);
+			if (!exported) return false;
+		}
+		if ((forceRequireReturn || forceRequireReturnContext) && (iteratingFunction || utils.isVirtualFunction())) return true;
+		const isAsync = !iteratingFunction && utils.hasTag("async") || iteratingFunction && utils.isAsync();
+		if (forceReturnsWithAsync && isAsync) return true;
+		return iteratingFunction && utils.hasValueOrExecutorHasNonEmptyResolveValue(forceReturnsWithAsync);
+	};
+	if (shouldReport()) utils.reportJSDoc(`Missing JSDoc @${tagName} declaration.`, null, enableFixer ? () => {
+		utils.addTag(tagName);
+	} : null);
+}, {
+	contextDefaults: true,
+	meta: {
+		docs: {
+			description: "Requires that returns are documented.",
+			url: "https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns.md#repos-sticky-header"
+		},
+		fixable: "code",
+		schema: [{
+			additionalProperties: false,
+			properties: {
+				checkConstructors: {
+					default: false,
+					type: "boolean"
+				},
+				checkGetters: {
+					default: true,
+					type: "boolean"
+				},
+				contexts: {
+					items: { anyOf: [{ type: "string" }, {
+						additionalProperties: false,
+						properties: {
+							comment: { type: "string" },
+							context: { type: "string" },
+							forceRequireReturn: { type: "boolean" }
+						},
+						type: "object"
+					}] },
+					type: "array"
+				},
+				enableFixer: { type: "boolean" },
+				exemptedBy: {
+					items: { type: "string" },
+					type: "array"
+				},
+				forceRequireReturn: {
+					default: false,
+					type: "boolean"
+				},
+				forceReturnsWithAsync: {
+					default: false,
+					type: "boolean"
+				},
+				publicOnly: { oneOf: [{
+					default: false,
+					type: "boolean"
+				}, {
+					additionalProperties: false,
+					default: {},
+					properties: {
+						ancestorsOnly: { type: "boolean" },
+						cjs: { type: "boolean" },
+						esm: { type: "boolean" },
+						window: { type: "boolean" }
+					},
+					type: "object"
+				}] }
+			},
+			type: "object"
+		}],
+		type: "suggestion"
+	}
+});
+
+//#endregion
+export { requireReturns_default as default };
+//# sourceMappingURL=requireReturns.js.map

package/dist/rules/requireReturns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requireReturns.js","names":["exportParser"],"sources":["../../src/rules/requireReturns.js"],"sourcesContent":["import exportParser from '../exportParser.js';\nimport iterateJsdoc from '../iterateJsdoc.js';\n\n/**\n * We can skip checking for a return value, in case the documentation is inherited\n * or the method is either a constructor or an abstract method.\n *\n * In either of these cases the return value is optional or not defined.\n * @param {import('../iterateJsdoc.js').Utils} utils\n *   a reference to the utils which are used to probe if a tag is present or not.\n * @returns {boolean}\n *   true in case deep checking can be skipped; otherwise false.\n */\nconst canSkip = (utils) => {\n  return utils.hasATag([\n    // inheritdoc implies that all documentation is inherited\n    // see https://jsdoc.app/tags-inheritdoc.html\n    //\n    // Abstract methods are by definition incomplete,\n    // so it is not an error if it declares a return value but does not implement it.\n    'abstract',\n    'virtual',\n\n    // Constructors do not have a return value by definition (https://jsdoc.app/tags-class.html)\n    // So we can bail out here, too.\n    'class',\n    'constructor',\n\n    // Return type is specified by type in @type\n    'type',\n\n    // This seems to imply a class as well\n    'interface',\n  ]) ||\n    utils.avoidDocs();\n};\n\nexport default iterateJsdoc(({\n  context,\n  info: {\n    comment,\n  },\n  node,\n  report,\n  settings,\n  utils,\n}) => {\n  const {\n    contexts,\n    enableFixer = false,\n    forceRequireReturn = false,\n    forceReturnsWithAsync = false,\n    publicOnly = false,\n  } = context.options[0] || {};\n\n  // A preflight check. We do not need to run a deep check\n  // in case the @returns comment is optional or undefined.\n  if (canSkip(utils)) {\n    return;\n  }\n\n  /** @type {boolean|undefined} */\n  let forceRequireReturnContext;\n  if (contexts) {\n    const {\n      foundContext,\n    } = utils.findContext(contexts, comment);\n    if (typeof foundContext === 'object') {\n      forceRequireReturnContext = foundContext.forceRequireReturn;\n    }\n  }\n\n  const tagName = /** @type {string} */ (utils.getPreferredTagName({\n    tagName: 'returns',\n  }));\n  if (!tagName) {\n    return;\n  }\n\n  const tags = utils.getTags(tagName);\n\n  if (tags.length > 1) {\n    report(`Found more than one @${tagName} declaration.`);\n  }\n\n  const iteratingFunction = utils.isIteratingFunction();\n\n  // In case the code returns something, we expect a return value in JSDoc.\n  const [\n    tag,\n  ] = tags;\n  const missingReturnTag = typeof tag === 'undefined' || tag === null;\n\n  const shouldReport = () => {\n    if (!missingReturnTag) {\n      return false;\n    }\n\n    if (publicOnly) {\n      /** @type {import('./requireJsdoc.js').RequireJsdocOpts} */\n      const opt = {\n        ancestorsOnly: Boolean(publicOnly?.ancestorsOnly ?? false),\n        esm: Boolean(publicOnly?.esm ?? true),\n        initModuleExports: Boolean(publicOnly?.cjs ?? true),\n        initWindow: Boolean(publicOnly?.window ?? false),\n      };\n      /* c8 ignore next -- Fallback to deprecated method */\n      const {\n        sourceCode = context.getSourceCode(),\n      } = context;\n      const exported = exportParser.isUncommentedExport(\n        /** @type {import('eslint').Rule.Node} */ (node), sourceCode, opt, settings,\n      );\n\n      if (!exported) {\n        return false;\n      }\n    }\n\n    if ((forceRequireReturn || forceRequireReturnContext) && (\n      iteratingFunction || utils.isVirtualFunction()\n    )) {\n      return true;\n    }\n\n    const isAsync = !iteratingFunction && utils.hasTag('async') ||\n      iteratingFunction && utils.isAsync();\n\n    if (forceReturnsWithAsync && isAsync) {\n      return true;\n    }\n\n    return iteratingFunction && utils.hasValueOrExecutorHasNonEmptyResolveValue(\n      forceReturnsWithAsync,\n    );\n  };\n\n  if (shouldReport()) {\n    utils.reportJSDoc(`Missing JSDoc @${tagName} declaration.`, null, enableFixer ? () => {\n      utils.addTag(tagName);\n    } : null);\n  }\n}, {\n  contextDefaults: true,\n  meta: {\n    docs: {\n      description: 'Requires that returns are documented.',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns.md#repos-sticky-header',\n    },\n    fixable: 'code',\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          checkConstructors: {\n            default: false,\n            type: 'boolean',\n          },\n          checkGetters: {\n            default: true,\n            type: 'boolean',\n          },\n          contexts: {\n            items: {\n              anyOf: [\n                {\n                  type: 'string',\n                },\n                {\n                  additionalProperties: false,\n                  properties: {\n                    comment: {\n                      type: 'string',\n                    },\n                    context: {\n                      type: 'string',\n                    },\n                    forceRequireReturn: {\n                      type: 'boolean',\n                    },\n                  },\n                  type: 'object',\n                },\n              ],\n            },\n            type: 'array',\n          },\n          enableFixer: {\n            type: 'boolean',\n          },\n          exemptedBy: {\n            items: {\n              type: 'string',\n            },\n            type: 'array',\n          },\n          forceRequireReturn: {\n            default: false,\n            type: 'boolean',\n          },\n          forceReturnsWithAsync: {\n            default: false,\n            type: 'boolean',\n          },\n          publicOnly: {\n            oneOf: [\n              {\n                default: false,\n                type: 'boolean',\n              },\n              {\n                additionalProperties: false,\n                default: {},\n                properties: {\n                  ancestorsOnly: {\n                    type: 'boolean',\n                  },\n                  cjs: {\n                    type: 'boolean',\n                  },\n                  esm: {\n                    type: 'boolean',\n                  },\n                  window: {\n                    type: 'boolean',\n                  },\n                },\n                type: 'object',\n              },\n            ],\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAM,UAAU,CAAC,UAAU;AACzB,QAAO,MAAM,QAAQ;EAMnB;EACA;EAIA;EACA;EAGA;EAGA;CACD,EAAC,IACA,MAAM,WAAW;AACpB;AAED,6BAAe,aAAa,CAAC,EAC3B,SACA,MAAM,EACJ,SACD,EACD,MACA,QACA,UACA,OACD,KAAK;CACJ,MAAM,EACJ,UACA,cAAc,OACd,qBAAqB,OACrB,wBAAwB,OACxB,aAAa,OACd,GAAG,QAAQ,QAAQ,MAAM,CAAE;AAI5B,KAAI,QAAQ,MAAM,CAChB;;CAIF,IAAI;AACJ,KAAI,UAAU;EACZ,MAAM,EACJ,cACD,GAAG,MAAM,YAAY,UAAU,QAAQ;AACxC,MAAI,OAAO,iBAAiB,UAC1B,4BAA4B,aAAa;CAE5C;CAED,MAAM,UAAiC,MAAM,oBAAoB,EAC/D,SAAS,UACV,EAAC;AACF,KAAI,CAAC,QACH;CAGF,MAAM,OAAO,MAAM,QAAQ,QAAQ;AAEnC,KAAI,KAAK,SAAS,GAChB,OAAO,CAAC,qBAAqB,EAAE,QAAQ,aAAa,CAAC,CAAC;CAGxD,MAAM,oBAAoB,MAAM,qBAAqB;CAGrD,MAAM,CACJ,IACD,GAAG;CACJ,MAAM,mBAAmB,OAAO,QAAQ,eAAe,QAAQ;CAE/D,MAAM,eAAe,MAAM;AACzB,MAAI,CAAC,iBACH,QAAO;AAGT,MAAI,YAAY;;GAEd,MAAM,MAAM;IACV,eAAe,QAAQ,YAAY,iBAAiB,MAAM;IAC1D,KAAK,QAAQ,YAAY,OAAO,KAAK;IACrC,mBAAmB,QAAQ,YAAY,OAAO,KAAK;IACnD,YAAY,QAAQ,YAAY,UAAU,MAAM;GACjD;;GAED,MAAM,EACJ,aAAa,QAAQ,eAAe,EACrC,GAAG;GACJ,MAAM,WAAWA,qBAAa,oBACe,MAAO,YAAY,KAAK,SACpE;AAED,OAAI,CAAC,SACH,QAAO;EAEV;AAED,OAAK,sBAAsB,+BACzB,qBAAqB,MAAM,mBAAmB,EAE9C,QAAO;EAGT,MAAM,UAAU,CAAC,qBAAqB,MAAM,OAAO,QAAQ,IACzD,qBAAqB,MAAM,SAAS;AAEtC,MAAI,yBAAyB,QAC3B,QAAO;AAGT,SAAO,qBAAqB,MAAM,0CAChC,sBACD;CACF;AAED,KAAI,cAAc,EAChB,MAAM,YAAY,CAAC,eAAe,EAAE,QAAQ,aAAa,CAAC,EAAE,MAAM,cAAc,MAAM;EACpF,MAAM,OAAO,QAAQ;CACtB,IAAG,KAAK;AAEZ,GAAE;CACD,iBAAiB;CACjB,MAAM;EACJ,MAAM;GACJ,aAAa;GACb,KAAK;EACN;EACD,SAAS;EACT,QAAQ,CACN;GACE,sBAAsB;GACtB,YAAY;IACV,mBAAmB;KACjB,SAAS;KACT,MAAM;IACP;IACD,cAAc;KACZ,SAAS;KACT,MAAM;IACP;IACD,UAAU;KACR,OAAO,EACL,OAAO,CACL,EACE,MAAM,SACP,GACD;MACE,sBAAsB;MACtB,YAAY;OACV,SAAS,EACP,MAAM,SACP;OACD,SAAS,EACP,MAAM,SACP;OACD,oBAAoB,EAClB,MAAM,UACP;MACF;MACD,MAAM;KACP,CACF,EACF;KACD,MAAM;IACP;IACD,aAAa,EACX,MAAM,UACP;IACD,YAAY;KACV,OAAO,EACL,MAAM,SACP;KACD,MAAM;IACP;IACD,oBAAoB;KAClB,SAAS;KACT,MAAM;IACP;IACD,uBAAuB;KACrB,SAAS;KACT,MAAM;IACP;IACD,YAAY,EACV,OAAO,CACL;KACE,SAAS;KACT,MAAM;IACP,GACD;KACE,sBAAsB;KACtB,SAAS,CAAE;KACX,YAAY;MACV,eAAe,EACb,MAAM,UACP;MACD,KAAK,EACH,MAAM,UACP;MACD,KAAK,EACH,MAAM,UACP;MACD,QAAQ,EACN,MAAM,UACP;KACF;KACD,MAAM;IACP,CACF,EACF;GACF;GACD,MAAM;EACP,CACF;EACD,MAAM;CACP;AACF,EAAC"}