. * * @author Mahdi * @copyright 2016-2025 Mahdi * @license https://opensource.org/licenses/AGPL-3.0 AGPLv3 * @link https://docs.madelineproto.xyz MadelineProto documentation */ namespace danog\MadelineProto\EventHandler\Message\Entities; use danog\MadelineProto\ParseMode; use danog\MadelineProto\StrTools; use JsonSerializable; use ReflectionClass; use ReflectionProperty; final class TextWithEntities implements JsonSerializable { public function __construct( /** Text */ public readonly string $text, /** * Message entities for styled text. * @var list */ public readonly array $entities, /** Whether to parse HTML or Markdown markup in the message */ public readonly ?ParseMode $parseMode, ) { } /** @internal */ #[\Override] public function jsonSerialize(): mixed { $res = ['_' => static::class]; $refl = new ReflectionClass($this); foreach ($refl->getProperties(ReflectionProperty::IS_PUBLIC) as $prop) { $res[$prop->getName()] = $prop->getValue($this); } return $res; } protected readonly string $html; protected readonly string $htmlTelegram; /** * Get an HTML version of the message. * * @psalm-suppress InaccessibleProperty * * @param bool $allowTelegramTags Whether to allow telegram-specific tags like tg-spoiler, tg-emoji, mention links and so on... */ public function getHTML(bool $allowTelegramTags = false): string { if (!$this->entities) { return StrTools::htmlEscape($this->text); } if ($allowTelegramTags) { return $this->htmlTelegram ??= StrTools::entitiesToHtml($this->text, $this->entities, $allowTelegramTags); } return $this->html ??= StrTools::entitiesToHtml($this->text, $this->entities, $allowTelegramTags); } }