[TASK] Deprecate __toString() (#1006)

Part of #998

Author: oliverklee

CHANGELOG.md

@@ -32,6 +32,7 @@ Please also have a look at our
 
 ### Deprecated
 
+- Deprecate `__toString()` (#1006)
 - `OutputFormat` properties for space around list separators as an array (#880)
 
 ### Removed

src/CSSList/AtRuleBlockList.php

@@ -42,6 +42,9 @@ public function atRuleArgs(): string
         return $this->arguments;
     }
 
+    /**
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
+     */
     public function __toString(): string
     {
         return $this->render(new OutputFormat());

src/CSSList/CSSList.php

@@ -402,6 +402,9 @@ public function removeDeclarationBlockBySelector($selectors, $removeAll = false)
         }
     }
 
+    /**
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
+     */
     public function __toString(): string
     {
         return $this->render(new OutputFormat());

src/CSSList/KeyFrame.php

@@ -51,6 +51,9 @@ public function getAnimationName()
         return $this->animationName;
     }
 
+    /**
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
+     */
     public function __toString(): string
     {
         return $this->render(new OutputFormat());

src/Comment/Comment.php

@@ -50,6 +50,9 @@ public function setComment(string $commentText): void
         $this->commentText = $commentText;
     }
 
+    /**
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
+     */
     public function __toString(): string
     {
         return $this->render(new OutputFormat());

src/OutputFormatter.php

@@ -159,7 +159,7 @@ public function safely(callable $callable): ?string
     }
 
     /**
-     * Clone of the `implode` function, but calls `render` with the current output format instead of `__toString()`.
+     * Clone of the `implode` function, but calls `render` with the current output format.
      *
      * @param array<array-key, Renderable|string> $values
      */

src/Property/CSSNamespace.php

@@ -54,6 +54,9 @@ public function getLineNo(): int
         return $this->lineNumber;
     }
 
+    /**
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
+     */
     public function __toString(): string
     {
         return $this->render(new OutputFormat());

src/Property/Charset.php

@@ -71,6 +71,9 @@ public function getCharset()
         return $this->charset->getString();
     }
 
+    /**
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
+     */
     public function __toString(): string
     {
         return $this->render(new OutputFormat());

src/Property/Import.php

@@ -72,6 +72,9 @@ public function getLocation()
         return $this->location;
     }
 
+    /**
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
+     */
     public function __toString(): string
     {
         return $this->render(new OutputFormat());

src/Property/Selector.php

@@ -113,6 +113,9 @@ public function setSelector($selector): void
         $this->specificity = null;
     }
 
+    /**
+     * @deprecated in V8.8.0, will be removed in V9.0.0. Use `render` instead.
+     */
     public function __toString(): string
     {
         return $this->getSelector();