[BUGFIX] Ensure valid position after AddRule

This is the backport of #1263, #1262 and #1265.

Since `getLineNo()` and `getColNo()`, which always returned an `int`, are
deprecated, using their replacements, which may return `null`, for `Rule`s in
a `RuleSet` may cause issues.
The fixes ensure that such `Rule`s will always have a valid position, so the
new methods will not return `null` in that situation, and a straightforward
replacement can be done.

Part of #974.

Author: JakeQZ

CHANGELOG.md

@@ -15,7 +15,7 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 - Methods `getLineNumber` and `getColumnNumber` which return a nullable `int`
   for the following classes:
   `Comment`, `CSSList`, `SourceException`, `Charset`, `CSSNamespace`, `Import`,
-  `Rule`, `DeclarationBlock`, `RuleSet`, `CSSFunction`, `Value` (#1225)
+  `Rule`, `DeclarationBlock`, `RuleSet`, `CSSFunction`, `Value` (#1225, #1263)
 - `Positionable` interface for CSS items that may have a position
   (line and perhaps column number) in the parsed CSS (#1221)
 
@@ -55,6 +55,10 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ### Fixed
 
+- Set line number when `RuleSet::addRule()` called with only column number set
+  (#1265)
+- Ensure first rule added with `RuleSet::addRule()` has valid position (#1262)
+
 ## 8.8.0: Bug fixes and deprecations
 
 ### Added

src/RuleSet/RuleSet.php

@@ -121,14 +121,19 @@ public function addRule(Rule $oRule, $oSibling = null)
                 $oRule->setPosition($oSibling->getLineNo(), $oSibling->getColNo() - 1);
             }
         }
-        if ($oRule->getLineNo() === 0 && $oRule->getColNo() === 0) {
+        if ($oRule->getLineNumber() === null) {
             //this node is added manually, give it the next best line
+            $columnNumber = $ruleToAdd->getColumnNumber() ?? 0;
             $rules = $this->getRules();
             $pos = count($rules);
             if ($pos > 0) {
                 $last = $rules[$pos - 1];
-                $oRule->setPosition($last->getLineNo() + 1, 0);
+                $oRule->setPosition($last->getLineNo() + 1, $columnNumber);
+            } else {
+                $oRule->setPosition(1, $columnNumber);
             }
+        } elseif ($ruleToAdd->getColumnNumber() === null) {
+            $ruleToAdd->setPosition($ruleToAdd->getLineNumber(), 0);
         }
 
         array_splice($this->aRules[$sRule], $iPosition, 0, [$oRule]);

tests/Unit/RuleSet/RuleSetTest.php

@@ -77,10 +77,6 @@ public function addRuleWithoutSiblingAddsRuleAfterInitialRulesAndSetsValidLineAn
         array $initialPropertyNames,
         string $propertyNameToAdd
     ) {
-        if ($initialPropertyNames === []) {
-            self::markTestSkipped('currently broken - first rule added does not have valid line number set');
-        }
-
         $subject = new ConcreteRuleSet();
         $ruleToAdd = new Rule($propertyNameToAdd);
         self::setRulesFromPropertyNames($subject, $initialPropertyNames);
@@ -106,8 +102,6 @@ public function addRuleWithOnlyLineNumberAddsRuleAndSetsColumnNumberPreservingLi
         array $initialPropertyNames,
         string $propertyNameToAdd
     ) {
-        self::markTestSkipped('currently broken - does not set column number');
-
         $subject = new ConcreteRuleSet();
         $ruleToAdd = new Rule($propertyNameToAdd);
         $ruleToAdd->setPosition(42);
@@ -128,20 +122,19 @@ public function addRuleWithOnlyLineNumberAddsRuleAndSetsColumnNumberPreservingLi
      *
      * @param list<string> $initialPropertyNames
      */
-    public function addRuleWithOnlyColumnNumberAddsRuleAndSetsLineNumberPreservingColumnNumber(
+    public function addRuleWithOnlyColumnNumberAddsRuleAfterInitialRulesAndSetsLineNumberPreservingColumnNumber(
         array $initialPropertyNames,
         string $propertyNameToAdd
     ) {
-        self::markTestSkipped('currently broken - does not preserve column number');
-
         $subject = new ConcreteRuleSet();
         $ruleToAdd = new Rule($propertyNameToAdd);
         $ruleToAdd->setPosition(null, 42);
         self::setRulesFromPropertyNames($subject, $initialPropertyNames);
 
         $subject->addRule($ruleToAdd);
 
-        self::assertContains($ruleToAdd, $subject->getRules());
+        $rules = $subject->getRules();
+        self::assertSame($ruleToAdd, \end($rules));
         self::assertInternalType('int', $ruleToAdd->getLineNumber(), 'line number not set');
         self::assertGreaterThanOrEqual(1, $ruleToAdd->getLineNumber(), 'line number not valid');
         self::assertSame(42, $ruleToAdd->getColumnNumber(), 'column number not preserved');