From f701e4b1a4673901dce995aead12dad11d01fbd1 Mon Sep 17 00:00:00 2001
From: Oliver Klee <github@oliverklee.de>
Date: Tue, 17 Feb 2026 23:22:23 +0100
Subject: [PATCH 1/3] [BUGFIX] Make class aliases available for consumers

Fixes #1532
---
 class-aliases/aliases.php     | 20 ++++++++++++++++++++
 composer.json                 | 15 +++++++++------
 config/phpstan.neon           |  4 ----
 config/rector.php             |  1 +
 src/Rule/Rule.php             | 14 --------------
 src/RuleSet/RuleContainer.php | 12 ------------
 6 files changed, 30 insertions(+), 36 deletions(-)
 create mode 100644 class-aliases/aliases.php
 delete mode 100644 src/Rule/Rule.php
 delete mode 100644 src/RuleSet/RuleContainer.php

diff --git a/class-aliases/aliases.php b/class-aliases/aliases.php
new file mode 100644
index 000000000..ceecd4770
--- /dev/null
+++ b/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);
diff --git a/composer.json b/composer.json
index c871f23b7..0b436c8df 100644
--- a/composer.json
+++ b/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"
     },
diff --git a/config/phpstan.neon b/config/phpstan.neon
index 84416ade1..55ba682af 100644
--- a/config/phpstan.neon
+++ b/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
diff --git a/config/rector.php b/config/rector.php
index cf501b19c..dfdf6f6f0 100644
--- a/config/rector.php
+++ b/config/rector.php
@@ -11,6 +11,7 @@
     ->withPaths(
         [
             __DIR__ . '/../bin',
+            __DIR__ . '/../class-aliases',
             __DIR__ . '/../config',
             __DIR__ . '/../src',
             __DIR__ . '/../tests',
diff --git a/src/Rule/Rule.php b/src/Rule/Rule.php
deleted file mode 100644
index bed19cf2a..000000000
--- a/src/Rule/Rule.php
+++ /dev/null
@@ -1,14 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Sabberworm\CSS\Rule;
-
-use Sabberworm\CSS\Property\Declaration;
-
-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);
diff --git a/src/RuleSet/RuleContainer.php b/src/RuleSet/RuleContainer.php
deleted file mode 100644
index daaf13090..000000000
--- a/src/RuleSet/RuleContainer.php
+++ /dev/null
@@ -1,12 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Sabberworm\CSS\RuleSet;
-
-use function Safe\class_alias;
-
-/**
- * @deprecated in v9.2, will be removed in v10.0.  Use `DeclarationList` instead, which is a direct replacement.
- */
-class_alias(DeclarationList::class, RuleContainer::class);

From 7640d311cb5243384a3f6ab27e02ca590e83ffe0 Mon Sep 17 00:00:00 2001
From: Oliver Klee <github@oliverklee.de>
Date: Wed, 18 Feb 2026 17:15:27 +0100
Subject: [PATCH 2/3] Sort the imports

---
 class-aliases/aliases.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/class-aliases/aliases.php b/class-aliases/aliases.php
index ceecd4770..f3db52cd1 100644
--- a/class-aliases/aliases.php
+++ b/class-aliases/aliases.php
@@ -2,10 +2,10 @@
 
 declare(strict_types=1);
 
-use Sabberworm\CSS\Rule\Rule;
-use Sabberworm\CSS\RuleSet\RuleContainer;
 use Sabberworm\CSS\Property\Declaration;
+use Sabberworm\CSS\Rule\Rule;
 use Sabberworm\CSS\RuleSet\DeclarationList;
+use Sabberworm\CSS\RuleSet\RuleContainer;
 
 use function Safe\class_alias;
 

From 4909d8cf2fd30a63122e2c593219c87232dbebd6 Mon Sep 17 00:00:00 2001
From: Oliver Klee <github@oliverklee.de>
Date: Wed, 18 Feb 2026 17:20:43 +0100
Subject: [PATCH 3/3] Keep the original files

---
 class-aliases/aliases.php     | 20 --------------------
 composer.json                 | 13 +++++++------
 config/rector.php             |  1 -
 src/Rule/Rule.php             | 14 ++++++++++++++
 src/RuleSet/RuleContainer.php | 12 ++++++++++++
 5 files changed, 33 insertions(+), 27 deletions(-)
 delete mode 100644 class-aliases/aliases.php
 create mode 100644 src/Rule/Rule.php
 create mode 100644 src/RuleSet/RuleContainer.php

diff --git a/class-aliases/aliases.php b/class-aliases/aliases.php
deleted file mode 100644
index f3db52cd1..000000000
--- a/class-aliases/aliases.php
+++ /dev/null
@@ -1,20 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-use Sabberworm\CSS\Property\Declaration;
-use Sabberworm\CSS\Rule\Rule;
-use Sabberworm\CSS\RuleSet\DeclarationList;
-use Sabberworm\CSS\RuleSet\RuleContainer;
-
-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);
diff --git a/composer.json b/composer.json
index 0b436c8df..6fbb7909f 100644
--- a/composer.json
+++ b/composer.json
@@ -48,7 +48,8 @@
             "Sabberworm\\CSS\\": "src/"
         },
         "files": [
-            "class-aliases/aliases.php"
+            "src/Rule/Rule.php",
+            "src/RuleSet/RuleContainer.php"
         ]
     },
     "autoload-dev": {
@@ -79,9 +80,9 @@
         "check:dynamic": [
             "@check: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: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:rector": "rector process --no-progress-bar --dry-run --config=config/rector.php",
         "check:php:stan": "phpstan --no-progress --configuration=config/phpstan.neon",
         "check:static": [
@@ -108,8 +109,8 @@
             "@fix:php:codesniffer",
             "@fix:php:fixer"
         ],
-        "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: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:rector": "rector process --config=config/rector.php",
         "phpstan:baseline": "phpstan --configuration=config/phpstan.neon --generate-baseline=config/phpstan-baseline.neon --allow-empty-baseline"
     },
diff --git a/config/rector.php b/config/rector.php
index dfdf6f6f0..cf501b19c 100644
--- a/config/rector.php
+++ b/config/rector.php
@@ -11,7 +11,6 @@
     ->withPaths(
         [
             __DIR__ . '/../bin',
-            __DIR__ . '/../class-aliases',
             __DIR__ . '/../config',
             __DIR__ . '/../src',
             __DIR__ . '/../tests',
diff --git a/src/Rule/Rule.php b/src/Rule/Rule.php
new file mode 100644
index 000000000..bed19cf2a
--- /dev/null
+++ b/src/Rule/Rule.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Sabberworm\CSS\Rule;
+
+use Sabberworm\CSS\Property\Declaration;
+
+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);
diff --git a/src/RuleSet/RuleContainer.php b/src/RuleSet/RuleContainer.php
new file mode 100644
index 000000000..daaf13090
--- /dev/null
+++ b/src/RuleSet/RuleContainer.php
@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Sabberworm\CSS\RuleSet;
+
+use function Safe\class_alias;
+
+/**
+ * @deprecated in v9.2, will be removed in v10.0.  Use `DeclarationList` instead, which is a direct replacement.
+ */
+class_alias(DeclarationList::class, RuleContainer::class);