@alexlit/lint-kit 183.4.0 → 183.6.0

package/packages/config-stylelint/node_modules/stylelint/lib/reference/selectors.mjs

@@ -0,0 +1,472 @@
+import htmlTags from 'html-tags';
+
+import uniteSets from '../utils/uniteSets.mjs';
+
+/** @type {ReadonlySet<string>} */
+const deprecatedHtmlTypeSelectors = new Set([
+	'acronym',
+	'applet',
+	'basefont',
+	'big',
+	'bgsound',
+	'blink',
+	'center',
+	'content',
+	'dir',
+	'font',
+	'frame',
+	'frameset',
+	'isindex',
+	'keygen',
+	'listing',
+	'marquee',
+	'menuitem',
+	'multicol',
+	'nextid',
+	'nobr',
+	'noembed',
+	'noframes',
+	'plaintext',
+	'param',
+	'popup',
+	'rb',
+	'rtc',
+	'selectmenu',
+	'shadow',
+	'spacer',
+	'strike',
+	'tt',
+	'xmp',
+]);
+
+// typecasting htmlTags to be more generic; see https://github.com/stylelint/stylelint/pull/6013 for discussion
+/** @type {ReadonlySet<string>} */
+const standardHtmlTypeSelectors = new Set(htmlTags);
+
+/** @type {ReadonlySet<string>} */
+const experimentalHtmlTypeSelectors = new Set([
+	'fencedframe',
+	'listbox',
+	'model',
+	'portal',
+	'selectedcontent',
+	'selectlist',
+	'geolocation',
+	'usermedia',
+]);
+
+/** @type {ReadonlySet<string>} */
+export const htmlTypeSelectors = uniteSets(
+	deprecatedHtmlTypeSelectors,
+	standardHtmlTypeSelectors,
+	experimentalHtmlTypeSelectors,
+);
+
+/** @type {ReadonlySet<string>} */
+export const deprecatedSvgTypeSelectors = new Set([
+	'altGlyph',
+	'altGlyphDef',
+	'altGlyphItem',
+	'cursor',
+	'font',
+	'font-face',
+	'font-face-format',
+	'font-face-name',
+	'font-face-src',
+	'font-face-uri',
+	'glyph',
+	'glyphRef',
+	'hatchPath',
+	'hkern',
+	'missing-glyph',
+	'tref',
+	'vkern',
+]);
+
+/** @type {ReadonlySet<string>} */
+export const mixedCaseSvgTypeSelectors = new Set([
+	'altGlyph',
+	'altGlyphDef',
+	'altGlyphItem',
+	'animateColor',
+	'animateMotion',
+	'animateTransform',
+	'clipPath',
+	'feBlend',
+	'feColorMatrix',
+	'feComponentTransfer',
+	'feComposite',
+	'feConvolveMatrix',
+	'feDiffuseLighting',
+	'feDisplacementMap',
+	'feDistantLight',
+	'feDropShadow',
+	'feFlood',
+	'feFuncA',
+	'feFuncB',
+	'feFuncG',
+	'feFuncR',
+	'feGaussianBlur',
+	'feImage',
+	'feMerge',
+	'feMergeNode',
+	'feMorphology',
+	'feOffset',
+	'fePointLight',
+	'feSpecularLighting',
+	'feSpotLight',
+	'feTile',
+	'feTurbulence',
+	'foreignObject',
+	'glyphRef',
+	'hatchPath',
+	'linearGradient',
+	'radialGradient',
+	'textPath',
+]);
+
+/**
+ * These are the ones that can have single-colon notation
+ *
+ * @type {ReadonlySet<string>}
+ */
+export const levelOneAndTwoPseudoElements = new Set([
+	'before',
+	'after',
+	'first-line',
+	'first-letter',
+]);
+
+/** @type {ReadonlySet<string>} */
+export const shadowTreePseudoElements = new Set(['part']);
+
+/** @type {ReadonlySet<string>} */
+export const webkitScrollbarPseudoElements = new Set([
+	'-webkit-resizer',
+	'-webkit-scrollbar',
+	'-webkit-scrollbar-button',
+	'-webkit-scrollbar-corner',
+	'-webkit-scrollbar-thumb',
+	'-webkit-scrollbar-track',
+	'-webkit-scrollbar-track-piece',
+]);
+
+/** @type {ReadonlySet<string>} */
+const vendorSpecificPseudoElements = uniteSets(webkitScrollbarPseudoElements, [
+	'-moz-focus-inner',
+	'-moz-focus-outer',
+	'-moz-list-bullet',
+	'-moz-meter-bar',
+	'-moz-placeholder',
+	'-moz-progress-bar',
+	'-moz-range-progress',
+	'-moz-range-thumb',
+	'-moz-range-track',
+	'-ms-browse',
+	'-ms-check',
+	'-ms-clear',
+	'-ms-expand',
+	'-ms-fill',
+	'-ms-fill-lower',
+	'-ms-fill-upper',
+	'-ms-reveal',
+	'-ms-thumb',
+	'-ms-ticks-after',
+	'-ms-ticks-before',
+	'-ms-tooltip',
+	'-ms-track',
+	'-ms-value',
+	'-webkit-color-swatch',
+	'-webkit-color-swatch-wrapper',
+	'-webkit-calendar-picker-indicator',
+	'-webkit-clear-button',
+	'-webkit-date-and-time-value',
+	'-webkit-datetime-edit',
+	'-webkit-datetime-edit-ampm-field',
+	'-webkit-datetime-edit-day-field',
+	'-webkit-datetime-edit-fields-wrapper',
+	'-webkit-datetime-edit-hour-field',
+	'-webkit-datetime-edit-millisecond-field',
+	'-webkit-datetime-edit-minute-field',
+	'-webkit-datetime-edit-month-field',
+	'-webkit-datetime-edit-second-field',
+	'-webkit-datetime-edit-text',
+	'-webkit-datetime-edit-week-field',
+	'-webkit-datetime-edit-year-field',
+	'-webkit-details-marker',
+	'-webkit-distributed',
+	'-webkit-file-upload-button',
+	'-webkit-input-placeholder',
+	'-webkit-keygen-select',
+	'-webkit-meter-bar',
+	'-webkit-meter-even-less-good-value',
+	'-webkit-meter-inner-element',
+	'-webkit-meter-optimum-value',
+	'-webkit-meter-suboptimum-value',
+	'-webkit-meter-horizontal-bar',
+	'-webkit-meter-horizontal-optimum-value',
+	'-webkit-meter-horizontal-suboptimal-value',
+	'-webkit-meter-horizontal-even-less-good-value',
+	'-webkit-meter-vertical-bar',
+	'-webkit-meter-vertical-optimum-value',
+	'-webkit-meter-vertical-suboptimal-value',
+	'-webkit-meter-vertical-even-less-good-value',
+	'-webkit-progress-bar',
+	'-webkit-progress-inner-element',
+	'-webkit-progress-value',
+	'-webkit-search-cancel-button',
+	'-webkit-search-decoration',
+	'-webkit-search-results-button',
+	'-webkit-search-results-decoration',
+	'-webkit-slider-runnable-track',
+	'-webkit-slider-thumb',
+	'-webkit-textfield-decoration-container',
+	'-webkit-validation-bubble',
+	'-webkit-validation-bubble-arrow',
+	'-webkit-validation-bubble-arrow-clipper',
+	'-webkit-validation-bubble-heading',
+	'-webkit-validation-bubble-message',
+	'-webkit-validation-bubble-text-block',
+]);
+
+/** @type {ReadonlySet<string>} */
+export const deprecatedPseudoElements = new Set(['shadow']);
+
+/** @type {ReadonlySet<string>} */
+export const pseudoElements = uniteSets(
+	levelOneAndTwoPseudoElements,
+	vendorSpecificPseudoElements,
+	shadowTreePseudoElements,
+	deprecatedPseudoElements,
+	[
+		'backdrop',
+		'checkmark',
+		'clear-icon',
+		'color-swatch',
+		'content',
+		'cue',
+		'details-content',
+		'field-component',
+		'field-separator',
+		'field-text',
+		'file-selector-button',
+		'grammar-error',
+		'highlight',
+		'marker',
+		'picker-icon',
+		'picker',
+		'placeholder',
+		'scroll-button',
+		'scroll-marker-group',
+		'scroll-marker',
+		'search-text',
+		'selection',
+		'slider-fill',
+		'slider-thumb',
+		'slider-track',
+		'slotted',
+		'spelling-error',
+		'step-control',
+		'step-down',
+		'step-up',
+		'target-text',
+		'view-transition-group',
+		'view-transition-image-pair',
+		'view-transition-new',
+		'view-transition-old',
+		'view-transition',
+	],
+);
+
+/** @type {ReadonlySet<string>} */
+export const percentageKeyframeWithNamedEquivalent = new Set(['0%', '100%']);
+
+/** @type {ReadonlySet<string>} */
+export const aNPlusBNotationPseudoClasses = new Set([
+	'nth-column',
+	'nth-last-column',
+	'nth-last-of-type',
+	'nth-of-type',
+]);
+
+/** @type {ReadonlySet<string>} */
+export const aNPlusBOfSNotationPseudoClasses = new Set(['nth-child', 'nth-last-child']);
+
+/** @type {ReadonlySet<string>} */
+export const atRulePagePseudoClasses = new Set([
+	'first',
+	'right',
+	'left',
+	'blank',
+	'recto',
+	'verso',
+	'nth',
+]);
+
+/** @type {ReadonlySet<string>} */
+export const linguisticPseudoClasses = new Set(['dir', 'lang']);
+
+/** @type {ReadonlySet<string>} */
+export const logicalCombinationsPseudoClasses = new Set(['has', 'is', 'matches', 'not', 'where']);
+
+/** @type {ReadonlySet<string>} */
+export const deprecatedPseudoClasses = new Set([
+	'contains',
+	'drop',
+	'focus-ring',
+	'fullscreen-ancestor',
+	'matches',
+	'popup-open',
+	'top-layer',
+	'user-error',
+]);
+
+/** @type {ReadonlySet<string>} */
+const vendorSpecificPseudoClasses = new Set([
+	'-khtml-drag',
+	'-moz-any',
+	'-moz-any-link',
+	'-moz-bound-element',
+	'-moz-broken',
+	'-moz-dir',
+	'-moz-drag-over',
+	'-moz-empty-except-children-with-localname',
+	'-moz-first-node',
+	'-moz-focusring',
+	'-moz-full-screen',
+	'-moz-full-screen-ancestor',
+	'-moz-is-html',
+	'-moz-last-node',
+	'-moz-loading',
+	'-moz-meter-optimum',
+	'-moz-meter-sub-optimum',
+	'-moz-meter-sub-sub-optimum',
+	'-moz-only-whitespace',
+	'-moz-placeholder',
+	'-moz-read-only',
+	'-moz-read-write',
+	'-moz-submit-invalid',
+	'-moz-suppressed',
+	'-moz-table-border-nonzero',
+	'-moz-ui-invalid',
+	'-moz-ui-valid',
+	'-moz-user-disabled',
+	'-moz-window-inactive',
+	'-ms-fullscreen',
+	'-ms-input-placeholder',
+	'-webkit-drag',
+	'-webkit-any',
+	'-webkit-any-link',
+	'-webkit-autofill',
+	'-webkit-full-screen',
+	'-webkit-full-screen-ancestor',
+]);
+
+/**
+ * @see https://webkit.org/blog/363/styling-scrollbars/
+ * @type {ReadonlySet<string>}
+ */
+export const webkitScrollbarPseudoClasses = new Set([
+	'horizontal',
+	'vertical',
+	'decrement',
+	'increment',
+	'start',
+	'end',
+	'double-button',
+	'single-button',
+	'no-button',
+	'corner-present',
+	'window-inactive',
+]);
+
+/**
+ * @see https://www.w3.org/TR/selectors-4/#resource-pseudos
+ * @type {ReadonlySet<string>}
+ */
+const resourceStatePseudoClasses = new Set([
+	'buffering',
+	'muted',
+	'paused',
+	'playing',
+	'seeking',
+	'stalled',
+	'volume-locked',
+]);
+
+/** @type {ReadonlySet<string>} */
+export const pseudoClasses = uniteSets(
+	aNPlusBNotationPseudoClasses,
+	linguisticPseudoClasses,
+	logicalCombinationsPseudoClasses,
+	aNPlusBOfSNotationPseudoClasses,
+	resourceStatePseudoClasses,
+	vendorSpecificPseudoClasses,
+	deprecatedPseudoClasses,
+	[
+		'active-view-transition-type',
+		'active-view-transition',
+		'active',
+		'any-link',
+		'autofill',
+		/*
+			introduced the 10/05/2016 by 8c808d0
+			as of 2024 it is still not supported by any browser
+		*/
+		'blank',
+		'checked',
+		'current',
+		'default',
+		'defined',
+		'disabled',
+		'empty',
+		'enabled',
+		'even-less-good-value',
+		'first-child',
+		'first-of-type',
+		'focus-visible',
+		'focus-within',
+		'focus',
+		'fullscreen',
+		'future',
+		'has-slotted',
+		'heading',
+		'high-value',
+		'host-context',
+		'host',
+		'hover',
+		'in-range',
+		'indeterminate',
+		'invalid',
+		'last-child',
+		'last-of-type',
+		'link',
+		'low-value',
+		'modal',
+		'only-child',
+		'only-of-type',
+		'open',
+		'optimal-value',
+		'optional',
+		'out-of-range',
+		'past',
+		'picture-in-picture',
+		'placeholder-shown',
+		'popover-open',
+		'read-only',
+		'read-write',
+		'required',
+		'root',
+		'scope',
+		'state',
+		'suboptimal-value',
+		'target',
+		'unchecked',
+		'unresolved',
+		'user-invalid',
+		'user-valid',
+		'valid',
+		'visited',
+		'window-inactive', // for ::selection (chrome)
+	],
+);

