@lucca/stylelint-config-prisme 22.0.0-rc.4 → 22.0.0

package/LFDeprecatedProperties.mjs

@@ -1,39 +1,68 @@
 // WARNING!
 // Always check for variables with regular expressions. A string will match all the value, not part of it.
+// {string} --token -> --token ✓ | var(--token) ✗
+//
+// Boundary convention:
+// - Each pattern ends with `(?![\w-])`: matches the exact token only; the guard blocks a trailing word char OR `-`.
+//   --token ✓ | --token-x ✗ | --tokenX ✗
 
 export default [
 	{
-		objectPattern: /--commons-elevations-elevation-[1-6]]/,
+		// SEE https://regex101.com/r/Qkq3ok.
+		objectPattern: /--commons-elevations-elevation-[1-6](?![\w-])/,
 		versionDeprecated: '17.3.0',
 		versionDeleted: '19.1.0',
 	},
 	{
-		objectPattern: /--commons-boxShadow-X*(S|M|L)/,
+		// SEE https://regex101.com/r/Y00E16.
+		objectPattern: /--commons-boxShadow-X*(S|M|L)(?![\w-])/,
 		versionDeprecated: '17.3.0',
 		versionDeleted: '19.1.0',
 	},
 	{
-		objectPattern: /--palettes-(grey|primary|secondary|lucca)-[0-9]{2,3}/,
+		// SEE https://regex101.com/r/BRi8Yi.
+		objectPattern: /--palettes-(grey|primary|secondary|lucca)-(25|50|100|200|300|400|500|600|700|800|900)(?![\w-])/,
 		versionDeprecated: '17.3.0',
-		versionDeleted: '21.1.0',
+		versionDeleted: '22.0.0',
+		actions: `
+			* Remplacer \`grey\` par \`neutral\`.
+			* Remplacer \`primary\` & \`secondary\` par \`product\`.
+			* Remplacer \`lucca\` par \`brand\`.
+		`,
+		urls: {
+			schematics: 'https://prisme.lucca.io/94310e217/p/40c515-cycle-de-vie-des-composants/b/15c256',
+		},
 	},
 	{
-		objectPattern: /--spacings-X*(S|M|L)/,
+		// SEE https://regex101.com/r/WqLllN.
+		objectPattern: /--spacings-X*(S|M|L)(?![\w-])/,
 		versionDeprecated: '17.4.0',
 		versionDeleted: '19.1.0',
 	},
 	{
-		objectPattern: /--colors-(black|white)-color/,
+		// SEE https://regex101.com/r/iMddaz.
+		objectPattern: /--colors-(black|white)-color(?![\w-])/,
 		versionDeprecated: '18.2.0',
-		versionDeleted: '21.1.0',
+		versionDeleted: '22.0.0',
+		actions: `
+			* Remplacer \`--colors-white-color\` par \`--palettes-neutral-0\` ou \`--pr-t-elevation-surface-raised\` selon si la couleur en question est considérée comme une couleur ou une surface.
+			* Remplacer \`--colors-black-color\` par \`--palettes-neutral-900\`.
+		`,
 	},
 	{
-		objectPattern: /--commons-navSide-compact-width/,
+		// SEE https://regex101.com/r/xx7vjW.
+		objectPattern: /--commons-navSide-compact-width(?![\w-])/,
 		versionDeprecated: '18.3.0',
 		versionDeleted: '20.1.0',
 	},
 	{
-		objectPattern: /--commons-borderRadius-(M|L|XL|full)/,
+		// SEE https://regex101.com/r/1P70OB.
+		objectPattern: /--commons-borderRadius-(M|L|XL|full)(?![\w-])/,
 		versionDeprecated: '20.2.0',
+		versionDeleted: '22.0.0',
+		actions: 'Remplacer par \`--pr-t-border-radius-XXX\`',
+		urls: {
+			schematics: 'https://prisme.lucca.io/94310e217/p/40c515-cycle-de-vie-des-composants/t/page-40c515-88288181-15c256-0',
+		},
 	},
 ];

package/LFDeprecatedSelectors.mjs

