"use strict"; Object.defineProperty(exports, "__esModule", { value: true }); exports.default = void 0; var _lodash = _interopRequireDefault(require("lodash")); var _iterateJsdoc = _interopRequireDefault(require("../iterateJsdoc")); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } var _default = (0, _iterateJsdoc.default)(({ jsdoc, report, utils, context }) => { if (utils.avoidDocs()) { return; } const { descriptionStyle = 'body' } = context.options[0] || {}; let targetTagName = utils.getPreferredTagName({ // We skip reporting except when `@description` is essential to the rule, // so user can block the tag and still meaningfully use this rule // even if the tag is present (and `check-tag-names` is the one to // normally report the fact that it is blocked but present) skipReportingBlockedTag: descriptionStyle !== 'tag', tagName: 'description' }); if (!targetTagName) { return; } const isBlocked = typeof targetTagName === 'object' && targetTagName.blocked; if (isBlocked) { targetTagName = targetTagName.tagName; } const checkDescription = description => { const exampleContent = _lodash.default.compact(description.trim().split('\n')); return exampleContent.length; }; if (descriptionStyle !== 'tag') { const { description } = utils.getDescription(); if (checkDescription(description || '')) { return; } if (descriptionStyle === 'body') { const descTags = utils.getPresentTags(['desc', 'description']); if (descTags.length) { const [{ tag: tagName }] = descTags; report(`Remove the @${tagName} tag to leave a plain block description or add additional description text above the @${tagName} line.`); } else { report('Missing JSDoc block description.'); } return; } } const functionExamples = isBlocked ? [] : _lodash.default.filter(jsdoc.tags, { tag: targetTagName }); if (!functionExamples.length) { report(descriptionStyle === 'any' ? `Missing JSDoc block description or @${targetTagName} declaration.` : `Missing JSDoc @${targetTagName} declaration.`); return; } functionExamples.forEach(example => { if (!checkDescription(`${example.name} ${utils.getTagDescription(example)}`)) { report(`Missing JSDoc @${targetTagName} description.`, null, example); } }); }, { contextDefaults: true, meta: { docs: { description: 'Requires that all functions have a description.', url: 'https://github.com/gajus/eslint-plugin-jsdoc#eslint-plugin-jsdoc-rules-require-description' }, schema: [{ additionalProperties: false, properties: { checkConstructors: { default: true, type: 'boolean' }, checkGetters: { default: true, type: 'boolean' }, checkSetters: { default: true, type: 'boolean' }, contexts: { items: { anyOf: [{ type: 'string' }, { additionalProperties: false, properties: { comment: { type: 'string' }, context: { type: 'string' } }, type: 'object' }] }, type: 'array' }, descriptionStyle: { enum: ['body', 'tag', 'any'], type: 'string' }, exemptedBy: { items: { type: 'string' }, type: 'array' } }, type: 'object' }], type: 'suggestion' } }); exports.default = _default; module.exports = exports.default; //# sourceMappingURL=requireDescription.js.map