From a8922bb5dbb774f53a134b9d2feeae0d3dc1a539 Mon Sep 17 00:00:00 2001
From: Anton Kurako <goodforgod.dev@gmail.com>
Date: Fri, 3 Jul 2026 02:46:52 +0300
Subject: [PATCH 1/3] docs: release version 1.2.18

- Add changelog entries for version 1.2.18 (EN/RU)
- Update version references from 1.2.17 to 1.2.18 in documentation
- Update kora-parent BOM version in general.md (EN/RU)
- Update openapi-generator version in openapi-codegen.md (EN/RU)
- Update version in getting-started.md guides (EN/RU)
- Update version in hello-world.md examples (EN/RU)
---
 mkdocs/docs/en/changelog/changelog.md           | 15 ++++++++++++++-
 mkdocs/docs/en/documentation/general.md         |  8 ++++----
 mkdocs/docs/en/documentation/openapi-codegen.md |  4 ++--
 mkdocs/docs/en/examples/hello-world.md          |  4 ++--
 mkdocs/docs/en/guides/getting-started.md        |  4 ++--
 mkdocs/docs/ru/changelog/changelog.md           | 15 ++++++++++++++-
 mkdocs/docs/ru/documentation/general.md         |  8 ++++----
 mkdocs/docs/ru/documentation/openapi-codegen.md |  4 ++--
 mkdocs/docs/ru/examples/hello-world.md          |  4 ++--
 mkdocs/docs/ru/guides/getting-started.md        |  4 ++--
 10 files changed, 48 insertions(+), 22 deletions(-)

diff --git a/mkdocs/docs/en/changelog/changelog.md b/mkdocs/docs/en/changelog/changelog.md
index d181b69..2ab3d7b 100644
--- a/mkdocs/docs/en/changelog/changelog.md
+++ b/mkdocs/docs/en/changelog/changelog.md
@@ -5,7 +5,20 @@ hide:
   - navigation
 ---
 
-## 1.2.17
+## 1.2.18
+
+Added:
+
+- Added Kotlin/KSP-native Konvert mapper integration
+- Added custom JSON value serialization for enums and arbitrary types via `@JsonReader` factory / `@JsonWriter` method
+- Added Kotlin lambda extensions for `JdbcConnectionFactory`
+
+Fixed:
+
+- Fixed handling of non-native `@Mdc` parameter types and `${}` value expressions
+- Fixed and removed unnecessary `os.flush` call from `HttpBodyOutput.write`
+
+### 1.2.17
 
 Added:
 
diff --git a/mkdocs/docs/en/documentation/general.md b/mkdocs/docs/en/documentation/general.md
index 92828f7..64a62f1 100644
--- a/mkdocs/docs/en/documentation/general.md
+++ b/mkdocs/docs/en/documentation/general.md
@@ -133,7 +133,7 @@ dependency `ru.tinkoff.kora:kora-parent` which requires to specify the version o
     }
 
     dependencies {
-        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.17")
+        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.18")
         annotationProcessor "ru.tinkoff.kora:annotation-processors"
     }
     ```
@@ -172,7 +172,7 @@ dependency `ru.tinkoff.kora:kora-parent` which requires to specify the version o
     }
 
     dependencies {
-        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.17"))
+        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.18"))
         ksp("ru.tinkoff.kora:symbol-processors")
     }
     ```
@@ -198,7 +198,7 @@ and the [BOM dependency](https://docs.gradle.org/current/userguide/platforms.htm
     }
 
     dependencies {
-        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.17")
+        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.18")
         annotationProcessor "ru.tinkoff.kora:annotation-processors"
     }
     ```
@@ -217,7 +217,7 @@ and the [BOM dependency](https://docs.gradle.org/current/userguide/platforms.htm
     }
 
     dependencies {
-        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.17"))
+        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.18"))
         ksp("ru.tinkoff.kora:symbol-processors")
     }
     ```