@@ -1,182 +1,264 @@
+// Deprecated selectors — used by Stylelint's selector-disallowed-list (see stylelint.config.mjs).
+// Each `objectPattern` is matched with `.test()` against a selector.
+//
+// WARNING!
+// Always match selectors with regular expressions. A string will match the whole selector, not part of it.
+// {string} .token -> .token ✓ | .foo .token ✗ | .token.mod-x ✗
+//
+// Boundary conventions:
+// - Exact token — `\.token(?![\w-])`: matches the token only; the guard blocks a trailing word char OR `-`.
+//   .token ✓ | .token-x ✗ | .tokenX ✗
+// - Component root — `\.token\b`: also flags hyphen-children (`\b` counts `-` as a boundary); not camelCase or plural.
+//   .token ✓ | .token-child ✓ | .tokens ✗
+// - Enumerated children — `\.token(-(a|b))?(?![\w-])`: base plus only its known children (avoids a broad root).
+//   .token ✓ | .token-a ✓ | .token-c ✗
+// - Order-independent combo — `(?=\S*\.a(?![\w-]))(?=\S*\.b(?![\w-]))\S*`: both tokens, any order; `\S*` never crosses whitespace (no descendant match).
+//   .a.b ✓ | .b.a ✓ | .a .b ✗
+// - Catch-all — `\.token.*`: base plus any suffix.
+//   .token ✓ | .tokenX ✓ | .other ✗
 export default [
 	// Any occurrence of one of these selectors in any part of a selector
 	// SEE https://regex101.com/r/OTnSEg
 	{
 		objectPattern: [
-			/\.active/,
-			/\.disabled/,
-			/\.error/,
-			/\.label/,
-			/\.mod-delete/,
-			/\.mod-link/,
-			/\.mod-outline\b/,
-			/\.success/,
-			/\.u-textLight/,
+			/\.active(?![\w-])/,
+			/\.disabled(?![\w-])/,
+			/\.error(?![\w-])/,
+			/\.label(?![\w-])/,
+			/\.label-icon(?![\w-])/,
+			/\.mod-delete(?![\w-])/,
+			/\.mod-link(?![\w-])/,
+			/\.mod-outline(?![\w-])/,
+			/\.success(?![\w-])/,
+			/\.u-textLight(?![\w-])/,
 		],
 	},
 	{
 		// Any combination of .button and .mod-counter, with any non-whitespace character between
 		// SEE https://regex101.com/r/9WOlXc.
-		objectPattern: /(?=\S*\.\bbutton\b)(?=\S*\.\bmod-counter\b)\S*/,
+		objectPattern: /(?=\S*\.button(?![\w-]))(?=\S*\.mod-counter(?![\w-]))\S*/,
 		versionDeleted: '18.1.0',
 	},
 	{
-		objectPattern: [/\.button-counter/, /\.navSide-item-alert/, /\.textfield-actionClear/, /\.lu-select-value .label/],
+		// SEE https://regex101.com/r/AUlf21.
+		objectPattern: [
+			/\.button-counter(?![\w-])/,
+			/\.navSide-item-alert(?![\w-])/,
+			/\.textfield-actionClear(?![\w-])/,
+			/\.lu-select-value \.label(?![\w-])/,
+		],
 		versionDeleted: '18.1.0',
 	},
 	{
 		// Any combination of .callout and .mod-tiny, with any non-whitespace character between
 		// SEE https://regex101.com/r/rW039S.
-		objectPattern: /(?=\S*\.\bcallout\b)(?=\S*\.\bmod-tiny\b)\S*/,
+		objectPattern: /(?=\S*\.callout(?![\w-]))(?=\S*\.mod-tiny(?![\w-]))\S*/,
 		versionDeleted: '18.1.0',
 	},
-	// Any occurrence of one of these selectors in any part of a selector
-	// SEE https://regex101.com/r/VHfdte.
 	{
-		objectPattern: [/\.user-info/, /\.user-tile(-(title|label|footnote))?/, /\.picture/],
+		// Any occurrence of one of these selectors in any part of a selector
+		// SEE https://regex101.com/r/VHfdte.
+		objectPattern: [/\.user-info\b/, /\.user-tile(-(title|label|footnote))?(?![\w-])/, /\.picture(?![\w-])/],
 		versionDeleted: '20.1.0',
 	},
 	{
 		// Any combination of .button and .mod-icon, with any non-whitespace character between
 		// SEE https://regex101.com/r/6yQzje.
-		objectPattern: /(\.button|\.mod-icon)[\S]*(\.button|\.mod-icon)/,
+		objectPattern: /(?=\S*\.button(?![\w-]))(?=\S*\.mod-icon(?![\w-]))\S*/,
 		versionDeprecated: '17.2.0',
 		versionDeleted: '19.1.0',
 	},
 	{
-		objectPattern: [/\.u-comma/, /\.u-unit/],
+		// SEE https://regex101.com/r/VGtzuM.
+		objectPattern: [/\.u-comma(?![\w-])/, /\.u-unit(?![\w-])/],
 		versionDeprecated: '17.3.0',
 		versionDeleted: '19.1.0',
 	},
 	{
-		objectPattern: /\.palette-(grey|primary|secondary|lucca)/,
+		// SEE https://regex101.com/r/nPMyQZ.
+		objectPattern: /\.palette-(grey|primary|secondary|lucca)(?![\w-])/,
 		versionDeprecated: '17.3.0',
 		versionDeleted: '22.0.0',
+		actions: `
+			* Remplacer \`grey\` par \`neutral\`.
+			* Remplacer \`primary\` & \`secondary\` par \`product\`.
+			* Remplacer \`lucca\` par \`brand\`.
+		`,
+		urls: {
+			schematics: 'https://prisme.lucca.io/94310e217/p/40c515-cycle-de-vie-des-composants/b/15c256',
+		},
 	},
 	{
-		objectPattern: /\.u-(padding|margin|gap)X*(S|M|L)/,
+		// Old t-shirt sized utilities
+		// - Sizes: 0, XXS-XXL, Auto (margins only).
+		// - Directions: physical, Inline, Block. Gaps: gap, rowGap, columnGap.
+		// - Excluded: `.u-{margin|padding}{Inline|Block}0`, still shipping (SEE next entry).
+		// SEE https://regex101.com/r/YCDDc8.
+		objectPattern:
+			/\.u-((margin|padding)(Top|Right|Bottom|Left)?(Auto|0|X{1,2}[SL]|[SML])|(margin|padding)(Inline|Block)(Auto|X{1,2}[SL]|[SML])|(columnGap|rowGap|gap)(0|X{1,2}[SL]|[SML]))(?![\w-])/,
 		versionDeprecated: '17.4.0',
 		versionDeleted: '19.1.0',
 	},
 	{
-		objectPattern: [/\.u-textLeft/, /\.u-textCenter/, /\.u-textRight/],
+		// Zero spacing utilities with the deprecated `.u-` prefix, renamed `.pr-u-` in 20.2.0
+		// - Box models: margin, padding, inset. Directions: Inline, Block, and their `-start`/`-end` children.
+		// - Names are generated `.u-{box}{capitalize(direction)}0`, so directional children stay hyphenated
+		//   and lower-cased (`.u-marginInline-start0`, not `.u-marginInlineStart0`); bare `.u-inset0` has no direction.
+		// SEE https://github.com/LuccaSA/lucca-front/pull/3814.
+		// SEE https://regex101.com/r/GwCS3W.
+		objectPattern: /\.u-(inset0|(margin|padding|inset)(Inline|Block)(-(start|end))?0)(?![\w-])/,
+		versionDeprecated: '20.2.0',
+	},
+	{
+		// SEE https://regex101.com/r/y2kYBk.
+		objectPattern: [/\.u-textLeft(?![\w-])/, /\.u-textCenter(?![\w-])/, /\.u-textRight(?![\w-])/],
 		versionDeprecated: '18.1.0',
 		versionDeleted: '22.0.0',
+		actions: `Doublon. Remplacer par : \`.u-textAlignLeft\`, \`.u-textAlignCenter\` & \`.u-textAlignRight\`.`,
 	},
 	{
-		objectPattern: /\.mod-columnSticky/,
+		// SEE https://regex101.com/r/HoanMW.
+		objectPattern: /\.mod-columnSticky(?![\w-])/,
 		versionDeprecated: '18.2.0',
 		versionDeleted: '20.1.0',
 	},
 	// SEE https://regex101.com/r/1EfDam
 	{
-		objectPattern: [/\.(indexT|t)able-head-row-cell-sortableButton/],
+		objectPattern: [/\.(indexT|t)able-head-row-cell-sortableButton(?![\w-])/],
 		versionDeprecated: '18.2.0',
 		versionDeleted: '20.1.0',
 	},
 	{
-		// Any combination of .table-head-row-cell and .mod-sortable, .sortedAscending or .sortedAscending, with any non-whitespace character between
+		// Any combination of .table-head-row-cell and .mod-sortable, .sortedAscending or .sortedDescending, with any non-whitespace character between
 		// SEE https://regex101.com/r/NFrjBF.
-		objectPattern: /(?=\S*\.\btable-head-row-cell\b)(?=\S*\.\b(mod-sortable|sortedAscending|sortedDescending)\b)\S*/,
+		objectPattern: /(?=\S*\.table-head-row-cell(?![\w-]))(?=\S*\.(mod-sortable|sortedAscending|sortedDescending)(?![\w-]))\S*/,
 		versionDeprecated: '18.2.0',
 		versionDeleted: '20.1.0',
 	},
 	{
-		objectPattern: /\.u-text(Left|Center|Right)/,
-		versionDeprecated: '18.2.0',
-	},
-	{
-		objectPattern: [/\.comment-content-textContainer/, /\.mod-withMenuCompact/],
+		// SEE https://regex101.com/r/8f4B4g.
+		objectPattern: [/\.comment-content-textContainer(?![\w-])/, /\.mod-withMenuCompact(?![\w-])/],
 		versionDeprecated: '18.3.0',
 		versionDeleted: '20.1.0',
+		urls: {
+			schematics: 'https://prisme.lucca.io/94310e217/p/40c515-cycle-de-vie-des-composants/b/95175f',
+		},
 	},
 	{
-		objectPattern: [/\.dialog-form/, /\.dialog-formOptional/],
+		// SEE https://regex101.com/r/Ndh0bQ.
+		objectPattern: [/\.dialog-form(?![\w-])/, /\.dialog-formOptional(?![\w-])/],
 		versionDeprecated: '18.3.0',
 		versionDeleted: '22.0.0',
+		actions: `Remplacer par la classe unique \`.dialog-inside-formOptional\`.`,
 	},
 	{
+		// SEE https://regex101.com/r/43OspP.
 		objectPattern: /\.u-elevate.*/,
 		versionDeprecated: '19.1.0',
 		versionDeleted: '19.1.0',
 	},
 	{
-		objectPattern: /\.lu-dropdown-(content|options|options-item|options-item-action)/,
+		// SEE https://regex101.com/r/7wO4Oc.
+		objectPattern: /\.lu-dropdown-(content|options|options-item|options-item-action)(?![\w-])/,
 		versionDeprecated: '19.2.0',
 		versionDeleted: '22.0.0',
+		actions: `Remplacer par le nouveau DOM du composant [Dropdown](https://prisme.lucca.io/94310e217/p/557682-dropdown).`,
 	},
 	{
 		// SEE https://regex101.com/r/VqPdDw.
-		objectPattern: /\.filterBarDeprecated-?/,
+		objectPattern: /\.filterBarDeprecated\b/,
 		versionDeprecated: '19.2.0',
-		versionDeleted: '21.1.0',
+		versionDeleted: '22.0.0',
 	},
 	{
-		objectPattern: /\.menu-?/,
+		// SEE https://regex101.com/r/1eWJ0d.
+		objectPattern: /\.menu\b/,
 		versionDeprecated: '19.3.0',
 		versionDeleted: '22.0.0',
+		actions: `Remplacer par [Horizontal navigation](https://prisme.lucca.io/94310e217/p/29aaef-horizontal-navigation).`,
 	},
 	{
 		// SEE https://regex101.com/r/rOqMxE.
-		objectPattern: /\.u-text(X?S|M|X{0,3}L)/,
+		objectPattern: /\.u-text(X?S|M|X{0,3}L)(?![\w-])/,
 		versionDeprecated: '20.1.0',
 		versionDeleted: '22.0.0',
+		actions: `
+			Remplacer par les classes \`.pr-u-bodyXS\`, \`.pr-u-bodyS\`, \`.pr-u-bodyM\`.
+
+			Les utilitaires L ~ XXXL peuvent être remplacés par un utilitaire de titre \`.pr-u-hx\` ou le [token typographie](https://prisme.lucca.io/94310e217/p/73bd2f-typographie/b/23f311) correspondant.
+
+			[Plus d’informations sur le sujet](https://www.notion.so/luccasoftware/Tokens-Typo-1ebd278ab26e808a9b58d1017514ecb9).
+		`,
 	},
 	{
 		// Any combination of .button and .mod-text, .mod-deleted or .loading, with any non-whitespace character between
 		// SEE https://regex101.com/r/5qB2gm.
-		objectPattern: /(?=\S*\.\bbutton\b)(?=\S*\.\b(mod-text|mod-deleted|loading)\b)\S*/,
+		objectPattern: /(?=\S*\.button(?![\w-]))(?=\S*\.(mod-text|mod-deleted|loading)(?![\w-]))\S*/,
 		versionDeprecated: '20.2.0',
 		versionDeleted: '22.0.0',
+		actions: `Remplacer par les classes \`.mod-ghost\` & \`.mod-critical\` et les inputs Angular \`critical\`, \`ghost\` & \`ghost-invert\``,
 	},
 	{
 		// Utilitaires renommés très utilisés
+		// SEE https://regex101.com/r/TdUmb8.
 		objectPattern: [
-			/\.pr-u-textPrimary/,
-			/\.pr-u-textProduct/,
-			/\.pr-u-textSecondary/,
-			/\.pr-u-textBrand/,
-			/\.pr-u-textCritical/,
-			/\.pr-u-textDefault/,
-			/\.pr-u-textError/,
-			/\.pr-u-textGrey/,
-			/\.pr-u-textLight/,
-			/\.pr-u-textLucca/,
-			/\.pr-u-textNeutral/,
-			/\.pr-u-textPlaceholder/,
-			/\.pr-u-textSuccess/,
-			/\.pr-u-textWarning/,
+			/\.pr-u-textPrimary(?![\w-])/,
+			/\.pr-u-textProduct(?![\w-])/,
+			/\.pr-u-textSecondary(?![\w-])/,
+			/\.pr-u-textBrand(?![\w-])/,
+			/\.pr-u-textCritical(?![\w-])/,
+			/\.pr-u-textDefault(?![\w-])/,
+			/\.pr-u-textError(?![\w-])/,
+			/\.pr-u-textGrey(?![\w-])/,
+			/\.pr-u-textLight(?![\w-])/,
+			/\.pr-u-textLucca(?![\w-])/,
+			/\.pr-u-textNeutral(?![\w-])/,
+			/\.pr-u-textPlaceholder(?![\w-])/,
+			/\.pr-u-textSuccess(?![\w-])/,
+			/\.pr-u-textWarning(?![\w-])/,
 		],
 		versionDeprecated: '21.0.0',
+		actions: `
+			Remplacer par les [nouvelles classes](https://prisme.lucca.io/94310e217/p/21a286-utilitaires) liées aux tokens (\`.pr-u-color\`…)
+		`,
+		urls: {
+			schematics: 'https://prisme.lucca.io/94310e217/p/40c515-cycle-de-vie-des-composants/t/17d7fdfdaf',
+		},
 	},
 	{
 		// Utilitaires renommés peu ou pas utilisés
+		// SEE https://regex101.com/r/Dk4cFs.
 		objectPattern: [
-			/\.pr-u-textSuccessContrasted/,
-			/\.pr-u-textWarningContrasted/,
-			/\.pr-u-textBrandContrasted/,
-			/\.pr-u-textNavigation/,
-			/\.pr-u-textAI/,
-			/\.pr-u-textProduct/,
-			/\.pr-u-textPagga/,
-			/\.pr-u-textPoplee/,
-			/\.pr-u-textCoreHR/,
-			/\.pr-u-textTimmi/,
-			/\.pr-u-textCleemy/,
-			/\.pr-u-textCc/,
-			/\.pr-u-textKiwi/,
-			/\.pr-u-textLime/,
-			/\.pr-u-textCucumber/,
-			/\.pr-u-textMint/,
-			/\.pr-u-textGlacier/,
-			/\.pr-u-textLagoon/,
-			/\.pr-u-textBlueberry/,
-			/\.pr-u-textLavender/,
-			/\.pr-u-textGrape/,
-			/\.pr-u-textWatermelon/,
-			/\.pr-u-textPumpkin/,
-			/\.pr-u-textPineapple/,
+			/\.pr-u-textSuccessContrasted(?![\w-])/,
+			/\.pr-u-textWarningContrasted(?![\w-])/,
+			/\.pr-u-textBrandContrasted(?![\w-])/,
+			/\.pr-u-textNavigation(?![\w-])/,
+			/\.pr-u-textAI(?![\w-])/,
+			/\.pr-u-textPagga(?![\w-])/,
+			/\.pr-u-textPoplee(?![\w-])/,
+			/\.pr-u-textCoreHR(?![\w-])/,
+			/\.pr-u-textTimmi(?![\w-])/,
+			/\.pr-u-textCleemy(?![\w-])/,
+			/\.pr-u-textCc(?![\w-])/,
+			/\.pr-u-textKiwi(?![\w-])/,
+			/\.pr-u-textLime(?![\w-])/,
+			/\.pr-u-textCucumber(?![\w-])/,
+			/\.pr-u-textMint(?![\w-])/,
+			/\.pr-u-textGlacier(?![\w-])/,
+			/\.pr-u-textLagoon(?![\w-])/,
+			/\.pr-u-textBlueberry(?![\w-])/,
+			/\.pr-u-textLavender(?![\w-])/,
+			/\.pr-u-textGrape(?![\w-])/,
+			/\.pr-u-textWatermelon(?![\w-])/,
+			/\.pr-u-textPumpkin(?![\w-])/,
+			/\.pr-u-textPineapple(?![\w-])/,
 		],
 		versionDeprecated: '21.0.0',
+		actions: `
+			Remplacer par les [nouvelles classes](https://prisme.lucca.io/94310e217/p/21a286-utilitaires) liées aux tokens (\`.pr-u-color\`…)
+		`,
+		urls: {
+			schematics: 'https://prisme.lucca.io/94310e217/p/40c515-cycle-de-vie-des-composants/t/17d7fdfdaf',
+		},
 	},
 ];

