New translations cli-output.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,92 @@ sidebar_label: Changelog
 
 # Changelog
 
+## 0.9.5 (2026-10-21)
+
+* **Structured CLI output** — shared helpers now provide Cargo-like human, plain, and JSON output modes.
+* **Color and diagnostics policy** — `--color`, `NO_COLOR`, `--quiet`, and `--verbose` are applied consistently across commands.
+* **Build reporting** — lifecycle events and compiler diagnostics are available as structured JSON events.
+* **Output lab** — sandbox scenarios cover help, lifecycle commands, compiler warnings/errors, stream capture, and broken pipes.
+
+## 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
+
+* **`dcr run -- \<args>...`** — cargo-style argument forwarding after a bare `--`\
+  (`dcr run --release -- --test_help`). Applies to direct binary runs and `[run].cmd`.
+* **Tests** — host target section `ldflags` without CLI `--target`; run-arg forwarding; `split_double_dash` unit tests.
+
+### Changed
+
+* **Native builds resolve the host triple** — without `--target` / package `build.target`, host sections such as\
+  `[build.x86_64-unknown-linux-gnu]` apply again (`cflags` / `ldflags` / toolchain).\
+  Previously the target was empty and those sections were ignored while artifacts already used the host triple path.
+* **Empty target** — no more `Unknown target ''` warning.
+* **`dcr run --help` / man `dcr-run`** — document `--` forwarding.
+
+### Fixed
+
+* **Native artifact paths on Windows and macOS** — without an explicit `--target` / `build.target`, artifacts use `target/\<profile>`, so `dcr run` and flat-bin find the build output.
+* Target-specific `ldflags` missing on native host builds (e.g. micro-lang + `libsct-elf`).
+* Spurious empty-target warning.
+
 ## 0.8.2 (2026-07-22)
 
 ### 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

@@ -11,7 +11,7 @@ Install and switch DCR versions (stable / dev / night, pin `0.8.2`, optional bui
 ### Linux / macOS / BSD / Windows (bash)
 
 ```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
+curl --proto '=https' --tlsv1.2 -sSf https://sh.dcr-tool.ru | sh -s -- self-install
 export PATH="$HOME/.dcr/bin:$PATH"
 dcrup install stable
 ```
@@ -19,36 +19,29 @@ dcrup install stable
 Non-interactive install of DCR in one shot:
 
 ```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- install stable
+curl --proto '=https' --tlsv1.2 -sSf https://sh.dcr-tool.ru | sh -s -- install stable
 export PATH="$HOME/.dcr/bin:$PATH"
 ```
 
 ### Windows (PowerShell)
 
 ```powershell
-irm https://ps1.dcr-tool.ru | iex
-# or download then run:
-# irm https://ps1.dcr-tool.ru -OutFile dcrup.ps1
-# powershell -File .\dcrup.ps1 self-install
+& ([scriptblock]::Create((irm https://ps1.dcr-tool.ru))) self-install
 # $env:Path += ";$env:USERPROFILE\.dcr\bin"
 dcrup install stable
 ```
 
-Optional cmd bootstrap (if you prefer `curl` of the cmd shim):
-
-```bat
-curl -fsSL -o dcrup.cmd https://cmd.dcr-tool.ru
-```
-
-After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows `dcrup.cmd`).
+After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`) and is installed in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows).
 
 ### 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
@@ -56,10 +49,28 @@ dcrup update
 dcrup list
 dcrup show
 dcrup which
+dcrup uninstall 0.8.2    # remove one installed version
+dcrup uninstall --all    # remove all installed versions
 ```
 
 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/cli-output.mdx.mdx