diff --git a/mkdocs/docs/en/documentation/openapi-codegen.md b/mkdocs/docs/en/documentation/openapi-codegen.md
index 845de09..45941aa 100644
--- a/mkdocs/docs/en/documentation/openapi-codegen.md
+++ b/mkdocs/docs/en/documentation/openapi-codegen.md
@@ -17,7 +17,7 @@ For a step-by-step walkthrough before the reference details, see [OpenAPI HTTP S
     ```groovy
     buildscript {
         dependencies {
-            classpath("ru.tinkoff.kora:openapi-generator:1.2.17")
+            classpath("ru.tinkoff.kora:openapi-generator:1.2.18")
         }
     }
     ```
@@ -37,7 +37,7 @@ For a step-by-step walkthrough before the reference details, see [OpenAPI HTTP S
     ```groovy
     buildscript {
         dependencies {
-            classpath("ru.tinkoff.kora:openapi-generator:1.2.17")
+            classpath("ru.tinkoff.kora:openapi-generator:1.2.18")
         }
     }
     ```
diff --git a/mkdocs/docs/en/examples/hello-world.md b/mkdocs/docs/en/examples/hello-world.md
index 1d4433a..4a4ec6c 100644
--- a/mkdocs/docs/en/examples/hello-world.md
+++ b/mkdocs/docs/en/examples/hello-world.md
@@ -54,7 +54,7 @@ Basic concepts and description of the framework can be read on the [main page](.
     }
 
     dependencies {
-        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.17")
+        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.18")
         annotationProcessor "ru.tinkoff.kora:annotation-processors"
 
         implementation "ru.tinkoff.kora:http-server-undertow"
@@ -91,7 +91,7 @@ Basic concepts and description of the framework can be read on the [main page](.
     }
 
     dependencies {
-        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.17"))
+        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.18"))
         ksp("ru.tinkoff.kora:symbol-processors")
 
         implementation("ru.tinkoff.kora:http-server-undertow")
diff --git a/mkdocs/docs/en/guides/getting-started.md b/mkdocs/docs/en/guides/getting-started.md
index 71d11c2..bc1f87e 100644
--- a/mkdocs/docs/en/guides/getting-started.md
+++ b/mkdocs/docs/en/guides/getting-started.md
@@ -491,7 +491,7 @@ Now add dependencies. First import the Kora BOM. After this line, Kora dependenc
 
     ```groovy
     dependencies {
-        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.17")
+        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.18")
 
         annotationProcessor "ru.tinkoff.kora:annotation-processors"
 
@@ -506,7 +506,7 @@ Now add dependencies. First import the Kora BOM. After this line, Kora dependenc
 
     ```kotlin
     dependencies {
-        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.17"))
+        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.18"))
 
         ksp("ru.tinkoff.kora:symbol-processor")
 
diff --git a/mkdocs/docs/ru/changelog/changelog.md b/mkdocs/docs/ru/changelog/changelog.md
index 432c581..1ee2a73 100644
--- a/mkdocs/docs/ru/changelog/changelog.md
+++ b/mkdocs/docs/ru/changelog/changelog.md
@@ -5,7 +5,20 @@ hide:
   - navigation
 ---
 
-## 1.2.17
+## 1.2.18
+
+Добавлено:
+
+- Добавлена интеграция Konvert мапперов для Kotlin/KSP-native
+- Добавлена кастомная сериализация JSON для enum и произвольных типов через `@JsonReader` factory / `@JsonWriter` method
+- Добавлены lambda-расширения для `JdbcConnectionFactory` в Kotlin
+
+Исправлено:
+
+- Исправлена обработка не-родных типов параметров `@Mdc` и выражений значений `${}`
+- Исправлено и удалено излишнее обращение `os.flush` из `HttpBodyOutput.write`
+
+### 1.2.17
 
 Добавлено:
 
diff --git a/mkdocs/docs/ru/documentation/general.md b/mkdocs/docs/ru/documentation/general.md
index d4556a9..3358a38 100644
--- a/mkdocs/docs/ru/documentation/general.md
+++ b/mkdocs/docs/ru/documentation/general.md
@@ -133,7 +133,7 @@ Kafka продюсеров, репозиториев баз данных и та
     }
 
     dependencies {
-        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.17")
+        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.18")
         annotationProcessor "ru.tinkoff.kora:annotation-processors"
     }
     ```
@@ -172,7 +172,7 @@ Kafka продюсеров, репозиториев баз данных и та
     }
 
     dependencies {
-        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.17"))
+        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.18"))
         ksp("ru.tinkoff.kora:symbol-processors")
     }
     ```
@@ -198,7 +198,7 @@ Kafka продюсеров, репозиториев баз данных и та
     }
 
     dependencies {
-        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.17")
+        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.18")
         annotationProcessor "ru.tinkoff.kora:annotation-processors"
     }
     ```
@@ -217,7 +217,7 @@ Kafka продюсеров, репозиториев баз данных и та
     }
 
     dependencies {
-        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.17"))
+        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.18"))
         ksp("ru.tinkoff.kora:symbol-processors")
     }
     ```
diff --git a/mkdocs/docs/ru/documentation/openapi-codegen.md b/mkdocs/docs/ru/documentation/openapi-codegen.md
index e92b859..85000e8 100644
--- a/mkdocs/docs/ru/documentation/openapi-codegen.md
+++ b/mkdocs/docs/ru/documentation/openapi-codegen.md
@@ -17,7 +17,7 @@ agent:
     ```groovy
     buildscript {
         dependencies {
-            classpath("ru.tinkoff.kora:openapi-generator:1.2.17")
+            classpath("ru.tinkoff.kora:openapi-generator:1.2.18")
         }
     }
     ```
@@ -37,7 +37,7 @@ agent:
     ```groovy
     buildscript {
         dependencies {
-            classpath("ru.tinkoff.kora:openapi-generator:1.2.17")
+            classpath("ru.tinkoff.kora:openapi-generator:1.2.18")
         }
     }
     ```
diff --git a/mkdocs/docs/ru/examples/hello-world.md b/mkdocs/docs/ru/examples/hello-world.md
index f27fb99..42c9ae4 100644
--- a/mkdocs/docs/ru/examples/hello-world.md
+++ b/mkdocs/docs/ru/examples/hello-world.md
@@ -54,7 +54,7 @@ distributionUrl=https\://services.gradle.org/distributions/gradle-8.10-bin.zip
     }
 
     dependencies {
-        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.17")
+        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.18")
         annotationProcessor "ru.tinkoff.kora:annotation-processors"
 
         implementation "ru.tinkoff.kora:http-server-undertow"
@@ -91,7 +91,7 @@ distributionUrl=https\://services.gradle.org/distributions/gradle-8.10-bin.zip
     }
 
     dependencies {
-        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.17"))
+        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.18"))
         ksp("ru.tinkoff.kora:symbol-processors")
 
         implementation("ru.tinkoff.kora:http-server-undertow")
diff --git a/mkdocs/docs/ru/guides/getting-started.md b/mkdocs/docs/ru/guides/getting-started.md
index 9f15ba4..b635705 100644
--- a/mkdocs/docs/ru/guides/getting-started.md
+++ b/mkdocs/docs/ru/guides/getting-started.md
@@ -494,7 +494,7 @@ Kora состоит из нескольких модулей. Чтобы не у
 
     ```groovy
     dependencies {
-        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.17")
+        koraBom platform("ru.tinkoff.kora:kora-parent:1.2.18")
 
         annotationProcessor "ru.tinkoff.kora:annotation-processors"
 
@@ -509,7 +509,7 @@ Kora состоит из нескольких модулей. Чтобы не у
 
     ```kotlin
     dependencies {
-        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.17"))
+        koraBom(platform("ru.tinkoff.kora:kora-parent:1.2.18"))
 
         ksp("ru.tinkoff.kora:symbol-processor")
 

From ad4896b9b4338efc00b4cab9d9122533d4ff963f Mon Sep 17 00:00:00 2001
From: Anton Kurako <goodforgod.dev@gmail.com>
Date: Fri, 3 Jul 2026 02:49:27 +0300
Subject: [PATCH 2/3] docs: fix terminology in changelog 1.2.18
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add backticks for terms (Konvert, enum, lambda)
- Replace anglicisms in RU version: мапперов → преобразователей, кастомная → пользовательская
---
 mkdocs/docs/en/changelog/changelog.md | 6 +++---
 mkdocs/docs/ru/changelog/changelog.md | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/mkdocs/docs/en/changelog/changelog.md b/mkdocs/docs/en/changelog/changelog.md
index 2ab3d7b..f25b0fb 100644
--- a/mkdocs/docs/en/changelog/changelog.md
+++ b/mkdocs/docs/en/changelog/changelog.md
@@ -9,9 +9,9 @@ hide:
 
 Added:
 
-- Added Kotlin/KSP-native Konvert mapper integration
-- Added custom JSON value serialization for enums and arbitrary types via `@JsonReader` factory / `@JsonWriter` method
-- Added Kotlin lambda extensions for `JdbcConnectionFactory`
+- Added Kotlin/KSP-native `Konvert` mapper integration
+- Added custom JSON value serialization for `enum` and arbitrary types via `@JsonReader` factory / `@JsonWriter` method
+- Added Kotlin `lambda` extensions for `JdbcConnectionFactory`
 
 Fixed:
 
diff --git a/mkdocs/docs/ru/changelog/changelog.md b/mkdocs/docs/ru/changelog/changelog.md
index 1ee2a73..f637c31 100644
--- a/mkdocs/docs/ru/changelog/changelog.md
+++ b/mkdocs/docs/ru/changelog/changelog.md
@@ -9,9 +9,9 @@ hide:
 
 Добавлено:
 
-- Добавлена интеграция Konvert мапперов для Kotlin/KSP-native
-- Добавлена кастомная сериализация JSON для enum и произвольных типов через `@JsonReader` factory / `@JsonWriter` method
-- Добавлены lambda-расширения для `JdbcConnectionFactory` в Kotlin
+- Добавлена интеграция преобразователей `Konvert` для Kotlin/KSP-native
+- Добавлена пользовательская сериализация JSON для `enum` и произвольных типов через фабрику `@JsonReader` / метод `@JsonWriter`
+- Добавлены `lambda`-расширения для `JdbcConnectionFactory` в Kotlin
 
 Исправлено:
 

From fe4e6a671fc4cc19c67ac0537303b117d1d7eae6 Mon Sep 17 00:00:00 2001
From: Anton Kurako <goodforgod.dev@gmail.com>
Date: Fri, 3 Jul 2026 02:52:45 +0300
Subject: [PATCH 3/3] 1.2.18

---
 mkdocs/config/en/mkdocs.yml | 2 +-
 mkdocs/config/ru/mkdocs.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/mkdocs/config/en/mkdocs.yml b/mkdocs/config/en/mkdocs.yml
index 5cdec18..ff031d1 100644
--- a/mkdocs/config/en/mkdocs.yml
+++ b/mkdocs/config/en/mkdocs.yml
@@ -3,7 +3,7 @@ site_dir: "../../generated/en"
 
 
 # Project information
-site_name: Kora Framework 1.2.17
+site_name: Kora Framework 1.2.18
 site_url: https://kora-projects.github.io/kora-docs/en/
 nav:
   - Guides:
diff --git a/mkdocs/config/ru/mkdocs.yml b/mkdocs/config/ru/mkdocs.yml
index 0f97eec..6374202 100644
--- a/mkdocs/config/ru/mkdocs.yml
+++ b/mkdocs/config/ru/mkdocs.yml
@@ -3,7 +3,7 @@ site_dir: "../../generated/ru"
 
 
 # Project information
-site_name: Kora фреймворк 1.2.17
+site_name: Kora фреймворк 1.2.18
 site_url: https://kora-projects.github.io/kora-docs/ru/
 nav:
   - Руководства: