Function StyleSheet

eslint-rules/css-documentation.js:31–89

(node)

		return {
			StyleSheet(node) {
				for (const child of node.children) {
					if (child.type !== 'Rule') {
						continue;
					}

					let line = child.loc.start.line - 1;
					const leadingComments = [];
					while (line >= 1) {
						// `line` is 1-based from source locations; sourceCode.lines is 0-based.
						const lineText = (sourceCode.lines[line - 1] ?? '').trim();
						if (lineText === '') {
							line--;
							continue;
						}

						const comment = commentsByEndLine.get(line);
						if (!comment) {
							break;
						}

						leadingComments.unshift(comment);
						line = comment.loc.start.line - 1;
					}

					let hasInfo = false;
					let hasTest = false;
					let hasDescription = false;
					for (const comment of leadingComments) {
						const commentValue = comment.value.trim().toLowerCase();
						hasInfo ||= commentValue.startsWith('info:');
						hasTest ||= commentValue.startsWith('test:');
						hasDescription ||= commentValue.length > 0 && !isNonDescriptionMetadataLine(commentValue);
					}

					const missingRequirements = [];
					if (!hasDescription) {
						missingRequirements.push('Description');
					}

					if (!hasInfo) {
						missingRequirements.push('Info');
					}

					if (!hasTest) {
						missingRequirements.push('Test');
					}

					if (missingRequirements.length > 0) {
						context.report({
							node: child,
							messageId: 'invalidComments',
							data: {
								missing: missingRequirements.join(', '),
							},
						});
					}
				}