package/LFVersions.mjs

@@ -4,6 +4,19 @@ import { join } from 'node:path';
 
 let LFVersions = null;
 
+/**
+ * Normalise a version to a patch version.
+ * e.g. `22.0` → `22.0.0`
+ *
+ * Used on both sides: LFVersions keys (built from milestone titles) and lookups.
+ *
+ * @param {string} version - Dot-separated LF version
+ * @return {string}
+ */
+export function normalizeVersion(version) {
+	return version.split('.').length === 2 ? `${version}.0` : version;
+}
+
 // Check if the `showCachePath` parameter is present when executing the script.
 const showCachePath = process.argv.includes('showCachePath');
 const CACHE_FILE_PATH = join(os.tmpdir(), 'stylelint-LFVersions.json');
@@ -31,25 +44,36 @@ if (LFVersions === null) {
 		console.info(`Fetching from Github to ${CACHE_FILE_PATH}…`);
 	}
 
-	const githubMilestones = await fetch('https://api.github.com/repos/LuccaSA/lucca-front/milestones?state=all&sort=due_on&direction=desc');
+	// The API caps page size at 100 and the repo already has >100 milestones, so paginate to the last
+	// page: every referenced version must resolve, not just the 100 most recent.
+	const PER_PAGE = 100;
+	const MAX_PAGES = 20; // Safety bound against an unbounded loop; far exceeds the milestone count.
+	let page = 1;
+	let hasMore = true;
 
