feat: absorb initphp/cli-table; document table rendering

  The Console package's Utils/Table has been structurally identical to
  the standalone initphp/cli-table package for some time. Formalise the
  consolidation:

  - Declare composer 'replace' for initphp/cli-table so the deprecated
    package is not installed alongside this one.
  - Add aliases.php with a class_alias keeping \InitPHP\CLITable\Table
    resolvable for transitive consumers.
  - Document the table renderer in the README and add a migration
    section for users coming from initphp/cli-table.

Author: muhammetsafak

README.md

@@ -1,5 +1,8 @@
 # Console
-It is a simple helper library that will allow you to write your console/cli application with PHP.
+
+A simple helper library for writing console/CLI applications in PHP.
+
+Starting with **2.1**, this package also ships the ANSI-coloured table renderer that used to be distributed as the separate [`initphp/cli-table`](https://github.com/InitPHP/CLITable) package (now deprecated). See the [migration section](#migrating-from-initphpcli-table) below if you are coming from that package.
 
 ## Requirements
 
@@ -42,6 +45,52 @@ $console->run();
 php console.php list
 ```
 
+## Rendering tables
+
+This package ships a styleable ASCII/ANSI table renderer under `\InitPHP\Console\Utils\Table`:
+
+```php
+use InitPHP\Console\Utils\Table;
+
+$table = Table::create()
+    ->setHeaderStyle(Table::COLOR_RED, Table::BOLD)
+    ->setBorderStyle(Table::COLOR_BLUE)
+    ->setCellStyle(Table::COLOR_GREEN);
+
+$table->row(['id' => 1, 'name' => 'Matthew S.', 'email' => 'matthew@example.com', 'status' => true])
+      ->row(['id' => 2, 'name' => 'Millie J.',  'email' => 'millie@example.com',  'status' => false])
+      ->row(['id' => 3, 'name' => 'Regina G.',  'email' => 'regina@example.com',  'status' => true]);
+
+echo $table; // or $table->getContent()
+```
+
+The renderer is intentionally lightweight: it stringifies non-string cell values (`[NULL]`, `[TRUE]`, `[FALSE]`, `[CALLABLE]`, `[RESOURCE]`, class name for objects), auto-sizes columns, and emits standard SGR escape sequences. `mb_strlen()` is used when available so multibyte values align correctly.
+
+## Migrating from `initphp/cli-table`
+
+The standalone [`initphp/cli-table`](https://github.com/InitPHP/CLITable) package has been merged into this one starting with **2.1** and is now deprecated.
+
+If your code currently uses `\InitPHP\CLITable\Table`, **no source changes are required** — this package ships a `class_alias` that keeps the old fully-qualified class name working. Just switch your dependency:
+
+```diff
+- "initphp/cli-table": "^1.0",
++ "initphp/console": "^2.1"
+```
+
+(`initphp/console:^2.1` declares a Composer `replace` for `initphp/cli-table`, so Composer will not install both side-by-side.)
+
+When you next touch the code, prefer the new canonical namespace:
+
+```php
+// Before
+use InitPHP\CLITable\Table;
+
+// After
+use InitPHP\Console\Utils\Table;
+```
+
+The alias is intended as a transition aid and may be removed in a future major release.
+
 ## Credits
 
 - [Muhammet ŞAFAK](https://www.muhammetsafak.com.tr) <<info@muhammetsafak.com.tr>>

composer.json

@@ -1,12 +1,15 @@
 {
     "name": "initphp/console",
-    "description": "It is a simple helper library that will allow you to write your console/cli application with PHP.",
+    "description": "A simple helper library for writing console/CLI applications in PHP. As of 2.1 this package also ships the table renderer previously distributed as initphp/cli-table.",
     "type": "library",
     "license": "MIT",
     "autoload": {
         "psr-4": {
             "InitPHP\\Console\\": "src/"
-        }
+        },
+        "files": [
+            "src/aliases.php"
+        ]
     },
     "authors": [
         {
@@ -19,5 +22,8 @@
     "minimum-stability": "stable",
     "require": {
         "php": ">=7.2"
+    },
+    "replace": {
+        "initphp/cli-table": "*"
     }
 }

src/aliases.php

@@ -0,0 +1,23 @@
+<?php
+/**
+ * aliases.php
+ *
+ * Backwards-compatibility shim for users migrating from the deprecated
+ * `initphp/cli-table` package. Aliases the old fully-qualified class
+ * name to the canonical class that now lives in this package.
+ *
+ * Existing code using `use InitPHP\CLITable\Table;` continues to work
+ * unchanged after switching to `initphp/console:^2.1`. The class_exists
+ * guard with autoload disabled prevents fatal "cannot declare class"
+ * errors if the legacy package is somehow still loaded alongside this
+ * one — Composer's `replace` directive normally prevents that.
+ *
+ * @see https://github.com/InitPHP/Console#migrating-from-initphpcli-table
+ */
+
+if (!class_exists(\InitPHP\CLITable\Table::class, false)) {
+    class_alias(
+        \InitPHP\Console\Utils\Table::class,
+        'InitPHP\\CLITable\\Table'
+    );
+}