quran/node_modules/stylelint/lib/formatters/githubFormatter.js

'use strict';

/**
 * @see https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions
 *
 * @type {import('stylelint').Formatter}
 */
module.exports = function githubFormatter(results, returnValue) {
	const title = 'Stylelint problem';
	const metadata = returnValue.ruleMetadata;

	return results
		.flatMap(({ source, warnings }) =>
			warnings.map(({ line, column, endLine, endColumn, text, severity, rule }) => {
				const msg = buildMessage(text, metadata[rule]);

				return endLine === undefined
					? `::${severity} file=${source},line=${line},col=${column},title=${title}::${msg}`
					: `::${severity} file=${source},line=${line},col=${column},endLine=${endLine},endColumn=${endColumn},title=${title}::${msg}`;
			}),
		)
		.join('\n');
};

/**
 * @param {string} msg
 * @param {Partial<import('stylelint').RuleMeta> | undefined} metadata
 * @returns {string}
 */
function buildMessage(msg, metadata) {
	if (!metadata) return msg;

	const url = metadata.url ? ` - ${metadata.url}` : '';
	const fixable = metadata.fixable ? ' [maybe fixable]' : '';

	return `${msg}${fixable}${url}`;
}