[TASK] Deprecate greedy calculation of selector specificity (#1022)

oliverklee · web-flow · commit a9fede8577c5 · 2025-02-27T18:49:23.000Z
This constructor parameter will no longer be used; having the specificity calculation always done lazily is not a problem. This is the V8.x backport of #1018.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -17,6 +17,7 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ### Deprecated
 
+- Deprecate greedy calculation of selector specificity (#1018)
 - Deprecate the IE hack in `Rule` (#993, #1003)
 - `OutputFormat` properties for space around list separators as an array (#880)
 - Deprecate `OutputFormat::level()` (#870)
diff --git a/src/Property/Selector.php b/src/Property/Selector.php
@@ -88,7 +88,7 @@ public static function isValid($sSelector)
 
     /**
      * @param string $sSelector
-     * @param bool $bCalculateSpecificity
+     * @param bool $bCalculateSpecificity @deprecated since V8.8.0, will be removed in V9.0.0
      */
     public function __construct($sSelector, $bCalculateSpecificity = false)
     {

Original file line number	Diff line number	Diff line change
`@@ -88,7 +88,7 @@ public static function isValid($sSelector)`
`88`	`88`
`89`	`89`	`/**`
`90`	`90`	`* @param string $sSelector`
`91`		`- * @param bool $bCalculateSpecificity`
	`91`	`+ * @param bool $bCalculateSpecificity @deprecated since V8.8.0, will be removed in V9.0.0`
`92`	`92`	`*/`
`93`	`93`	`public function __construct($sSelector, $bCalculateSpecificity = false)`
`94`	`94`	`{`