@@ -0,0 +1,34 @@
+---
+sidebar_label: CLI output
+---
+
+# CLI output (experimental)
+
+The structured output implementation is being developed incrementally.
+Currently these global options apply to diagnostics emitted through the logger:
+
+```sh
+dcr --output plain build
+dcr --output json build
+dcr --color never build
+dcr --quiet build
+dcr --verbose build
+```
+
+`--output` accepts `human` (default), `plain`, or `json`.
+Diagnostics are written to stderr. JSON diagnostics are newline-delimited objects
+with `schema_version: 1`, `event`, and `message` fields. Command statuses use the
+shared output helpers, build reporting emits structured lifecycle events, and
+compiler output is represented as JSON events with its original stream and text.
+The protocol is still experimental: some raw command data and subprocess stdout
+remain unstructured.
+
+`--color` accepts `auto`, `always`, or `never`. Automatic coloring requires a
+terminal and respects `NO_COLOR`. Plain and JSON diagnostics never add colors.
+Quiet mode preserves warnings, errors, and compiler diagnostics; verbose mode
+enables debug and trace logging. Arguments following `--` are passed through
+unchanged.
+
+Remaining work includes migrating the remaining raw command data and subprocess
+stdout, improving progress rendering and contextual errors, and expanding
+integration coverage for stdout/stderr and closed pipes.

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                                 |
-| --------- | -------- | ------------------------------------------- |
-| `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]
 
 ...
@@ -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)
-2. For path deps: recursively read their `dcr.toml`
-3. For registry deps: search `index.json`
-4. For git deps: clone to cache
-5. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler
+1. Resolve dependency sources (registry → git → path)
+2. Fetch git dependencies into `~/.dcr/git/` and check out the requested ref
+3. Build DCR package dependencies recursively
+4. 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,92 @@ sidebar_label: Changelog
 
 # Changelog
 
+## 0.9.5 (2026-10-21)
+
+* **Structured CLI output** — shared helpers now provide Cargo-like human, plain, and JSON output modes.
+* **Color and diagnostics policy** — `--color`, `NO_COLOR`, `--quiet`, and `--verbose` are applied consistently across commands.
+* **Build reporting** — lifecycle events and compiler diagnostics are available as structured JSON events.
+* **Output lab** — sandbox scenarios cover help, lifecycle commands, compiler warnings/errors, stream capture, and broken pipes.
+
+## 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
+
+* **`dcr run -- \<args>...`** — cargo-style argument forwarding after a bare `--`\
+  (`dcr run --release -- --test_help`). Applies to direct binary runs and `[run].cmd`.
+* **Tests** — host target section `ldflags` without CLI `--target`; run-arg forwarding; `split_double_dash` unit tests.
+
+### Changed
+
+* **Native builds resolve the host triple** — without `--target` / package `build.target`, host sections such as\
+  `[build.x86_64-unknown-linux-gnu]` apply again (`cflags` / `ldflags` / toolchain).\
+  Previously the target was empty and those sections were ignored while artifacts already used the host triple path.
+* **Empty target** — no more `Unknown target ''` warning.
+* **`dcr run --help` / man `dcr-run`** — document `--` forwarding.
+
+### Fixed
+
+* **Native artifact paths on Windows and macOS** — without an explicit `--target` / `build.target`, artifacts use `target/\<profile>`, so `dcr run` and flat-bin find the build output.
+* Target-specific `ldflags` missing on native host builds (e.g. micro-lang + `libsct-elf`).
+* Spurious empty-target warning.
+
 ## 0.8.2 (2026-07-22)
 
 ### 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

@@ -11,7 +11,7 @@ Install and switch DCR versions (stable / dev / night, pin `0.8.2`, optional bui
 ### Linux / macOS / BSD / Windows (bash)
 
 ```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
+curl --proto '=https' --tlsv1.2 -sSf https://sh.dcr-tool.ru | sh -s -- self-install
 export PATH="$HOME/.dcr/bin:$PATH"
 dcrup install stable
 ```
@@ -19,36 +19,29 @@ dcrup install stable
 Non-interactive install of DCR in one shot:
 
 ```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- install stable
+curl --proto '=https' --tlsv1.2 -sSf https://sh.dcr-tool.ru | sh -s -- install stable
 export PATH="$HOME/.dcr/bin:$PATH"
 ```
 
 ### Windows (PowerShell)
 
 ```powershell