package/packages/config-stylelint/node_modules/stylelint/lib/reference/units.mjs

@@ -0,0 +1,82 @@
+import uniteSets from '../utils/uniteSets.mjs';
+
+/** @type {ReadonlySet<string>} */
+export const lengthUnits = new Set([
+	// Font-relative length units
+	'cap',
+	'ch',
+	'em',
+	'ex',
+	'ic',
+	'lh',
+	'rcap',
+	'rch',
+	'rem',
+	'rex',
+	'ric',
+	'rlh',
+	// Viewport-percentage lengths
+	'dvb',
+	'dvh',
+	'dvi',
+	'dvmax',
+	'dvmin',
+	'dvw',
+	'lvb',
+	'lvh',
+	'lvi',
+	'lvmax',
+	'lvmin',
+	'lvw',
+	'svb',
+	'svh',
+	'svi',
+	'svmax',
+	'svmin',
+	'svw',
+	'vb',
+	'vh',
+	'vi',
+	'vw',
+	'vmin',
+	'vmax',
+	'vm',
+	// Absolute length units
+	'px',
+	'mm',
+	'cm',
+	'in',
+	'pt',
+	'pc',
+	'q',
+	'mozmm',
+	// Flexible length units
+	'fr',
+	// Container query units
+	'cqw',
+	'cqh',
+	'cqi',
+	'cqb',
+	'cqmin',
+	'cqmax',
+]);
+
+/** @type {ReadonlySet<string>} */
+export const resolutionUnits = new Set(['dpi', 'dpcm', 'dppx', 'x']);
+
+/** @type {ReadonlySet<string>} */
+export const units = uniteSets(lengthUnits, resolutionUnits, [
+	// Relative length units
+	'%',
+	// Time length units
+	's',
+	'ms',
+	// Angle
+	'deg',
+	'grad',
+	'turn',
+	'rad',
+	// Frequency
+	'Hz',
+	'kHz',
+]);

