improvements in rich messages

2026-08-19 15:46:31 +00:00 · 2026-08-17 23:30:37 +06:00
parent 8bee8982bb
commit 5755724569
10 changed files with 337 additions and 35 deletions
--- a/tgbotapi.core/api/tgbotapi.core.api
+++ b/tgbotapi.core/api/tgbotapi.core.api
@@ -35863,10 +35863,10 @@ public final class dev/inmo/tgbotapi/types/rich/InputRichBlockTableBuilder {
 public final class dev/inmo/tgbotapi/types/rich/InputRichBlockTableRowBuilder {
 	public fun <init> ()V
 	public final fun build ()Ljava/util/List;
-	public final fun cell (Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;Ljava/lang/Integer;Ljava/lang/Integer;Lkotlin/jvm/functions/Function1;)V
-	public static synthetic fun cell$default (Ldev/inmo/tgbotapi/types/rich/InputRichBlockTableRowBuilder;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;Ljava/lang/Integer;Ljava/lang/Integer;Lkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
-	public final fun headerCell (Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;Ljava/lang/Integer;Ljava/lang/Integer;Lkotlin/jvm/functions/Function1;)V
-	public static synthetic fun headerCell$default (Ldev/inmo/tgbotapi/types/rich/InputRichBlockTableRowBuilder;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;Ljava/lang/Integer;Ljava/lang/Integer;Lkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
+	public final fun cell (Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;Ljava/lang/Integer;Ljava/lang/Integer;Lkotlin/jvm/functions/Function1;)V
+	public static synthetic fun cell$default (Ldev/inmo/tgbotapi/types/rich/InputRichBlockTableRowBuilder;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;Ljava/lang/Integer;Ljava/lang/Integer;Lkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
+	public final fun headerCell (Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;Ljava/lang/Integer;Ljava/lang/Integer;Lkotlin/jvm/functions/Function1;)V
+	public static synthetic fun headerCell$default (Ldev/inmo/tgbotapi/types/rich/InputRichBlockTableRowBuilder;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;Ljava/lang/Integer;Ljava/lang/Integer;Lkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
 }

 public final class dev/inmo/tgbotapi/types/rich/InputRichBlockThinking : dev/inmo/tgbotapi/types/rich/InputRichBlock {
@@ -36937,7 +36937,7 @@ public abstract interface class dev/inmo/tgbotapi/types/rich/RichBlockTableCell
 	public abstract fun getColspan ()Ljava/lang/Integer;
 	public abstract fun getRowspan ()Ljava/lang/Integer;
 	public abstract fun getText ()Ldev/inmo/tgbotapi/types/rich/RichText;
-	public abstract fun getValign ()Ljava/lang/String;
+	public abstract fun getValign ()Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;
 }

 public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCell$Companion {
@@ -36946,21 +36946,21 @@ public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCell$Companion {

 public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCell$Header : dev/inmo/tgbotapi/types/rich/RichBlockTableCell {
 	public static final field Companion Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Header$Companion;
-	public fun <init> (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;)V
-	public synthetic fun <init> (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun <init> (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;)V
+	public synthetic fun <init> (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun component1 ()Ldev/inmo/tgbotapi/types/rich/RichText;
 	public final fun component2 ()Ljava/lang/Integer;
 	public final fun component3 ()Ljava/lang/Integer;
 	public final fun component4 ()Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;
-	public final fun component5 ()Ljava/lang/String;
-	public final fun copy (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;)Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Header;
-	public static synthetic fun copy$default (Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Header;Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;ILjava/lang/Object;)Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Header;
+	public final fun component5 ()Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;
+	public final fun copy (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;)Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Header;
+	public static synthetic fun copy$default (Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Header;Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;ILjava/lang/Object;)Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Header;
 	public fun equals (Ljava/lang/Object;)Z
 	public fun getAlign ()Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;
 	public fun getColspan ()Ljava/lang/Integer;
 	public fun getRowspan ()Ljava/lang/Integer;
 	public fun getText ()Ldev/inmo/tgbotapi/types/rich/RichText;
-	public fun getValign ()Ljava/lang/String;
+	public fun getValign ()Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;
 	public fun hashCode ()I
 	public fun toString ()Ljava/lang/String;
 }
@@ -36971,21 +36971,21 @@ public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCell$Header$Compan

 public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCell$Regular : dev/inmo/tgbotapi/types/rich/RichBlockTableCell {
 	public static final field Companion Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Regular$Companion;
-	public fun <init> (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;)V
-	public synthetic fun <init> (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun <init> (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;)V
+	public synthetic fun <init> (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun component1 ()Ldev/inmo/tgbotapi/types/rich/RichText;
 	public final fun component2 ()Ljava/lang/Integer;
 	public final fun component3 ()Ljava/lang/Integer;
 	public final fun component4 ()Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;
-	public final fun component5 ()Ljava/lang/String;
-	public final fun copy (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;)Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Regular;
-	public static synthetic fun copy$default (Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Regular;Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ljava/lang/String;ILjava/lang/Object;)Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Regular;
+	public final fun component5 ()Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;
+	public final fun copy (Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;)Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Regular;
+	public static synthetic fun copy$default (Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Regular;Ldev/inmo/tgbotapi/types/rich/RichText;Ljava/lang/Integer;Ljava/lang/Integer;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;ILjava/lang/Object;)Ldev/inmo/tgbotapi/types/rich/RichBlockTableCell$Regular;
 	public fun equals (Ljava/lang/Object;)Z
 	public fun getAlign ()Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign;
 	public fun getColspan ()Ljava/lang/Integer;
 	public fun getRowspan ()Ljava/lang/Integer;
 	public fun getText ()Ldev/inmo/tgbotapi/types/rich/RichText;
-	public fun getValign ()Ljava/lang/String;
+	public fun getValign ()Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;
 	public fun hashCode ()I
 	public fun toString ()Ljava/lang/String;
 }
@@ -37048,6 +37048,51 @@ public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCellAlign$Serializ
 	public synthetic fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/lang/Object;)V
 }

+public abstract interface class dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign {
+	public static final field Companion Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign$Companion;
+	public abstract fun getName ()Ljava/lang/String;
+}
+
+public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign$Bottom : dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign {
+	public static final field INSTANCE Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign$Bottom;
+	public fun equals (Ljava/lang/Object;)Z
+	public fun getName ()Ljava/lang/String;
+	public fun hashCode ()I
+	public final fun serializer ()Lkotlinx/serialization/KSerializer;
+	public fun toString ()Ljava/lang/String;
+}
+
+public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign$Companion {
+	public final fun serializer ()Lkotlinx/serialization/KSerializer;
+}
+
+public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign$Middle : dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign {
+	public static final field INSTANCE Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign$Middle;
+	public fun equals (Ljava/lang/Object;)Z
+	public fun getName ()Ljava/lang/String;
+	public fun hashCode ()I
+	public final fun serializer ()Lkotlinx/serialization/KSerializer;
+	public fun toString ()Ljava/lang/String;
+}
+
+public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign$Serializer : kotlinx/serialization/KSerializer {
+	public static final field INSTANCE Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign$Serializer;
+	public fun deserialize (Lkotlinx/serialization/encoding/Decoder;)Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;
+	public synthetic fun deserialize (Lkotlinx/serialization/encoding/Decoder;)Ljava/lang/Object;
+	public fun getDescriptor ()Lkotlinx/serialization/descriptors/SerialDescriptor;
+	public fun serialize (Lkotlinx/serialization/encoding/Encoder;Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign;)V
+	public synthetic fun serialize (Lkotlinx/serialization/encoding/Encoder;Ljava/lang/Object;)V
+}
+
+public final class dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign$Top : dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign {
+	public static final field INSTANCE Ldev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign$Top;
+	public fun equals (Ljava/lang/Object;)Z
+	public fun getName ()Ljava/lang/String;
+	public fun hashCode ()I
+	public final fun serializer ()Lkotlinx/serialization/KSerializer;
+	public fun toString ()Ljava/lang/String;
+}
+
 public final class dev/inmo/tgbotapi/types/rich/RichBlockThinking : dev/inmo/tgbotapi/types/rich/RichBlock {
 	public static final field Companion Ldev/inmo/tgbotapi/types/rich/RichBlockThinking$Companion;
 	public static final field TYPE Ljava/lang/String;
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/rich/InputRichBlocksDsl.kt
+++ b/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/rich/InputRichBlocksDsl.kt
@@ -56,7 +56,7 @@ class InputRichBlockTableRowBuilder {

    fun cell(
        align: RichBlockTableCellAlign,
-        valign: String,
+        valign: RichBlockTableCellVAlign,
        colspan: Int? = null,
        rowspan: Int? = null,
        block: RichTextBuilder.() -> Unit
@@ -66,7 +66,7 @@ class InputRichBlockTableRowBuilder {

    fun headerCell(
        align: RichBlockTableCellAlign,
-        valign: String,
+        valign: RichBlockTableCellVAlign,
        colspan: Int? = null,
        rowspan: Int? = null,
        block: RichTextBuilder.() -> Unit
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/rich/RichBlockParts.kt
+++ b/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/rich/RichBlockParts.kt
@@ -45,7 +45,7 @@ sealed interface RichBlockTableCell {
    val colspan: Int?
    val rowspan: Int?
    val align: RichBlockTableCellAlign
-    val valign: String
+    val valign: RichBlockTableCellVAlign

    @Suppress("SERIALIZER_TYPE_INCOMPATIBLE")
    @Serializable(Serializer::class)
@@ -59,7 +59,7 @@ sealed interface RichBlockTableCell {
        @SerialName(alignField)
        override val align: RichBlockTableCellAlign,
        @SerialName(valignField)
-        override val valign: String
+        override val valign: RichBlockTableCellVAlign
    ) : RichBlockTableCell

    @Suppress("SERIALIZER_TYPE_INCOMPATIBLE")
@@ -74,7 +74,7 @@ sealed interface RichBlockTableCell {
        @SerialName(alignField)
        override val align: RichBlockTableCellAlign,
        @SerialName(valignField)
-        override val valign: String
+        override val valign: RichBlockTableCellVAlign
    ) : RichBlockTableCell

    object Serializer : KSerializer<RichBlockTableCell> {
@@ -92,7 +92,7 @@ sealed interface RichBlockTableCell {
            @SerialName(alignField)
            val align: RichBlockTableCellAlign,
            @SerialName(valignField)
-            val valign: String
+            val valign: RichBlockTableCellVAlign
        )

        override val descriptor: SerialDescriptor = Surrogate.serializer().descriptor
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign.kt
+++ b/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/rich/RichBlockTableCellVAlign.kt
@@ -0,0 +1,52 @@
+package dev.inmo.tgbotapi.types.rich
+
+import kotlinx.serialization.KSerializer
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.SerializationException
+import kotlinx.serialization.descriptors.PrimitiveKind
+import kotlinx.serialization.descriptors.PrimitiveSerialDescriptor
+import kotlinx.serialization.descriptors.SerialDescriptor
+import kotlinx.serialization.encoding.Decoder
+import kotlinx.serialization.encoding.Encoder
+
+/** Vertical alignment of a [RichBlockTableCell]. */
+@Serializable(RichBlockTableCellVAlign.Serializer::class)
+sealed interface RichBlockTableCellVAlign {
+    val name: String
+
+    @Suppress("SERIALIZER_TYPE_INCOMPATIBLE")
+    @Serializable(Serializer::class)
+    data object Top : RichBlockTableCellVAlign {
+        override val name: String = "top"
+    }
+
+    @Suppress("SERIALIZER_TYPE_INCOMPATIBLE")
+    @Serializable(Serializer::class)
+    data object Middle : RichBlockTableCellVAlign {
+        override val name: String = "middle"
+    }
+
+    @Suppress("SERIALIZER_TYPE_INCOMPATIBLE")
+    @Serializable(Serializer::class)
+    data object Bottom : RichBlockTableCellVAlign {
+        override val name: String = "bottom"
+    }
+
+    object Serializer : KSerializer<RichBlockTableCellVAlign> {
+        override val descriptor: SerialDescriptor = PrimitiveSerialDescriptor(
+            "RichBlockTableCellVAlign",
+            PrimitiveKind.STRING
+        )
+
+        override fun deserialize(decoder: Decoder): RichBlockTableCellVAlign = when (val name = decoder.decodeString()) {
+            Top.name -> Top
+            Middle.name -> Middle
+            Bottom.name -> Bottom
+            else -> throw SerializationException("Unknown RichBlockTableCell vertical alignment: $name")
+        }
+
+        override fun serialize(encoder: Encoder, value: RichBlockTableCellVAlign) {
+            encoder.encodeString(value.name)
+        }
+    }
+}
--- a/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/rich/RichBlocks.kt
+++ b/tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/types/rich/RichBlocks.kt
@@ -437,7 +437,7 @@ data class RichBlockTable(
                        cell.colspan?.let { append(" colspan=\"$it\"") }
                        cell.rowspan?.let { append(" rowspan=\"$it\"") }
                        append(" align=\"${cell.align.name}\"")
-                        append(" valign=\"${cell.valign}\"")
+                        append(" valign=\"${cell.valign.name}\"")
                    }
                    "<$tag$cellAttributes>${cell.text?.html ?: ""}</$tag>"
                }
--- a/tgbotapi.core/src/commonTest/kotlin/dev/inmo/tgbotapi/types/rich/InputRichBlocksDslTest.kt
+++ b/tgbotapi.core/src/commonTest/kotlin/dev/inmo/tgbotapi/types/rich/InputRichBlocksDslTest.kt
@@ -84,12 +84,12 @@ class InputRichBlocksDslTest {
        val blocks = buildInputRichBlocks {
            table(isBordered = true, isStriped = false, caption = RichTextPlain("caption")) {
                row {
-                    headerCell(align = RichBlockTableCellAlign.Left, valign = "top", colspan = 2) {
+                    headerCell(align = RichBlockTableCellAlign.Left, valign = RichBlockTableCellVAlign.Top, colspan = 2) {
                        bold("heading")
                    }
                }
                row {
-                    cell(align = RichBlockTableCellAlign.Center, valign = "middle", rowspan = 2) {
+                    cell(align = RichBlockTableCellAlign.Center, valign = RichBlockTableCellVAlign.Middle, rowspan = 2) {
                        plain("value")
                    }
                }
@@ -105,7 +105,7 @@ class InputRichBlocksDslTest {
                                text = RichTextBold(RichTextPlain("heading")),
                                colspan = 2,
                                align = RichBlockTableCellAlign.Left,
-                                valign = "top"
+                                valign = RichBlockTableCellVAlign.Top
                            )
                        ),
                        listOf(
@@ -113,7 +113,7 @@ class InputRichBlocksDslTest {
                                text = RichTextPlain("value"),
                                rowspan = 2,
                                align = RichBlockTableCellAlign.Center,
-                                valign = "middle"
+                                valign = RichBlockTableCellVAlign.Middle
                            )
                        )
                    ),
--- a/tgbotapi.core/src/commonTest/kotlin/dev/inmo/tgbotapi/types/rich/InputRichMessageSerializationTest.kt
+++ b/tgbotapi.core/src/commonTest/kotlin/dev/inmo/tgbotapi/types/rich/InputRichMessageSerializationTest.kt
@@ -61,7 +61,7 @@ class InputRichMessageSerializationTest {
    fun encodesTableReusingReceivedCellType() {
        val table = InputRichBlockTable(
            cells = listOf(
-                listOf(RichBlockTableCell.Header(RichTextPlain("h1"), align = RichBlockTableCellAlign.Left, valign = "top"))
+                listOf(RichBlockTableCell.Header(RichTextPlain("h1"), align = RichBlockTableCellAlign.Left, valign = RichBlockTableCellVAlign.Top))
            )
        )
        val message = InputRichMessageBlocks(blocks = listOf(table))
@@ -69,13 +69,14 @@ class InputRichMessageSerializationTest {
        val tableJson = json.encodeToJsonElement(InputRichMessage.serializer(), message).jsonObject["blocks"]!!.jsonArray[0].jsonObject
        val cell = tableJson["cells"]!!.jsonArray[0].jsonArray[0].jsonObject
        assertEquals("left", cell["align"]?.jsonPrimitive?.content)
+        assertEquals("top", cell["valign"]?.jsonPrimitive?.content)
        assertEquals(true, cell["is_header"]?.jsonPrimitive?.boolean)
    }

    @Test
    fun serializesTableCellVariantsWithSharedFlatShape() {
-        val header: RichBlockTableCell = RichBlockTableCell.Header(RichTextPlain("h"), align = RichBlockTableCellAlign.Left, valign = "top")
-        val regular: RichBlockTableCell = RichBlockTableCell.Regular(RichTextPlain("v"), align = RichBlockTableCellAlign.Right, valign = "bottom")
+        val header: RichBlockTableCell = RichBlockTableCell.Header(RichTextPlain("h"), align = RichBlockTableCellAlign.Left, valign = RichBlockTableCellVAlign.Top)
+        val regular: RichBlockTableCell = RichBlockTableCell.Regular(RichTextPlain("v"), align = RichBlockTableCellAlign.Right, valign = RichBlockTableCellVAlign.Bottom)

        val headerElement = json.encodeToJsonElement(RichBlockTableCell.Serializer, header).jsonObject
        val regularElement = json.encodeToJsonElement(RichBlockTableCell.Serializer, regular).jsonObject
@@ -108,6 +109,28 @@ class InputRichMessageSerializationTest {
        }
    }

+    @Test
+    fun serializesEveryTableCellVerticalAlignmentAsItsName() {
+        val alignments = listOf(
+            RichBlockTableCellVAlign.Top,
+            RichBlockTableCellVAlign.Middle,
+            RichBlockTableCellVAlign.Bottom
+        )
+
+        alignments.forEach { alignment ->
+            val encoded = json.encodeToString(RichBlockTableCellVAlign.Serializer, alignment)
+            assertEquals("\"${alignment.name}\"", encoded)
+            assertEquals(alignment, json.decodeFromString(RichBlockTableCellVAlign.Serializer, encoded))
+        }
+    }
+
+    @Test
+    fun rejectsUnknownTableCellVerticalAlignment() {
+        assertFailsWith<SerializationException> {
+            json.decodeFromString(RichBlockTableCellVAlign.Serializer, "\"baseline\"")
+        }
+    }
+
    @Test
    fun encodesPhotoBlockMedia() {
        val photoBlock = InputRichBlockPhoto(TelegramMediaPhoto(FileId("photo_file_id")))
--- a/tgbotapi.core/src/commonTest/kotlin/dev/inmo/tgbotapi/types/rich/RichBlockFormattingTest.kt
+++ b/tgbotapi.core/src/commonTest/kotlin/dev/inmo/tgbotapi/types/rich/RichBlockFormattingTest.kt
@@ -108,12 +108,12 @@ class RichBlockFormattingTest {
        val block = RichBlockTable(
            listOf(
                listOf(
-                    RichBlockTableCell.Header(text = RichTextPlain("H1"), align = RichBlockTableCellAlign.Left, valign = "top"),
-                    RichBlockTableCell.Header(text = RichTextPlain("H2"), align = RichBlockTableCellAlign.Center, valign = "top")
+                    RichBlockTableCell.Header(text = RichTextPlain("H1"), align = RichBlockTableCellAlign.Left, valign = RichBlockTableCellVAlign.Top),
+                    RichBlockTableCell.Header(text = RichTextPlain("H2"), align = RichBlockTableCellAlign.Center, valign = RichBlockTableCellVAlign.Top)
                ),
                listOf(
-                    RichBlockTableCell.Regular(text = RichTextPlain("a"), align = RichBlockTableCellAlign.Left, valign = "top"),
-                    RichBlockTableCell.Regular(text = RichTextPlain("b"), align = RichBlockTableCellAlign.Center, valign = "top")
+                    RichBlockTableCell.Regular(text = RichTextPlain("a"), align = RichBlockTableCellAlign.Left, valign = RichBlockTableCellVAlign.Top),
+                    RichBlockTableCell.Regular(text = RichTextPlain("b"), align = RichBlockTableCellAlign.Center, valign = RichBlockTableCellVAlign.Top)
                )
            )
        )