New translations dcr-toml.mdx (Ukrainian)

[ci skip]

docs-crowdin-export/de-DE/docs/README.mdx.mdx

@@ -11,7 +11,8 @@ sidebar_label: Introduction
 # Installation (dcrup)
 curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
 export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable
+dcrup install stable                 # auto: cf → gh → sf → ya
+# dcrup install stable --mirror cf   # CloudFlare / GitHub / SourceForge / Yandex
 
 # Create a project
 dcr new my-app

docs-crowdin-export/de-DE/docs/changelog.mdx.mdx

@@ -4,6 +4,63 @@ sidebar_label: Changelog
 
 # Changelog
 
+## 0.9.1 (2026-09-13)
+
+* **`pkg-config` dependencies** — declare `fmt = { pkg-config = "fmt" }` or multiple package names in `[dependencies]`; DCR applies `.pc` compiler/linker flags and records the resolved package in `dcr.lock`.
+* **`dcr add` support for `pkg-config`** — easily add system package dependencies with `dcr add fmt pkg-config:fmt` or `dcr add openssl pkg:openssl,libcrypto`.
+* **`dcr tree` & IDE integration** — `pkg-config` packages are marked in `dcr tree` and resolved into compiler flags in `dcr gen` (`compile_commands.json`).
+* **Fixed `dcr new` in non-ASCII / spaced paths** — initializing projects from folders with non-ASCII characters or spaces no longer fails validation.
+
+## 0.9.0 (2026-08-31)
+
+* **Download mirrors in `dcrup`** — `--mirror auto|cf|gh|sf|ya` and `DCRUP_MIRROR`.
+  Default `auto` tries **cf → gh → sf → ya** (CloudFlare CDN, GitHub, SourceForge, Yandex CDN).
+* **Complete Path/Git dependencies** — DCR packages from `path` and `git` are built before their consumer. Git sources are cached in `~/.dcr/git`, support `branch`/`tag`/`rev`, and record the exact commit in `dcr.lock`.
+* **Build and prebuild modes** — `path` and `git` dependencies can build a DCR package from `dcr.toml` or link existing `include`/`lib`/`libs` artifacts; `mode = "build"` / `"prebuild"` selects explicitly when both forms are present.
+* **Prebuilt dependency examples** — documentation now shows the `dcr-math-lib` Git repository and recommended build/prebuilt layouts for both `git` and `path`.
+* **Transitive dependency builds and cycle reporting** — DCR recursively builds DCR packages and reports a clear dependency chain for cycles.
+* **Bare path arguments for `dcr add`** — `dcr add mylib ../mylib` now works in addition to the explicit `path:` form.
+* **Removed `install.sh` / `install.ps1` / `install_bsd.sh`** — superseded by `dcrup`.
+
+## 0.8.5 (2026-08-08)
+
+* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
+  `dcr new` / `dcr init` write the current version. On config load:
+  * missing / empty pin → warn "add dcr-version";
+  * dcr older than pin → warn "update dcr";
+  * dcr newer than pin → warn "check changelog, update pin";
+  * equal → silent.
+    Commands do not fail, warning only (once per path per process).
+
+## 0.8.4 (2026-08-04)
+
+**Added:**
+
+* **`.dcr/` directory** — shared machine-readable build facts for IDE integrations:
+  * `.dcr/compile_commands.json`
+  * `.dcr/build-info.json` (`schemaVersion`, `artifact_path`, `profile`, …)
+  * `.dcr/toolchain.json` (compiler/debugger paths, moc/uic/rcc)
+  * `.dcr/ide/` (placeholder for IDE lock files)
+* **`dcr gen project-info`** — `target`, `target_dir`, `artifact_path`, `artifact_kind`, `source_roots`, `include_globs`, `exclude_globs`; absolute/canonical paths.
+* **`dcr build --print-artifact-path`** — one absolute artifact path line on stdout after a successful build.
+* **`dcr gen … --quiet` / `-q`** — suppress human success logs for gen subcommands.
+* **`.clangd`** — created on first gen with `CompilationDatabase: .dcr` (`# managed by dcr gen`); custom `.clangd` is not overwritten.
+* **Helpers** `canonicalize_path`, `atomic_write`, `ensure_dcr_dir`; pure `resolve_artifact_path` via `platform::*`.
+* **`dcr new` / `dcr init`** — add `.dcr/` to `.gitignore`.
+
+**Changed (breaking):**
+
+* **`compile_commands.json` moved** from project root to **`.dcr/compile_commands.json`**.\
+  clangd discovers it via `.clangd` / `--compile-commands-dir=.dcr`.\
+  CLion and VSCode generators updated accordingly.
+* **Atomic write** for compile_commands (tmp + rename).
+* **`gen vscode` / `gen clion` launch/run** — use the same artifact path resolver as `project-info` / `build-info.json`.
+
+**Fixed:**
+
+* Launch configs no longer hardcode `target/\<profile>/\<name>` without the Linux triple segment.
+* Symlink/mount roots: best-effort canonicalize for root and compile database paths.
+
 ## 0.8.3 (2026-08-03)
 
 ### Added

docs-crowdin-export/de-DE/docs/commands/dependency-commands.mdx.mdx

@@ -15,6 +15,8 @@ dcr add mylib path:./lib       # explicit path prefix
 dcr add mylib git:https://github.com/user/repo  # explicit git prefix
 dcr add mylib github:user/repo # GitHub shorthand
 dcr add mylib gitlab:user/repo # GitLab shorthand
+dcr add fmt pkg-config:fmt     # system package via pkg-config
+dcr add openssl pkg:openssl,libcrypto # multiple pkg-config packages
 ```
 
 Source prefixes:
@@ -23,6 +25,7 @@ Source prefixes:
 * `git:` — generic git URL
 * `github:` — expands to `https://github.com/\<user>/\<repo>`
 * `gitlab:` — expands to `https://gitlab.com/\<user>/\<repo>`
+* `pkg-config:` / `pkg:` — one or more packages resolved by `pkg-config`
 * `http://` / `https://` / `git@` — full URL
 
 Flags:
@@ -31,7 +34,12 @@ Flags:
 * `--tag \<name>` — git tag
 * `--rev \<hash>` — git commit
 
-If source is omitted — DCR searches connected registries.
+If source is omitted — DCR searches connected registries. A bare relative or absolute path is accepted as a path dependency.
+
+For `pkg-config` dependencies, the referenced packages must already be installed
+and provide `.pc` files. DCR invokes `pkg-config` during the build (using
+`PATH` and `PKG_CONFIG_PATH`) and forwards the returned compiler and linker
+flags; it does not download or build these packages.
 
 ## `dcr tree`
 

docs-crowdin-export/de-DE/docs/contributing.mdx.mdx

@@ -8,6 +8,7 @@ sidebar_label: Contributing
 
 ```bash
 git clone https://github.com/dexoron/dcr
+# or a source mirror: GitVerse / SourceCraft / SourceForge / GitLab (see README)
 cd dcr
 cargo build
 ```

docs-crowdin-export/de-DE/docs/faq.mdx.mdx

@@ -61,6 +61,15 @@ Use `kind = "flat-bin"` (NASM `-f bin`) and optional `[archive]` for a FAT disk
 
 See [OS-dev recipe](/docs/recipes/os-flat-bin-archive).
 
+## How do I choose a download mirror?
+
+`dcrup install` uses `--mirror auto` by default and tries **cf → gh → sf → ya**.
+
+```bash
+dcrup install stable --mirror cf
+export DCRUP_MIRROR=ya
+```
+
 ## Lock file
 
 `dcr.lock` is created during builds (`dcr build`) when registry dependencies are present. To force an update — delete `dcr.lock` and run `dcr build`.

docs-crowdin-export/de-DE/docs/getting-started/installation.mdx.mdx

@@ -45,10 +45,12 @@ After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live
 ### Common dcrup commands
 
 ```sh
-dcrup install stable              # latest stable prebuilt
+dcrup install stable              # latest stable prebuilt (auto: cf → gh → sf → ya)
 dcrup install 0.8.2               # pin → 0.8.2@stable
 dcrup install 0.8.2@dev
 dcrup install stable --libc musl  # Linux: musl asset (default: gnu)
+dcrup install stable --mirror cf  # CloudFlare CDN
+dcrup install stable --mirror ya  # Yandex CDN (RU fallback)
 dcrup install stable --build      # cargo build --features archive
 dcrup install night               # always build from branch dev HEAD
 dcrup default 0.8.2
@@ -60,6 +62,22 @@ dcrup which
 
 Layout: `~/.dcr/toolchains/\<id>/dcr` and `~/.dcr/bin/dcr` → active version.
 
+### Download mirrors
+
+Prebuilt installs try **cf → gh → sf → ya** unless you pin a host.
+
+| Code | URL                                                                                                          | Notes                      |
+| ---- | ------------------------------------------------------------------------------------------------------------ | -------------------------- |
+| `cf` | `https://cdn-global.dcr-tool.ru/\<tag>/\<asset>`                           | CloudFlare CDN (worldwide) |
+| `gh` | `https://github.com/dexoron/dcr/releases/download/\<tag>/\<asset>`         | GitHub Releases            |
+| `sf` | `https://sourceforge.net/projects/dcr-tool/files/\<tag>/\<asset>/download` | SourceForge                |
+| `ya` | `https://cdn-ru.dcr-tool.ru/\<tag>/\<asset>`                               | Yandex CDN (RU fallback)   |
+
+```sh
+dcrup install stable --mirror auto   # default
+export DCRUP_MIRROR=cf               # persist for this shell
+```
+
 ---
 
 ## Arch Linux (AUR)