package/packages/config-stylelint/node_modules/stylelint/lib/reportDisables.mjs

@@ -0,0 +1,48 @@
+import { SEVERITY_ERROR } from './constants.mjs';
+import reportCommentProblem from './utils/reportCommentProblem.mjs';
+
+/**
+ * Returns a report describing which `results` (if any) contain disabled ranges
+ * for rules that disallow disables via `reportDisables: true`.
+ *
+ * @param {import('stylelint').PostcssResult} postcssResult
+ * @returns {void}
+ */
+export default function reportDisables(postcssResult) {
+	const rangeData = postcssResult.stylelint.disabledRanges;
+	const configRules = postcssResult.stylelint.config?.rules;
+
+	if (!configRules) return;
+
+	// If no rules actually disallow disables, don't bother looking for ranges
+	// that correspond to disabled rules.
+	if (!Object.values(configRules).some((rule) => reportDisablesForRule(rule))) {
+		return;
+	}
+
+	for (const [rule, ranges] of Object.entries(rangeData)) {
+		for (const range of ranges) {
+			if (!configRules[rule]) continue;
+
+			if (!reportDisablesForRule(configRules[rule])) continue;
+
+			reportCommentProblem({
+				rule: 'reportDisables',
+				message: `Rule "${rule}" may not be disabled`,
+				severity: SEVERITY_ERROR,
+				node: range.node,
+				postcssResult,
+			});
+		}
+	}
+}
+
+/**
+ * @param {import('stylelint').ConfigRuleSettings<any, object>} options
+ * @returns {boolean}
+ */
+function reportDisablesForRule(options) {
+	if (!options || !options[1]) return false;
+
+	return Boolean(options[1].reportDisables);
+}

