. * * @author Daniil Gentili * @copyright 2016-2025 Daniil Gentili * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\EventHandler; use AssertionError; use danog\MadelineProto\EventHandler\Keyboard\InlineKeyboard; use danog\MadelineProto\EventHandler\Keyboard\ReplyKeyboard; use danog\MadelineProto\MTProto; use danog\MadelineProto\TL\Types\Button; /** * Represents an inline or reply keyboard. */ abstract class Keyboard { /** @var non-empty-list> */ public readonly array $buttons; /** @internal */ protected function __construct(MTProto $API, Message $message, array $buttons) { foreach ($buttons as &$row) { $row = $row['buttons']; foreach ($row as &$button) { $button = new Button($API, $message, $button); } unset($button); } unset($row); $this->buttons = $buttons; } /** @internal */ public static function fromRawReplyMarkup(MTProto $API, Message $message, array $rawReplyMarkup): ?self { return match ($rawReplyMarkup['_']) { 'replyKeyboardMarkup' => new ReplyKeyboard($API, $message, $rawReplyMarkup['rows']), 'replyInlineMarkup' => new InlineKeyboard($API, $message, $rawReplyMarkup['rows']), default => null }; } /** * Press button at the specified keyboard coordinates. * * @param bool $waitForResult If true, waits for a result from the bot before returning. */ public function pressByCoordinates(int $row, int $column, bool $waitForResult): mixed { return $this->buttons[$row][$column]->click(!$waitForResult); } /** * Presses the first keyboard button with the specified label. * * @param bool $waitForResult If true, waits for a result from the bot before returning. * * @throws AssertionError If a button with the specified label cannot be found. */ public function press(string $label, bool $waitForResult): mixed { foreach ($this->buttons as $rows) { foreach ($rows as $button) { if ($button->label === $label) { return $button->click(!$waitForResult); } } } throw new AssertionError("Could not find a button with the specified label!"); } }