stylelint/lib/utils/parseSelector.mjs

A mighty CSS linter that helps you avoid errors and enforce conventions.

import selectorParser from 'postcss-selector-parser';

/**
 * @param {string} selector
 * @param {import('stylelint').PostcssResult} result
 * @param {import('postcss').Node} node
 * @param {(root: import('postcss-selector-parser').Root) => void} [callback] - Deprecated. It will be removed in the future.
 * @returns {import('postcss-selector-parser').Root | undefined}
 */
export default function parseSelector(selector, result, node, callback) {
	if (!selector) return undefined;

	try {
		// TODO: Remove `callback` in the future. See #7647.
		if (callback) {
			// @ts-expect-error -- TS2322: Type 'string' is not assignable to type 'Root'.
			return selectorParser(callback).processSync(selector);
		}

		return selectorParser().astSync(selector);
	} catch (err) {
		result.warn(`Cannot parse selector (${err})`, { node, stylelintType: 'parseError' });

		return undefined;
	}
}