package/packages/config-stylelint/node_modules/stylelint/lib/reportUnknownRuleNames.mjs

@@ -0,0 +1,76 @@
+import { distance } from 'fastest-levenshtein';
+
+import { SEVERITY_ERROR } from './constants.mjs';
+import rules from './rules/index.mjs';
+
+const MAX_LEVENSHTEIN_DISTANCE = 6;
+const MAX_SUGGESTIONS_COUNT = 3;
+
+/**
+ * @param {string} ruleName
+ * @returns {string[]}
+ */
+function extractSuggestions(ruleName) {
+	const suggestions = Array.from({ length: MAX_LEVENSHTEIN_DISTANCE });
+
+	for (let i = 0; i < suggestions.length; i++) {
+		suggestions[i] = [];
+	}
+
+	for (const existRuleName of Object.keys(rules)) {
+		const dist = distance(existRuleName, ruleName);
+
+		if (dist <= MAX_LEVENSHTEIN_DISTANCE) {
+			suggestions[dist - 1].push(existRuleName);
+		}
+	}
+
+	/** @type {string[]} */
+	let result = [];
+
+	for (const [i, suggestion] of suggestions.entries()) {
+		if (suggestion.length > 0) {
+			if (i < 3) {
+				return suggestion.slice(0, MAX_SUGGESTIONS_COUNT);
+			}
+
+			result = result.concat(suggestion);
+		}
+	}
+
+	return result.slice(0, MAX_SUGGESTIONS_COUNT);
+}
+
+/**
+ * @param {string} ruleName
+ * @param {string[]} [suggestions]
+ * @returns {string}
+ */
+function rejectMessage(ruleName, suggestions = []) {
+	return `Unknown rule ${ruleName}.${
+		suggestions.length > 0 ? ` Did you mean ${suggestions.join(', ')}?` : ''
+	}`;
+}
+
+/** @type {Map<string, string[]>} */
+const cache = new Map();
+
+/**
+ * @param {string} unknownRuleName
+ * @param {import('postcss').Root} postcssRoot
+ * @param {import('stylelint').PostcssResult} postcssResult
+ * @returns {void}
+ */
+export default function reportUnknownRuleNames(unknownRuleName, postcssRoot, postcssResult) {
+	const suggestions = cache.has(unknownRuleName)
+		? /** @type {string[]} */ (cache.get(unknownRuleName))
+		: extractSuggestions(unknownRuleName);
+
+	cache.set(unknownRuleName, suggestions);
+	postcssResult.warn(rejectMessage(unknownRuleName, suggestions), {
+		severity: SEVERITY_ERROR,
+		rule: unknownRuleName,
+		node: postcssRoot,
+		index: 0,
+	});
+}

package/packages/config-stylelint/node_modules/stylelint/lib/resolveConfig.mjs

@@ -0,0 +1,43 @@
+import { isAbsolute, join, normalize } from 'node:path';
+import process from 'node:process';
+
+import createStylelint from './createStylelint.mjs';
+import getConfigForFile from './getConfigForFile.mjs';
+
+/**
+ * @type {import('stylelint').PublicApi['resolveConfig']}
+ */
+export default async function resolveConfig(
+	filePath,
+	{
+		cwd = process.cwd(),
+		config = undefined,
+		configBasedir = undefined,
+		configFile = undefined,
+	} = {},
+) {
+	if (!filePath) {
+		return undefined;
+	}
+
+	const stylelint = createStylelint({
+		config,
+		configFile,
+		configBasedir,
+		cwd,
+	});
+
+	const absoluteFilePath = !isAbsolute(filePath) ? join(cwd, filePath) : normalize(filePath);
+
+	const resolved = await getConfigForFile({
+		stylelint,
+		searchPath: absoluteFilePath,
+		filePath: absoluteFilePath,
+	});
+
+	if (!resolved) {
+		return undefined;
+	}
+
+	return resolved.config;
+}