-	if (githubMilestones.ok) {
-		const milestones = await githubMilestones.json();
+	while (hasMore && page <= MAX_PAGES) {
+		const githubMilestones = await fetch(
+			`https://api.github.com/repos/LuccaSA/lucca-front/milestones?state=all&sort=due_on&direction=desc&per_page=${PER_PAGE}&page=${page}`,
+		);
 
-		for (const milestone of milestones) {
-			let version = milestone.title;
+		if (!githubMilestones.ok) {
+			break;
+		}
 
-			if (version) {
-				const date = new Date(milestone.due_on);
+		const milestones = await githubMilestones.json();
 
-				// If version doesn't have patch version, add it as .0
-				if (version.split('.').length === 2) {
-					version += '.0';
-				}
+		for (const milestone of milestones) {
+			const version = milestone.title;
 
-				LFVersions[version] = date.toLocaleDateString();
+			// due_on is already ISO 8601 UTC; store as-is (a locale string breaks new Date() outside en-US).
+			// Skip milestones with no due date so they don't resolve to the epoch.
+			if (version && milestone.due_on) {
+				LFVersions[normalizeVersion(version)] = milestone.due_on;
 			}
 		}
+
+		hasMore = milestones.length === PER_PAGE;
+		page++;
 	}
 
 	writeFileSync(CACHE_FILE_PATH, JSON.stringify({ LFVersions, createdAt: Date.now() }), 'utf8');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucca/stylelint-config-prisme",
-  "version": "22.0.0-rc.4",
+  "version": "22.0.0",
   "description": "Lucca Front stylelint configuration",
   "repository": {
     "type": "git",
@@ -23,9 +23,9 @@
   },
   "homepage": "https://github.com/LuccaSA/lucca-front#readme",
   "peerDependencies": {
-    "@stylistic/stylelint-config": "^4.0.0 || ^5.0.0",
-    "@stylistic/stylelint-plugin": "^5.0.0",
-    "stylelint": "^17.4.0",
+    "@stylistic/stylelint-config": "^5.0.0",
+    "@stylistic/stylelint-plugin": "^5.2.1",
+    "stylelint": "^17.14.1",
     "stylelint-config-standard-scss": "^17.0.0"
   }
 }

package/stylelint.config.mjs

@@ -11,7 +11,7 @@ export default {
 			files: ['**/*.scss'],
 			rules: {
 				// Disable for now because of bugs with SCSS files.
-				// SEE https://github.com/stylelint-scss/stylelint-config-standard-scss/issues/252
+				// SEE https://github.com/stylelint-scss/stylelint-config-standard-scss/issues/269
 				'no-invalid-position-declaration': null,
 			},
 		},
@@ -23,6 +23,12 @@ export default {
 			},
 		},
 	],
