docs: add docs about mapping types

Author: Alex-pvl

CHANGELOG.md

@@ -6,6 +6,10 @@
 
 - Add `tarantool-spring-data-40` module with support for Spring Boot 4.0.x and Spring Data 4.0.x
 
+### Documentation
+
+- Document supported Java types for Tarantool data mapping in `tuple_pojo_mapping` docs (RU/EN), including Tarantool extension types (`decimal`, `uuid`, `datetime`, `interval`, `tuple`) and related mapping notes.
+
 ## [1.6.0] - 2026-04-01
 
 ### BOM Module

documentation/doc-src/pages/client/arch/tuple_pojo_mapping.en.md

@@ -25,6 +25,31 @@ guide, but will help you understand the principles of interaction. Mastering the
 efficiently with the database in any scenarios, whether it's a cluster or a single instance, and with any POJO
 objects.
 
+## Supported Java Types for Mapping
+
+The SDK uses `Jackson + jackson-dataformat-msgpack`, so:
+
+- standard Java/Jackson types (primitives and wrappers, `String`, `byte[]`, `List`, `Map`, nested POJOs)
+  are supported by default;
+- Tarantool extension types are additionally supported.
+
+Below are the types that have explicit Tarantool extension-type mapping in the SDK:
+
+| Tarantool type | Java type | Comment |
+| --- | --- | --- |
+| `decimal` | `java.math.BigDecimal` | Uses MsgPack `decimal` extension; scale with absolute value up to and including `38` is supported. |
+| `uuid` | `java.util.UUID` | Uses MsgPack `uuid` extension. |
+| `datetime` | `java.time.Instant`, `java.time.LocalDateTime`, `java.time.LocalDate`, `java.time.LocalTime`, `java.time.OffsetDateTime`, `java.time.ZonedDateTime` | Uses MsgPack `datetime` extension. |
+| `interval` | `io.tarantool.mapping.Interval` | Uses MsgPack `interval` extension. |
+| `tuple` (Tarantool 3.x, `TUPLE_EXT`) | `io.tarantool.mapping.Tuple<T>` | Uses MsgPack `tuple` extension; useful when tuple format is returned with tuple data. |
+
+???+ note "Note"
+
+    If you read data as `Object` (without an explicit target type), extension values are
+    deserialized to SDK Java objects automatically:
+    `decimal -> BigDecimal`, `uuid -> UUID`, `datetime -> ZonedDateTime`,
+    `interval -> Interval`, `tuple -> Tuple<?>`.
+
 ## Efficient Mapping (Flatten input, Flatten output)
 
 By default, field mapping in any of the clients (CrudClient, BoxClient) is performed in the most

documentation/doc-src/pages/client/arch/tuple_pojo_mapping.md

@@ -27,6 +27,31 @@ tarantool-java-sdk SDK есть модуль, который будет сери
 работать с базой данных в любых сценариях, будь то кластер или одиночный экземпляр, и с любыми POJO
 объектами.
 
+## Поддерживаемые Java-типы при маппинге
+
+SDK использует `Jackson + jackson-dataformat-msgpack`, поэтому:
+
+- базовые типы Java/Jackson (примитивы и их обертки, `String`, `byte[]`, `List`, `Map`, вложенные POJO)
+  поддерживаются по умолчанию;
+- дополнительно поддерживаются extension-типы Tarantool.
+
+Ниже приведены типы, для которых в SDK есть явный маппинг из/в Tarantool extension types:
+
+| Tarantool type | Java type | Комментарий |
+| --- | --- | --- |
+| `decimal` | `java.math.BigDecimal` | Используется MsgPack extension `decimal`; поддерживается scale по модулю до `38` включительно. |
+| `uuid` | `java.util.UUID` | Используется MsgPack extension `uuid`. |
+| `datetime` | `java.time.Instant`, `java.time.LocalDateTime`, `java.time.LocalDate`, `java.time.LocalTime`, `java.time.OffsetDateTime`, `java.time.ZonedDateTime` | Используется MsgPack extension `datetime`. |
+| `interval` | `io.tarantool.mapping.Interval` | Используется MsgPack extension `interval`. |
+| `tuple` (Tarantool 3.x, `TUPLE_EXT`) | `io.tarantool.mapping.Tuple<T>` | Используется MsgPack extension `tuple`; полезно, когда вместе с данными приходит формат кортежа. |
+
+???+ note "Заметка"
+
+    Если вы читаете данные как `Object` (без явного целевого класса), extension-типы будут
+    десериализованы в Java-объекты SDK автоматически:
+    `decimal -> BigDecimal`, `uuid -> UUID`, `datetime -> ZonedDateTime`,
+    `interval -> Interval`, `tuple -> Tuple<?>`.
+
 ## Эффективный Маппинг (Flatten input, Flatten output)
 
 По умолчанию маппинг полей в любом из клиентов(CrudClient, BoxClient), выполняется наиболее