-irm https://ps1.dcr-tool.ru | iex
-# or download then run:
-# irm https://ps1.dcr-tool.ru -OutFile dcrup.ps1
-# powershell -File .\dcrup.ps1 self-install
+& ([scriptblock]::Create((irm https://ps1.dcr-tool.ru))) self-install
 # $env:Path += ";$env:USERPROFILE\.dcr\bin"
 dcrup install stable
 ```
 
-Optional cmd bootstrap (if you prefer `curl` of the cmd shim):
-
-```bat
-curl -fsSL -o dcrup.cmd https://cmd.dcr-tool.ru
-```
-
-After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows `dcrup.cmd`).
+After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`) and is installed in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows).
 
 ### 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
@@ -56,10 +49,28 @@ dcrup update
 dcrup list
 dcrup show
 dcrup which
+dcrup uninstall 0.8.2    # remove one installed version
+dcrup uninstall --all    # remove all installed versions
 ```
 
 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/cli-output.mdx.mdx

@@ -0,0 +1,34 @@
+---
+sidebar_label: CLI output
+---
+
+# CLI output (experimental)
+
+The structured output implementation is being developed incrementally.
+Currently these global options apply to diagnostics emitted through the logger:
+
+```sh
+dcr --output plain build
+dcr --output json build
+dcr --color never build
+dcr --quiet build
+dcr --verbose build
+```
+
+`--output` accepts `human` (default), `plain`, or `json`.
+Diagnostics are written to stderr. JSON diagnostics are newline-delimited objects
+with `schema_version: 1`, `event`, and `message` fields. Command statuses use the
+shared output helpers, build reporting emits structured lifecycle events, and
+compiler output is represented as JSON events with its original stream and text.
+The protocol is still experimental: some raw command data and subprocess stdout
+remain unstructured.
+
+`--color` accepts `auto`, `always`, or `never`. Automatic coloring requires a
+terminal and respects `NO_COLOR`. Plain and JSON diagnostics never add colors.
+Quiet mode preserves warnings, errors, and compiler diagnostics; verbose mode
+enables debug and trace logging. Arguments following `--` are passed through
+unchanged.
+
+Remaining work includes migrating the remaining raw command data and subprocess
+stdout, improving progress rendering and contextual errors, and expanding
+integration coverage for stdout/stderr and closed pipes.

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                                 |
-| --------- | -------- | ------------------------------------------- |
-| `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]
 
 ...
@@ -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)
-2. For path deps: recursively read their `dcr.toml`
-3. For registry deps: search `index.json`
-4. For git deps: clone to cache
-5. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler
+1. Resolve dependency sources (registry → git → path)
+2. Fetch git dependencies into `~/.dcr/git/` and check out the requested ref
+3. Build DCR package dependencies recursively
+4. 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,17 +4,103 @@ sidebar_label: Список изменений
 
 # Список изменений
 
-## 0.8.2 (2026-07-22)
+## 0.9.5 (2026-10-21)
+
+* **Structured CLI output** — shared helpers now provide Cargo-like human, plain, and JSON output modes.
+* **Color and diagnostics policy** — `--color`, `NO_COLOR`, `--quiet`, and `--verbose` are applied consistently across commands.
+* **Build reporting** — lifecycle events and compiler diagnostics are available as structured JSON events.
+* **Output lab** — sandbox scenarios cover help, lifecycle commands, compiler warnings/errors, stream capture, and broken pipes.
+
+## 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)
 
 ### Добавлено:
 
+* **`dcr run -- \<args>...`** — cargo-style argument forwarding after a bare `--`\
+  (`dcr run --release -- --test_help`). Applies to direct binary runs and `[run].cmd`.
+* **Tests** — host target section `ldflags` without CLI `--target`; run-arg forwarding; `split_double_dash` unit tests.
+
+### Изменено:
+
+* **Native builds resolve the host triple** — without `--target` / package `build.target`, host sections such as\
+  `[build.x86_64-unknown-linux-gnu]` apply again (`cflags` / `ldflags` / toolchain).\
+  Previously the target was empty and those sections were ignored while artifacts already used the host triple path.
+* **Empty target** — no more `Unknown target ''` warning.
+* **`dcr run --help` / man `dcr-run`** — document `--` forwarding.
+
+### Исправлено:
+
+* **Native artifact paths on Windows and macOS** — without an explicit `--target` / `build.target`, artifacts use `target/\<profile>`, so `dcr run` and flat-bin find the build output.
+* Target-specific `ldflags` missing on native host builds (e.g. micro-lang + `libsct-elf`).
+* Spurious empty-target warning.
+
+## 0.8.2 (2026-07-22)
+
+### Добавлено
+
 * **Compile progress `[N/M]`** — live TTY status line (`compile  pkg v0.1.0  [12/41]`) so long mono-package builds do not look hung.
 * **DCR status style** — fixed-width verbs: `project`, `compile`, `dep`, `ready`, `pack`, `done`, `run`.
 * **Cargo feature `archive`** — optional FAT packing via `fatfs` (`cargo build --features archive`). Release CI builds with the feature; without it `[archive]` fails with a clear message.
 * **Tests** — `flat_bin_nasm_build`, package `build.target` without CLI `--target`, stricter workspace `clean --all`.
 * **CI expansion** — unit + integration on Linux/macOS/Windows, archive feature job, rust-cache, clippy default + all-features (see `.github/workflows/ci.yml`).
 
