From 6d232b3a5190d5f33959170eabcef7736e3238c0 Mon Sep 17 00:00:00 2001
From: Oliver Klee <github@oliverklee.de>
Date: Sun, 27 Jun 2021 09:36:25 +0200
Subject: [PATCH] Add type annotations for `OutputFormatter`

---
 src/OutputFormatter.php | 76 +++++++++++++++++++++++++++++++++++++++--
 1 file changed, 74 insertions(+), 2 deletions(-)

diff --git a/src/OutputFormatter.php b/src/OutputFormatter.php
index 6abb9c3e..535feca7 100644
--- a/src/OutputFormatter.php
+++ b/src/OutputFormatter.php
@@ -6,6 +6,9 @@
 
 class OutputFormatter
 {
+    /**
+     * @var OutputFormat
+     */
     private $oFormat;
 
     public function __construct(OutputFormat $oFormat)
@@ -13,6 +16,12 @@ public function __construct(OutputFormat $oFormat)
         $this->oFormat = $oFormat;
     }
 
+    /**
+     * @param string $sName
+     * @param string|null $sType
+     *
+     * @return string
+     */
     public function space($sName, $sType = null)
     {
         $sSpaceString = $this->oFormat->get("Space$sName");
@@ -28,68 +37,112 @@ public function space($sName, $sType = null)
         return $this->prepareSpace($sSpaceString);
     }
 
+    /**
+     * @return string
+     */
     public function spaceAfterRuleName()
     {
         return $this->space('AfterRuleName');
     }
 
+    /**
+     * @return string
+     */
     public function spaceBeforeRules()
     {
         return $this->space('BeforeRules');
     }
 
+    /**
+     * @return string
+     */
     public function spaceAfterRules()
     {
         return $this->space('AfterRules');
     }
 
+    /**
+     * @return string
+     */
     public function spaceBetweenRules()
     {
         return $this->space('BetweenRules');
     }
 
+    /**
+     * @return string
+     */
     public function spaceBeforeBlocks()
     {
         return $this->space('BeforeBlocks');
     }
 
+    /**
+     * @return string
+     */
     public function spaceAfterBlocks()
     {
         return $this->space('AfterBlocks');
     }
 
+    /**
+     * @return string
+     */
     public function spaceBetweenBlocks()
     {
         return $this->space('BetweenBlocks');
     }
 
+    /**
+     * @return string
+     */
     public function spaceBeforeSelectorSeparator()
     {
         return $this->space('BeforeSelectorSeparator');
     }
 
+    /**
+     * @return string
+     */
     public function spaceAfterSelectorSeparator()
     {
         return $this->space('AfterSelectorSeparator');
     }
 
+    /**
+     * @param string $sSeparator
+     *
+     * @return string
+     */
     public function spaceBeforeListArgumentSeparator($sSeparator)
     {
         return $this->space('BeforeListArgumentSeparator', $sSeparator);
     }
 
+    /**
+     * @param string $sSeparator
+     *
+     * @return string
+     */
     public function spaceAfterListArgumentSeparator($sSeparator)
     {
         return $this->space('AfterListArgumentSeparator', $sSeparator);
     }
 
+    /**
+     * @return string
+     */
     public function spaceBeforeOpeningBrace()
     {
         return $this->space('BeforeOpeningBrace');
     }
 
     /**
-     * Runs the given code, either swallowing or passing exceptions, depending on the  bIgnoreExceptions  setting.
+     * Runs the given code, either swallowing or passing exceptions, depending on the `bIgnoreExceptions` setting.
+     *
+     * @param string $cCode the name of the function to call
+     *
+     * @return string|null
      */
     public function safely($cCode)
     {
@@ -107,7 +160,13 @@ public function safely($cCode)
     }
 
     /**
-     * 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 instead of `__toString()`.
+     *
+     * @param string $sSeparator
+     * @param array<array-key, Renderable|string> $aValues
+     * @param bool $bIncreaseLevel
+     *
+     * @return string
      */
     public function implode($sSeparator, array $aValues, $bIncreaseLevel = false)
     {
@@ -132,6 +191,11 @@ public function implode($sSeparator, array $aValues, $bIncreaseLevel = false)
         return $sResult;
     }
 
+    /**
+     * @param string $sString
+     *
+     * @return string
+     */
     public function removeLastSemicolon($sString)
     {
         if ($this->oFormat->get('SemicolonAfterLastRule')) {
@@ -147,11 +211,19 @@ public function removeLastSemicolon($sString)
         return implode(';', $sString);
     }
 
+    /**
+     * @param string $sSpaceString
+     *
+     * @return string
+     */
     private function prepareSpace($sSpaceString)
     {
         return str_replace("\n", "\n" . $this->indent(), $sSpaceString);
     }
 
+    /**
+     * @return string
+     */
     private function indent()
     {
         return str_repeat($this->oFormat->sIndentation, $this->oFormat->level());