Output Layer Implementation

composer.json

@@ -11,8 +11,11 @@
   ],
   "require": {
     "php": "^8.1",
+    "ext-readline": "*",
     "filp/whoops": "^2.15",
-    "minicli/mini-plugin": "dev-main"
+    "league/plates": "^3.5",
+    "minicli/mini-plugin": "dev-main",
+    "nunomaduro/termwind": "^1.15"
   },
   "require-dev": {
     "laravel/pint": "^1.10",

src/Configuration/Config.php

@@ -4,44 +4,97 @@
 
 namespace Minicli\Framework\Configuration;
 
+use Minicli\Framework\Contracts\Output\EngineContract;
+use Minicli\Framework\Contracts\Output\PrinterContract;
 use Minicli\Framework\Contracts\Theme\ThemeContract;
 
 final class Config
 {
     /**
      * @param string $path
+     * @param string $views
      * @param class-string<ThemeContract>|null $theme
+     * @param class-string<PrinterContract>|null $printer
+     * @param class-string<EngineContract>|null $engine
      * @param bool $debug
      */
     public function __construct(
         private readonly string $path,
+        private readonly string $views,
         private readonly ?string $theme = null,
+        private readonly ?string $printer = null,
+        private readonly ?string $engine = null,
         private readonly bool $debug = false,
     ) {
     }
 
     /**
-     * @return array{path:string,theme:class-string<ThemeContract>|null,debug:bool}
+     * @return array{path:string,views:string,theme:class-string<ThemeContract>|null,debug:bool}
      */
     public function toArray(): array
     {
         return [
             'path' => $this->path,
+            'views' => $this->views,
             'theme' => $this->theme,
+            'printer' => $this->printer,
+            'engine' => $this->engine,
             'debug' => $this->debug,
         ];
     }
 
     /**
-     * @param array{path:string,theme:class-string<ThemeContract>|null,debug:bool|null} $data
+     * @param array{path:string,views:string,theme:class-string<ThemeContract>|null,printer:class-string<PrinterContract>|null,engine:class-string<EngineContract>|null,debug:bool|null} $data
      * @return Config
      */
     public static function make(array $data): Config
     {
         return new Config(
             path: $data['path'],
+            views: $data['views'],
             theme: $data['theme'],
+            printer: $data['printer'],
+            engine: $data['engine'],
             debug: $data['debug'] ?? false,
         );
     }
+
+    public function path(): string
+    {
+        return $this->path;
+    }
+
+    public function views(): string
+    {
+        return $this->views;
+    }
+
+    /**
+     * @return class-string<ThemeContract>|null
+     */
+    public function theme(): ?string
+    {
+        return $this->theme;
+    }
+
+    /**
+     * @return class-string<PrinterContract>|null
+     */
+    public function printer(): ?string
+    {
+        return $this->printer;
+    }
+
+    /**
+     * @return class-string<EngineContract>|null
+     */
+    public function engine(): ?string
+    {
+        return $this->engine;
+    }
+
+    public function debug(): bool
+    {
+        return $this->debug;
+    }
 }

src/Contracts/Output/EngineContract.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Minicli\Framework\Contracts\Output;
+
+use Minicli\Framework\Output\Table;
+
+interface EngineContract
+{
+    public function print(string $message): void;
+
+    public function lineBreak(): void;
+
+    public function table(Table $table): void;
+
+    public function ask(string $question, string $method = 'default'): string;
+
+    public function default(string $message): void;
+
+    public function alt(string $message): void;
+
+    public function error(string $message): void;
+
+    public function errorAlt(string $message): void;
+
+    public function warning(string $message): void;
+
+    public function warningAlt(string $message): void;
+
+    public function success(string $message): void;
+
+    public function successAlt(string $message): void;
+
+    public function info(string $message): void;
+
+    public function infoAlt(string $message): void;
+
+    public function bold(string $message): void;
+
+    public function dim(string $message): void;
+
+    public function italic(string $message): void;
+
+    public function underline(string $message): void;
+
+    public function invert(string $message): void;
+}

src/Contracts/Theme/TermwindThemeContract.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Minicli\Framework\Contracts\Theme;
+
+interface TermwindThemeContract extends ThemeContract
+{
+}

src/Exceptions/MissingParametersException.php

@@ -11,7 +11,7 @@ final class MissingParametersException extends Exception
     public function __construct(array $missing)
     {
         parent::__construct(sprintf(
-            'Missing required parameters: %s',
+            'Missing required parameter(s): %s',
             implode(', ', $missing)
         ));
     }

src/Input/AskInput.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Minicli\Framework\Input;
+
+final class AskInput
+{
+    /**
+     * @param string $prompt
+     * @param array<int,string> $inputHistory
+     */
+    public function __construct(
+        private string $prompt = '> ',
+        private array $inputHistory = [],
+    ) {
+    }
+
+    public static function make(string $prompt = '> ', array $inputHistory = []): AskInput
+    {
+        return new self($prompt, $inputHistory);
+    }
+
+    public function read(): string
+    {
+        $input = (string) readline($this->prompt);
+        $this->inputHistory[] = $input;
+
+        return $input;
+    }
+
+    public function prompt(): string
+    {
+        return $this->prompt;
+    }
+
+    public function history(): array
+    {
+        return $this->inputHistory;
+    }
+
+    public function setPrompt(string $prompt): AskInput
+    {
+        $this->prompt = $prompt;
+
+        return $this;
+    }
+}

src/Minicli.php

@@ -7,10 +7,17 @@
 use Minicli\Framework\Commands\AbstractCommand;
 use Minicli\Framework\Commands\DefaultCommand;
 use Minicli\Framework\Configuration\Config;
+use Minicli\Framework\Contracts\Output\EngineContract;
+use Minicli\Framework\Contracts\Output\PrinterContract;
 use Minicli\Framework\Contracts\Theme\ThemeContract;
 use Minicli\Framework\DI\Container;
 use Minicli\Framework\Exceptions\MissingParametersException;
 use Minicli\Framework\Input\Input;
+use Minicli\Framework\Output\Engine\DefaultEngine;
+use Minicli\Framework\Output\Printer\DefaultPrinter;
+use Minicli\Framework\Output\Services\Plates;
+use Minicli\Framework\Output\Services\Termwind;
+use Minicli\Framework\Theme\Catalog\DefaultTheme;
 
 final class Minicli extends Container
 {
@@ -21,23 +28,33 @@ public function __construct(
     ) {
         parent::__construct();
 
+        $this->loadEngine();
         $this->loadCommands();
     }
 
     /**
      * @param string $path
+     * @param string $views
      * @param class-string<ThemeContract>|null $theme
+     * @param class-string<PrinterContract>|null $printer
+     * @param class-string<EngineContract>|null $engine
      * @param bool $debug
      * @return Minicli
      */
     public static function boot(
         string $path,
+        string $views,
         ?string $theme,
+        ?string $printer,
+        ?string $engine,
         bool $debug = false,
     ): Minicli {
         $config = new Config(
             path: $path,
+            views: $views,
             theme: $theme,
+            printer: $printer,
+            engine: $engine,
             debug: $debug,
         );
 
@@ -63,6 +80,36 @@ public function run(array $argv = []): void
         $command->teardown();
     }
 
+    private function loadEngine(): void
+    {
+        $this->singleton(
+            abstract: Termwind::class,
+            concrete: Termwind::class,
+        );
+
+        $this->singleton(
+            abstract: Plates::class,
+            concrete: fn () => new Plates(
+                path: $this->config->views(),
+            ),
+        );
+
+        $this->singleton(
+            abstract: ThemeContract::class,
+            concrete: $this->config->theme() ?? DefaultTheme::class,
+        );
+
+        $this->singleton(
+            abstract: PrinterContract::class,
+            concrete: $this->config->printer() ?? DefaultPrinter::class,
+        );
+
+        $this->singleton(
+            abstract: EngineContract::class,
+            concrete: $this->config->engine() ?? DefaultEngine::class,
+        );
+    }
+
     /**
      * Loads commands into the DI container.
      */