-### Изменено:
+### Изменено
 
 * **No forced host triple from CLI** — without `--target`, package/member `build.target` is honored (bare-metal / ISO `post_steps` paths).
 * **Relative include/lib flags** (`-I`, `-i`, `-isystem`, `-idirafter`, `-L`, `-T`) absolutized against the package root under workspace builds.
@@ -25,7 +111,7 @@ sidebar_label: Список изменений
 
 ## 0.8.1 (2026-07-20)
 
-### Добавлено
+### Added
 
 * **`build.kind = "flat-bin"`** — raw binary (default `.bin`) for OS-dev payloads:
   * **NASM** — `-f bin` → `\<stem>.bin`
@@ -36,7 +122,7 @@ sidebar_label: Список изменений
 * **`[archive]` section** — FAT12/16/32 disk images after build (`output`, `format`, `size`, `offset`, `label`, `bootsector`, `layout`). From 0.8.2 requires feature `archive`.
 * **Single-file `build.roots`** — a root may be a single source or header file, not only a directory.
 
-### Изменено
+### Changed
 
 * **`--force`** also re-runs `build.steps` and `build.post_steps`.
 * **`dcr run` on workspace-only root** — if `[run].cmd` is set, run that after build; otherwise delegate to a workspace member.
@@ -112,7 +198,7 @@ sidebar_label: Список изменений
 
 * `default_target_triple()` now respects `target_env` — Linux (gnu/musl) and Windows (msvc/gnu) use the correct environment instead of hardcoded values.
 
-### Исправлено:
+### Исправлено
 
 * **macOS Apple Silicon builds failed with `_main` undefined** — `--target=` is now passed to ldflags, not just cflags. `default_target_triple()` uses `std::env::consts::ARCH` on macOS instead of hardcoded `x86_64`.
 * **GitHub Stars and GPL-3.0 badges not rendering in README** — badge block converted to pure HTML.
@@ -155,7 +241,7 @@ sidebar_label: Список изменений
 * **`tree.rs`, `fmt.rs` и `setup.rs`** — теперь поддерживают аргументы для опции `--help`.
 * **Команды установки из файла README** — `| bash` → `| sh` для обеспечения совместимости с POSIX.
 
-### Исправлено
+### Fixed
 
 * **`dcr new \<invalid-name>` создает каталог, а затем завершается с ошибкой** — теперь проверка
   выполняется до начала любых операций с файлами.

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 mylib ../path/to/lib   # путь как источник
-dcr add mylib path:./lib       # явный префикс пути
-dcr add mylib git:https://github.com/user/repo  # явный префикс git
-dcr add mylib github:user/repo # сокращённая запись GitHub
-dcr add mylib gitlab:user/repo # сокращённая запись GitLab
+dcr add fmt                    # registry lookup
+dcr add mylib ../path/to/lib   # path as source
+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
 ```
 
 Префиксы источника:
@@ -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

@@ -11,7 +11,7 @@ Install and switch DCR versions (stable / dev / night, pin `0.8.2`, optional bui
 ### Linux / macOS / BSD / Windows (bash)
 
 ```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
+curl --proto '=https' --tlsv1.2 -sSf https://sh.dcr-tool.ru | sh -s -- self-install
 export PATH="$HOME/.dcr/bin:$PATH"
 dcrup install stable
 ```
@@ -19,36 +19,29 @@ dcrup install stable
 Non-interactive install of DCR in one shot:
 
 ```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- install stable
+curl --proto '=https' --tlsv1.2 -sSf https://sh.dcr-tool.ru | sh -s -- install stable
 export PATH="$HOME/.dcr/bin:$PATH"
 ```
 
 ### Windows (PowerShell)
 
 ```powershell
