[BUGFIX] Make class aliases available for consumers

Fixes #1532

Author: oliverklee

class-aliases/aliases.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+use Sabberworm\CSS\Rule\Rule;
+use Sabberworm\CSS\RuleSet\RuleContainer;
+use Sabberworm\CSS\Property\Declaration;
+use Sabberworm\CSS\RuleSet\DeclarationList;
+
+use function Safe\class_alias;
+
+/**
+ * @deprecated in v9.2, will be removed in v10.0.  Use `Property\Declaration` instead, which is a direct replacement.
+ */
+class_alias(Declaration::class, Rule::class);
+
+/**
+ * @deprecated in v9.2, will be removed in v10.0.  Use `DeclarationList` instead, which is a direct replacement.
+ */
+class_alias(DeclarationList::class, RuleContainer::class);

composer.json

@@ -46,7 +46,10 @@
     "autoload": {
         "psr-4": {
             "Sabberworm\\CSS\\": "src/"
-        }
+        },
+        "files": [
+            "class-aliases/aliases.php"
+        ]
     },
     "autoload-dev": {
         "psr-4": {
@@ -76,9 +79,9 @@
         "check:dynamic": [
             "@check:tests"
         ],
-        "check:php:codesniffer": "phpcs --standard=config/phpcs.xml bin config src tests",
-        "check:php:fixer": "\"./.phive/php-cs-fixer\" --config=config/php-cs-fixer.php fix --dry-run -v --show-progress=dots --diff bin config src tests",
-        "check:php:lint": "parallel-lint bin config src tests",
+        "check:php:codesniffer": "phpcs --standard=config/phpcs.xml bin class-aliases config src tests",
+        "check:php:fixer": "\"./.phive/php-cs-fixer\" --config=config/php-cs-fixer.php fix --dry-run -v --show-progress=dots --diff bin class-aliases config src tests",
+        "check:php:lint": "parallel-lint bin class-aliases config src tests",
         "check:php:rector": "rector process --no-progress-bar --dry-run --config=config/rector.php",
         "check:php:stan": "phpstan --no-progress --configuration=config/phpstan.neon",
         "check:static": [
@@ -105,8 +108,8 @@
             "@fix:php:codesniffer",
             "@fix:php:fixer"
         ],
-        "fix:php:codesniffer": "phpcbf --standard=config/phpcs.xml bin config src tests",
-        "fix:php:fixer": "\"./.phive/php-cs-fixer\" --config=config/php-cs-fixer.php fix bin config src tests",
+        "fix:php:codesniffer": "phpcbf --standard=config/phpcs.xml bin class-aliases config src tests",
+        "fix:php:fixer": "\"./.phive/php-cs-fixer\" --config=config/php-cs-fixer.php fix bin class-aliases config src tests",
         "fix:php:rector": "rector process --config=config/rector.php",
         "phpstan:baseline": "phpstan --configuration=config/phpstan.neon --generate-baseline=config/phpstan-baseline.neon --allow-empty-baseline"
     },

config/phpstan.neon

@@ -15,10 +15,6 @@ parameters:
     - %currentWorkingDirectory%/src/
     - %currentWorkingDirectory%/tests/
 
-  bootstrapFiles:
-    - %currentWorkingDirectory%/src/Rule/Rule.php
-    - %currentWorkingDirectory%/src/RuleSet/RuleContainer.php
-
   type_perfect:
     no_mixed_property: true
     no_mixed_caller: true

config/rector.php

@@ -11,6 +11,7 @@
     ->withPaths(
         [
             __DIR__ . '/../bin',
+            __DIR__ . '/../class-aliases',
             __DIR__ . '/../config',
             __DIR__ . '/../src',
             __DIR__ . '/../tests',

phpunit.xml

@@ -18,6 +18,7 @@
 
     <filter>
         <whitelist>
+            <directory suffix=".php">class-alias</directory>
             <directory suffix=".php">src</directory>
         </whitelist>
     </filter>