<?php

declare(strict_types=1);

namespace App\Helpers;

/**
 * ساخت خروجی InputRichMessage برای متد sendRichMessage / editMessageText(rich_message).
 * برای «تابلوی گروه/کانال» استفاده می‌شه تا به‌جای متن ساده، یک جدول واقعی نمایش داده بشه.
 *
 * منبع دقیق ساختار (تأیید شده از مستندات رسمی تلگرام):
 * - https://core.telegram.org/bots/api#inputrichmessage
 *   فیلد `is_rtl` روی خودِ InputRichMessage جهت راست‌به‌چپ کل پیام رو مشخص می‌کنه؛ چون محتوا فارسیه
 *   باید true باشه، وگرنه تلگرام پیام رو چپ‌به‌راست می‌چینه (نتیجه‌ش ترتیب برعکس ستون‌های جدول بود).
 * - https://core.telegram.org/bots/api#inputrichblocktable
 *   فیلد جدول اسمش `cells` هست و مستقیماً یک آرایه‌ی دوبعدیه: لیستی از ردیف‌ها، هر ردیف یک لیست خام
 *   از سلول‌ها. `is_compact` باعث نمایش «فشرده/جمع‌شده» جدول می‌شه (باید false باشه برای نمایش کامل).
 *   `is_bordered` خط جداکننده‌ی واقعی بین سلول‌ها رو فعال می‌کنه.
 * - https://core.telegram.org/bots/api#richblocktablecell
 *   هر سلول: align و valign الزامی‌ان ('left'|'center'|'right' و 'top'|'middle'|'bottom')،
 *   text اختیاریه (نوع RichText که طبق مستندات رسمی می‌تونه صرفاً یک رشته‌ی متن ساده هم باشه).
 */
final class RichTable
{
    /**
     * @param string $title عنوان بالای جدول
     * @param string[] $headers سرستون‌ها (اولین عضو آرایه = ستون سمت راست، چون is_rtl فعاله)
     * @param string[][] $rows هر ردیف آرایه‌ای از رشته به تعداد $headers
     * @param string|null $footer متن پایینی (مثلاً ساعت بروزرسانی)
     */
    public static function build(string $title, array $headers, array $rows, ?string $footer = null, bool $isCompact = false): array
    {
        $blocks = [];

        $blocks[] = [
            'type' => 'paragraph',
            'text' => $title,
        ];

        $cells = [];
        $cells[] = self::cellRow($headers, true);
        foreach ($rows as $row) {
            $cells[] = self::cellRow($row, false);
        }

        $blocks[] = [
            'type'        => 'table',
            'cells'       => $cells,
            'is_compact'  => $isCompact,
            'is_bordered' => true,
        ];

        if ($footer !== null) {
            $blocks[] = [
                'type' => 'footer',
                'text' => $footer,
            ];
        }

        return [
            'is_rtl' => true,
            'blocks' => $blocks,
        ];
    }

    /** @param string[] $texts */
    private static function cellRow(array $texts, bool $isHeader): array
    {
        return array_map(
            static fn(string $t) => [
                'text'      => $t,
                'is_header' => $isHeader,
                'align'     => $isHeader ? 'center' : 'right',
                'valign'    => 'middle',
            ],
            $texts
        );
    }
}