-irm https://ps1.dcr-tool.ru | iex
-# or download then run:
-# irm https://ps1.dcr-tool.ru -OutFile dcrup.ps1
-# powershell -File .\dcrup.ps1 self-install
+& ([scriptblock]::Create((irm https://ps1.dcr-tool.ru))) self-install
 # $env:Path += ";$env:USERPROFILE\.dcr\bin"
 dcrup install stable
 ```
 
-Optional cmd bootstrap (if you prefer `curl` of the cmd shim):
-
-```bat
-curl -fsSL -o dcrup.cmd https://cmd.dcr-tool.ru
-```
-
-After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows `dcrup.cmd`).
+After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`) and is installed in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows).
 
 ### 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
@@ -56,10 +49,28 @@ dcrup update
 dcrup list
 dcrup show
 dcrup which
+dcrup uninstall 0.8.2    # remove one installed version
+dcrup uninstall --all    # remove all installed versions
 ```
 
 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/cli-output.mdx.mdx

@@ -0,0 +1,34 @@
+---
+sidebar_label: CLI output
+---
+
+# CLI output (experimental)
+
+The structured output implementation is being developed incrementally.
+Currently these global options apply to diagnostics emitted through the logger:
+
+```sh
+dcr --output plain build
+dcr --output json build
+dcr --color never build
+dcr --quiet build
+dcr --verbose build
+```
+
+`--output` accepts `human` (default), `plain`, or `json`.
+Diagnostics are written to stderr. JSON diagnostics are newline-delimited objects
+with `schema_version: 1`, `event`, and `message` fields. Command statuses use the
+shared output helpers, build reporting emits structured lifecycle events, and
+compiler output is represented as JSON events with its original stream and text.
+The protocol is still experimental: some raw command data and subprocess stdout
+remain unstructured.
+
+`--color` accepts `auto`, `always`, or `never`. Automatic coloring requires a
+terminal and respects `NO_COLOR`. Plain and JSON diagnostics never add colors.
+Quiet mode preserves warnings, errors, and compiler diagnostics; verbose mode
+enables debug and trace logging. Arguments following `--` are passed through
+unchanged.
+
+Remaining work includes migrating the remaining raw command data and subprocess
+stdout, improving progress rendering and contextual errors, and expanding
+integration coverage for stdout/stderr and closed pipes.

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

@@ -40,23 +40,39 @@ sidebar_label: Обзор dcr.toml
 
 ## [пакет]
 
-| Поле       | Обязательное | Описание                                    |
-| ---------- | ------------ | ------------------------------------------- |
-| `имя`      | да           | Имя проекта                                 |
-| `версия`   | да           | Семантическая версия                        |
-| `тип`      | no           | `app`, `lib`, `none` (defaults to `"none"`) |
-| `лицензия` | нет          | SPDX-идентификатор лицензии                 |
-| `автор`    | нет          | Автор                                       |
+| Поле          | Обязательное | Описание                                                                                                        |
+| ------------- | ------------ | --------------------------------------------------------------------------------------------------------------- |
+| `имя`         | да           | Имя проекта                                                                                                     |
+| `версия`      | да           | 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. |
+| `тип`         | нет          | `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)
-2. For path deps: recursively read their `dcr.toml`
-3. For registry deps: search `index.json`
-4. For git deps: clone to cache
-5. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler
+1. Resolve dependency sources (registry → git → path)
+2. Fetch git dependencies into `~/.dcr/git/` and check out the requested ref
+3. Build DCR package dependencies recursively
+4. 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,92 @@ sidebar_label: Changelog
 
 # Changelog
 
+## 0.9.5 (2026-10-21)
+
+* **Structured CLI output** — shared helpers now provide Cargo-like human, plain, and JSON output modes.
+* **Color and diagnostics policy** — `--color`, `NO_COLOR`, `--quiet`, and `--verbose` are applied consistently across commands.
+* **Build reporting** — lifecycle events and compiler diagnostics are available as structured JSON events.
+* **Output lab** — sandbox scenarios cover help, lifecycle commands, compiler warnings/errors, stream capture, and broken pipes.
+
+## 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
+
+* **`dcr run -- \<args>...`** — cargo-style argument forwarding after a bare `--`\
+  (`dcr run --release -- --test_help`). Applies to direct binary runs and `[run].cmd`.
+* **Tests** — host target section `ldflags` without CLI `--target`; run-arg forwarding; `split_double_dash` unit tests.
+
+### Changed
+
+* **Native builds resolve the host triple** — without `--target` / package `build.target`, host sections such as\
+  `[build.x86_64-unknown-linux-gnu]` apply again (`cflags` / `ldflags` / toolchain).\
+  Previously the target was empty and those sections were ignored while artifacts already used the host triple path.
+* **Empty target** — no more `Unknown target ''` warning.
+* **`dcr run --help` / man `dcr-run`** — document `--` forwarding.
+
+### Fixed
+
+* **Native artifact paths on Windows and macOS** — without an explicit `--target` / `build.target`, artifacts use `target/\<profile>`, so `dcr run` and flat-bin find the build output.
+* Target-specific `ldflags` missing on native host builds (e.g. micro-lang + `libsct-elf`).
+* Spurious empty-target warning.
+
 ## 0.8.2 (2026-07-22)
 
 ### 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