docs-crowdin-export/de-DE/docs/ide-integration.mdx.mdx

@@ -6,6 +6,13 @@ sidebar_label: IDE Integration
 
 ## VS Code
 
+Install the recommended [DCR extension by Dexoron-Labs](https://marketplace.visualstudio.com/items?itemName=Dexoron-Labs.dcr). Do not install Microsoft C/C++ extensions for DCR projects: DCR uses `clangd`. MS C/C++ is acceptable only when you need its debugger.
+
+Recommended companion extensions:
+
+* [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)
+* [CodeLLDB](https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb), or MS C/C++ for debugger support only
+
 ```bash
 dcr gen vscode
 ```

docs-crowdin-export/de-DE/docs/reference/dcr-toml.mdx.mdx

@@ -40,23 +40,39 @@ Main project configuration file. Located at the project root.
 
 ## [package]
 
-| Field     | Required | Description                                 |
+| Field         | Required | Description                                                                                                     |
-| --------- | -------- | ------------------------------------------- |
+| ------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `name`    | yes      | Project name                                |
+| `name`        | yes      | Project name                                                                                                    |
-| `version` | yes      | Semantic version                            |
+| `version`     | yes      | Semantic version of the **project**                                                                             |
-| `type`    | no       | `app`, `lib`, `none` (defaults to `"none"`) |
+| `dcr-version` | no       | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `license` | no       | SPDX license identifier                     |
+| `type`        | no       | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `author`  | no       | Author                                      |
+| `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]
 
 ...
@@ -96,7 +112,12 @@ author = "John Doe"
 
 Settings from raw config (not in typed struct):
 
-* `pkg_config` — list of pkg-config packages
+* `pkg_config` — list of packages queried for build-wide compiler/linker flags
+
+Dependencies can also declare a system package directly, for example
+`fmt = { pkg-config = "fmt" }`. This records the package in `dcr.lock` and applies
+the flags returned by `pkg-config --cflags` and `pkg-config --libs`.
+
 * `ldscript` — linker script path
 * `build.steps` / `build.post_steps` — codegen steps
 

docs-crowdin-export/de-DE/docs/reference/dependencies.mdx.mdx

@@ -6,7 +6,7 @@ sidebar_label: Dependencies
 
 ## Formats
 
-The `[dependencies]` section supports three formats:
+The `[dependencies]` section supports registry, path, Git, and `pkg-config` dependencies:
 
 ### String (registry)
 
@@ -23,10 +23,10 @@ The version string is used as-is for registry lookup.
 
 ```toml
 [dependencies]
-fmt = { git = "https://github.com/fmtlib/fmt", tag = "10.1.1" }
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0" }
 ```
 
-Fields: `git`, `branch`, `tag`, `rev`.
+Fields: `git`, `branch`, `tag`, `rev`, `mode`, `include`, `lib`, `libs`.
 
 ### Table (path)
 
@@ -35,6 +35,32 @@ Fields: `git`, `branch`, `tag`, `rev`.
 mylib = { path = "../mylib" }
 ```
 
+For a prebuilt external library, specify its layout explicitly. The three
+arrays are paths relative to the dependency root (`include`, `lib`) and linker
+names (`libs`):
+
+```toml
+[dependencies]
+dcr-math = { path = "../deps/dcr-math", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+### Table (`pkg-config`)
+
+Use an installed `.pc` package when the library is provided by the operating system
+or another system package manager. DCR invokes `pkg-config --cflags` and
+`pkg-config --libs`, preserving include, library, linker, and other flags:
+
+```toml
+[dependencies]
+fmt = { pkg-config = "fmt" }
+openssl = { pkg-config = ["openssl", "libcrypto"] }
+```
+
+The `pkg-config` executable must be available in `PATH`. The named `.pc` files must
+be available through pkg-config's standard search paths or via `PKG_CONFIG_PATH`.
+These dependencies are not downloaded or built by DCR; they are recorded in
+`dcr.lock` with a `pkg-config+...` source.
+
 ## Registry
 
 DCR uses a package registry for dependency lookup by name.
@@ -42,7 +68,7 @@ DCR uses a package registry for dependency lookup by name.
 ```toml
 # ~/.dcr/config.toml
 [registry.default]
-url = "https://index.dcr.pm"
+url = "https://index.dcr.dexoron.tech"
 priority = 1
 ```
 
@@ -50,7 +76,23 @@ Registry priority: order in `config.toml`. The `DCR_INDEX_PATH` variable overrid
 
 ## Git dependencies
 
-Git dependencies are parsed and recorded in `dcr.lock`. DCR supports specifying branch/tag/rev for git sources:
+Git dependencies are cloned into `~/.dcr/git/`; their exact checked-out commit is written to `dcr.lock`.
+
+Both Git and path dependencies have two modes:
+
+* **DCR package:** the source has `dcr.toml`. DCR builds it before the consumer and uses the package name from its manifest for linking.
+* **Prebuilt library:** it provides existing headers and binaries through `include`, `lib`, and `libs`. DCR passes them to the compiler/linker without building the dependency.
+
+The mode is normally detected automatically. Use `mode = "build"` or `mode = "prebuild"` when a source contains both a manifest and prebuilt artifacts and you need to choose explicitly.
+
+`dcr-math-lib` publishes both forms. Select its prebuilt library explicitly:
+
+```toml
+[dependencies]
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0", mode = "prebuild", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+DCR supports specifying branch/tag/rev for git sources:
 
 * `branch` — switch to a branch
 * `tag` — switch to a tag
@@ -59,7 +101,7 @@ Git dependencies are parsed and recorded in `dcr.lock`. DCR supports specifying
 
 ## Path dependencies
 
-Local paths. DCR automatically discovers include and lib directories from the neighbor's `dcr.toml`.
+Local paths may point at a DCR package or a prebuilt external library. A path DCR package is built before its consumer, including its own path/git dependencies. DCR detects dependency cycles. A prebuilt library is never built by DCR; it is linked from the directories declared in its dependency entry.
 
 ```toml
 [dependencies]
@@ -67,18 +109,51 @@ mylib = { path = "/abs/path/to/lib" }
 mylib = { path = "../relative/path" }
 ```
 
-*Note: Header resolution automatically checks the packaged `target/include` directory of path dependencies, ensuring consumer packages can find headers from compiled static or dynamic libraries.*
+For DCR packages, the package name from `dcr.toml` is used for linking (so the dependency key may differ from the library name). Header resolution includes the packaged `target/include` directory and link search includes `target/lib`.
+
+### Recommended library layouts
+
+Buildable DCR library:
+
+```text
+dcr-math-lib/
+├── dcr.toml
+└── src/
+    ├── dcr_math.c
+    └── dcr_math.h
+```
+
+Prebuilt library:
+
+```text
+dcr-math-lib/
+├── include/
+│   └── dcr_math.h
+└── lib/
+    └── libdcr-math.a       # or .so / .lib
+```
+
+`libs` contains linker names without the `lib` prefix and file extension: use
+`["dcr-math"]` for `libdcr-math.a`.
+
+If one repository contains both forms, keep the prebuilt files in `include/` and `lib/` and select the mode explicitly:
+
+```toml
+[dependencies]
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0", mode = "prebuild", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+For a local copy, replace `git` with `path = "../dcr-math-lib"`. In `prebuild` mode DCR does not run the dependency build, even when `dcr.toml` is present.
 
 ## dcr.lock
 
 Dependency lock file. Contains package names and sources.
 
-Created during `dcr build` when registry dependencies are present. Not updated during `dcr add` — only on the next `dcr build`.
+Created during `dcr build` for resolved registry, path, and Git dependencies. Not updated during `dcr add` — only on the next `dcr build`.
 
 ## Resolution process
 
-1. Load all dependencies (registry → git → path)
+1. Resolve dependency sources (registry → git → path)
-2. For path deps: recursively read their `dcr.toml`
+2. Fetch git dependencies into `~/.dcr/git/` and check out the requested ref
-3. For registry deps: search `index.json`
+3. Build DCR package dependencies recursively
-4. For git deps: clone to cache
+4. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler
-5. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler

docs-crowdin-export/de-DE/docs/reference/environment-variables.mdx.mdx

@@ -58,3 +58,27 @@ export DCR_INDEX_PATH=/custom/path/index.json
 ```
 
 Default: `~/.dcr/index.json`.
+
+## DCRUP_MIRROR
+
+Download mirror for `dcrup` (prebuilt binaries only).
+
+```bash
+export DCRUP_MIRROR=auto   # cf → gh → sf → ya (default)
+export DCRUP_MIRROR=cf     # CloudFlare CDN
+export DCRUP_MIRROR=gh     # GitHub Releases
+export DCRUP_MIRROR=sf     # SourceForge
+export DCRUP_MIRROR=ya     # Yandex CDN (RU fallback)
+```
+
+CLI override: `dcrup install stable --mirror cf`.
+
+## DCRUP_HOME / DCRUP_BIN / DCRUP_REPO
+
+Installer layout and source clone URL:
+
+```bash
+export DCRUP_HOME=~/.dcr
+export DCRUP_BIN=~/.dcr/bin
+export DCRUP_REPO=https://github.com/dexoron/dcr
+```

docs-crowdin-export/pl-PL/docs/README.mdx.mdx

@@ -11,7 +11,8 @@ sidebar_label: Introduction
 # Installation (dcrup)
 curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
 export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable
+dcrup install stable                 # auto: cf → gh → sf → ya
+# dcrup install stable --mirror cf   # CloudFlare / GitHub / SourceForge / Yandex
 
 # Create a project
 dcr new my-app

docs-crowdin-export/pl-PL/docs/changelog.mdx.mdx

@@ -4,6 +4,63 @@ sidebar_label: Changelog
 
 # Changelog
 
+## 0.9.1 (2026-09-13)
+
+* **`pkg-config` dependencies** — declare `fmt = { pkg-config = "fmt" }` or multiple package names in `[dependencies]`; DCR applies `.pc` compiler/linker flags and records the resolved package in `dcr.lock`.
+* **`dcr add` support for `pkg-config`** — easily add system package dependencies with `dcr add fmt pkg-config:fmt` or `dcr add openssl pkg:openssl,libcrypto`.
+* **`dcr tree` & IDE integration** — `pkg-config` packages are marked in `dcr tree` and resolved into compiler flags in `dcr gen` (`compile_commands.json`).
+* **Fixed `dcr new` in non-ASCII / spaced paths** — initializing projects from folders with non-ASCII characters or spaces no longer fails validation.
+
+## 0.9.0 (2026-08-31)
+
+* **Download mirrors in `dcrup`** — `--mirror auto|cf|gh|sf|ya` and `DCRUP_MIRROR`.
+  Default `auto` tries **cf → gh → sf → ya** (CloudFlare CDN, GitHub, SourceForge, Yandex CDN).
+* **Complete Path/Git dependencies** — DCR packages from `path` and `git` are built before their consumer. Git sources are cached in `~/.dcr/git`, support `branch`/`tag`/`rev`, and record the exact commit in `dcr.lock`.
+* **Build and prebuild modes** — `path` and `git` dependencies can build a DCR package from `dcr.toml` or link existing `include`/`lib`/`libs` artifacts; `mode = "build"` / `"prebuild"` selects explicitly when both forms are present.
+* **Prebuilt dependency examples** — documentation now shows the `dcr-math-lib` Git repository and recommended build/prebuilt layouts for both `git` and `path`.
+* **Transitive dependency builds and cycle reporting** — DCR recursively builds DCR packages and reports a clear dependency chain for cycles.
+* **Bare path arguments for `dcr add`** — `dcr add mylib ../mylib` now works in addition to the explicit `path:` form.
+* **Removed `install.sh` / `install.ps1` / `install_bsd.sh`** — superseded by `dcrup`.
+
+## 0.8.5 (2026-08-08)
+
+* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
+  `dcr new` / `dcr init` write the current version. On config load:
+  * missing / empty pin → warn "add dcr-version";
+  * dcr older than pin → warn "update dcr";
+  * dcr newer than pin → warn "check changelog, update pin";
+  * equal → silent.
+    Commands do not fail, warning only (once per path per process).
+
+## 0.8.4 (2026-08-04)
+
+**Added:**
+
+* **`.dcr/` directory** — shared machine-readable build facts for IDE integrations:
+  * `.dcr/compile_commands.json`
+  * `.dcr/build-info.json` (`schemaVersion`, `artifact_path`, `profile`, …)
+  * `.dcr/toolchain.json` (compiler/debugger paths, moc/uic/rcc)
+  * `.dcr/ide/` (placeholder for IDE lock files)
+* **`dcr gen project-info`** — `target`, `target_dir`, `artifact_path`, `artifact_kind`, `source_roots`, `include_globs`, `exclude_globs`; absolute/canonical paths.
+* **`dcr build --print-artifact-path`** — one absolute artifact path line on stdout after a successful build.
+* **`dcr gen … --quiet` / `-q`** — suppress human success logs for gen subcommands.
+* **`.clangd`** — created on first gen with `CompilationDatabase: .dcr` (`# managed by dcr gen`); custom `.clangd` is not overwritten.
+* **Helpers** `canonicalize_path`, `atomic_write`, `ensure_dcr_dir`; pure `resolve_artifact_path` via `platform::*`.
+* **`dcr new` / `dcr init`** — add `.dcr/` to `.gitignore`.
+
+**Changed (breaking):**
+
+* **`compile_commands.json` moved** from project root to **`.dcr/compile_commands.json`**.\
+  clangd discovers it via `.clangd` / `--compile-commands-dir=.dcr`.\
+  CLion and VSCode generators updated accordingly.
+* **Atomic write** for compile_commands (tmp + rename).
+* **`gen vscode` / `gen clion` launch/run** — use the same artifact path resolver as `project-info` / `build-info.json`.
+
+**Fixed:**
+
+* Launch configs no longer hardcode `target/\<profile>/\<name>` without the Linux triple segment.
+* Symlink/mount roots: best-effort canonicalize for root and compile database paths.
+
 ## 0.8.3 (2026-08-03)
 
 ### Added

docs-crowdin-export/pl-PL/docs/commands/dependency-commands.mdx.mdx

@@ -15,6 +15,8 @@ dcr add mylib path:./lib       # explicit path prefix
 dcr add mylib git:https://github.com/user/repo  # explicit git prefix
 dcr add mylib github:user/repo # GitHub shorthand
 dcr add mylib gitlab:user/repo # GitLab shorthand
+dcr add fmt pkg-config:fmt     # system package via pkg-config
+dcr add openssl pkg:openssl,libcrypto # multiple pkg-config packages
 ```
 
 Source prefixes:
@@ -23,6 +25,7 @@ Source prefixes:
 * `git:` — generic git URL
 * `github:` — expands to `https://github.com/\<user>/\<repo>`
 * `gitlab:` — expands to `https://gitlab.com/\<user>/\<repo>`
+* `pkg-config:` / `pkg:` — one or more packages resolved by `pkg-config`
 * `http://` / `https://` / `git@` — full URL
 
 Flags:
@@ -31,7 +34,12 @@ Flags:
 * `--tag \<name>` — git tag
 * `--rev \<hash>` — git commit
 
-If source is omitted — DCR searches connected registries.
+If source is omitted — DCR searches connected registries. A bare relative or absolute path is accepted as a path dependency.
+
+For `pkg-config` dependencies, the referenced packages must already be installed
+and provide `.pc` files. DCR invokes `pkg-config` during the build (using
+`PATH` and `PKG_CONFIG_PATH`) and forwards the returned compiler and linker
+flags; it does not download or build these packages.
 
 ## `dcr tree`
 

docs-crowdin-export/pl-PL/docs/contributing.mdx.mdx

@@ -8,6 +8,7 @@ sidebar_label: Contributing
 
 ```bash
 git clone https://github.com/dexoron/dcr
+# or a source mirror: GitVerse / SourceCraft / SourceForge / GitLab (see README)
 cd dcr
 cargo build
 ```

docs-crowdin-export/pl-PL/docs/faq.mdx.mdx

@@ -61,6 +61,15 @@ Use `kind = "flat-bin"` (NASM `-f bin`) and optional `[archive]` for a FAT disk
 
 See [OS-dev recipe](/docs/recipes/os-flat-bin-archive).
 
+## How do I choose a download mirror?
+
+`dcrup install` uses `--mirror auto` by default and tries **cf → gh → sf → ya**.
+
+```bash
+dcrup install stable --mirror cf
+export DCRUP_MIRROR=ya
+```
+
 ## Lock file
 
 `dcr.lock` is created during builds (`dcr build`) when registry dependencies are present. To force an update — delete `dcr.lock` and run `dcr build`.

docs-crowdin-export/pl-PL/docs/getting-started/installation.mdx.mdx

@@ -45,10 +45,12 @@ After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live
 ### Common dcrup commands
 
 ```sh
-dcrup install stable              # latest stable prebuilt
+dcrup install stable              # latest stable prebuilt (auto: cf → gh → sf → ya)
 dcrup install 0.8.2               # pin → 0.8.2@stable
 dcrup install 0.8.2@dev
 dcrup install stable --libc musl  # Linux: musl asset (default: gnu)
+dcrup install stable --mirror cf  # CloudFlare CDN
+dcrup install stable --mirror ya  # Yandex CDN (RU fallback)
 dcrup install stable --build      # cargo build --features archive
 dcrup install night               # always build from branch dev HEAD
 dcrup default 0.8.2
@@ -60,6 +62,22 @@ dcrup which
 
 Layout: `~/.dcr/toolchains/\<id>/dcr` and `~/.dcr/bin/dcr` → active version.
 
+### Download mirrors
+
+Prebuilt installs try **cf → gh → sf → ya** unless you pin a host.
+
+| Code | URL                                                                                                          | Notes                      |
+| ---- | ------------------------------------------------------------------------------------------------------------ | -------------------------- |
+| `cf` | `https://cdn-global.dcr-tool.ru/\<tag>/\<asset>`                           | CloudFlare CDN (worldwide) |
+| `gh` | `https://github.com/dexoron/dcr/releases/download/\<tag>/\<asset>`         | GitHub Releases            |
+| `sf` | `https://sourceforge.net/projects/dcr-tool/files/\<tag>/\<asset>/download` | SourceForge                |
+| `ya` | `https://cdn-ru.dcr-tool.ru/\<tag>/\<asset>`                               | Yandex CDN (RU fallback)   |
+
+```sh
+dcrup install stable --mirror auto   # default
+export DCRUP_MIRROR=cf               # persist for this shell
+```
+
 ---
 
 ## Arch Linux (AUR)

docs-crowdin-export/pl-PL/docs/ide-integration.mdx.mdx

@@ -6,6 +6,13 @@ sidebar_label: IDE Integration
 
 ## VS Code
 
+Install the recommended [DCR extension by Dexoron-Labs](https://marketplace.visualstudio.com/items?itemName=Dexoron-Labs.dcr). Do not install Microsoft C/C++ extensions for DCR projects: DCR uses `clangd`. MS C/C++ is acceptable only when you need its debugger.
+
+Recommended companion extensions:
+
+* [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)
+* [CodeLLDB](https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb), or MS C/C++ for debugger support only
+
 ```bash
 dcr gen vscode
 ```

docs-crowdin-export/pl-PL/docs/reference/dcr-toml.mdx.mdx

@@ -40,23 +40,39 @@ Main project configuration file. Located at the project root.
 
 ## [package]
 
-| Field     | Required | Description                                 |
+| Field         | Required | Description                                                                                                     |
-| --------- | -------- | ------------------------------------------- |
+| ------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `name`    | yes      | Project name                                |
+| `name`        | yes      | Project name                                                                                                    |
-| `version` | yes      | Semantic version                            |
+| `version`     | yes      | Semantic version of the **project**                                                                             |
-| `type`    | no       | `app`, `lib`, `none` (defaults to `"none"`) |
+| `dcr-version` | no       | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `license` | no       | SPDX license identifier                     |
+| `type`        | no       | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `author`  | no       | Author                                      |
+| `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]
 
 ...
@@ -96,7 +112,12 @@ author = "John Doe"
 
 Settings from raw config (not in typed struct):
 
-* `pkg_config` — list of pkg-config packages
+* `pkg_config` — list of packages queried for build-wide compiler/linker flags
+
+Dependencies can also declare a system package directly, for example
+`fmt = { pkg-config = "fmt" }`. This records the package in `dcr.lock` and applies
+the flags returned by `pkg-config --cflags` and `pkg-config --libs`.
+
 * `ldscript` — linker script path
 * `build.steps` / `build.post_steps` — codegen steps
 

docs-crowdin-export/pl-PL/docs/reference/dependencies.mdx.mdx

@@ -6,7 +6,7 @@ sidebar_label: Dependencies
 
 ## Formats
 
-The `[dependencies]` section supports three formats:
+The `[dependencies]` section supports registry, path, Git, and `pkg-config` dependencies:
 
 ### String (registry)
 
@@ -23,10 +23,10 @@ The version string is used as-is for registry lookup.
 
 ```toml
 [dependencies]
-fmt = { git = "https://github.com/fmtlib/fmt", tag = "10.1.1" }
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0" }
 ```
 
-Fields: `git`, `branch`, `tag`, `rev`.
+Fields: `git`, `branch`, `tag`, `rev`, `mode`, `include`, `lib`, `libs`.
 
 ### Table (path)
 
@@ -35,6 +35,32 @@ Fields: `git`, `branch`, `tag`, `rev`.
 mylib = { path = "../mylib" }
 ```
 
+For a prebuilt external library, specify its layout explicitly. The three
+arrays are paths relative to the dependency root (`include`, `lib`) and linker
+names (`libs`):
+
+```toml
+[dependencies]
+dcr-math = { path = "../deps/dcr-math", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+### Table (`pkg-config`)
+
+Use an installed `.pc` package when the library is provided by the operating system
+or another system package manager. DCR invokes `pkg-config --cflags` and
+`pkg-config --libs`, preserving include, library, linker, and other flags:
+
+```toml
+[dependencies]
+fmt = { pkg-config = "fmt" }
+openssl = { pkg-config = ["openssl", "libcrypto"] }
+```
+
+The `pkg-config` executable must be available in `PATH`. The named `.pc` files must
+be available through pkg-config's standard search paths or via `PKG_CONFIG_PATH`.
+These dependencies are not downloaded or built by DCR; they are recorded in
+`dcr.lock` with a `pkg-config+...` source.
+
 ## Registry
 
 DCR uses a package registry for dependency lookup by name.
@@ -42,7 +68,7 @@ DCR uses a package registry for dependency lookup by name.
 ```toml
 # ~/.dcr/config.toml
 [registry.default]
-url = "https://index.dcr.pm"
+url = "https://index.dcr.dexoron.tech"
 priority = 1
 ```
 
@@ -50,7 +76,23 @@ Registry priority: order in `config.toml`. The `DCR_INDEX_PATH` variable overrid
 
 ## Git dependencies
 
-Git dependencies are parsed and recorded in `dcr.lock`. DCR supports specifying branch/tag/rev for git sources:
+Git dependencies are cloned into `~/.dcr/git/`; their exact checked-out commit is written to `dcr.lock`.
+
+Both Git and path dependencies have two modes:
+
+* **DCR package:** the source has `dcr.toml`. DCR builds it before the consumer and uses the package name from its manifest for linking.
+* **Prebuilt library:** it provides existing headers and binaries through `include`, `lib`, and `libs`. DCR passes them to the compiler/linker without building the dependency.
+
+The mode is normally detected automatically. Use `mode = "build"` or `mode = "prebuild"` when a source contains both a manifest and prebuilt artifacts and you need to choose explicitly.
+
+`dcr-math-lib` publishes both forms. Select its prebuilt library explicitly:
+
+```toml
+[dependencies]
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0", mode = "prebuild", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+DCR supports specifying branch/tag/rev for git sources:
 
 * `branch` — switch to a branch
 * `tag` — switch to a tag
@@ -59,7 +101,7 @@ Git dependencies are parsed and recorded in `dcr.lock`. DCR supports specifying
 
 ## Path dependencies
 
-Local paths. DCR automatically discovers include and lib directories from the neighbor's `dcr.toml`.
+Local paths may point at a DCR package or a prebuilt external library. A path DCR package is built before its consumer, including its own path/git dependencies. DCR detects dependency cycles. A prebuilt library is never built by DCR; it is linked from the directories declared in its dependency entry.
 
 ```toml
 [dependencies]
@@ -67,18 +109,51 @@ mylib = { path = "/abs/path/to/lib" }
 mylib = { path = "../relative/path" }
 ```
 
-*Note: Header resolution automatically checks the packaged `target/include` directory of path dependencies, ensuring consumer packages can find headers from compiled static or dynamic libraries.*
+For DCR packages, the package name from `dcr.toml` is used for linking (so the dependency key may differ from the library name). Header resolution includes the packaged `target/include` directory and link search includes `target/lib`.
+
+### Recommended library layouts
+
+Buildable DCR library:
+
+```text
+dcr-math-lib/
+├── dcr.toml
+└── src/
+    ├── dcr_math.c
+    └── dcr_math.h
+```
+
+Prebuilt library:
+
+```text
+dcr-math-lib/
+├── include/
+│   └── dcr_math.h
+└── lib/
+    └── libdcr-math.a       # or .so / .lib
+```
+
+`libs` contains linker names without the `lib` prefix and file extension: use
+`["dcr-math"]` for `libdcr-math.a`.
+
+If one repository contains both forms, keep the prebuilt files in `include/` and `lib/` and select the mode explicitly:
+
+```toml
+[dependencies]
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0", mode = "prebuild", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+For a local copy, replace `git` with `path = "../dcr-math-lib"`. In `prebuild` mode DCR does not run the dependency build, even when `dcr.toml` is present.
 
 ## dcr.lock
 
 Dependency lock file. Contains package names and sources.
 
-Created during `dcr build` when registry dependencies are present. Not updated during `dcr add` — only on the next `dcr build`.
+Created during `dcr build` for resolved registry, path, and Git dependencies. Not updated during `dcr add` — only on the next `dcr build`.
 
 ## Resolution process
 
-1. Load all dependencies (registry → git → path)
+1. Resolve dependency sources (registry → git → path)
-2. For path deps: recursively read their `dcr.toml`
+2. Fetch git dependencies into `~/.dcr/git/` and check out the requested ref
-3. For registry deps: search `index.json`
+3. Build DCR package dependencies recursively
-4. For git deps: clone to cache
+4. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler
-5. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler

docs-crowdin-export/pl-PL/docs/reference/environment-variables.mdx.mdx

@@ -58,3 +58,27 @@ export DCR_INDEX_PATH=/custom/path/index.json
 ```
 
 Default: `~/.dcr/index.json`.
+
+## DCRUP_MIRROR
+
+Download mirror for `dcrup` (prebuilt binaries only).
+
+```bash
+export DCRUP_MIRROR=auto   # cf → gh → sf → ya (default)
+export DCRUP_MIRROR=cf     # CloudFlare CDN
+export DCRUP_MIRROR=gh     # GitHub Releases
+export DCRUP_MIRROR=sf     # SourceForge
+export DCRUP_MIRROR=ya     # Yandex CDN (RU fallback)
+```
+
+CLI override: `dcrup install stable --mirror cf`.
+
+## DCRUP_HOME / DCRUP_BIN / DCRUP_REPO
+
+Installer layout and source clone URL:
+
+```bash
+export DCRUP_HOME=~/.dcr
+export DCRUP_BIN=~/.dcr/bin
+export DCRUP_REPO=https://github.com/dexoron/dcr
+```

docs-crowdin-export/ru-RU/docs/README.mdx.mdx

@@ -11,7 +11,8 @@ sidebar_label: Введение
 # Installation (dcrup)
 curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
 export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable
+dcrup install stable                 # auto: cf → gh → sf → ya
+# dcrup install stable --mirror cf   # CloudFlare / GitHub / SourceForge / Yandex
 
 # Create a project
 dcr new my-app

docs-crowdin-export/ru-RU/docs/changelog.mdx.mdx

@@ -4,6 +4,63 @@ sidebar_label: Список изменений
 
 # Список изменений
 
+## 0.9.1 (2026-09-13)
+
+* **`pkg-config` dependencies** — declare `fmt = { pkg-config = "fmt" }` or multiple package names in `[dependencies]`; DCR applies `.pc` compiler/linker flags and records the resolved package in `dcr.lock`.
+* **`dcr add` support for `pkg-config`** — easily add system package dependencies with `dcr add fmt pkg-config:fmt` or `dcr add openssl pkg:openssl,libcrypto`.
+* **`dcr tree` & IDE integration** — `pkg-config` packages are marked in `dcr tree` and resolved into compiler flags in `dcr gen` (`compile_commands.json`).
+* **Fixed `dcr new` in non-ASCII / spaced paths** — initializing projects from folders with non-ASCII characters or spaces no longer fails validation.
+
+## 0.9.0 (2026-08-31)
+
+* **Download mirrors in `dcrup`** — `--mirror auto|cf|gh|sf|ya` and `DCRUP_MIRROR`.
+  Default `auto` tries **cf → gh → sf → ya** (CloudFlare CDN, GitHub, SourceForge, Yandex CDN).
+* **Complete Path/Git dependencies** — DCR packages from `path` and `git` are built before their consumer. Git sources are cached in `~/.dcr/git`, support `branch`/`tag`/`rev`, and record the exact commit in `dcr.lock`.
+* **Build and prebuild modes** — `path` and `git` dependencies can build a DCR package from `dcr.toml` or link existing `include`/`lib`/`libs` artifacts; `mode = "build"` / `"prebuild"` selects explicitly when both forms are present.
+* **Prebuilt dependency examples** — documentation now shows the `dcr-math-lib` Git repository and recommended build/prebuilt layouts for both `git` and `path`.
+* **Transitive dependency builds and cycle reporting** — DCR recursively builds DCR packages and reports a clear dependency chain for cycles.
+* **Bare path arguments for `dcr add`** — `dcr add mylib ../mylib` now works in addition to the explicit `path:` form.
+* **Removed `install.sh` / `install.ps1` / `install_bsd.sh`** — superseded by `dcrup`.
+
+## 0.8.5 (2026-08-08)
+
+* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
+  `dcr new` / `dcr init` write the current version. On config load:
+  * missing / empty pin → warn "add dcr-version";
+  * dcr older than pin → warn "update dcr";
+  * dcr newer than pin → warn "check changelog, update pin";
+  * equal → silent.
+    Commands do not fail, warning only (once per path per process).
+
+## 0.8.4 (2026-08-04)
+
+**Added:**
+
+* **`.dcr/` directory** — shared machine-readable build facts for IDE integrations:
+  * `.dcr/compile_commands.json`
+  * `.dcr/build-info.json` (`schemaVersion`, `artifact_path`, `profile`, …)
+  * `.dcr/toolchain.json` (compiler/debugger paths, moc/uic/rcc)
+  * `.dcr/ide/` (placeholder for IDE lock files)
+* **`dcr gen project-info`** — `target`, `target_dir`, `artifact_path`, `artifact_kind`, `source_roots`, `include_globs`, `exclude_globs`; absolute/canonical paths.
+* **`dcr build --print-artifact-path`** — one absolute artifact path line on stdout after a successful build.
+* **`dcr gen … --quiet` / `-q`** — suppress human success logs for gen subcommands.
+* **`.clangd`** — created on first gen with `CompilationDatabase: .dcr` (`# managed by dcr gen`); custom `.clangd` is not overwritten.
+* **Helpers** `canonicalize_path`, `atomic_write`, `ensure_dcr_dir`; pure `resolve_artifact_path` via `platform::*`.
+* **`dcr new` / `dcr init`** — add `.dcr/` to `.gitignore`.
+
+**Changed (breaking):**
+
+* **`compile_commands.json` moved** from project root to **`.dcr/compile_commands.json`**.\
+  clangd discovers it via `.clangd` / `--compile-commands-dir=.dcr`.\
+  CLion and VSCode generators updated accordingly.
+* **Atomic write** for compile_commands (tmp + rename).
+* **`gen vscode` / `gen clion` launch/run** — use the same artifact path resolver as `project-info` / `build-info.json`.
+
+**Fixed:**
+
+* Launch configs no longer hardcode `target/\<profile>/\<name>` without the Linux triple segment.
+* Symlink/mount roots: best-effort canonicalize for root and compile database paths.
+
 ## 0.8.3 (2026-08-03)
 
 ### Добавлено:

docs-crowdin-export/ru-RU/docs/commands/dependency-commands.mdx.mdx

@@ -9,12 +9,14 @@ sidebar_label: Команды зависимостей (add, tree)
 Добавляет зависимость в `dcr.toml`.
 
 ```bash
-dcr add fmt                    # поиск в реестре
+dcr add fmt                    # registry lookup
-dcr add mylib ../path/to/lib   # путь как источник
+dcr add mylib ../path/to/lib   # path as source
-dcr add mylib path:./lib       # явный префикс пути
+dcr add mylib path:./lib       # explicit path prefix
-dcr add mylib git:https://github.com/user/repo  # явный префикс git
+dcr add mylib git:https://github.com/user/repo  # explicit git prefix
-dcr add mylib github:user/repo # сокращённая запись GitHub
+dcr add mylib github:user/repo # GitHub shorthand
-dcr add mylib gitlab:user/repo # сокращённая запись GitLab
+dcr add mylib gitlab:user/repo # GitLab shorthand
+dcr add fmt pkg-config:fmt     # system package via pkg-config
+dcr add openssl pkg:openssl,libcrypto # multiple pkg-config packages
 ```
 
 Префиксы источника:
@@ -23,6 +25,7 @@ dcr add mylib gitlab:user/repo # сокращённая запись GitLab
 * `git:` — URL адрес git-репозитория
 * `github:` — расширение `https://github.com/\<user>/\<repo>`
 * `gitlab:` — расширение `https://gitlab.com/\<user>/\<repo>`
+* `pkg-config:` / `pkg:` — one or more packages resolved by `pkg-config`
 * `http://` / `https://` / `git@` — полный URL
 
 Флаги:
@@ -31,7 +34,12 @@ dcr add mylib gitlab:user/repo # сокращённая запись GitLab
 * `--tag \<name>` — git tag
 * `--rev \<hash>` — git commit
 
-Если источник не указан — DCR выполняет поиск в подключенных реестрах.
+Если источник не указан — DCR выполняет поиск в подключенных реестрах. A bare relative or absolute path is accepted as a path dependency.
+
+For `pkg-config` dependencies, the referenced packages must already be installed
+and provide `.pc` files. DCR invokes `pkg-config` during the build (using
+`PATH` and `PKG_CONFIG_PATH`) and forwards the returned compiler and linker
+flags; it does not download or build these packages.
 
 ## `dcr tree`
 

docs-crowdin-export/ru-RU/docs/contributing.mdx.mdx

@@ -8,6 +8,7 @@ sidebar_label: Вклад
 
 ```bash
 git clone https://github.com/dexoron/dcr
+# or a source mirror: GitVerse / SourceCraft / SourceForge / GitLab (see README)
 cd dcr
 cargo build
 ```

docs-crowdin-export/ru-RU/docs/faq.mdx.mdx

@@ -61,6 +61,15 @@ Use `kind = "flat-bin"` (NASM `-f bin`) and optional `[archive]` for a FAT disk
 
 See [OS-dev recipe](/docs/recipes/os-flat-bin-archive).
 
+## How do I choose a download mirror?
+
+`dcrup install` uses `--mirror auto` by default and tries **cf → gh → sf → ya**.
+
+```bash
+dcrup install stable --mirror cf
+export DCRUP_MIRROR=ya
+```
+
 ## Lock-файл устарел
 
 При изменении зависимостей `dcr.lock` автоматически обновляется при следующем `dcr add`. Если нужно принудительно обновить — удалите `dcr.lock` и выполните `dcr build`.

docs-crowdin-export/ru-RU/docs/getting-started/installation.mdx.mdx

@@ -45,10 +45,12 @@ After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live
 ### Common dcrup commands
 
 ```sh
-dcrup install stable              # latest stable prebuilt
+dcrup install stable              # latest stable prebuilt (auto: cf → gh → sf → ya)
 dcrup install 0.8.2               # pin → 0.8.2@stable
 dcrup install 0.8.2@dev
 dcrup install stable --libc musl  # Linux: musl asset (default: gnu)
+dcrup install stable --mirror cf  # CloudFlare CDN
+dcrup install stable --mirror ya  # Yandex CDN (RU fallback)
 dcrup install stable --build      # cargo build --features archive
 dcrup install night               # always build from branch dev HEAD
 dcrup default 0.8.2
@@ -60,6 +62,22 @@ dcrup which
 
 Layout: `~/.dcr/toolchains/\<id>/dcr` and `~/.dcr/bin/dcr` → active version.
 
+### Download mirrors
+
+Prebuilt installs try **cf → gh → sf → ya** unless you pin a host.
+
+| Code | URL                                                                                                          | Notes                      |
+| ---- | ------------------------------------------------------------------------------------------------------------ | -------------------------- |
+| `cf` | `https://cdn-global.dcr-tool.ru/\<tag>/\<asset>`                           | CloudFlare CDN (worldwide) |
+| `gh` | `https://github.com/dexoron/dcr/releases/download/\<tag>/\<asset>`         | GitHub Releases            |
+| `sf` | `https://sourceforge.net/projects/dcr-tool/files/\<tag>/\<asset>/download` | SourceForge                |
+| `ya` | `https://cdn-ru.dcr-tool.ru/\<tag>/\<asset>`                               | Yandex CDN (RU fallback)   |
+
+```sh
+dcrup install stable --mirror auto   # default
+export DCRUP_MIRROR=cf               # persist for this shell
+```
+
 ---
 
 ## Arch Linux (AUR)

docs-crowdin-export/ru-RU/docs/ide-integration.mdx.mdx

@@ -6,6 +6,13 @@ sidebar_label: Интеграция с IDE
 
 ## VS Code
 
+Install the recommended [DCR extension by Dexoron-Labs](https://marketplace.visualstudio.com/items?itemName=Dexoron-Labs.dcr). Do not install Microsoft C/C++ extensions for DCR projects: DCR uses `clangd`. MS C/C++ is acceptable only when you need its debugger.
+
+Recommended companion extensions:
+
+* [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)
+* [CodeLLDB](https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb), or MS C/C++ for debugger support only
+
 ```bash
 dcr gen vscode
 ```

docs-crowdin-export/ru-RU/docs/reference/dcr-toml.mdx.mdx

@@ -40,23 +40,39 @@ sidebar_label: Обзор dcr.toml
 
 ## [пакет]
 
-| Поле       | Обязательное | Описание                                    |
+| Поле          | Обязательное | Описание                                                                                                        |
-| ---------- | ------------ | ------------------------------------------- |
+| ------------- | ------------ | --------------------------------------------------------------------------------------------------------------- |
-| `имя`      | да           | Имя проекта                                 |
+| `имя`         | да           | Имя проекта                                                                                                     |
-| `версия`   | да           | Семантическая версия                        |
+| `версия`      | да           | Semantic version of the **project**                                                                             |
-| `тип`      | no           | `app`, `lib`, `none` (defaults to `"none"`) |
+| `dcr-version` | no           | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `лицензия` | нет          | SPDX-идентификатор лицензии                 |
+| `тип`         | нет          | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `автор`    | нет          | Автор                                       |
+| `лицензия`    | нет          | SPDX-идентификатор лицензии                                                                                     |
+| `автор`       | no           | Автор                                                                                                           |
 
 ```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`).
+
 ## [сборка]
 
 ...
@@ -96,7 +112,12 @@ author = "John Doe"
 
 Параметры из исходного файла конфигурации (не в виде типизированной структуры):
 
-* Пакеты для pkg-config
+* `pkg_config` — list of packages queried for build-wide compiler/linker flags
+
+Dependencies can also declare a system package directly, for example
+`fmt = { pkg-config = "fmt" }`. This records the package in `dcr.lock` and applies
+the flags returned by `pkg-config --cflags` and `pkg-config --libs`.
+
 * Путь к linker script
 * `build.steps` / `build.post_steps` — этапы генерации кода
 

docs-crowdin-export/ru-RU/docs/reference/dependencies.mdx.mdx

@@ -6,7 +6,7 @@ sidebar_label: Зависимости
 
 ## Форматы
 
-В секции `[dependencies]` поддерживаются три формата:
+The `[dependencies]` section supports registry, path, Git, and `pkg-config` dependencies:
 
 ### Строка (реестр)
 
@@ -23,10 +23,10 @@ catch2 = ">=3.0,<4.0"
 
 ```toml
 [dependencies]
-fmt = { git = "https://github.com/fmtlib/fmt", tag = "10.1.1" }
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0" }
 ```
 
-Поля: `git`, `branch`, `tag`, `rev`, `features`.
+Fields: `git`, `branch`, `tag`, `rev`, `mode`, `include`, `lib`, `libs`.
 
 ### Табличный (path)
 
@@ -35,6 +35,32 @@ fmt = { git = "https://github.com/fmtlib/fmt", tag = "10.1.1" }
 mylib = { path = "../mylib" }
 ```
 
+For a prebuilt external library, specify its layout explicitly. The three
+arrays are paths relative to the dependency root (`include`, `lib`) and linker
+names (`libs`):
+
+```toml
+[dependencies]
+dcr-math = { path = "../deps/dcr-math", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+### Table (`pkg-config`)
+
+Use an installed `.pc` package when the library is provided by the operating system
+or another system package manager. DCR invokes `pkg-config --cflags` and
+`pkg-config --libs`, preserving include, library, linker, and other flags:
+
+```toml
+[dependencies]
+fmt = { pkg-config = "fmt" }
+openssl = { pkg-config = ["openssl", "libcrypto"] }
+```
+
+The `pkg-config` executable must be available in `PATH`. The named `.pc` files must
+be available through pkg-config's standard search paths or via `PKG_CONFIG_PATH`.
+These dependencies are not downloaded or built by DCR; they are recorded in
+`dcr.lock` with a `pkg-config+...` source.
+
 ## Реестр
 
 ## RegistryDCR использует реестр пакетов для поиска зависимостей по имени.```toml
@@ -46,7 +72,7 @@ main = { url = "https://github.com/dcr-ports/dcr-index", priority = 1 }
 ```toml
 # ~/.dcr/config.toml
 [registry.default]
-url = "https://index.dcr.pm"
+url = "https://index.dcr.dexoron.tech"
 priority = 1
 ```
 
@@ -54,7 +80,23 @@ priority = 1
 
 ## Git-зависимости
 
-Git dependencies are parsed and recorded in `dcr.lock`. DCR supports specifying branch/tag/rev for git sources:
+Git dependencies are cloned into `~/.dcr/git/`; their exact checked-out commit is written to `dcr.lock`.
+
+Both Git and path dependencies have two modes:
+
+* **DCR package:** the source has `dcr.toml`. DCR builds it before the consumer and uses the package name from its manifest for linking.
+* **Prebuilt library:** it provides existing headers and binaries through `include`, `lib`, and `libs`. DCR passes them to the compiler/linker without building the dependency.
+
+The mode is normally detected automatically. Use `mode = "build"` or `mode = "prebuild"` when a source contains both a manifest and prebuilt artifacts and you need to choose explicitly.
+
+`dcr-math-lib` publishes both forms. Select its prebuilt library explicitly:
+
+```toml
+[dependencies]
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0", mode = "prebuild", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+DCR supports specifying branch/tag/rev for git sources:
 
 * `branch` — переключиться на ветку
 * `tag` — переключиться на тег
@@ -63,7 +105,7 @@ Git dependencies are parsed and recorded in `dcr.lock`. DCR supports specifying
 
 ## Path dependencies
 
-Local paths. DCR automatically discovers include and lib directories from the neighbor's `dcr.toml`.
+Local paths may point at a DCR package or a prebuilt external library. A path DCR package is built before its consumer, including its own path/git dependencies. DCR detects dependency cycles. A prebuilt library is never built by DCR; it is linked from the directories declared in its dependency entry.
 
 ```toml
 [dependencies]
@@ -71,18 +113,51 @@ mylib = { path = "/abs/path/to/lib" }
 mylib = { path = "../relative/path" }
 ```
 
-*Note: Header resolution automatically checks the packaged `target/include` directory of path dependencies, ensuring consumer packages can find headers from compiled static or dynamic libraries.*
+For DCR packages, the package name from `dcr.toml` is used for linking (so the dependency key may differ from the library name). Header resolution includes the packaged `target/include` directory and link search includes `target/lib`.
+
+### Recommended library layouts
+
+Buildable DCR library:
+
+```text
+dcr-math-lib/
+├── dcr.toml
+└── src/
+    ├── dcr_math.c
+    └── dcr_math.h
+```
+
+Prebuilt library:
+
+```text
+dcr-math-lib/
+├── include/
+│   └── dcr_math.h
+└── lib/
+    └── libdcr-math.a       # or .so / .lib
+```
+
+`libs` contains linker names without the `lib` prefix and file extension: use
+`["dcr-math"]` for `libdcr-math.a`.
+
+If one repository contains both forms, keep the prebuilt files in `include/` and `lib/` and select the mode explicitly:
+
+```toml
+[dependencies]
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0", mode = "prebuild", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+For a local copy, replace `git` with `path = "../dcr-math-lib"`. In `prebuild` mode DCR does not run the dependency build, even when `dcr.toml` is present.
 
 ## dcr.lock
 
 Dependency lock file. Contains package names and sources.
 
-Created during `dcr build` when registry dependencies are present. Not updated during `dcr add` — only on the next `dcr build`.
+Created during `dcr build` for resolved registry, path, and Git dependencies. Not updated during `dcr add` — only on the next `dcr build`.
 
 ## Resolution process
 
-1. Load all dependencies (registry → git → path)
+1. Resolve dependency sources (registry → git → path)
-2. For path deps: recursively read their `dcr.toml`
+2. Fetch git dependencies into `~/.dcr/git/` and check out the requested ref
-3. For registry deps: search `index.json`
+3. Build DCR package dependencies recursively
-4. For git deps: clone to cache
+4. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler
-5. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler

docs-crowdin-export/ru-RU/docs/reference/environment-variables.mdx.mdx

@@ -58,3 +58,27 @@ export DCR_INDEX_PATH=/custom/path/index.json
 ```
 
 По умолчанию: `~/.dcr/index.json`.
+
+## DCRUP_MIRROR
+
+Download mirror for `dcrup` (prebuilt binaries only).
+
+```bash
+export DCRUP_MIRROR=auto   # cf → gh → sf → ya (default)
+export DCRUP_MIRROR=cf     # CloudFlare CDN
+export DCRUP_MIRROR=gh     # GitHub Releases
+export DCRUP_MIRROR=sf     # SourceForge
+export DCRUP_MIRROR=ya     # Yandex CDN (RU fallback)
+```
+
+CLI override: `dcrup install stable --mirror cf`.
+
+## DCRUP_HOME / DCRUP_BIN / DCRUP_REPO
+
+Installer layout and source clone URL:
+
+```bash
+export DCRUP_HOME=~/.dcr
+export DCRUP_BIN=~/.dcr/bin
+export DCRUP_REPO=https://github.com/dexoron/dcr
+```

docs-crowdin-export/uk-UA/docs/README.mdx.mdx

@@ -11,7 +11,8 @@ sidebar_label: Introduction
 # Installation (dcrup)
 curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
 export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable
+dcrup install stable                 # auto: cf → gh → sf → ya
+# dcrup install stable --mirror cf   # CloudFlare / GitHub / SourceForge / Yandex
 
 # Create a project
 dcr new my-app

docs-crowdin-export/uk-UA/docs/changelog.mdx.mdx

@@ -4,6 +4,63 @@ sidebar_label: Changelog
 
 # Changelog
 
+## 0.9.1 (2026-09-13)
+
+* **`pkg-config` dependencies** — declare `fmt = { pkg-config = "fmt" }` or multiple package names in `[dependencies]`; DCR applies `.pc` compiler/linker flags and records the resolved package in `dcr.lock`.
+* **`dcr add` support for `pkg-config`** — easily add system package dependencies with `dcr add fmt pkg-config:fmt` or `dcr add openssl pkg:openssl,libcrypto`.
+* **`dcr tree` & IDE integration** — `pkg-config` packages are marked in `dcr tree` and resolved into compiler flags in `dcr gen` (`compile_commands.json`).
+* **Fixed `dcr new` in non-ASCII / spaced paths** — initializing projects from folders with non-ASCII characters or spaces no longer fails validation.
+
+## 0.9.0 (2026-08-31)
+
+* **Download mirrors in `dcrup`** — `--mirror auto|cf|gh|sf|ya` and `DCRUP_MIRROR`.
+  Default `auto` tries **cf → gh → sf → ya** (CloudFlare CDN, GitHub, SourceForge, Yandex CDN).
+* **Complete Path/Git dependencies** — DCR packages from `path` and `git` are built before their consumer. Git sources are cached in `~/.dcr/git`, support `branch`/`tag`/`rev`, and record the exact commit in `dcr.lock`.
+* **Build and prebuild modes** — `path` and `git` dependencies can build a DCR package from `dcr.toml` or link existing `include`/`lib`/`libs` artifacts; `mode = "build"` / `"prebuild"` selects explicitly when both forms are present.
+* **Prebuilt dependency examples** — documentation now shows the `dcr-math-lib` Git repository and recommended build/prebuilt layouts for both `git` and `path`.
+* **Transitive dependency builds and cycle reporting** — DCR recursively builds DCR packages and reports a clear dependency chain for cycles.
+* **Bare path arguments for `dcr add`** — `dcr add mylib ../mylib` now works in addition to the explicit `path:` form.
+* **Removed `install.sh` / `install.ps1` / `install_bsd.sh`** — superseded by `dcrup`.
+
+## 0.8.5 (2026-08-08)
+
+* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
+  `dcr new` / `dcr init` write the current version. On config load:
+  * missing / empty pin → warn "add dcr-version";
+  * dcr older than pin → warn "update dcr";
+  * dcr newer than pin → warn "check changelog, update pin";
+  * equal → silent.
+    Commands do not fail, warning only (once per path per process).
+
+## 0.8.4 (2026-08-04)
+
+**Added:**
+
+* **`.dcr/` directory** — shared machine-readable build facts for IDE integrations:
+  * `.dcr/compile_commands.json`
+  * `.dcr/build-info.json` (`schemaVersion`, `artifact_path`, `profile`, …)
+  * `.dcr/toolchain.json` (compiler/debugger paths, moc/uic/rcc)
+  * `.dcr/ide/` (placeholder for IDE lock files)
+* **`dcr gen project-info`** — `target`, `target_dir`, `artifact_path`, `artifact_kind`, `source_roots`, `include_globs`, `exclude_globs`; absolute/canonical paths.
+* **`dcr build --print-artifact-path`** — one absolute artifact path line on stdout after a successful build.
+* **`dcr gen … --quiet` / `-q`** — suppress human success logs for gen subcommands.
+* **`.clangd`** — created on first gen with `CompilationDatabase: .dcr` (`# managed by dcr gen`); custom `.clangd` is not overwritten.
+* **Helpers** `canonicalize_path`, `atomic_write`, `ensure_dcr_dir`; pure `resolve_artifact_path` via `platform::*`.
+* **`dcr new` / `dcr init`** — add `.dcr/` to `.gitignore`.
+
+**Changed (breaking):**
+
+* **`compile_commands.json` moved** from project root to **`.dcr/compile_commands.json`**.\
+  clangd discovers it via `.clangd` / `--compile-commands-dir=.dcr`.\
+  CLion and VSCode generators updated accordingly.
+* **Atomic write** for compile_commands (tmp + rename).
+* **`gen vscode` / `gen clion` launch/run** — use the same artifact path resolver as `project-info` / `build-info.json`.
+
+**Fixed:**
+
+* Launch configs no longer hardcode `target/\<profile>/\<name>` without the Linux triple segment.
+* Symlink/mount roots: best-effort canonicalize for root and compile database paths.
+
 ## 0.8.3 (2026-08-03)
 
 ### Added

docs-crowdin-export/uk-UA/docs/commands/dependency-commands.mdx.mdx

@@ -15,6 +15,8 @@ dcr add mylib path:./lib       # explicit path prefix
 dcr add mylib git:https://github.com/user/repo  # explicit git prefix
 dcr add mylib github:user/repo # GitHub shorthand
 dcr add mylib gitlab:user/repo # GitLab shorthand
+dcr add fmt pkg-config:fmt     # system package via pkg-config
+dcr add openssl pkg:openssl,libcrypto # multiple pkg-config packages
 ```
 
 Source prefixes:
@@ -23,6 +25,7 @@ Source prefixes:
 * `git:` — generic git URL
 * `github:` — expands to `https://github.com/\<user>/\<repo>`
 * `gitlab:` — expands to `https://gitlab.com/\<user>/\<repo>`
+* `pkg-config:` / `pkg:` — one or more packages resolved by `pkg-config`
 * `http://` / `https://` / `git@` — full URL
 
 Flags:
@@ -31,7 +34,12 @@ Flags:
 * `--tag \<name>` — git tag
 * `--rev \<hash>` — git commit
 
-If source is omitted — DCR searches connected registries.
+If source is omitted — DCR searches connected registries. A bare relative or absolute path is accepted as a path dependency.
+
+For `pkg-config` dependencies, the referenced packages must already be installed
+and provide `.pc` files. DCR invokes `pkg-config` during the build (using
+`PATH` and `PKG_CONFIG_PATH`) and forwards the returned compiler and linker
+flags; it does not download or build these packages.
 
 ## `dcr tree`
 

docs-crowdin-export/uk-UA/docs/contributing.mdx.mdx

@@ -8,6 +8,7 @@ sidebar_label: Contributing
 
 ```bash
 git clone https://github.com/dexoron/dcr
+# or a source mirror: GitVerse / SourceCraft / SourceForge / GitLab (see README)
 cd dcr
 cargo build
 ```

docs-crowdin-export/uk-UA/docs/faq.mdx.mdx

@@ -61,6 +61,15 @@ Use `kind = "flat-bin"` (NASM `-f bin`) and optional `[archive]` for a FAT disk
 
 See [OS-dev recipe](/docs/recipes/os-flat-bin-archive).
 
+## How do I choose a download mirror?
+
+`dcrup install` uses `--mirror auto` by default and tries **cf → gh → sf → ya**.
+
+```bash
+dcrup install stable --mirror cf
+export DCRUP_MIRROR=ya
+```
+
 ## Lock file
 
 `dcr.lock` is created during builds (`dcr build`) when registry dependencies are present. To force an update — delete `dcr.lock` and run `dcr build`.

docs-crowdin-export/uk-UA/docs/getting-started/installation.mdx.mdx

@@ -45,10 +45,12 @@ After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live
 ### Common dcrup commands
 
 ```sh
-dcrup install stable              # latest stable prebuilt
+dcrup install stable              # latest stable prebuilt (auto: cf → gh → sf → ya)
 dcrup install 0.8.2               # pin → 0.8.2@stable
 dcrup install 0.8.2@dev
 dcrup install stable --libc musl  # Linux: musl asset (default: gnu)
+dcrup install stable --mirror cf  # CloudFlare CDN
+dcrup install stable --mirror ya  # Yandex CDN (RU fallback)
 dcrup install stable --build      # cargo build --features archive
 dcrup install night               # always build from branch dev HEAD
 dcrup default 0.8.2
@@ -60,6 +62,22 @@ dcrup which
 
 Layout: `~/.dcr/toolchains/\<id>/dcr` and `~/.dcr/bin/dcr` → active version.
 
+### Download mirrors
+
+Prebuilt installs try **cf → gh → sf → ya** unless you pin a host.
+
+| Code | URL                                                                                                          | Notes                      |
+| ---- | ------------------------------------------------------------------------------------------------------------ | -------------------------- |
+| `cf` | `https://cdn-global.dcr-tool.ru/\<tag>/\<asset>`                           | CloudFlare CDN (worldwide) |
+| `gh` | `https://github.com/dexoron/dcr/releases/download/\<tag>/\<asset>`         | GitHub Releases            |
+| `sf` | `https://sourceforge.net/projects/dcr-tool/files/\<tag>/\<asset>/download` | SourceForge                |
+| `ya` | `https://cdn-ru.dcr-tool.ru/\<tag>/\<asset>`                               | Yandex CDN (RU fallback)   |
+
+```sh
+dcrup install stable --mirror auto   # default
+export DCRUP_MIRROR=cf               # persist for this shell
+```
+
 ---
 
 ## Arch Linux (AUR)

docs-crowdin-export/uk-UA/docs/ide-integration.mdx.mdx

@@ -6,6 +6,13 @@ sidebar_label: IDE Integration
 
 ## VS Code
 
+Install the recommended [DCR extension by Dexoron-Labs](https://marketplace.visualstudio.com/items?itemName=Dexoron-Labs.dcr). Do not install Microsoft C/C++ extensions for DCR projects: DCR uses `clangd`. MS C/C++ is acceptable only when you need its debugger.
+
+Recommended companion extensions:
+
+* [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)
+* [CodeLLDB](https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb), or MS C/C++ for debugger support only
+
 ```bash
 dcr gen vscode
 ```

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                                 |
+| Field         | Required | Description                                                                                                     |
-| --------- | -------- | ------------------------------------------- |
+| ------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `name`    | yes      | Project name                                |
+| `name`        | yes      | Project name                                                                                                    |
-| `version` | yes      | Semantic version                            |
+| `version`     | yes      | Semantic version of the **project**                                                                             |
-| `type`    | no       | `app`, `lib`, `none` (defaults to `"none"`) |
+| `dcr-version` | no       | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `license` | no       | SPDX license identifier                     |
+| `type`        | no       | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `author`  | no       | Author                                      |
+| `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]
 
 ...
@@ -96,7 +112,12 @@ author = "John Doe"
 
 Settings from raw config (not in typed struct):
 
-* `pkg_config` — list of pkg-config packages
+* `pkg_config` — list of packages queried for build-wide compiler/linker flags
+
+Dependencies can also declare a system package directly, for example
+`fmt = { pkg-config = "fmt" }`. This records the package in `dcr.lock` and applies
+the flags returned by `pkg-config --cflags` and `pkg-config --libs`.
+
 * `ldscript` — linker script path
 * `build.steps` / `build.post_steps` — codegen steps
 

docs-crowdin-export/uk-UA/docs/reference/dependencies.mdx.mdx

@@ -6,7 +6,7 @@ sidebar_label: Dependencies
 
 ## Formats
 
-The `[dependencies]` section supports three formats:
+The `[dependencies]` section supports registry, path, Git, and `pkg-config` dependencies:
 
 ### String (registry)
 
@@ -23,10 +23,10 @@ The version string is used as-is for registry lookup.
 
 ```toml
 [dependencies]
-fmt = { git = "https://github.com/fmtlib/fmt", tag = "10.1.1" }
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0" }
 ```
 
-Fields: `git`, `branch`, `tag`, `rev`.
+Fields: `git`, `branch`, `tag`, `rev`, `mode`, `include`, `lib`, `libs`.
 
 ### Table (path)
 
@@ -35,6 +35,32 @@ Fields: `git`, `branch`, `tag`, `rev`.
 mylib = { path = "../mylib" }
 ```
 
+For a prebuilt external library, specify its layout explicitly. The three
+arrays are paths relative to the dependency root (`include`, `lib`) and linker
+names (`libs`):
+
+```toml
+[dependencies]
+dcr-math = { path = "../deps/dcr-math", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+### Table (`pkg-config`)
+
+Use an installed `.pc` package when the library is provided by the operating system
+or another system package manager. DCR invokes `pkg-config --cflags` and
+`pkg-config --libs`, preserving include, library, linker, and other flags:
+
+```toml
+[dependencies]
+fmt = { pkg-config = "fmt" }
+openssl = { pkg-config = ["openssl", "libcrypto"] }
+```
+
+The `pkg-config` executable must be available in `PATH`. The named `.pc` files must
+be available through pkg-config's standard search paths or via `PKG_CONFIG_PATH`.
+These dependencies are not downloaded or built by DCR; they are recorded in
+`dcr.lock` with a `pkg-config+...` source.
+
 ## Registry
 
 DCR uses a package registry for dependency lookup by name.
@@ -42,7 +68,7 @@ DCR uses a package registry for dependency lookup by name.
 ```toml
 # ~/.dcr/config.toml
 [registry.default]
-url = "https://index.dcr.pm"
+url = "https://index.dcr.dexoron.tech"
 priority = 1
 ```
 
@@ -50,7 +76,23 @@ Registry priority: order in `config.toml`. The `DCR_INDEX_PATH` variable overrid
 
 ## Git dependencies
 
-Git dependencies are parsed and recorded in `dcr.lock`. DCR supports specifying branch/tag/rev for git sources:
+Git dependencies are cloned into `~/.dcr/git/`; their exact checked-out commit is written to `dcr.lock`.
+
+Both Git and path dependencies have two modes:
+
+* **DCR package:** the source has `dcr.toml`. DCR builds it before the consumer and uses the package name from its manifest for linking.
+* **Prebuilt library:** it provides existing headers and binaries through `include`, `lib`, and `libs`. DCR passes them to the compiler/linker without building the dependency.
+
+The mode is normally detected automatically. Use `mode = "build"` or `mode = "prebuild"` when a source contains both a manifest and prebuilt artifacts and you need to choose explicitly.
+
+`dcr-math-lib` publishes both forms. Select its prebuilt library explicitly:
+
+```toml
+[dependencies]
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0", mode = "prebuild", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+DCR supports specifying branch/tag/rev for git sources:
 
 * `branch` — switch to a branch
 * `tag` — switch to a tag
@@ -59,7 +101,7 @@ Git dependencies are parsed and recorded in `dcr.lock`. DCR supports specifying
 
 ## Path dependencies
 
-Local paths. DCR automatically discovers include and lib directories from the neighbor's `dcr.toml`.
+Local paths may point at a DCR package or a prebuilt external library. A path DCR package is built before its consumer, including its own path/git dependencies. DCR detects dependency cycles. A prebuilt library is never built by DCR; it is linked from the directories declared in its dependency entry.
 
 ```toml
 [dependencies]
@@ -67,18 +109,51 @@ mylib = { path = "/abs/path/to/lib" }
 mylib = { path = "../relative/path" }
 ```
 
-*Note: Header resolution automatically checks the packaged `target/include` directory of path dependencies, ensuring consumer packages can find headers from compiled static or dynamic libraries.*
+For DCR packages, the package name from `dcr.toml` is used for linking (so the dependency key may differ from the library name). Header resolution includes the packaged `target/include` directory and link search includes `target/lib`.
+
+### Recommended library layouts
+
+Buildable DCR library:
+
+```text
+dcr-math-lib/
+├── dcr.toml
+└── src/
+    ├── dcr_math.c
+    └── dcr_math.h
+```
+
+Prebuilt library:
+
+```text
+dcr-math-lib/
+├── include/
+│   └── dcr_math.h
+└── lib/
+    └── libdcr-math.a       # or .so / .lib
+```
+
+`libs` contains linker names without the `lib` prefix and file extension: use
+`["dcr-math"]` for `libdcr-math.a`.
+
+If one repository contains both forms, keep the prebuilt files in `include/` and `lib/` and select the mode explicitly:
+
+```toml
+[dependencies]
+dcr-math = { git = "https://github.com/dexoron/dcr-math-lib.git", tag = "v0.1.0", mode = "prebuild", include = ["include"], lib = ["lib"], libs = ["dcr-math"] }
+```
+
+For a local copy, replace `git` with `path = "../dcr-math-lib"`. In `prebuild` mode DCR does not run the dependency build, even when `dcr.toml` is present.
 
 ## dcr.lock
 
 Dependency lock file. Contains package names and sources.
 
-Created during `dcr build` when registry dependencies are present. Not updated during `dcr add` — only on the next `dcr build`.
+Created during `dcr build` for resolved registry, path, and Git dependencies. Not updated during `dcr add` — only on the next `dcr build`.
 
 ## Resolution process
 
-1. Load all dependencies (registry → git → path)
+1. Resolve dependency sources (registry → git → path)
-2. For path deps: recursively read their `dcr.toml`
+2. Fetch git dependencies into `~/.dcr/git/` and check out the requested ref
-3. For registry deps: search `index.json`
+3. Build DCR package dependencies recursively
-4. For git deps: clone to cache
+4. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler
-5. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler

docs-crowdin-export/uk-UA/docs/reference/environment-variables.mdx.mdx

@@ -58,3 +58,27 @@ export DCR_INDEX_PATH=/custom/path/index.json
 ```
 
 Default: `~/.dcr/index.json`.
+
+## DCRUP_MIRROR
+
+Download mirror for `dcrup` (prebuilt binaries only).
+
+```bash
+export DCRUP_MIRROR=auto   # cf → gh → sf → ya (default)
+export DCRUP_MIRROR=cf     # CloudFlare CDN
+export DCRUP_MIRROR=gh     # GitHub Releases
+export DCRUP_MIRROR=sf     # SourceForge
+export DCRUP_MIRROR=ya     # Yandex CDN (RU fallback)
+```
+
+CLI override: `dcrup install stable --mirror cf`.
+
+## DCRUP_HOME / DCRUP_BIN / DCRUP_REPO
+
+Installer layout and source clone URL:
+
+```bash
+export DCRUP_HOME=~/.dcr
+export DCRUP_BIN=~/.dcr/bin
+export DCRUP_REPO=https://github.com/dexoron/dcr
+```