example.php

<?php
require_once __DIR__ . '/vendor/autoload.php';

use PhpCliToolkit\Command\Application;
use PhpCliToolkit\Command\Command;
use PhpCliToolkit\Output\Text;
use PhpCliToolkit\Output\Table;
use PhpCliToolkit\Output\Grid;
use PhpCliToolkit\Output\Cell;
use PhpCliToolkit\Output\ProgressBar;
use PhpCliToolkit\Input\Prompt;
use PhpCliToolkit\Output\Styles\Colors;
use PhpCliToolkit\Output\Styles\BgColors;
use PhpCliToolkit\Output\Styles\Formattings;

class TextCommand extends Command {
    public function name(): string        { return 'text'; }
    public function description(): string { return 'Showcase the Text component with padding, margin, and styles'; }

    public function handle(): int {
        (new Text('Full-width banner'))
            ->style([Formattings::BOLD, Colors::BRIGHT_WHITE, BgColors::BLUE])
            ->margin(1, 0, 1, 0, [BgColors::BLUE])
            ->write();

        (new Text('Padded box — inner spacing on all sides'))
            ->style([Colors::WHITE, BgColors::MAGENTA])
            ->padding(1, 0, 1, 4, [BgColors::MAGENTA])
            ->margin(0, 0, 1, 0)
            ->write();

        (new Text('Success  ✔'))
            ->style([Formattings::BOLD, Colors::BLACK, BgColors::GREEN])
            ->padding(0, 0, 0, 2, [BgColors::GREEN])
            ->write();

        (new Text('Warning  ⚠'))
            ->style([Formattings::BOLD, Colors::BLACK, BgColors::YELLOW])
            ->padding(0, 0, 0, 2, [BgColors::YELLOW])
            ->write();

        (new Text('Error  ✖'))
            ->style([Formattings::BOLD, Colors::WHITE, BgColors::RED])
            ->padding(0, 0, 0, 2, [BgColors::RED])
            ->write();

        (new Text('Dim italic note — subtle helper text'))
            ->style([Formattings::DIM, Formattings::ITALIC, Colors::BRIGHT_BLACK])
            ->margin(1, 0, 1, 0)
            ->write();

        return 0;
    }
}

class TableCommand extends Command {
    public function name(): string        { return 'table'; }
    public function description(): string { return 'Showcase the Table component'; }

    public function handle(): int {
        (new Text('  Users'))
            ->style([Formattings::BOLD, Colors::BRIGHT_WHITE])
            ->margin(1, 0, 0, 0)
            ->write();

        (new Table(
            headers: ['Name',  'Role',      'Status',   'Joined'],
            rows: [
                ['Alice', 'Admin',     'Active',   '2022-01-15'],
                ['Bob',   'Editor',    'Inactive', '2022-03-22'],
                ['Carol', 'Viewer',    'Active',   '2023-07-01'],
                ['Dave',  'Moderator', 'Active',   '2021-11-30'],
            ]
        ))->render();

        echo "\n";
        return 0;
    }
}

class GridCommand extends Command {
    public function name(): string        { return 'grid'; }
    public function description(): string { return 'Showcase Grid and Cell with various layouts'; }