@@ -11,7 +11,7 @@ Install and switch DCR versions (stable / dev / night, pin `0.8.2`, optional bui
 ### Linux / macOS / BSD / Windows (bash)
 
 ```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
+curl --proto '=https' --tlsv1.2 -sSf https://sh.dcr-tool.ru | sh -s -- self-install
 export PATH="$HOME/.dcr/bin:$PATH"
 dcrup install stable
 ```
@@ -19,36 +19,29 @@ dcrup install stable
 Non-interactive install of DCR in one shot:
 
 ```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- install stable
+curl --proto '=https' --tlsv1.2 -sSf https://sh.dcr-tool.ru | sh -s -- install stable
 export PATH="$HOME/.dcr/bin:$PATH"
 ```
 
 ### Windows (PowerShell)
 
 ```powershell
-irm https://ps1.dcr-tool.ru | iex
-# or download then run:
-# irm https://ps1.dcr-tool.ru -OutFile dcrup.ps1
-# powershell -File .\dcrup.ps1 self-install
+& ([scriptblock]::Create((irm https://ps1.dcr-tool.ru))) self-install
 # $env:Path += ";$env:USERPROFILE\.dcr\bin"
 dcrup install stable
 ```
 
-Optional cmd bootstrap (if you prefer `curl` of the cmd shim):
-
-```bat
-curl -fsSL -o dcrup.cmd https://cmd.dcr-tool.ru
-```
-
-After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows `dcrup.cmd`).
+After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`) and is installed in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows).
 
 ### 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
@@ -56,10 +49,28 @@ dcrup update
 dcrup list
 dcrup show
 dcrup which
+dcrup uninstall 0.8.2    # remove one installed version
+dcrup uninstall --all    # remove all installed versions
 ```
 
 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/cli-output.mdx.mdx

@@ -0,0 +1,34 @@
+---
+sidebar_label: CLI output
+---
+
+# CLI output (experimental)
+
+The structured output implementation is being developed incrementally.
+Currently these global options apply to diagnostics emitted through the logger:
+
+```sh
+dcr --output plain build
+dcr --output json build
+dcr --color never build
+dcr --quiet build
+dcr --verbose build
+```
+
+`--output` accepts `human` (default), `plain`, or `json`.
+Diagnostics are written to stderr. JSON diagnostics are newline-delimited objects
+with `schema_version: 1`, `event`, and `message` fields. Command statuses use the
+shared output helpers, build reporting emits structured lifecycle events, and
+compiler output is represented as JSON events with its original stream and text.
+The protocol is still experimental: some raw command data and subprocess stdout
+remain unstructured.
+
+`--color` accepts `auto`, `always`, or `never`. Automatic coloring requires a
+terminal and respects `NO_COLOR`. Plain and JSON diagnostics never add colors.
+Quiet mode preserves warnings, errors, and compiler diagnostics; verbose mode
+enables debug and trace logging. Arguments following `--` are passed through
+unchanged.
+
+Remaining work includes migrating the remaining raw command data and subprocess
+stdout, improving progress rendering and contextual errors, and expanding
+integration coverage for stdout/stderr and closed pipes.

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]
 
 ...
@@ -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)
-2. For path deps: recursively read their `dcr.toml`
-3. For registry deps: search `index.json`
-4. For git deps: clone to cache
-5. Collect `include_dirs`, `lib_dirs`, `libs` for the compiler
+1. Resolve dependency sources (registry → git → path)
+2. Fetch git dependencies into `~/.dcr/git/` and check out the requested ref
+3. Build DCR package dependencies recursively
+4. 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
+```