From 59a7cb6b8c534b788e4730fefa6105291e392a96 Mon Sep 17 00:00:00 2001
From: Dexoron <probrovova1@gmail.com>
Date: Sat, 8 Aug 2026 15:03:14 +0800
Subject: [PATCH] New translations dcr-toml.mdx (Ukrainian)

[ci skip]
---
 .../uk-UA/docs/reference/dcr-toml.mdx.mdx     | 30 ++++++++++++++-----
 1 file changed, 23 insertions(+), 7 deletions(-)

diff --git a/docs-crowdin-export/uk-UA/docs/reference/dcr-toml.mdx.mdx b/docs-crowdin-export/uk-UA/docs/reference/dcr-toml.mdx.mdx
index bb9be20..685c7cd 100644
--- a/docs-crowdin-export/uk-UA/docs/reference/dcr-toml.mdx.mdx
+++ b/docs-crowdin-export/uk-UA/docs/reference/dcr-toml.mdx.mdx
@@ -40,23 +40,39 @@ Main project configuration file. Located at the project root.
 
 ## [package]
 
-| Field     | Required | Description                                 |
-| --------- | -------- | ------------------------------------------- |
-| `name`    | yes      | Project name                                |
-| `version` | yes      | Semantic version                            |
-| `type`    | no       | `app`, `lib`, `none` (defaults to `"none"`) |
-| `license` | no       | SPDX license identifier                     |
-| `author`  | no       | Author                                      |
+| Field         | Required | Description                                                                                                     |
+| ------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
+| `name`        | yes      | Project name                                                                                                    |
+| `version`     | yes      | Semantic version of the **project**                                                                             |
+| `dcr-version` | no       | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
+| `type`        | no       | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
+| `license`     | no       | SPDX license identifier                                                                                         |
+| `author`      | no       | Author                                                                                                          |
 
 ```toml
 [package]
 name = "my-app"
 version = "0.1.0"
+dcr-version = "0.8.4"
 type = "app"
 license = "MIT"
 author = "John Doe"
 ```
 
+### `package.dcr-version`
+
+Optional pin of the DCR CLI the project was written for. On every `dcr.toml` load:
+
+| Situation                      | Behaviour                                                  |
+| ------------------------------ | ---------------------------------------------------------- |
+| Field missing / empty          | Warning: add `dcr-version` (set by `dcr new` / `dcr init`) |
+| Running dcr **older** than pin | Warning: upgrade dcr (`dcr --update`)                      |
+| Running dcr **newer** than pin | Warning: review changelog, bump the pin when ready         |
+| Equal                          | Silent                                                     |
+| Invalid semver                 | Warning once, field ignored                                |
+
+Never fails the command — warnings only. Pre-release suffixes (`1.0.0-dev`) are ignored for comparison (`1.0.0-dev` ≡ `1.0.0`).
+
 ## [build]
 
 ...