+	languageOptions: {
+		directionality: {
+			block: 'top-to-bottom',
+			inline: 'left-to-right',
+		},
+	},
 	rules: {
 		// SCSS specific
 		// ============================================================================================
@@ -130,6 +136,14 @@ export default {
 				severity: (property) => getDisallowedData(LFDeprecatedProperties, property).severity,
 			},
 		],
+		'property-layout-mappings': [
+			'flow-relative',
+			{
+				// overflow-x / overflow-y logical equivalents (overflow-inline / overflow-block)
+				// are not yet Baseline widely available (Chrome 135+, Safari 26+).
+				ignoreProperties: ['overflow-x', 'overflow-y'],
+			},
+		],
 		'property-no-unknown': [
 			true,
 			{
@@ -157,13 +171,16 @@ export default {
 				message: (selectorId) => `Expected "${selectorId}" to match pattern #foo(-bar(Baz)*)*`,
 			},
 		],
+		'selector-no-deprecated': true,
 		'selector-pseudo-element-no-unknown': [
 			true,
 			{
 				ignorePseudoElements: ['ng-deep'],
 			},
 		],
+		'unit-layout-mappings': 'flow-relative',
 		'value-keyword-case': null,
+		'value-keyword-layout-mappings': 'flow-relative',
 
 		// Formatting with @stylistic
 		// SEE: https://github.com/stylelint-stylistic/stylelint-stylistic/blob/main/docs/user-guide/rules.md
@@ -183,6 +200,7 @@ export default {
 				alignQuotes: true,
 			},
 		],
+		'@stylistic/no-multiple-whitespaces': null, // Allow people to align values as they wish.
 		'@stylistic/string-quotes': 'single',
 	},
 };

package/stylelintForLF.mjs

@@ -1,25 +1,51 @@
-import LFVersions from './LFVersions.mjs';
+import LFVersions, { normalizeVersion } from './LFVersions.mjs';
 import currentLFVersion from './currentLFVersion.mjs';
 
+/**
+ * @typedef {object} DisallowedObject - Object found in the list of disallowed objects
+ * @property {(RegExp | string)[] | RegExp | string} [objectPattern] - Pattern(s) matching the deprecated element
+ * @property {string} [versionDeprecated] - LF version deprecating the element
+ * @property {string} [versionDeleted] - LF version deleting the element
+ * @property {string} [actions] - Migration actions
+ * @property {object} [urls] - Related URLs
+ * @property {Date} [dateDeprecated] - Deprecation date, added by setDates()
+ * @property {Date} [dateDeleted] - Deletion date, added by setDates()
+ * @property {string} [faultyPattern] - Pattern reported by Stylelint, added by getDisallowedData()
+ */
+
 /**
  * Get all blacklisted elements from all versions.
  *
- * @return {Array[Regex | String]}
+ * @param {DisallowedObject[]} disallowedObjects - List of disallowed objects
+ * @return {(RegExp | string)[]}
  */
 export function getDisallowedObjects(disallowedObjects) {
-	return disallowedObjects.reduce((output, object) => {
-		return output.concat(object.objectPattern);
-	}, []);
+	return disallowedObjects.flatMap((object) => object.objectPattern).filter((pattern) => pattern != null);
 }
 
