/
descriptionlessDisables.js
62 lines (48 loc) · 1.99 KB
/
descriptionlessDisables.js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
'use strict';
const optionsMatches = require('./utils/optionsMatches');
const validateDisableSettings = require('./validateDisableSettings');
/** @typedef {import('postcss').Comment} PostcssComment */
/** @typedef {import('stylelint').RangeType} RangeType */
/** @typedef {import('stylelint').DisableReportRange} DisableReportRange */
/** @typedef {import('stylelint').DisableOptionsReport} StylelintDisableOptionsReport */
/**
* @param {import('stylelint').LintResult[]} results
*/
module.exports = function descriptionlessDisables(results) {
results.forEach((result) => {
const settings = validateDisableSettings(
result._postcssResult,
'reportDescriptionlessDisables',
);
if (!settings) return;
const [enabled, options, stylelintResult] = settings;
const rangeData = stylelintResult.disabledRanges;
/** @type {Set<PostcssComment>} */
const alreadyReported = new Set();
Object.keys(rangeData).forEach((rule) => {
rangeData[rule].forEach((range) => {
if (range.description) return;
if (alreadyReported.has(range.comment)) return;
if (enabled === optionsMatches(options, 'except', rule)) {
// An 'all' rule will get copied for each individual rule. If the
// configuration is `[false, {except: ['specific-rule']}]`, we
// don't want to report the copies that match except, so we record
// the comment as already reported.
if (!enabled && rule === 'all') alreadyReported.add(range.comment);
return;
}
alreadyReported.add(range.comment);
// If the comment doesn't have a location, we can't report a useful error.
// In practice we expect all comments to have locations, though.
if (!range.comment.source || !range.comment.source.start) return;
result.warnings.push({
text: `Disable for "${rule}" is missing a description`,
rule: '--report-descriptionless-disables',
line: range.comment.source.start.line,
column: range.comment.source.start.column,
severity: options.severity,
});
});
});
});
};