    public function handle(): int {
        (new Text('  2-column equal'))
            ->style([Formattings::BOLD, Colors::BRIGHT_WHITE])
            ->margin(1, 0, 0, 0)
            ->write();

        (new Grid(columns: 2, gap: 2))
            ->cell('Left column',  style: [Colors::WHITE, BgColors::BLUE],  paddingTop: 1, paddingBottom: 1, paddingLeft: 2, paddingRight: 2, paddingStyle: [BgColors::BLUE])
            ->cell('Right column', style: [Colors::WHITE, BgColors::CYAN],  paddingTop: 1, paddingBottom: 1, paddingLeft: 2, paddingRight: 2, paddingStyle: [BgColors::CYAN])
            ->render();

        (new Text('  3-column fixed widths — long content wraps in the centre'))
            ->style([Formattings::BOLD, Colors::BRIGHT_WHITE])
            ->margin(1, 0, 0, 0)
            ->write();

        (new Grid(columns: [20, 36, 20], gap: 1))
            ->add(new Cell('Narrow left',  [Colors::WHITE, BgColors::MAGENTA], 1, 1, 1, 1, [BgColors::MAGENTA]))
            ->add(new Cell('Wide centre — this column has more room for content and will wrap gracefully', [Colors::WHITE, BgColors::BLUE], 1, 1, 1, 1, [BgColors::BLUE]))
            ->add(new Cell('Narrow right', [Colors::WHITE, BgColors::GREEN],   1, 1, 1, 1, [BgColors::GREEN]))
            ->render();

        (new Text('  3-column auto with 6 cells (wraps into 2 rows)'))
            ->style([Formattings::BOLD, Colors::BRIGHT_WHITE])
            ->margin(1, 0, 0, 0)
            ->write();

        (new Grid(columns: 3, gap: 2))
            ->cell('Alpha',   style: [Colors::WHITE, BgColors::BLUE])
            ->cell('Beta',    style: [Colors::WHITE, BgColors::GREEN])
            ->cell('Gamma',   style: [Colors::WHITE, BgColors::RED])
            ->cell('Delta',   style: [Colors::WHITE, BgColors::YELLOW])
            ->cell('Epsilon', style: [Colors::BLACK, BgColors::BRIGHT_WHITE])
            ->cell('Zeta',    style: [Colors::WHITE, BgColors::MAGENTA])
            ->render();

        echo "\n";
        return 0;
    }
}

class ProgressCommand extends Command {
    public function name(): string        { return 'progress'; }
    public function description(): string { return 'Showcase the ProgressBar component'; }

    protected function setup(): void {
        $this->parser->registerOption('steps|s', 'Number of steps to simulate', default: 30);
    }

    public function handle(): int {
        $steps = (int) ($this->parser->getOption('steps') ?? 30);

        (new Text("  Simulating {$steps} steps…"))
            ->style([Formattings::DIM, Colors::BRIGHT_WHITE])
            ->margin(1, 0, 1, 0)
            ->write();

        $bar = new ProgressBar($steps);
        for ($i = 0; $i < $steps; $i++) {
            usleep(60_000);
            $bar->advance();
        }
        $bar->finish();

        (new Text('  Done!'))
            ->style([Formattings::BOLD, Colors::BLACK, BgColors::GREEN])
            ->padding(0, 0, 0, 2, [BgColors::GREEN])
            ->margin(1, 0, 1, 0)
            ->write();

        return 0;
    }
}

class PromptCommand extends Command {
    public function name(): string        { return 'prompt'; }
    public function description(): string { return 'Showcase all Prompt interactions (ask, confirm, secret, select)'; }

    public function handle(): int {
        (new Text('  Interactive Prompts'))
            ->style([Formattings::BOLD, Colors::BRIGHT_WHITE, BgColors::BLUE])
            ->margin(1, 0, 1, 0, [BgColors::BLUE])
            ->write();

        $name      = Prompt::ask('Your name', 'World');
        $lang      = Prompt::select('Favourite language', ['PHP', 'Python', 'Go', 'Rust']);
        $confirmed = Prompt::confirm('Continue?', true);
        $secret    = Prompt::secret('Enter a secret (input hidden)');

        echo "\n";

        (new Table(
            headers: ['Field', 'Value'],
            rows: [
                ['name',      $name],
                ['language',  $lang],
                ['confirmed', $confirmed ? 'yes' : 'no'],
                ['secret',    str_repeat('*', strlen($secret)) ?: '(empty)'],
            ]
        ))->render();

        echo "\n";
        return 0;
    }
}

class StylesCommand extends Command {
    public function name(): string        { return 'styles'; }
    public function description(): string { return 'Display all foreground colors, background colors, and text formats'; }

