Add clear option to redraw

Author: AydinHassan

README.md

@@ -415,6 +415,27 @@ $menu = (new CliMenuBuilder)
 $menu->open();
 ```
 
+If you change the menu drastically, such as making the width smaller, when it redraws you might see artifacts of the previous draw
+as `redraw` only draws over the top of the terminal. If this happens you can pass `true` to `redraw` and it will first clear
+the terminal before redrawing.
+
+```php
+$itemCallable = function (CliMenu $menu) {
+    $menu->getStyle()->setWidth($menu->getStyle()->getWidth() === 100 ? 80 : 100);
+    $menu->redraw(true);
+};
+
+$menu = (new CliMenuBuilder)
+    ->setTitle('Basic CLI Menu')
+    ->addItem('First Item', $itemCallable)
+    ->addItem('Second Item', $itemCallable)
+    ->addItem('Third Item', $itemCallable)
+    ->addLineBreak('-')
+    ->build();
+
+$menu->open();
+```
+
 #### Getting, Removing and Adding items
 
 You can also interact with the menu items in an action. You can add, remove and replace items. If you do this, you 

examples/crazy-redraw.php

@@ -46,7 +46,7 @@ function (MenuItemInterface $item) use ($menu) {
         }
     );
 
-    $menu->redraw();
+    $menu->redraw(true);
 };
 
 $menu = (new CliMenuBuilder)

src/CliMenu.php

@@ -307,10 +307,18 @@ protected function executeCurrentItem() : void
     }
 
     /**
+     * If true we clear the whole terminal screen, useful
+     * for example when reducing the width of the menu, to not
+     * leave leftovers of the previous wider menu.
+     *
      * Redraw the menu
      */
-    public function redraw() : void
+    public function redraw(bool $clear = false) : void
     {
+        if ($clear) {
+            $this->terminal->clear();
+        }
+        
         $this->assertOpen();
         $this->draw();
     }

test/CliMenuTest.php

@@ -165,6 +165,58 @@ public function testReDrawReDrawsImmediately() : void
         static::assertStringEqualsFile($this->getTestFile(), $this->output->fetch());
     }
 
+    public function testRedrawClearsTerminalFirstIfOptionIsPassed() : void
+    {
+        $terminal = $this->createMock(Terminal::class);
+        $terminal->expects($this->any())
+            ->method('isInteractive')
+            ->willReturn(true);
+
+        $terminal->expects($this->any())
+            ->method('getWidth')
+            ->willReturn(80);
+
+        $terminal->expects($this->any())
+            ->method('write')
+            ->will($this->returnCallback(function ($buffer) {
+                $this->output->write($buffer);
+            }));
+        
+        $terminal->expects($this->exactly(3))
+            ->method('read')
+            ->willReturn("\n", "\n", "\n");
+        
+        $terminal->expects($this->atLeast(2))
+            ->method('clear');
+
+        $style = $this->getStyle($terminal);
+        $style->setWidth(70);
+
+        $hits = 0;
+        $item = new SelectableItem('Item 1', function (CliMenu $menu) use (&$hits) {
+            if ($hits === 0) {
+                $menu->getStyle()->setWidth(50);
+                $menu->redraw(true);
+            }
+
+            if ($hits === 1) {
+                $menu->getStyle()->setWidth(70);
+                $menu->redraw(true);
+            }
+            
+            if ($hits === 2) {
+                $menu->close();
+            }
+            
+            $hits++;
+        });
+
+        $menu = new CliMenu('PHP School FTW', [$item], $terminal, $style);
+        $menu->open();
+
+        static::assertStringEqualsFile($this->getTestFile(), $this->output->fetch());
+    }
+
     public function testGetItems() : void
     {
         $item1 = new LineBreakItem();

test/res/testRedrawClearsTerminalFirstIfOptionIsPassed.txt

@@ -0,0 +1,27 @@
+
+
+                                                                        
+    PHP School FTW                                                      
+    ==================================================================  
+    ● Item 1                                                            
+                                                                        
+
+
+
+
+                                                    
+    PHP School FTW                                  
+    ==============================================  
+    ● Item 1                                        
+                                                    
+
+
+
+
+                                                                        
+    PHP School FTW                                                      
+    ==================================================================  
+    ● Item 1                                                            
+                                                                        
+
+