Remove spread support from Features::include()

Author: dlh01

CHANGELOG.md

@@ -6,15 +6,13 @@ This library adheres to [Semantic Versioning](https://semver.org/) and [Keep a C
 
 ### Added
 
-- `Widget_Feature` feature. #32
-- `Widget_Features` feature. #32
-- Ignore `.idea` dir from source control for PHPStorm users.
-- CI: support PHP 8.4. #35
+- `Widget_Feature` feature.
+- `Widget_Features` feature.
+- PHP 8.4 support.
 
 ### Changed
 
-- PHPCS: The minimum PHP version is now 8.2.
-- Unit test: `WidgetFeatureTest` test works por PHP 8.3 and 8.4.
+- `Features::include()` no longer accepts a spread of individual `Feature` instances. Use something more specific like `Group` or `Ordered` to include multiple features at once.
 
 ## 4.0.0
 

docs/features.md

@@ -6,7 +6,7 @@ The `Features` interface describes multiple project features. This interface ext
 
 ```php
 interface Features extends Feature{
-	public function include( Feature ...$features ): void;
+	public function include( Feature $feature ): void;
 }
 ```
 

src/features/class-group.php

@@ -40,11 +40,11 @@ public function boot(): void {
 	}
 
 	/**
-	 * Include features.
+	 * Include a feature.
 	 *
-	 * @param Feature ...$features Features to include.
+	 * @param Feature $feature Feature to include.
 	 */
-	public function include( Feature ...$features ): void {
-		array_push( $this->features, ...$features );
+	public function include( Feature $feature ): void {
+		$this->features[] = $feature;
 	}
 }

src/types/interface-features.php

@@ -12,9 +12,9 @@
  */
 interface Features extends Feature {
 	/**
-	 * Include features.
+	 * Include a feature.
 	 *
-	 * @param Feature ...$features Features to include.
+	 * @param Feature $feature Feature to include.
 	 */
-	public function include( Feature ...$features ): void;
+	public function include( Feature $feature ): void;
 }