    public function handle(): int {
        $esc = static fn(array $codes, string $text): string =>
            "\033[" . implode(';', $codes) . "m{$text}\033[0m";

        (new Text('  Foreground Colors'))
            ->style([Formattings::BOLD, Colors::BRIGHT_WHITE])
            ->margin(1, 0, 0, 0)
            ->write();

        $fgColors = [
            'BLACK'          => Colors::BLACK,
            'RED'            => Colors::RED,
            'GREEN'          => Colors::GREEN,
            'YELLOW'         => Colors::YELLOW,
            'BLUE'           => Colors::BLUE,
            'MAGENTA'        => Colors::MAGENTA,
            'CYAN'           => Colors::CYAN,
            'WHITE'          => Colors::WHITE,
            'BRIGHT_BLACK'   => Colors::BRIGHT_BLACK,
            'BRIGHT_RED'     => Colors::BRIGHT_RED,
            'BRIGHT_GREEN'   => Colors::BRIGHT_GREEN,
            'BRIGHT_YELLOW'  => Colors::BRIGHT_YELLOW,
            'BRIGHT_BLUE'    => Colors::BRIGHT_BLUE,
            'BRIGHT_MAGENTA' => Colors::BRIGHT_MAGENTA,
            'BRIGHT_CYAN'    => Colors::BRIGHT_CYAN,
            'BRIGHT_WHITE'   => Colors::BRIGHT_WHITE,
        ];

        foreach ($fgColors as $name => $code) {
            echo '  ' . $esc([$code], str_pad($name, 20)) . "\n";
        }

        (new Text('  Background Colors'))
            ->style([Formattings::BOLD, Colors::BRIGHT_WHITE])
            ->margin(1, 0, 0, 0)
            ->write();

        $bgColors = [
            'BLACK'          => BgColors::BLACK,
            'RED'            => BgColors::RED,
            'GREEN'          => BgColors::GREEN,
            'YELLOW'         => BgColors::YELLOW,
            'BLUE'           => BgColors::BLUE,
            'MAGENTA'        => BgColors::MAGENTA,
            'CYAN'           => BgColors::CYAN,
            'WHITE'          => BgColors::WHITE,
            'BRIGHT_BLACK'   => BgColors::BRIGHT_BLACK,
            'BRIGHT_RED'     => BgColors::BRIGHT_RED,
            'BRIGHT_GREEN'   => BgColors::BRIGHT_GREEN,
            'BRIGHT_YELLOW'  => BgColors::BRIGHT_YELLOW,
            'BRIGHT_BLUE'    => BgColors::BRIGHT_BLUE,
            'BRIGHT_MAGENTA' => BgColors::BRIGHT_MAGENTA,
            'BRIGHT_CYAN'    => BgColors::BRIGHT_CYAN,
            'BRIGHT_WHITE'   => BgColors::BRIGHT_WHITE,
        ];

        foreach ($bgColors as $name => $code) {
            echo '  ' . $esc([$code, Colors::BLACK], str_pad($name, 20)) . "\n";
        }

        (new Text('  Text Formats'))
            ->style([Formattings::BOLD, Colors::BRIGHT_WHITE])
            ->margin(1, 0, 0, 0)
            ->write();

        $formats = [
            'BOLD'      => [Formattings::BOLD],
            'DIM'       => [Formattings::DIM],
            'ITALIC'    => [Formattings::ITALIC],
            'UNDERLINE' => [Formattings::UNDERLINE],
            'BLINK'     => [Formattings::BLINK],
            'INVERT'    => [Formattings::INVERT],
        ];

        foreach ($formats as $name => $codes) {
            echo '  ' . $esc($codes, str_pad($name, 20)) . "\n";
        }

        echo "\n";
        return 0;
    }
}

$app = new Application('toolkit-demo', '1.0.0');
$app->register(
    new TextCommand(),
    new TableCommand(),
    new GridCommand(),
    new ProgressCommand(),
    new PromptCommand(),
    new StylesCommand(),
);
$app->run();