+// Results are constant per (list, faultyPattern) within a run; Stylelint calls getDisallowedData once for
+// the message and once for the severity of every warning, so memoise to compute each result only once.
+const disallowedDataCache = new WeakMap();
+
 /**
  * Get data related to object.
  *
- * @param {Array[Object{objectPattern, versionDeprecated, versionDeleted}]} disallowedObjects - List of disallowed objects
- * @param {String} faultyPattern - Pattern provided by Stylelint, to check against list of custom patterns
- * @return {{message: String, severity: String}}
+ * @param {DisallowedObject[]} disallowedObjects - List of disallowed objects
+ * @param {string} faultyPattern - Pattern provided by Stylelint, to check against list of custom patterns
+ * @return {{message: string, severity: string}}
  */
 export function getDisallowedData(disallowedObjects, faultyPattern) {
+	let cache = disallowedDataCache.get(disallowedObjects);
+
+	if (!cache) {
+		cache = new Map();
+		disallowedDataCache.set(disallowedObjects, cache);
+	}
+
+	if (cache.has(faultyPattern)) {
+		return cache.get(faultyPattern);
+	}
+
 	let objectData = disallowedObjects.find((haystack) => {
 		// If the patterns are within an array, parse it.
 		if (Array.isArray(haystack.objectPattern)) {
@@ -34,17 +60,21 @@ export function getDisallowedData(disallowedObjects, faultyPattern) {
 	objectData = setDates(objectData);
 	objectData.faultyPattern = faultyPattern;
 
-	return {
+	const result = {
 		message: getMessage(objectData),
 		severity: getSeverity(objectData),
 	};
+
+	cache.set(faultyPattern, result);
+
+	return result;
 }
 
 /**
  * Set deprecation and deletion dates for an object.
  *
- * @param {Object} objectData - Object found in the list of disallowed objects
- * @return {Object}           - objectData with dates.
+ * @param {DisallowedObject} objectData
+ * @return {DisallowedObject}           - objectData with dates.
  */
 function setDates(objectData) {
 	return {
@@ -57,8 +87,8 @@ function setDates(objectData) {
 /**
  * Is the parameter a valid date?
  *
- * @param {*} date - Value to analise
- * @return boolean
+ * @param {*} date - Value to analyse
+ * @return {boolean}
  */
 function isValidDate(date) {
 	return date instanceof Date && !isNaN(date);
@@ -71,8 +101,15 @@ function isValidDate(date) {
  * @return {Date|undefined}
  */
 function getDateForVersion(version) {
-	if (version && version in LFVersions) {
-		const date = new Date(LFVersions[version]);
+	if (!version) {
+		return;
+	}
+
+	// LFVersions keys are normalised; a non-normalised lookup would silently miss the map.
+	const normalizedVersion = normalizeVersion(version);
+
+	if (normalizedVersion in LFVersions) {
+		const date = new Date(LFVersions[normalizedVersion]);
 
 		if (isValidDate(date)) {
 			return date;
@@ -83,23 +120,33 @@ function getDateForVersion(version) {
 /**
  * Compare the faulty pattern with disallowed patterns.
  *
- * @param {String} faultyPattern - faultyPattern returned by Stylelint
- * @param {Array[RegExp | String] | RegExp | String} disallowedPattern - Custom pattern to match
- * @return boolean
+ * @param {string} faultyPattern - faultyPattern returned by Stylelint
+ * @param {(RegExp | string)[] | RegExp | string} disallowedPattern - Custom pattern to match
+ * @return {boolean}
  */
 function comparePatterns(faultyPattern, disallowedPattern) {
-	return typeof disallowedPattern === 'string' ? faultyPattern === disallowedPattern : disallowedPattern.test(faultyPattern);
+	//  A missing pattern never matches: this keeps a broken object from crashing Stylelint.
+	if (disallowedPattern == null) {
+		return false;
+	}
+
+	if (typeof disallowedPattern === 'string') {
+		return faultyPattern === disallowedPattern;
+	}
+
+	return disallowedPattern.test(faultyPattern);
 }
 
 /**
  * Format message based on versions criticity.
  *
- * @param {Object} objectData
- * @return {String}
+ * @param {DisallowedObject} objectData
+ * @return {string}
  */
 function getMessage(objectData) {
+	const status = isDeleted(objectData) ? 'deleted' : 'deprecated';
+
 	let pattern = `${objectData.faultyPattern}`;
-	let status = 'deprecated';
 	let messageDeprecated = '';
 	let messageDeleted = '';
 	let messageLFVersionWarning = '';
@@ -119,10 +166,6 @@ function getMessage(objectData) {
 		const daysLeft = Math.ceil((objectData.dateDeleted.getTime() - new Date().getTime()) / (1000 * 60 * 60 * 24));
 		const dayString = new Intl.RelativeTimeFormat().format(daysLeft, 'day');
 
-		if (daysLeft <= 0) {
-			status = 'deleted';
-		}
-
 		messageDeleted = ` | until ${objectData.dateDeleted.toLocaleDateString()} (${dayString}, LF ${objectData.versionDeleted})`;
 	}
 
@@ -130,23 +173,66 @@ function getMessage(objectData) {
 }
 
 /**
- * Get severity based on version used.
+ * Is the element deleted for the current LF version?
+ * Single source of truth for getMessage() and getSeverity().
+ * Compares dot-separated versions part by part so the most significant difference decides.
+ * A plain string comparison would misorder them (e.g. `9.0.0` > `22.0.0`).
  *
- * @param {String} objectData
- * @return {'warning'|'error'}
+ * @param {DisallowedObject} objectData
+ * @return {boolean} - true if the current LF version is at or past versionDeleted
  */
-function getSeverity(objectData) {
-	if (!currentLFVersion) {
-		return 'warning';
+function isDeleted(objectData) {
+	if (!currentLFVersion || !objectData.versionDeleted) {
+		return false;
+	}
+
+	const [currentParts, currentPrerelease] = parseVersion(currentLFVersion);
+	const [deletedParts, deletedPrerelease] = parseVersion(objectData.versionDeleted);
+	const length = Math.max(currentParts.length, deletedParts.length);
+
+	for (let i = 0; i < length; i++) {
+		const diff = (parseInt(currentParts[i], 10) || 0) - (parseInt(deletedParts[i], 10) || 0);
+
+		if (diff < 0) {
+			return false;
+		}
+
+		if (diff > 0) {
+			return true;
+		}
 	}
 
-	if (!objectData.versionDeleted) {
-		return 'warning';
+	// Equal release versions: per semver, a prerelease sorts before its release (`22.0.0-rc.1` < `22.0.0`).
+	if (currentPrerelease && !deletedPrerelease) {
+		return false;
 	}
 
-	if (currentLFVersion < objectData.versionDeleted) {
-		return 'warning';
+	return true;
+}
+
+/**
+ * Split a version into its numeric release parts and its prerelease tag.
+ * e.g. `22.0.0-rc.1` → [['22', '0', '0'], 'rc.1']
+ *
+ * @param {string} version - semver formatted LF version
+ * @return {[string[], string]}
+ */
+function parseVersion(version) {
+	const hyphenIndex = version.indexOf('-');
+
+	if (hyphenIndex === -1) {
+		return [version.split('.'), ''];
 	}
 
-	return 'error';
+	return [version.slice(0, hyphenIndex).split('.'), version.slice(hyphenIndex + 1)];
+}
+
+/**
+ * Get severity based on version used.
+ *
+ * @param {DisallowedObject} objectData
+ * @return {'warning'|'error'}
+ */
+function getSeverity(objectData) {
+	return isDeleted(objectData) ? 'error' : 'warning';
 }