New translations quality-commands.mdx (Russian)

[ci skip]

.github/workflows/ci.yml

@@ -5,18 +5,10 @@ on:
     branches:
       - master
       - main
-      - dev
   pull_request:
 
-env:
-  CARGO_TERM_COLOR: always
-  RUSTFLAGS: -Dwarnings
-  CARGO_INCREMENTAL: "0"
-  SCCACHE_GHA_ENABLED: "true"
-
 jobs:
   checks:
-    name: fmt / clippy / check
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -26,129 +18,11 @@ jobs:
         with:
           components: rustfmt, clippy
 
-      - name: sccache
-        uses: mozilla-actions/sccache-action@v0.0.9
-
-      - uses: Swatinem/rust-cache@v2
-        with:
-          shared-key: dcr-ci
-          cache-all-crates: true
-
       - name: Format
         run: cargo fmt --all --check
 
-      - name: Clippy (default features)
-        run: cargo clippy --all-targets -- -D warnings
-
-      - name: Clippy (all features)
+      - name: Lint
         run: cargo clippy --all-targets --all-features -- -D warnings
 
-      - name: Check (all features)
+      - name: Check
         run: cargo check --all-targets --all-features
-
-  test:
-    name: tests (${{ matrix.os }})
-    needs: checks
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-    runs-on: ${{ matrix.os }}
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Rust
-        uses: dtolnay/rust-toolchain@stable
-
-      - name: sccache
-        uses: mozilla-actions/sccache-action@v0.0.9
-
-      - uses: Swatinem/rust-cache@v2
-        with:
-          shared-key: dcr-ci
-          cache-all-crates: true
-          cache-on-failure: true
-
-      - name: Cache apt packages
-        if: runner.os == 'Linux'
-        uses: actions/cache@v4
-        with:
-          path: /var/cache/apt/archives
-          key: apt-${{ runner.os }}-${{ hashFiles('.github/workflows/ci.yml') }}
-          restore-keys: apt-${{ runner.os }}-
-
-      - name: Install Linux tools
-        if: runner.os == 'Linux'
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y \
-            build-essential \
-            clang \
-            nasm \
-            clang-format \
-            clang-tidy \
-            git \
-            llvm
-
-      - name: Install macOS tools
-        if: runner.os == 'macOS'
-        run: |
-          brew install nasm llvm || true
-          echo "$(brew --prefix llvm)/bin" >> "$GITHUB_PATH"
-
-      - name: Install Windows tools
-        if: runner.os == 'Windows'
-        shell: pwsh
-        run: |
-          choco install nasm llvm -y
-          echo "C:\Program Files\NASM" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
-          if (Test-Path "C:\Program Files\LLVM\bin") {
-            echo "C:\Program Files\LLVM\bin" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
-          }
-
-      - name: Unit tests (binary crate)
-        run: cargo test --bins -- --nocapture
-
-      - name: Integration tests (default features)
-        run: cargo test --tests -- --nocapture
-
-      - name: Integration tests (archive feature)
-        if: runner.os != 'Windows'
-        run: cargo test --tests --features archive -- --nocapture
-
-      - name: sccache stats
-        if: always()
-        run: sccache --show-stats || true
-
-  test-archive-linux:
-    name: archive feature smoke
-    needs: checks
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Setup Rust
-        uses: dtolnay/rust-toolchain@stable
-
-      - name: sccache
-        uses: mozilla-actions/sccache-action@v0.0.9
-
-      - uses: Swatinem/rust-cache@v2
-        with:
-          shared-key: dcr-ci
-          cache-all-crates: true
-
-      - name: Install tools
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y build-essential clang nasm llvm
-
-      - name: Build with archive
-        run: cargo build --features archive
-
-      - name: Flat-bin + unit suite with archive
-        run: cargo test --features archive --test cli_build --test cli_workspace --test cli_errors -- --nocapture
-
-      - name: sccache stats
-        if: always()
-        run: sccache --show-stats || true

.github/workflows/release.yml

@@ -223,9 +223,9 @@ jobs:
       - name: Build
         run: |
           if [ "${{ matrix.target }}" != "x86_64-unknown-linux-gnu" ]; then
-            cargo zigbuild --release --features archive --target ${{ matrix.target }}
+            cargo zigbuild --release --target ${{ matrix.target }}
           else
-            cargo build --release --features archive --target ${{ matrix.target }}
+            cargo build --release --target ${{ matrix.target }}
           fi
 
       - name: Prepare Artifact
@@ -298,9 +298,9 @@ jobs:
         run: |
           cargo install cargo-deb
           if [ "${{ matrix.target }}" != "x86_64-unknown-linux-gnu" ]; then
-            cargo zigbuild --release --features archive --target ${{ matrix.target }}
+            cargo zigbuild --release --target ${{ matrix.target }}
           else
-            cargo build --release --features archive --target ${{ matrix.target }}
+            cargo build --release --target ${{ matrix.target }}
           fi
           cargo deb --no-build --target ${{ matrix.target }}
           mkdir -p dist-packages && cp target/${{ matrix.target }}/debian/*.deb dist-packages/
@@ -311,9 +311,9 @@ jobs:
         run: |
           cargo install cargo-generate-rpm
           if [ "${{ matrix.target }}" != "x86_64-unknown-linux-gnu" ]; then
-            cargo zigbuild --release --features archive --target ${{ matrix.target }}
+            cargo zigbuild --release --target ${{ matrix.target }}
           else
-            cargo build --release --features archive --target ${{ matrix.target }}
+            cargo build --release --target ${{ matrix.target }}
           fi
           cargo generate-rpm --target ${{ matrix.target }}
           mkdir -p dist-packages && cp target/${{ matrix.target }}/generate-rpm/*.rpm dist-packages/
@@ -322,7 +322,7 @@ jobs:
       - name: Build Snap Package
         if: matrix.package_type == 'snap'
         run: |
-          cargo build --release --features archive
+          cargo build --release
           mkdir -p packaging/snap/dist/bin
           cp target/release/dcr packaging/snap/dist/bin/
           cp -r man packaging/snap/dist/man
@@ -364,7 +364,7 @@ jobs:
             cd "\$srcdir/\$pkgname-${PKGVER_ORIG}"
             unset CFLAGS CXXFLAGS LDFLAGS
             export RUSTFLAGS="-C linker=cc"
-            cargo build --release --locked --features archive
+            cargo build --release --locked
           }
           package() {
             cd "\$srcdir/dcr-${PKGVER_ORIG}"
@@ -454,7 +454,7 @@ jobs:
           targets: ${{ matrix.target }}
 
       - name: Build
-        run: cargo build --release --features archive --target ${{ matrix.target }}
+        run: cargo build --release --target ${{ matrix.target }}
 
       - name: Prepare Artifact
         run: |
@@ -499,7 +499,7 @@ jobs:
           run: |
             export PATH="/usr/local/bin:/usr/local/sbin:$PATH"
             pkg install -y rust perl5 gmake
-            cargo build --release --features archive
+            cargo build --release
 
       - name: Prepare FreeBSD Artifact
         if: matrix.system == 'freebsd'
@@ -517,7 +517,7 @@ jobs:
           run: |
             export PATH="/usr/local/bin:$PATH"
             pkg_add rust perl gmake
-            cargo build --release --features archive
+            cargo build --release
 
       - name: Prepare OpenBSD Artifact
         if: matrix.system == 'openbsd'
@@ -537,7 +537,7 @@ jobs:
             mkdir -p /tmp/bin
             ln -sf /usr/pkg/bin/gmake /tmp/bin/make
             export PATH="/tmp/bin:/usr/pkg/bin:/usr/pkg/sbin:$PATH"
-            cargo build --release --features archive
+            cargo build --release
 
       - name: Prepare NetBSD Artifact
         if: matrix.system == 'netbsd'
@@ -585,7 +585,7 @@ jobs:
           targets: ${{ matrix.target }}
 
       - name: Build
-        run: cargo build --release --features archive --target ${{ matrix.target }}
+        run: cargo build --release --target ${{ matrix.target }}
 
       - name: Prepare Artifact
         shell: pwsh
@@ -654,7 +654,7 @@ jobs:
             cd "\$srcdir/\$pkgname-${PKGVER_ORIG}"
             unset CFLAGS CXXFLAGS LDFLAGS
             export RUSTFLAGS="-C linker=cc"
-            cargo build --release --locked --features archive
+            cargo build --release --locked
           }
 
           package() {
@@ -919,7 +919,7 @@ jobs:
             cd "\$srcdir/dcr-${PKGVER_ORIG}"
             unset CFLAGS CXXFLAGS LDFLAGS
             export RUSTFLAGS="-C linker=cc"
-            cargo build --release --locked --features archive
+            cargo build --release --locked
           }
 
           package() {

.github/workflows/trigger-site-build.yml

@@ -1,14 +0,0 @@
-name: Trigger site rebuild
-
-on:
-  push:
-    branches: [master]
-    paths:
-      - 'docs/**'
-
-jobs:
-  trigger:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Trigger Cloudflare Pages build
-        run: curl -sS -X POST "${{ secrets.CF_PAGES_DEPLOY_HOOK }}"

.gitignore

@@ -5,6 +5,4 @@ sandbox/**
 .cargo/
 .env
 
-personal/
-.*
-!.gitignore
+personal/

AGENTS.md

@@ -0,0 +1,56 @@
+# AGENTS.md
+
+## Quick start
+
+```bash
+cargo build --release && ./target/release/dcr setup
+```
+
+## Pre-PR (CI) gate
+
+```bash
+cargo fmt --all --check
+cargo clippy --all-targets --all-features -- -D warnings
+cargo check --all-targets --all-features
+cargo test
+```
+
+CI (`.github/workflows/ci.yml`) runs fmt, clippy, check — **not** tests.
+
+## Tests
+
+- Integration tests in `tests/` build the dcr binary and run it in temp dirs under `sandbox/cli-tests/` (gitignored).
+- Some tests **skip** if no C compiler (`gcc`/`clang`/`cc`) is found at runtime.
+- Compiler can be overridden via `DCR_COMPILER` or `DCR_CC` env vars.
+- Tests use `$CARGO_BIN_EXE_dcr` when available, else `target/debug/dcr`.
+
+## Architecture
+
+- **Single Rust package** (edition 2024), not a workspace. Only one binary: `dcr`.
+- **Entrypoint**: `src/main.rs` — matches `args[1]` against command names.
+- **Compiler backends** in `src/core/builder/`: `unix_cc` (gcc/clang), `msvc` (cl/clang-cl), `gas`, `nasm`. Dispatched by matching compiler name string.
+- **Config**: `dcr.toml` (per-project), `~/.dcr/config.toml` (registry), `~/.dcr/index.json` (index). Defaults: `language=c`, `standard=c11`, `compiler=clang`, `kind=bin`.
+- **`build.rs`** embeds `TARGET` as `DCR_TARGET` env var (shown in `--version`).
+- **CLI output** must be in English. Use `utils::log` for messaging.
+
+## Key commands
+
+| Command | Notes |
+|---|---|
+| `dcr new <name>` | Creates project dir |
+| `dcr init` | Init from CWD (must be empty) |
+| `dcr build [--debug\|--release] [--target <triple>]` | Default profile: `--debug` |
+| `dcr run [--debug\|--release]` | Only for `kind = "bin"` |
+| `dcr clean [--debug\|--release] [--all]` | `--all` for workspace roots |
+| `dcr tree` | Dependency tree viewer |
+| `dcr test [--init]` | Runs/test project tests |
+| `dcr gen <vscode\|clion\|compile-commands>` | IDE integration |
+| `dcr --update` | Self-update from GitHub Releases |
+
+## Cross-compilation
+
+`--target` accepts short names (`linux`, `macos`, `windows`) or full triples. In CI, Linux cross-builds use `cargo-zigbuild`. When `build.target` is set in `dcr.toml`, DCR auto-injects `--target=<value>` into cflags (clang). Bare-metal targets (containing `none`/`-elf`/`eabi`/`baremetal`) skip DCR's default compiler flags.
+
+## Dependencies (Cargo)
+
+reqwest (blocking+json+rustls-tls), serde, toml, git2, openssl (vendored), self-replace, sha2, ctrlc.

CHANGELOG.md

@@ -1,125 +1,5 @@
 # Changelog
 
-## [0.8.2] - 2026-07-22 "CLI Progress, archive Feature, Workspace Path Fixes / CLI Progress, archive Feature, Workspace Path Fixes"
-
-### RU
-
-**Добавлено:**
-
-- **Прогресс компиляции `[N/M]`** — live-строка `compile  pkg v0.1.0  [12/41]` на TTY (stderr), чтобы длинные mono-package сборки не выглядели «зависшими».
-- **Свой стиль статуса build** — фиксированная колонка глаголов: `project`, `compile`, `dep`, `ready`, `pack`, `done`, `run` (не cargo-clone).
-- **Cargo feature `archive`** — `fatfs` и упаковка FAT-образов опциональны (`cargo build --features archive`). Release CI собирает с feature; без feature `[archive]` даёт явную ошибку.
-- **Интеграционные тесты** — `flat_bin_nasm_build`, `package_build_target_used_without_cli_flag`, усилен workspace `clean --all`.
-- **Расширенный CI** — unit + integration на Linux/macOS/Windows, отдельный job с `--features archive`, rust-cache, clippy default + all-features.
-
-**Изменено:**
-
-- **CLI host triple больше не форсится** — без `--target` используется `build.target` пакета/member (важно для bare-metal / post_steps ISO).
-- **Relative `-I`/`-L`/`-T` (и `-isystem`/`-idirafter`)** в cflags/ldflags абсолютизируются относительно корня пакета (workspace CWD = root).
-- **`dcr clean --all`** — не спамит `target not found` по members без локального `target/` (общий root `target/`).
-- **`error` / `warn`** — красный / жёлтый, вывод на stderr; `Подсказка:` → `Hint:`.
-- **`dcr --help` / man** — добавлены `add`, `lint`, `setup`; unknown command → exit code 1.
-- **Сообщения NotFound** — `linker not found: ld.lld …` / `{tool} not found …` вместо сырого `os error 2`.
-
-### EN
-
-**Added:**
-
-- **Compile progress `[N/M]`** — live TTY line `compile  pkg v0.1.0  [12/41]` so long mono-package builds do not look hung.
-- **DCR status verbs** — fixed-width column: `project`, `compile`, `dep`, `ready`, `pack`, `done`, `run`.
-- **Cargo feature `archive`** — optional `fatfs` / FAT packing (`cargo build --features archive`). Release CI builds with the feature; without it `[archive]` errors clearly.
-- **Integration tests** — `flat_bin_nasm_build`, package `build.target` without CLI flag, stricter workspace `clean --all`.
-- **Expanded CI** — unit + integration on Linux/macOS/Windows, archive feature job, rust-cache, clippy default + all-features.
-
-**Changed:**
-
-- **CLI no longer forces host triple** — without `--target`, package/member `build.target` is used (bare-metal / ISO post_steps).
-- **Relative `-I`/`-L`/`-T` (and `-isystem`/`-idirafter`)** in flags are absolutized against the package root when workspace CWD is the root.
-- **`dcr clean --all`** — no spam for members without a local `target/` (shared root `target/`).
-- **`error` / `warn`** — red / yellow on stderr; Russian `Подсказка:` → `Hint:`.
-- **`dcr --help` / man** — list `add`, `lint`, `setup`; unknown command exits 1.
-- **NotFound messages** — `linker not found: ld.lld …` / `{tool} not found …` instead of raw `os error 2`.
-
-## [0.8.1] - 2026-07-20 "OS-Dev: flat-bin, FAT-образы / OS-Dev: flat-bin & FAT Images"
-
-### RU
-
-**Добавлено:**
-
-- **`build.kind = "flat-bin"`** — сырой бинарный артефакт (расширение по умолчанию `.bin`):
-  - **NASM** — `-f bin`, прямой вывод `<stem>.bin`
-  - **FASM** — прямой вывод (ожидается `format binary` в исходнике)
-  - **GAS / MASM / LLVM IR (`llc`)** — объект → `objcopy -O binary` → `<stem>.bin`
-  - **C/C++ (gcc/clang/MSVC)** — compile → link (nostdlib/static) → `objcopy -O binary` → `<name>.bin`
-  - Требуется `llvm-objcopy` / `objcopy` / `gobjcopy` в PATH (кроме NASM/FASM direct)
-- **Секция `[archive]`** — после успешной сборки DCR собирает образ диска (FAT12/16/32): размер, offset, volume label, опциональный bootsector и `layout`. С 0.8.2 — за feature `archive`.
-- **Одиночные файлы в `build.roots`** — корень может быть файлом (`.c`, `.asm`, header), а не только каталогом.
-
-**Изменено:**
-
-- **`dcr build --force` / `dcr run --force`** — force также перезапускает `build.steps` и `build.post_steps`.
-- **`dcr run` на workspace-only root** — если задан `[run].cmd`, сначала build + run по конфигу корня; иначе делегирование члену workspace.
-
-### EN
-
-**Added:**
-
-- **`build.kind = "flat-bin"`** — raw binary (default `.bin`) across NASM/FASM/GAS/MASM/LLC and C/C++ (objcopy where needed).
-- **`[archive]` section** — FAT12/16/32 disk images after build (from 0.8.2 gated by feature `archive`).
-- **Single-file `build.roots`**.
-
-**Changed:**
-
-- **`--force`** re-runs steps/post_steps; workspace-only **`dcr run`** prefers root `[run].cmd` when set.
-
-## [0.8.0] - 2026-07-18 "Модульный Движок Сборки, Новая Архитектура Ядра и Улучшение Workspaces / Modular Build Engine, New Core Architecture, & Workspace Improvements"
-
-### RU
-
-**Добавлено:**
-
-- **Выделенное ядро сборки (Build Engine extraction)** — вся логика оркестрации компиляции и сборки полностью вынесена из интерфейсного модуля `src/cli/build.rs` в изолированный, переиспользуемый модуль ядра `src/core/build/engine.rs`.
-- **Полиморфная модель языков (Трейт `Language`)** — введение абстрактного трейта `Language` (`src/core/build/language/mod.rs`). Логика поиска файлов, сопоставления расширений и компиляторов распределена по выделенным языковым бэкендам для C, C++ (включая шаги генерации Qt), LLVM IR и ассемблера (GAS, NASM, FASM, MASM).
-- **Абстракция сборщиков (Трейт `Builder`)** — введение трейта `Builder` для полиморфного управления процессами компиляции (`src/core/build/builder/mod.rs`). Логика вызова компиляторов семейства GCC/Clang вынесена в общий модуль `builder/cc_common.rs`, а MSVC — в `builder/msvc/`.
-- **Поязыковая конфигурация (`[build.<lang>]`)** — добавлена поддержка индивидуальных настроек для каждого языка в `dcr.toml` (например, `[build.c]`, `[build.cpp]`, `[build.asm]`), позволяя независимо настраивать компилятор, стандарт и флаги сборки.
-- **Интеграция путей зависимостей в Workspaces** — сборщик теперь автоматически инжектирует пути заголовков (включая исходники `src/` членов, папки `include/` и директорию `target/include`) и библиотек (`target/lib`, а также специфичные для целевой платформы папки сборки) зависимых членов workspace при сборке.
-- **Система событий `BuildReporter`** — весь вывод сборщика переведён на событийную модель (`src/core/build/report.rs`), что делает движок пригодным для программного встраивания (например, в IDE) без необходимости перехвата stdout/stderr.
-- **Поддержка отмены сборки** — добавлен потокобезопасный токен отмены (`Arc<AtomicBool>`), позволяющий безопасно прервать выполнение компиляции на любом этапе.
-- **Сохранение кастомных ключей TOML** — парсер `dcr.toml` переведен на `toml_edit`, что гарантирует сохранение всех неизвестных/пользовательских ключей, комментариев и форматирования при перезаписи файла (например, через `dcr add`).
-- **Разрешение заголовков для локальных path-зависимостей** — исправлена проблема, при которой потребители не могли найти заголовочные файлы статических/динамических библиотек, лежащие в упакованной папке `target/include` локальных path-зависимостей.
-- **Новая система интеграционных тестов** — старый громоздкий файл `tests/cli_basic.rs` разделен на изолированные и структурированные интеграционные тесты для каждой команды и фичи: `cli_build.rs`, `cli_deps.rs`, `cli_lint.rs`, `cli_new.rs`, `cli_qt.rs`, `cli_test.rs`, `cli_workspace.rs`.
-
-**Изменено:**
-
-- **Дедупликация генерации артефактов** — логика линковки бинарных файлов (ELF, PE, EXE), динамических библиотек (`.so`, `.dll`, `.dylib`) и архивации статических библиотек (`.a`, `.lib`) полностью перенесена в выделенный модуль `src/core/build/builder/artifact.rs`.
-- **Запуск членов workspace из корня** — команда `dcr run` при вызове из корня workspace-only проекта теперь запускает сборку выбранного пакета в контексте workspace (через флаг `--workspace`), исключая изолированные ошибки сборки.
-- **Отказ от глобального состояния** — все операции сборки изолированы внутри структуры `BuildContext`, обеспечивая многопоточную безопасность сборщика.
-- **Вынос логики кэширования** — проверка инкрементальных изменений, отслеживание заголовков (`#include`) и вычисление хэшей сборки перенесено в изолированный модуль `src/core/build/cache.rs`.
-- **Модуляризация кастомных шагов** — обработка этапа `build.steps` для препроцессоров вынесена в `src/core/build/steps.rs`.
-
-### EN
-
-**Added:**
-
-- **Dedicated Build Engine (`src/core/build/engine.rs`)** — decoupled the build orchestration logic completely from the CLI front-end wrapper in `src/cli/build.rs` to a reusable, decoupled core build engine.
-- **Polymorphic Language Model (`Language` trait)** — introduced the abstract `Language` trait (`src/core/build/language/mod.rs`). File scanning, compiler resolution, and flags handling are now encapsulated in dedicated language modules for C, C++ (including Qt code generation), LLVM IR, and ASM (GAS, NASM, FASM, MASM).
-- **Polymorphic Compilation Dispatch (`Builder` trait)** — introduced the `Builder` trait to generalize builder invocations (`src/core/build/builder/mod.rs`). Consolidated GCC/Clang logic into `builder/cc_common.rs` and Microsoft Visual C++ logic into `builder/msvc/`.
-- **Per-Language Configuration overrides (`[build.<lang>]`)** — introduced support for configuring language-specific compiler, standard, and flags (e.g. `[build.c]`, `[build.cpp]`, `[build.asm]`) independently in `dcr.toml`.
-- **Automatic Workspace Dependency Injection** — during workspace builds, include/lib paths of dependent workspace members (including their source headers, local `include/` folders, and build target `target/include` / `target/lib` folders) are automatically resolved and injected.
-- **`BuildReporter` Event System** — decoupled build orchestration output into a structured event-driven reporter model (`src/core/build/report.rs`), making DCR suitable for library embedding and IDE integrations without stderr capturing.
-- **Build Cancellation Support** — introduced thread-safe cancellation tokens (`Arc<AtomicBool>`) allowing clients to safely abort compile runs mid-execution.
-- **TOML Formatting & Custom Keys Preservation** — migrated the config editor to `toml_edit`, preserving all unknown/user-defined TOML keys, structures, and comments during file write operations (e.g., in `dcr add`).
-- **Path Dependencies Target Include Resolution** — local path dependencies configured via tables now correctly expose headers built and packaged into their `target/include` folder to consumer packages.
-- **Modular Integration Test Suite** — refactored the monolith `tests/cli_basic.rs` file into clean, specialized integration tests: `cli_build.rs`, `cli_deps.rs`, `cli_lint.rs`, `cli_new.rs`, `cli_qt.rs`, `cli_test.rs`, `cli_workspace.rs`.
-
-**Changed:**
-
-- **Consolidated Linking and Archiving** — artifact generation (linking executables/shared libraries and archiving static libraries) consolidated into a single `src/core/build/builder/artifact.rs` module.
-- **Workspace-Aware member execution** — `dcr run` executed at the workspace root of a `workspace_only` project now triggers the member build inside the workspace context using the `--workspace` parameter, preventing standalone build issues.
-- **Elimination of Global State** — removed global variables and states from the build core, encapsulating build logic inside isolated `BuildContext` structs for thread safety.
-- **Build Cache Separation** — relocated mtime tracking, incremental caching, and header-dependency checking logic to `src/core/build/cache.rs`.
-- **Modularized Pre-build Steps** — decoupled generator scripts and pre-build commands parsing into `src/core/build/steps.rs`.
-
 ## [0.7.4] - 2026-06-17 "Qt Поддержка, Linting и Рефакторинг Архитектуры / Qt Support, Linting, & Architecture Refactor"
 
 ### RU

Cargo.lock

@@ -2,39 +2,18 @@
 # It is not intended for manual editing.
 version = 4
 
-[[package]]
-name = "android_system_properties"
-version = "0.1.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "819e7219dbd41043ac279b19830f2efc897156490d7fd6ea916720117ee66311"
-dependencies = [
- "libc",
-]
-
 [[package]]
 name = "anyhow"
 version = "1.0.102"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7f202df86484c868dbad7eaa557ef785d5c66295e41b460ef922eca0723b842c"
 
-[[package]]
-name = "autocfg"
-version = "1.5.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f2032f911046de80f0a198e0901378627c33f59ea0ac00e363d481118bd70a53"
-
 [[package]]
 name = "base64"
 version = "0.22.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
 
-[[package]]
-name = "bitflags"
-version = "1.3.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
-
 [[package]]
 name = "bitflags"
 version = "2.11.1"
@@ -59,28 +38,6 @@ dependencies = [
  "objc2",
 ]
 
-[[package]]
-name = "bumpalo"
-version = "3.20.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "72f5acc6cb2ba439de613abc23857ec3d78374d8ed5ac84e9d11336e87da8649"
-
-[[package]]
-name = "byteorder"
-version = "1.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
-
-[[package]]
-name = "cc"
-version = "1.3.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c89588d05638b5b4594a3348a2d6c20277e43a7f5c5202b05cc56888475a47b8"
-dependencies = [
- "find-msvc-tools",
- "shlex",
-]
-
 [[package]]
 name = "cfg-if"
 version = "1.0.4"
@@ -93,19 +50,6 @@ version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "613afe47fcd5fac7ccf1db93babcb082c5994d996f20b8b159f2ad1658eb5724"
 
-[[package]]
-name = "chrono"
-version = "0.4.45"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1aa79e62e7697b8e29b513a68abacf485adcd1fe8284a4316c5ae868e6633327"
-dependencies = [
- "iana-time-zone",
- "js-sys",
- "num-traits",
- "wasm-bindgen",
- "windows-link",
-]
-
 [[package]]
 name = "core-foundation"
 version = "0.9.4"
@@ -154,17 +98,15 @@ dependencies = [
 
 [[package]]
 name = "dcr"
-version = "0.8.2"
+version = "0.7.4"
 dependencies = [
  "ctrlc",
- "fatfs",
  "glob",
  "self-replace",
  "serde",
  "serde_json",
  "sha2",
  "toml",
- "toml_edit",
  "ureq",
 ]
 
@@ -184,7 +126,7 @@ version = "0.3.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1e0e367e4e7da84520dedcac1901e4da967309406d1e51017ae1abfb97adbd38"
 dependencies = [
- "bitflags 2.11.1",
+ "bitflags",
  "block2",
  "libc",
  "objc2",
@@ -223,24 +165,6 @@ version = "2.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9f1f227452a390804cdb637b74a86990f2a7d7ba4b7d5693aac9b4dd6defd8d6"
 
-[[package]]
-name = "fatfs"
-version = "0.3.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "05669f8e7e2d7badc545c513710f0eba09c2fbef683eb859fd79c46c355048e0"
-dependencies = [
- "bitflags 1.3.2",
- "byteorder",
- "chrono",
- "log",
-]
-
-[[package]]
-name = "find-msvc-tools"
-version = "0.1.9"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5baebc0774151f905a1a2cc41989300b1e6fbb29aff0ceffa1064fdd3088d582"
-
 [[package]]
 name = "foldhash"
 version = "0.1.5"
@@ -256,30 +180,6 @@ dependencies = [
  "percent-encoding",
 ]
 
-[[package]]
-name = "futures-core"
-version = "0.3.33"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2cd50c473c80f6d7c3670a752354b8e569b1a7cbfdc0419ec88e5edad85e0dc7"
-
-[[package]]
-name = "futures-task"
-version = "0.3.33"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b231ed28831efb4a61a08580c4bc233ec56bc009f4cd8f52da2c3cb97df0c109"
-
-[[package]]
-name = "futures-util"
-version = "0.3.33"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a77a90a256fce34da66415271e30f94ee91c57b04b8a2c042d9cf3220179deaa"
-dependencies = [
- "futures-core",
- "futures-task",
- "pin-project-lite",
- "slab",
-]
-
 [[package]]
 name = "generic-array"
 version = "0.14.7"
@@ -330,30 +230,6 @@ version = "0.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
 
-[[package]]
-name = "iana-time-zone"
-version = "0.1.65"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e31bc9ad994ba00e440a8aa5c9ef0ec67d5cb5e5cb0cc7f8b744a35b389cc470"
-dependencies = [
- "android_system_properties",
- "core-foundation-sys",
- "iana-time-zone-haiku",
- "js-sys",
- "log",
- "wasm-bindgen",
- "windows-core",
-]
-
-[[package]]
-name = "iana-time-zone-haiku"
-version = "0.1.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f31827a206f56af32e590ba56d5d2d085f558508192593743f16b2306495269f"
-dependencies = [
- "cc",
-]
-
 [[package]]
 name = "icu_collections"
 version = "2.2.0"
@@ -481,17 +357,6 @@ version = "1.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
 
-[[package]]
-name = "js-sys"
-version = "0.3.103"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "53b44bfcdb3f8d5837a46dae1ca9660a837176eee74a28b229bc626816589102"
-dependencies = [
- "cfg-if",
- "futures-util",
- "wasm-bindgen",
-]
-
 [[package]]
 name = "leb128fmt"
 version = "0.1.0"
@@ -534,21 +399,12 @@ version = "0.31.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "cf20d2fde8ff38632c426f1165ed7436270b44f199fc55284c38276f9db47c3d"
 dependencies = [
- "bitflags 2.11.1",
+ "bitflags",
  "cfg-if",
  "cfg_aliases",
  "libc",
 ]
 
-[[package]]
-name = "num-traits"
-version = "0.2.19"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
-dependencies = [
- "autocfg",
-]
-
 [[package]]
 name = "objc2"
 version = "0.6.4"
@@ -582,12 +438,6 @@ version = "2.3.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220"
 
-[[package]]
-name = "pin-project-lite"
-version = "0.2.17"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a89322df9ebe1c1578d689c92318e070967d1042b512afbe49518723f4e6d5cd"
-
 [[package]]
 name = "potential_utf"
 version = "0.1.5"
@@ -637,7 +487,7 @@ version = "1.1.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b6fe4565b9518b83ef4f91bb47ce29620ca828bd32cb7e408f0062e9930ba190"
 dependencies = [
- "bitflags 2.11.1",
+ "bitflags",
  "errno",
  "libc",
  "linux-raw-sys",
@@ -675,12 +525,6 @@ dependencies = [
  "zeroize",
 ]
 
-[[package]]
-name = "rustversion"
-version = "1.0.23"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
-
 [[package]]
 name = "schannel"
 version = "0.1.29"
@@ -696,7 +540,7 @@ version = "2.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "897b2245f0b511c87893af39b033e5ca9cce68824c4d7e7630b5a1d339658d02"
 dependencies = [
- "bitflags 2.11.1",
+ "bitflags",
  "core-foundation",
  "core-foundation-sys",
  "libc",
@@ -793,18 +637,6 @@ dependencies = [
  "digest",
 ]
 
-[[package]]
-name = "shlex"
-version = "2.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
-
-[[package]]
-name = "slab"
-version = "0.4.12"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5"
-
 [[package]]
 name = "smallvec"
 version = "1.15.1"
@@ -871,18 +703,12 @@ dependencies = [
  "indexmap",
  "serde_core",
  "serde_spanned",
- "toml_datetime 1.1.1+spec-1.1.0",
+ "toml_datetime",
  "toml_parser",
  "toml_writer",
- "winnow 1.0.3",
+ "winnow",
 ]
 
-[[package]]
-name = "toml_datetime"
-version = "0.6.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "22cddaf88f4fbc13c51aebbf5f8eceb5c7c5a9da2ac40a13519eb5b0a0e8f11c"
-
 [[package]]
 name = "toml_datetime"
 version = "1.1.1+spec-1.1.0"
@@ -892,33 +718,15 @@ dependencies = [
  "serde_core",
 ]
 
-[[package]]
-name = "toml_edit"
-version = "0.22.27"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "41fe8c660ae4257887cf66394862d21dbca4a6ddd26f04a3560410406a2f819a"
-dependencies = [
- "indexmap",
- "toml_datetime 0.6.11",
- "toml_write",
- "winnow 0.7.15",
-]
-
 [[package]]
 name = "toml_parser"
 version = "1.1.2+spec-1.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a2abe9b86193656635d2411dc43050282ca48aa31c2451210f4202550afb7526"
 dependencies = [
- "winnow 1.0.3",
+ "winnow",
 ]
 
-[[package]]
-name = "toml_write"
-version = "0.1.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5d99f8c9a7727884afe522e9bd5edbfc91a3312b36a77b5fb8926e4c31a41801"
-
 [[package]]
 name = "toml_writer"
 version = "1.1.1+spec-1.1.0"
@@ -1000,51 +808,6 @@ dependencies = [
  "wit-bindgen 0.51.0",
 ]
 
-[[package]]
-name = "wasm-bindgen"
-version = "0.2.126"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4b067c0c11094aef6b7a801c1e34a26affafdf3d051dba08456b868789aaf9a4"
-dependencies = [
- "cfg-if",
- "once_cell",
- "rustversion",
- "wasm-bindgen-macro",
- "wasm-bindgen-shared",
-]
-
-[[package]]
-name = "wasm-bindgen-macro"
-version = "0.2.126"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "167ce5e579f6bcf889c4f7175a8a5a585de84e8ff93976ce393efa5f2837aab1"
-dependencies = [
- "quote",
- "wasm-bindgen-macro-support",
-]
-
-[[package]]
-name = "wasm-bindgen-macro-support"
-version = "0.2.126"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f3997c7839262f4ef12cf90b818d6340c18e80f263f1a94bf157d0ec4420380e"
-dependencies = [
- "bumpalo",
- "proc-macro2",
- "quote",
- "syn",
- "wasm-bindgen-shared",
-]
-
-[[package]]
-name = "wasm-bindgen-shared"
-version = "0.2.126"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dc1b4cb0cc549fcf58d7dfc081778139b3d283a081644e833e84682ad71cea24"
-dependencies = [
- "unicode-ident",
-]
-
 [[package]]
 name = "wasm-encoder"
 version = "0.244.0"
@@ -1073,71 +836,18 @@ version = "0.244.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "47b807c72e1bac69382b3a6fb3dbe8ea4c0ed87ff5629b8685ae6b9a611028fe"
 dependencies = [
- "bitflags 2.11.1",
+ "bitflags",
  "hashbrown 0.15.5",
  "indexmap",
  "semver",
 ]
 
-[[package]]
-name = "windows-core"
-version = "0.62.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b8e83a14d34d0623b51dce9581199302a221863196a1dde71a7663a4c2be9deb"
-dependencies = [
- "windows-implement",
- "windows-interface",
- "windows-link",
- "windows-result",
- "windows-strings",
-]
-
-[[package]]
-name = "windows-implement"
-version = "0.60.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "053e2e040ab57b9dc951b72c264860db7eb3b0200ba345b4e4c3b14f67855ddf"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn",
-]
-
-[[package]]
-name = "windows-interface"
-version = "0.59.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3f316c4a2570ba26bbec722032c4099d8c8bc095efccdc15688708623367e358"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn",
-]
-
 [[package]]
 name = "windows-link"
 version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
 
-[[package]]
-name = "windows-result"
-version = "0.4.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7781fa89eaf60850ac3d2da7af8e5242a5ea78d1a11c49bf2910bb5a73853eb5"
-dependencies = [
- "windows-link",
-]
-
-[[package]]
-name = "windows-strings"
-version = "0.5.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7837d08f69c77cf6b07689544538e017c1bfcf57e34b4c0ff58e6c2cd3b37091"
-dependencies = [
- "windows-link",
-]
-
 [[package]]
 name = "windows-sys"
 version = "0.52.0"
@@ -1220,15 +930,6 @@ version = "0.52.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
 
-[[package]]
-name = "winnow"
-version = "0.7.15"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "df79d97927682d2fd8adb29682d1140b343be4ac0f08fd68b7765d9c059d3945"
-dependencies = [
- "memchr",
-]
-
 [[package]]
 name = "winnow"
 version = "1.0.3"
@@ -1299,7 +1000,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9d66ea20e9553b30172b5e831994e35fbde2d165325bec84fc43dbf6f4eb9cb2"
 dependencies = [
  "anyhow",
- "bitflags 2.11.1",
+ "bitflags",
  "indexmap",
  "log",
  "serde",

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "dcr"
-version = "0.8.2"
+version = "0.7.4"
 edition = "2024"
 build = "build.rs"
 description = "DCR is a utility for managing C/C++ projects in a Cargo-like style."
@@ -59,10 +59,6 @@ assets = [
     { source = "man/man1/dcr-tree.1", dest = "/usr/share/man/man1/dcr-tree.1", mode = "644" },
 ]
 
-[features]
-default = []
-archive = ["dep:fatfs"]
-
 [dependencies]
 glob = "0.3"
 ureq = { version = "2.10", default-features = false, features = ["json", "native-certs"] }
@@ -70,10 +66,8 @@ serde = { version = "1", features = ["derive"] }
 self-replace = "1"
 sha2 = "0.10"
 toml = "1.0.3"
-toml_edit = "0.22"
 serde_json = "1"
 ctrlc = "3"
-fatfs = { version = "0.3", optional = true }
 
 [profile.release]
 opt-level = "z"

README.md

@@ -34,6 +34,32 @@
 
 <table>
 <tr>
+<td><b>Linux (Dexoron Packages)</b></td>
+<td>
+
+See https://pkg.dexoron.su for settings youre packages manager
+
+**Arch Linux:**
+
+```sh
+sudo pacman -Sy dcr
+```
+
+**Debian/Ubuntu:**
+
+```sh
+sudo apt update && sudo apt install dcr
+```
+
+**Fedora/RHEL:**
+
+```sh
+sudo dnf install dcr
+```
+
+</td>
+</tr>
+<tr>
 <td><b>Arch Linux (AUR)</b></td>
 <td>
 
@@ -77,28 +103,21 @@ cargo install dcr
 </td>
 </tr>
 <tr>
-<td><b>dcrup (Linux / macOS / BSD / Windows(Bash))</b></td>
+<td><b>Linux / macOS (script)</b></td>
 <td>
 
 ```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
-export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable
+curl -fsSL https://dcr.dexoron.su/install.sh | sh
 ```
 
 </td>
 </tr>
 <tr>
-<td><b>dcrup (Windows PowerShell)</b></td>
+<td><b>BSD (script)</b></td>
 <td>
 
-```powershell
-irm https://ps1.dcr-tool.ru | iex
-# or:
-# irm https://ps1.dcr-tool.ru -OutFile dcrup.ps1
-# powershell -File .\dcrup.ps1 self-install
-# $env:Path += ";$env:USERPROFILE\.dcr\bin"
-dcrup install stable
+```sh
+curl -fsSL https://dcr.dexoron.su/install_bsd.sh | sh
 ```
 
 </td>
@@ -114,6 +133,16 @@ dcrup install stable
 sudo snap install --classic --dangerous dcrup_*.snap
 ```
 
+</td>
+</tr>
+<tr>
+<td><b>Windows (PowerShell)</b></td>
+<td>
+
+```powershell
+irm https://dcr.dexoron.su/install.ps1 | iex
+```
+
 </td>
 </tr>
 <tr>
@@ -122,7 +151,7 @@ sudo snap install --classic --dangerous dcrup_*.snap
 
 ```sh
 git clone https://github.com/dexoron/dcr.git
-cd dcr && cargo build --release --features archive
+cd dcr && cargo build --release
 ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
 ```
 

TODO.md

@@ -0,0 +1,65 @@
+# DCR TODO.md
+
+Priority list of tasks to turn DCR into a true Cargo killer for C/C++ developers.
+
+**Legend:** `[ ]` — not implemented | `[-]` — partially implemented | `[x]` — implemented
+
+## 🔥 High Priority
+
+- [ ] **CLI Output Refactoring & Cleanup**
+  - [ ] Move all terminal strings to a dedicated module (`src/ui/messages.rs`)
+  - [ ] Standardize logging formats (`error:`, `warning:`, `status:`)
+  - [x] Add build execution time statistics to the final output (e.g., `Finished in 4.23s`)
+- [ ] **Internationalization (i18n) / Localization**
+  - [ ] Integrate a lightweight localization engine (`fluent` or `gettext` pure-Rust port)
+  - [ ] Create initial translation catalogs (`en.ftl`, `ru.ftl`)
+- [x] **Self-Update Stability Validation**
+  - [x] Self-update implemented via `self-replace` + `ureq` in `flag_update.rs`
+- [-] **Freestanding / Embedded Automation**
+  - *`-ffreestanding` injected at compile time, `-nostdlib -static` at link time for bare-metal targets or `build.freestanding = true`. Config option `build.freestanding` (bool) added.*
+- [ ] **Conan and vcpkg integration** Automatic download, installation and linking of packages
+
+## ✅ Medium Priority
+
+- [ ] **Static analysis** (`dcr check`)  
+  Integration with clang-tidy, cppcheck, include-what-you-use
+- [-] **Linter + Formatter** (`dcr fmt`, `dcr lint`)  
+  *`dcr fmt` (clang-format) implemented; `dcr lint` does not exist yet*
+- [ ] **Hot reload / Live reload** for applications (raylib, SFML, SDL, etc.)
+- [-] **Workspaces improvements** Per-member include directories, selective builds, better dependency graph  
+  *Basic workspaces with dep ordering + topological sort work; advanced features missing*
+- [-] **Build-time code generation** Support for protobuf, flatbuffers, Qt moc, custom generators  
+  *Generic `build.steps` machinery + Qt toolchain (uic/moc/rcc) work; no dedicated protobuf/flatbuffers generators*
+- [-] **dcr publish + official package registry** *Registry consumption (fetch, resolve, link) works; `dcr publish` command / local packing missing*
+
+## 📌 Low Priority / Nice to Have
+
+- [ ] Support for Meson and Ninja as alternative backends
+- [ ] Dockerfile generation (`dcr docker init`)
+- [ ] First-class Windows MSVC support (currently works but rough)
+- [ ] Documentation generation (`dcr doc`)
+- [ ] Sanitizers integration (`dcr sanitize`)
+- [ ] Benchmarks and comparison with CMake/Meson
+- [ ] C++20 modules support (when it becomes stable)
+
+## 🧠 Future Ideas
+
+- Official DCR package registry (dcrhub)
+- GUI wrapper (dcr-gui)
+- Plugin system
+- Toolchain manager (like rustup)
+- Zig as alternative compiler
+- deb/rpm/flatpak/AppImage packaging support
+
+---
+
+**Currently in progress:**
+- UI/UX terminal output unification and benchmarking metrics.
+
+**Completed in recent releases:**
+- Extreme binary size optimization (-50% weight reduction via `ureq` + `native-certs`)
+- Complete removal of `git2` and `openssl` in favor of system Git execution
+- Workspaces & Cross-compilation (`--target <triple>`)
+- IDE config generation (VS Code, CLion, compile_commands.json)
+- EFI support & Linker script support (`build.ldscript`)
+- Mixed C/C++/ASM compilation with custom `std::thread::scope` work-stealing engine

dcrup.cmd

@@ -1,13 +0,0 @@
-@echo off
-setlocal
-set "SCRIPT_DIR=%~dp0"
-if exist "%SCRIPT_DIR%dcrup.ps1" (
-  powershell -NoProfile -ExecutionPolicy Bypass -File "%SCRIPT_DIR%dcrup.ps1" %*
-  exit /b %ERRORLEVEL%
-)
-if exist "%USERPROFILE%\.dcr\bin\dcrup.ps1" (
-  powershell -NoProfile -ExecutionPolicy Bypass -File "%USERPROFILE%\.dcr\bin\dcrup.ps1" %*
-  exit /b %ERRORLEVEL%
-)
-echo [error] dcrup.ps1 not found near dcrup.cmd >&2
-exit /b 1

dcrup.ps1

@@ -1,367 +0,0 @@
-#Requires -Version 5.1
-$ErrorActionPreference = 'Stop'
-
-$DcrupHome = if ($env:DCRUP_HOME) { $env:DCRUP_HOME } else { Join-Path $env:USERPROFILE '.dcr' }
-$DcrupBin  = if ($env:DCRUP_BIN)  { $env:DCRUP_BIN  } else { Join-Path $DcrupHome 'bin' }
-$DcrupTc   = Join-Path $DcrupHome 'toolchains'
-$DcrupMeta = Join-Path $DcrupHome 'meta'
-$RepoUrl   = if ($env:DCRUP_REPO) { $env:DCRUP_REPO } else { 'https://github.com/dexoron/dcr' }
-$ApiLatest = 'https://api.github.com/repos/dexoron/dcr/releases/latest'
-$ApiAll    = 'https://api.github.com/repos/dexoron/dcr/releases'
-$Features  = if ($env:DCR_FEATURES) { $env:DCR_FEATURES } else { 'archive' }
-
-function Info($m) { Write-Host "[dcrup] $m" -ForegroundColor Cyan }
-function Ok($m)   { Write-Host "[ok] $m" -ForegroundColor Green }
-function Warn($m) { Write-Host "[warn] $m" -ForegroundColor Yellow }
-function Die($m)  { Write-Host "[error] $m" -ForegroundColor Red; exit 1 }
-
-function Show-Usage {
-    @'
-dcrup — install and switch DCR versions (Windows)
-
-Usage:
-  dcrup install <spec> [--build|--release] [--force]
-  dcrup default <spec>
-  dcrup update
-  dcrup list
-  dcrup show
-  dcrup which
-  dcrup uninstall [<spec>|--all]
-  dcrup self-install [--to DIR]
-  dcrup help
-
-Spec:
-  stable | dev | night
-  VERSION              → VERSION@stable  (e.g. 0.8.2)
-  VERSION@stable
-  VERSION@dev
-  night                → always build from branch "dev" HEAD
-
-Modes:
-  --release   download GitHub Release binary (default for stable/dev)
-  --build     cargo build --release --features archive
-  night       always --build (prebuilt not available)
-
-Env:
-  DCRUP_HOME      default ~/.dcr
-  DCRUP_BIN       default $DCRUP_HOME/bin
-  DCR_FEATURES    default archive
-  DCRUP_REPO      git/GitHub repo URL
-'@ | Write-Host
-}
-
-function Ensure-Dirs {
-    New-Item -ItemType Directory -Force -Path $DcrupTc, $DcrupBin, $DcrupMeta | Out-Null
-}
-
-function Get-Target {
-    $arch = $env:PROCESSOR_ARCHITECTURE
-    if ($env:PROCESSOR_ARCHITEW6432) { $arch = $env:PROCESSOR_ARCHITEW6432 }
-    switch ($arch) {
-        'AMD64' { return 'x86_64-pc-windows-msvc' }
-        'ARM64' { return 'aarch64-pc-windows-msvc' }
-        'x86'   { return 'i686-pc-windows-msvc' }
-        default { Die "unsupported arch: $arch" }
-    }
-}
-
-function Normalize-Version([string]$v) {
-    if ($v.StartsWith('v')) { return $v.Substring(1) }
-    return $v
-}
-
-function Parse-Spec([string]$raw) {
-    $script:SpecRaw = $raw
-    $script:SpecChannel = $null
-    $script:SpecVersion = $null
-    $script:SpecFloating = $false
-
-    if ($raw -in @('stable', 'dev', 'night')) {
-        $script:SpecChannel = $raw
-        $script:SpecFloating = $true
-        return
-    }
-    if ($raw -match '^(.*)@(.*)$') {
-        $script:SpecVersion = Normalize-Version $Matches[1]
-        $script:SpecChannel = $Matches[2]
-        if ($script:SpecChannel -eq 'night') { Die 'cannot pin version on night' }
-        if ($script:SpecChannel -notin @('stable', 'dev')) { Die "unknown channel: $($script:SpecChannel)" }
-        return
-    }
-    $script:SpecVersion = Normalize-Version $raw
-    $script:SpecChannel = 'stable'
-}
-
-function Toolchain-Id([string]$extra = '') {
-    if ($script:SpecChannel -eq 'night') {
-        return "night-$extra"
-    }
-    if ($script:SpecFloating) {
-        return "$($script:SpecChannel)-$extra"
-    }
-    return "$($script:SpecVersion)-$($script:SpecChannel)"
-}
-
-function Active-Path { Join-Path $DcrupMeta 'active' }
-
-function Read-Active {
-    $p = Active-Path
-    if (Test-Path $p) { return (Get-Content $p -Raw).Trim() }
-    return $null
-}
-
-function Write-Active([string]$id) {
-    Set-Content -Path (Active-Path) -Value $id -NoNewline
-}
-
-function Link-Default([string]$id) {
-    $src = Join-Path (Join-Path $DcrupTc $id) 'dcr.exe'
-    if (-not (Test-Path $src)) { Die "toolchain not installed: $id" }
-    $dst = Join-Path $DcrupBin 'dcr.exe'
-    Copy-Item $src $dst -Force
-    Write-Active $id
-    Ok "default → $id ($dst)"
-}
-
-function Fetch-Release($channel, $version) {
-    if ($version) {
-        return Invoke-RestMethod -Uri "https://api.github.com/repos/dexoron/dcr/releases/tags/v$version"
-    }
-    if ($channel -eq 'dev') {
-        $all = Invoke-RestMethod -Uri $ApiAll
-        $pre = $all | Where-Object { $_.prerelease } | Select-Object -First 1
-        if (-not $pre) { Die 'no prerelease (dev) found' }
-        return $pre
-    }
-    return Invoke-RestMethod -Uri $ApiLatest
-}
-
-function Install-Prebuilt([switch]$Force) {
-    $triple = Get-Target
-    $rel = Fetch-Release $script:SpecChannel $script:SpecVersion
-    $tag = $rel.tag_name
-    $ver = Normalize-Version $tag
-    $assetName = "dcr-$triple-$ver.exe"
-    $asset = $rel.assets | Where-Object { $_.name -eq $assetName } | Select-Object -First 1
-    if (-not $asset) { Die "asset not found: $assetName" }
-
-    $id = if ($script:SpecFloating) { Toolchain-Id $ver } else { Toolchain-Id }
-    $dest = Join-Path $DcrupTc $id
-    $bin = Join-Path $dest 'dcr.exe'
-    if ((Test-Path $bin) -and -not $Force) {
-        Ok "already installed: $id"
-        Link-Default $id
-        return
-    }
-    Ensure-Dirs
-    New-Item -ItemType Directory -Force -Path $dest | Out-Null
-    Info "downloading $assetName …"
-    Invoke-WebRequest -Uri $asset.browser_download_url -OutFile $bin
-    @"
-channel=$($script:SpecChannel)
-version=$ver
-tag=$tag
-source=release
-triple=$triple
-"@ | Set-Content (Join-Path $dest 'dcrup-meta')
-    Ok "installed prebuilt $id"
-    Link-Default $id
-}
-
-function Install-Build([switch]$Force) {
-    if (-not (Get-Command git -ErrorAction SilentlyContinue)) { Die 'git not found' }
-    if (-not (Get-Command cargo -ErrorAction SilentlyContinue)) { Die 'cargo not found' }
-
-    $tmp = Join-Path $env:TEMP ("dcrup-" + [guid]::NewGuid().ToString('N'))
-    New-Item -ItemType Directory -Path $tmp | Out-Null
-    try {
-        $src = Join-Path $tmp 'src'
-        if ($script:SpecChannel -eq 'night') {
-            Info "cloning dev for night …"
-            git clone --depth 1 --branch dev $RepoUrl $src 2>$null
-            if ($LASTEXITCODE -ne 0) { git clone --depth 1 $RepoUrl $src | Out-Null }
-            $sha = (git -C $src rev-parse --short HEAD).Trim()
-            $id = Toolchain-Id $sha
-            $ver = 'night'
-        } elseif ($script:SpecFloating) {
-            $rel = Fetch-Release $script:SpecChannel $null
-            $tag = $rel.tag_name
-            $ver = Normalize-Version $tag
-            $id = Toolchain-Id $ver
-            Info "cloning $tag …"
-            git clone --depth 1 --branch $tag $RepoUrl $src 2>$null
-            if ($LASTEXITCODE -ne 0) {
-                git clone --depth 1 $RepoUrl $src | Out-Null
-                git -C $src fetch --depth 1 origin "refs/tags/${tag}:refs/tags/${tag}"
-                git -C $src checkout $tag
-            }
-            $sha = (git -C $src rev-parse --short HEAD).Trim()
-        } else {
-            $tag = "v$($script:SpecVersion)"
-            $ver = $script:SpecVersion
-            $id = Toolchain-Id
-            Info "cloning $tag …"
-            git clone --depth 1 --branch $tag $RepoUrl $src 2>$null
-            if ($LASTEXITCODE -ne 0) {
-                git clone --depth 1 $RepoUrl $src | Out-Null
-                git -C $src fetch --depth 1 origin "refs/tags/${tag}:refs/tags/${tag}"
-                git -C $src checkout $tag
-            }
-            $sha = (git -C $src rev-parse --short HEAD).Trim()
-        }
-
-        $dest = Join-Path $DcrupTc $id
-        $bin = Join-Path $dest 'dcr.exe'
-        if ((Test-Path $bin) -and -not $Force) {
-            Ok "already installed: $id"
-            Link-Default $id
-            return
-        }
-
-        $triple = Get-Target
-        Info "building release (features: $Features) …"
-        Push-Location $src
-        cargo build --release --features $Features --target $triple
-        if ($LASTEXITCODE -ne 0) { Die 'cargo build failed' }
-        Pop-Location
-
-        New-Item -ItemType Directory -Force -Path $dest | Out-Null
-        Copy-Item (Join-Path $src "target\$triple\release\dcr.exe") $bin -Force
-        @"
-channel=$($script:SpecChannel)
-version=$ver
-git=$sha
-source=build
-features=$Features
-"@ | Set-Content (Join-Path $dest 'dcrup-meta')
-        Ok "installed build $id"
-        Link-Default $id
-    } finally {
-        Remove-Item -Recurse -Force $tmp -ErrorAction SilentlyContinue
-    }
-}
-
-function Ensure-UserPath {
-    $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
-    if (-not $userPath) { $userPath = '' }
-    if (-not ($userPath -split ';' | Where-Object { $_ -eq $DcrupBin })) {
-        $new = if ($userPath) { "$userPath;$DcrupBin" } else { $DcrupBin }
-        [Environment]::SetEnvironmentVariable('Path', $new, 'User')
-        $env:Path = "$env:Path;$DcrupBin"
-        Warn "added to user PATH: $DcrupBin (restart shell if needed)"
-    }
-}
-
-function Install-CmdShim {
-    $cmd = Join-Path $DcrupBin 'dcrup.cmd'
-    $ps1 = Join-Path $DcrupBin 'dcrup.ps1'
-    @"
-@echo off
-setlocal
-powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0dcrup.ps1" %*
-"@ | Set-Content -Path $cmd -Encoding ASCII
-    if (-not (Test-Path $ps1)) {
-        Copy-Item $PSCommandPath $ps1 -Force
-    }
-}
-
-function Cmd-Install {
-    param([string[]]$Args)
-    $mode = 'release'
-    $force = $false
-    $spec = $null
-    foreach ($a in $Args) {
-        switch -Regex ($a) {
-            '^--build$' { $mode = 'build'; continue }
-            '^--release$' { $mode = 'release'; continue }
-            '^--force$' { $force = $true; continue }
-            '^-' { Die "unknown flag: $a" }
-            default {
-                if ($spec) { Die "unexpected: $a" }
-                $spec = $a
-            }
-        }
-    }
-    if (-not $spec) { Die 'usage: dcrup install <spec> [--build|--release] [--force]' }
-    Parse-Spec $spec
-    Ensure-Dirs
-    if ($script:SpecChannel -eq 'night') { $mode = 'build' }
-    Info "install spec=$spec channel=$($script:SpecChannel) mode=$mode"
-    if ($mode -eq 'build') { Install-Build -Force:$force } else { Install-Prebuilt -Force:$force }
-    Ensure-UserPath
-    Install-CmdShim
-}
-
-function Cmd-List {
-    Ensure-Dirs
-    $active = Read-Active
-    Get-ChildItem $DcrupTc -Directory -ErrorAction SilentlyContinue | ForEach-Object {
-        $mark = if ($_.Name -eq $active) { ' *' } else { '  ' }
-        Write-Host "$mark $($_.Name)"
-    }
-}
-
-function Cmd-Show {
-    Ensure-Dirs
-    Write-Host "DCRUP_HOME=$DcrupHome"
-    Write-Host "DCRUP_BIN=$DcrupBin"
-    Write-Host "active=$(Read-Active)"
-    $exe = Join-Path $DcrupBin 'dcr.exe'
-    if (Test-Path $exe) { & $exe --version }
-}
-
-function Cmd-SelfInstall {
-    Ensure-Dirs
-    Copy-Item $PSCommandPath (Join-Path $DcrupBin 'dcrup.ps1') -Force
-    Install-CmdShim
-    Ensure-UserPath
-    Ok "dcrup installed to $DcrupBin (use: dcrup …)"
-}
-
-$cmd = if ($args.Count -ge 1) { $args[0] } else { 'help' }
-$rest = @()
-if ($args.Count -gt 1) { $rest = $args[1..($args.Count - 1)] }
-
-switch ($cmd) {
-    { $_ -in @('help', '-h', '--help') } { Show-Usage }
-    'install' { Cmd-Install $rest }
-    'list' { Cmd-List }
-    'show' { Cmd-Show }
-    'which' {
-        $p = Join-Path $DcrupBin 'dcr.exe'
-        if (Test-Path $p) { $p } else { Die 'dcr not installed' }
-    }
-    'default' {
-        if ($rest.Count -ne 1) { Die 'usage: dcrup default <spec>' }
-        Parse-Spec $rest[0]
-        if ($script:SpecFloating -or $script:SpecChannel -eq 'night') {
-            $id = Get-ChildItem $DcrupTc -Directory |
-                Where-Object { $_.Name -like "$($script:SpecChannel)-*" } |
-                Sort-Object Name | Select-Object -Last 1
-            if (-not $id) { Die "not installed: $($rest[0])" }
-            Link-Default $id.Name
-        } else {
-            Link-Default (Toolchain-Id)
-        }
-    }
-    'update' {
-        $a = Read-Active
-        if (-not $a) { Die 'no active toolchain' }
-        if ($a -like 'night-*') { Cmd-Install @('night', '--build', '--force') }
-        elseif ($a -like 'stable-*') { Cmd-Install @('stable', '--force') }
-        elseif ($a -like 'dev-*') { Cmd-Install @('dev', '--force') }
-        else { Ok "pinned $a — install a newer version explicitly" }
-    }
-    'uninstall' {
-        if ($rest -contains '--all') {
-            Remove-Item -Recurse -Force $DcrupTc -ErrorAction SilentlyContinue
-            Remove-Item (Join-Path $DcrupBin 'dcr.exe') -ErrorAction SilentlyContinue
-            Remove-Item (Active-Path) -ErrorAction SilentlyContinue
-            Ok 'removed all'
-        } else {
-            Die 'use: dcrup uninstall --all  (or install a replacement first)'
-        }
-    }
-    'self-install' { Cmd-SelfInstall }
-    default { Die "unknown command: $cmd" }
-}

dcrup.sh

@@ -1,599 +0,0 @@
-#!/usr/bin/env bash
-set -Eeuo pipefail
-
-DCRUP_HOME="${DCRUP_HOME:-$HOME/.dcr}"
-DCRUP_BIN="${DCRUP_BIN:-$DCRUP_HOME/bin}"
-DCRUP_TC="${DCRUP_HOME}/toolchains"
-DCRUP_META="${DCRUP_HOME}/meta"
-REPO_URL="${DCRUP_REPO:-https://github.com/dexoron/dcr}"
-API_LATEST="https://api.github.com/repos/dexoron/dcr/releases/latest"
-API_ALL="https://api.github.com/repos/dexoron/dcr/releases"
-FEATURES="${DCR_FEATURES:-archive}"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-CYAN='\033[0;36m'
-NC='\033[0m'
-
-log()  { printf "${CYAN}[dcrup]${NC} %s\n" "$*"; }
-ok()   { printf "${GREEN}[ok]${NC} %s\n" "$*"; }
-warn() { printf "${YELLOW}[warn]${NC} %s\n" "$*"; }
-die()  { printf "${RED}[error]${NC} %s\n" "$*" >&2; exit 1; }
-
-usage() {
-    cat <<'EOF'
-dcrup — install and switch DCR versions
-
-Usage:
-  dcrup install <spec> [--build|--release] [--force] [--libc gnu|musl|auto]
-  dcrup default <spec>
-  dcrup update
-  dcrup list
-  dcrup show
-  dcrup which
-  dcrup uninstall [<spec>|--all]
-  dcrup self-install [--to DIR]
-  dcrup help
-
-Spec:
-  stable | dev | night
-  VERSION              → VERSION@stable  (e.g. 0.8.2)
-  VERSION@stable
-  VERSION@dev
-  night                → always build from branch "dev" HEAD
-
-Modes:
-  --release   download GitHub Release binary (default for stable/dev)
-  --build     cargo build --release --features archive
-  night       always --build (prebuilt not available)
-
-Linux libc (prebuilt triple only):
-  --libc gnu    x86_64-unknown-linux-gnu (default)
-  --libc musl   x86_64-unknown-linux-musl
-  --libc auto   musl if host ldd/libc is musl, else gnu
-
-Env:
-  DCRUP_HOME      default ~/.dcr
-  DCRUP_BIN       default $DCRUP_HOME/bin
-  DCR_FEATURES    default archive
-  DCRUP_REPO      git/GitHub repo URL
-  DCRUP_LIBC      gnu|musl|auto (default: gnu)
-EOF
-}
-
-need_cmd() {
-    command -v "$1" >/dev/null 2>&1 || die "required command not found: $1"
-}
-
-detect_linux_libc() {
-    local pref="${DCRUP_LIBC:-gnu}"
-    case "$pref" in
-        gnu|glibc) echo "gnu" ;;
-        musl) echo "musl" ;;
-        auto)
-            if command -v ldd >/dev/null 2>&1; then
-                if ldd --version 2>&1 | grep -qi musl; then
-                    echo "musl"
-                    return 0
-                fi
-            fi
-            if [[ -e /lib/ld-musl-x86_64.so.1 || -e /lib/ld-musl-aarch64.so.1 ]]; then
-                echo "musl"
-                return 0
-            fi
-            if command -v getconf >/dev/null 2>&1 && getconf GNU_LIBC_VERSION >/dev/null 2>&1; then
-                echo "gnu"
-                return 0
-            fi
-            echo "gnu"
-            ;;
-        *) die "invalid DCRUP_LIBC / --libc: $pref (use gnu|musl|auto)" ;;
-    esac
-}
-
-detect_triple() {
-    local os arch libc
-    os="$(uname -s)"
-    arch="$(uname -m)"
-    case "$os:$arch" in
-        Linux:x86_64)
-            libc="$(detect_linux_libc)"
-            if [[ "$libc" == "musl" ]]; then
-                echo "x86_64-unknown-linux-musl"
-            else
-                echo "x86_64-unknown-linux-gnu"
-            fi
-            ;;
-        Linux:aarch64|Linux:arm64)
-            libc="$(detect_linux_libc)"
-            if [[ "$libc" == "musl" ]]; then
-                echo "aarch64-unknown-linux-musl"
-            else
-                echo "aarch64-unknown-linux-gnu"
-            fi
-            ;;
-        Linux:i686|Linux:i386)
-            libc="$(detect_linux_libc)"
-            if [[ "$libc" == "musl" ]]; then
-                echo "i686-unknown-linux-musl"
-            else
-                echo "i686-unknown-linux-gnu"
-            fi
-            ;;
-        Linux:armv7l|Linux:armv7)
-            libc="$(detect_linux_libc)"
-            if [[ "$libc" == "musl" ]]; then
-                echo "armv7-unknown-linux-musleabihf"
-            else
-                echo "armv7-unknown-linux-gnueabihf"
-            fi
-            ;;
-        Linux:riscv64)
-            libc="$(detect_linux_libc)"
-            if [[ "$libc" == "musl" ]]; then
-                echo "riscv64gc-unknown-linux-musl"
-            else
-                echo "riscv64gc-unknown-linux-gnu"
-            fi
-            ;;
-        Darwin:x86_64)               echo "x86_64-apple-darwin" ;;
-        Darwin:arm64|Darwin:aarch64) echo "aarch64-apple-darwin" ;;
-        FreeBSD:x86_64|FreeBSD:amd64) echo "x86_64-unknown-freebsd" ;;
-        FreeBSD:aarch64|FreeBSD:arm64) echo "aarch64-unknown-freebsd" ;;
-        OpenBSD:x86_64|OpenBSD:amd64) echo "x86_64-unknown-openbsd" ;;
-        NetBSD:x86_64|NetBSD:amd64)  echo "x86_64-unknown-netbsd" ;;
-        MINGW*|MSYS*|CYGWIN*)
-            case "$arch" in
-                x86_64|amd64) echo "x86_64-pc-windows-gnu" ;;
-                aarch64|arm64) echo "aarch64-pc-windows-gnullvm" ;;
-                i686|i386) echo "i686-pc-windows-gnu" ;;
-                *) die "unsupported Windows arch under MSYS: $arch" ;;
-            esac
-            ;;
-        *) die "unsupported platform: $os/$arch" ;;
-    esac
-}
-
-normalize_version() {
-    local v="$1"
-    v="${v#v}"
-    printf '%s' "$v"
-}
-
-parse_spec() {
-    local raw="$1"
-    SPEC_RAW="$raw"
-    SPEC_CHANNEL=""
-    SPEC_VERSION=""
-    SPEC_FLOATING=0
-
-    case "$raw" in
-        "") die "missing version/channel spec" ;;
-        stable|dev|night)
-            SPEC_CHANNEL="$raw"
-            SPEC_VERSION=""
-            SPEC_FLOATING=1
-            ;;
-        *@*)
-            SPEC_VERSION="$(normalize_version "${raw%@*}")"
-            SPEC_CHANNEL="${raw#*@}"
-            case "$SPEC_CHANNEL" in
-                stable|dev) ;;
-                night) die "cannot pin a version on night (use: dcrup install night)" ;;
-                *) die "unknown channel in spec: $SPEC_CHANNEL (use stable|dev)" ;;
-            esac
-            [[ -n "$SPEC_VERSION" ]] || die "empty version in spec: $raw"
-            ;;
-        *)
-            SPEC_VERSION="$(normalize_version "$raw")"
-            SPEC_CHANNEL="stable"
-            [[ -n "$SPEC_VERSION" ]] || die "invalid spec: $raw"
-            ;;
-    esac
-}
-
-toolchain_id() {
-    if [[ "$SPEC_CHANNEL" == "night" ]]; then
-        local sha="${1:-unknown}"
-        echo "night-${sha}"
-    elif [[ "$SPEC_FLOATING" -eq 1 ]]; then
-        local ver="${1:-latest}"
-        echo "${SPEC_CHANNEL}-${ver}"
-    else
-        echo "${SPEC_VERSION}-${SPEC_CHANNEL}"
-    fi
-}
-
-ensure_dirs() {
-    mkdir -p "$DCRUP_TC" "$DCRUP_BIN" "$DCRUP_META"
-}
-
-active_file() { echo "$DCRUP_META/active"; }
-
-read_active() {
-    if [[ -f "$(active_file)" ]]; then
-        cat "$(active_file)"
-    fi
-}
-
-write_active() {
-    printf '%s\n' "$1" >"$(active_file)"
-}
-
-link_default() {
-    local id="$1"
-    local src="$DCRUP_TC/$id/dcr"
-    [[ -x "$src" ]] || die "toolchain not installed: $id"
-    ln -sfn "$src" "$DCRUP_BIN/dcr"
-    write_active "$id"
-    ok "default → $id ($DCRUP_BIN/dcr)"
-}
-
-fetch_json() {
-    need_cmd curl
-    curl -fsSL "$1"
-}
-
-json_tag() {
-    printf '%s' "$1" | sed -n 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -n1
-}
-
-json_asset_url() {
-    local json="$1" asset="$2"
-    printf '%s' "$json" | sed -n "s#.*\"browser_download_url\"[[:space:]]*:[[:space:]]*\"\([^\"]*/${asset}\)\"#\1#p" | head -n1
-}
-
-latest_stable_json() {
-    fetch_json "$API_LATEST"
-}
-
-latest_dev_json() {
-    need_cmd curl
-    local json result
-    json="$(fetch_json "$API_ALL")"
-    if command -v jq >/dev/null 2>&1; then
-        result="$(printf '%s' "$json" | jq -e -c '[.[] | select(.prerelease == true)][0]')" || true
-    elif command -v python3 >/dev/null 2>&1; then
-        result="$(printf '%s' "$json" | python3 -c '
-import sys, json
-rels = json.load(sys.stdin)
-pre = [r for r in rels if r.get("prerelease")]
-print(json.dumps(pre[0]) if pre else "", end="")
-')"
-    else
-        die "dev channel needs jq or python3 to parse GitHub API"
-    fi
-    [[ -n "$result" && "$result" != "null" ]] || die "no prerelease (dev) found"
-    printf '%s' "$result"
-}
-
-release_json_for_spec() {
-    if [[ "$SPEC_FLOATING" -eq 1 ]]; then
-        case "$SPEC_CHANNEL" in
-            stable) latest_stable_json ;;
-            dev)    latest_dev_json ;;
-            night)  die "night has no GitHub release binary" ;;
-        esac
-    else
-        fetch_json "https://api.github.com/repos/dexoron/dcr/releases/tags/v${SPEC_VERSION}"
-    fi
-}
-
-install_prebuilt() {
-    local triple asset tag version url json id dest
-    need_cmd curl
-    triple="$(detect_triple)"
-    json="$(release_json_for_spec)"
-    tag="$(json_tag "$json")"
-    [[ -n "$tag" ]] || die "failed to parse release tag"
-    version="$(normalize_version "$tag")"
-    asset="dcr-${triple}-${version}"
-    case "$triple" in
-        *windows*) asset="${asset}.exe" ;;
-    esac
-    url="$(json_asset_url "$json" "$asset")"
-    [[ -n "$url" ]] || die "asset not found: $asset (tag $tag)"
-
-    id="$(toolchain_id "$version")"
-    dest="$DCRUP_TC/$id"
-    if [[ -x "$dest/dcr" && "${FORCE:-0}" != "1" ]]; then
-        ok "already installed: $id"
-        link_default "$id"
-        return 0
-    fi
-
-    log "downloading $asset …"
-    mkdir -p "$dest"
-    curl -fL "$url" -o "$dest/dcr"
-    chmod +x "$dest/dcr"
-    printf '%s\n' \
-        "channel=$SPEC_CHANNEL" \
-        "version=$version" \
-        "tag=$tag" \
-        "source=release" \
-        "triple=$triple" \
-        "libc=${DCRUP_LIBC:-gnu}" \
-        >"$dest/dcrup-meta"
-    ok "installed prebuilt $id ($triple)"
-    link_default "$id"
-}
-
-install_build() {
-    local tmp id dest sha version branch_or_tag
-    need_cmd git
-    need_cmd cargo
-
-    tmp="$(mktemp -d "${TMPDIR:-/tmp}/dcrup.XXXXXX")"
-    cleanup_tmp() { rm -rf "$tmp"; }
-    trap cleanup_tmp EXIT
-
-    if [[ "$SPEC_CHANNEL" == "night" ]]; then
-        log "cloning $REPO_URL (branch dev) for night …"
-        git clone --depth 1 --branch dev "$REPO_URL" "$tmp/src" 2>/dev/null \
-            || git clone --depth 1 "$REPO_URL" "$tmp/src"
-        sha="$(git -C "$tmp/src" rev-parse --short HEAD)"
-        version="night"
-        id="$(toolchain_id "$sha")"
-    elif [[ "$SPEC_FLOATING" -eq 1 ]]; then
-        local json tag
-        json="$(release_json_for_spec)"
-        tag="$(json_tag "$json")"
-        [[ -n "$tag" ]] || die "failed to resolve floating channel tag"
-        version="$(normalize_version "$tag")"
-        id="$(toolchain_id "$version")"
-        log "cloning $REPO_URL @ $tag …"
-        git clone --depth 1 --branch "$tag" "$REPO_URL" "$tmp/src" 2>/dev/null \
-            || {
-                git clone --depth 1 "$REPO_URL" "$tmp/src"
-                git -C "$tmp/src" fetch --depth 1 origin "refs/tags/${tag}:refs/tags/${tag}"
-                git -C "$tmp/src" checkout "$tag"
-            }
-        sha="$(git -C "$tmp/src" rev-parse --short HEAD)"
-    else
-        version="$SPEC_VERSION"
-        id="$(toolchain_id)"
-        local tag="v${SPEC_VERSION}"
-        log "cloning $REPO_URL @ $tag …"
-        git clone --depth 1 --branch "$tag" "$REPO_URL" "$tmp/src" 2>/dev/null \
-            || {
-                git clone --depth 1 "$REPO_URL" "$tmp/src"
-                git -C "$tmp/src" fetch --depth 1 origin "refs/tags/${tag}:refs/tags/${tag}"
-                git -C "$tmp/src" checkout "$tag"
-            }
-        sha="$(git -C "$tmp/src" rev-parse --short HEAD)"
-    fi
-
-    dest="$DCRUP_TC/$id"
-    if [[ -x "$dest/dcr" && "${FORCE:-0}" != "1" ]]; then
-        ok "already installed: $id"
-        link_default "$id"
-        return 0
-    fi
-
-    log "building release (features: $FEATURES) …"
-    (
-        cd "$tmp/src"
-        # shellcheck disable=SC2086
-        cargo build --release --features $FEATURES
-    )
-    mkdir -p "$dest"
-    cp "$tmp/src/target/release/dcr" "$dest/dcr"
-    chmod +x "$dest/dcr"
-    printf '%s\n' "channel=$SPEC_CHANNEL" "version=$version" "git=$sha" "source=build" "features=$FEATURES" >"$dest/dcrup-meta"
-    ok "installed build $id"
-    link_default "$id"
-    trap - EXIT
-    cleanup_tmp
-}
-
-cmd_install() {
-    local mode="release" FORCE=0
-    local spec=""
-    local libc_cli=""
-    while [[ $# -gt 0 ]]; do
-        case "$1" in
-            --build) mode="build"; shift ;;
-            --release) mode="release"; shift ;;
-            --force) FORCE=1; shift ;;
-            --libc)
-                [[ $# -ge 2 ]] || die "--libc needs gnu|musl|auto"
-                libc_cli="$2"
-                shift 2
-                ;;
-            --libc=*)
-                libc_cli="${1#--libc=}"
-                shift
-                ;;
-            -h|--help) usage; exit 0 ;;
-            -*) die "unknown flag: $1" ;;
-            *)
-                [[ -z "$spec" ]] || die "unexpected argument: $1"
-                spec="$1"
-                shift
-                ;;
-        esac
-    done
-    [[ -n "$spec" ]] || die "usage: dcrup install <spec> [--build|--release] [--force] [--libc gnu|musl|auto]"
-    parse_spec "$spec"
-    ensure_dirs
-
-    if [[ -n "$libc_cli" ]]; then
-        case "$libc_cli" in
-            gnu|glibc|musl|auto) DCRUP_LIBC="$libc_cli" ;;
-            *) die "invalid --libc: $libc_cli (use gnu|musl|auto)" ;;
-        esac
-    fi
-    export DCRUP_LIBC="${DCRUP_LIBC:-gnu}"
-
-    if [[ "$SPEC_CHANNEL" == "night" ]]; then
-        mode="build"
-    fi
-
-    export FORCE
-    log "install spec=$SPEC_RAW channel=$SPEC_CHANNEL version=${SPEC_VERSION:-∅} mode=$mode libc=$DCRUP_LIBC"
-    if [[ "$mode" == "build" ]]; then
-        install_build
-    else
-        install_prebuilt
-    fi
-    check_path
-}
-
-cmd_default() {
-    [[ $# -eq 1 ]] || die "usage: dcrup default <spec>"
-    parse_spec "$1"
-    ensure_dirs
-    local id
-    if [[ "$SPEC_CHANNEL" == "night" || "$SPEC_FLOATING" -eq 1 ]]; then
-        id="$(ls -1 "$DCRUP_TC" 2>/dev/null | grep -E "^${SPEC_CHANNEL}-" | sort | tail -n1 || true)"
-        [[ -n "$id" ]] || die "no installed toolchain for channel $SPEC_CHANNEL (run: dcrup install $SPEC_CHANNEL)"
-    else
-        id="$(toolchain_id)"
-        [[ -d "$DCRUP_TC/$id" ]] || die "not installed: $id (run: dcrup install $1)"
-    fi
-    link_default "$id"
-}
-
-cmd_update() {
-    ensure_dirs
-    local active
-    active="$(read_active)"
-    [[ -n "$active" ]] || die "no active toolchain (run: dcrup install stable)"
-    case "$active" in
-        night-*)
-            log "updating night (rebuild HEAD) …"
-            FORCE=1 cmd_install night --build --force
-            ;;
-        stable-*|dev-*)
-            local ch="${active%%-*}"
-            log "updating floating channel $ch …"
-            FORCE=1 cmd_install "$ch" --force
-            ;;
-        *-stable|*-dev)
-            ok "pinned toolchain $active — not floating; install a newer version explicitly"
-            ;;
-        *)
-            warn "unknown active id $active; try: dcrup install stable"
-            ;;
-    esac
-}
-
-cmd_list() {
-    ensure_dirs
-    local active
-    active="$(read_active)"
-    if [[ ! -d "$DCRUP_TC" ]] || [[ -z "$(ls -A "$DCRUP_TC" 2>/dev/null || true)" ]]; then
-        warn "no toolchains installed"
-        return 0
-    fi
-    local d base
-    for d in "$DCRUP_TC"/*; do
-        [[ -d "$d" ]] || continue
-        base="$(basename "$d")"
-        if [[ "$base" == "$active" ]]; then
-            printf ' * %s\n' "$base"
-        else
-            printf '   %s\n' "$base"
-        fi
-    done
-}
-
-cmd_show() {
-    ensure_dirs
-    local active
-    active="$(read_active)"
-    echo "DCRUP_HOME=$DCRUP_HOME"
-    echo "DCRUP_BIN=$DCRUP_BIN"
-    echo "active=${active:-none}"
-    if [[ -n "$active" && -f "$DCRUP_TC/$active/dcrup-meta" ]]; then
-        echo "--- meta ---"
-        cat "$DCRUP_TC/$active/dcrup-meta"
-    fi
-    if [[ -x "$DCRUP_BIN/dcr" ]]; then
-        echo "--- dcr --version ---"
-        "$DCRUP_BIN/dcr" --version 2>/dev/null || true
-    fi
-}
-
-cmd_which() {
-    if [[ -L "$DCRUP_BIN/dcr" || -e "$DCRUP_BIN/dcr" ]]; then
-        readlink -f "$DCRUP_BIN/dcr" 2>/dev/null || readlink "$DCRUP_BIN/dcr" 2>/dev/null || echo "$DCRUP_BIN/dcr"
-    else
-        die "dcr not linked (run: dcrup install stable)"
-    fi
-}
-
-cmd_uninstall() {
-    ensure_dirs
-    if [[ "${1:-}" == "--all" ]]; then
-        rm -rf "$DCRUP_TC"
-        rm -f "$DCRUP_BIN/dcr" "$(active_file)"
-        ok "removed all toolchains"
-        return 0
-    fi
-    [[ $# -eq 1 ]] || die "usage: dcrup uninstall <spec>|--all"
-    parse_spec "$1"
-    local id
-    if [[ "$SPEC_FLOATING" -eq 1 || "$SPEC_CHANNEL" == "night" ]]; then
-        id="$(ls -1 "$DCRUP_TC" 2>/dev/null | grep -E "^${SPEC_CHANNEL}-" | sort | tail -n1 || true)"
-    else
-        id="$(toolchain_id)"
-    fi
-    [[ -n "$id" && -d "$DCRUP_TC/$id" ]] || die "not installed: $1"
-    rm -rf "$DCRUP_TC/$id"
-    if [[ "$(read_active)" == "$id" ]]; then
-        rm -f "$DCRUP_BIN/dcr" "$(active_file)"
-        warn "removed active toolchain; run: dcrup install stable"
-    fi
-    ok "removed $id"
-}
-
-check_path() {
-    case ":$PATH:" in
-        *":$DCRUP_BIN:"*) ;;
-        *)
-            warn "$DCRUP_BIN is not in PATH"
-            echo "Add to ~/.bashrc / ~/.zshrc / ~/.profile:"
-            echo "  export PATH=\"$DCRUP_BIN:\$PATH\""
-            ;;
-    esac
-}
-
-cmd_self_install() {
-    local dest="$DCRUP_BIN"
-    while [[ $# -gt 0 ]]; do
-        case "$1" in
-            --to) dest="$2"; shift 2 ;;
-            *) die "usage: dcrup self-install [--to DIR]" ;;
-        esac
-    done
-    ensure_dirs
-    mkdir -p "$dest"
-    local self
-    self="$(readlink -f "$0" 2>/dev/null || realpath "$0" 2>/dev/null || echo "$0")"
-    cp "$self" "$dest/dcrup"
-    chmod +x "$dest/dcrup"
-    ok "dcrup installed to $dest/dcrup"
-    check_path
-    echo "Then: dcrup install stable"
-}
-
-main() {
-    local cmd="${1:-}"
-    shift || true
-    case "$cmd" in
-        ""|-h|--help|help) usage ;;
-        install) cmd_install "$@" ;;
-        default) cmd_default "$@" ;;
-        update) cmd_update "$@" ;;
-        list) cmd_list "$@" ;;
-        show) cmd_show "$@" ;;
-        which) cmd_which "$@" ;;
-        uninstall) cmd_uninstall "$@" ;;
-        self-install) cmd_self_install "$@" ;;
-        *) die "unknown command: $cmd (try: dcrup help)" ;;
-    esac
-}
-
-main "$@"

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

@@ -0,0 +1,63 @@
+---
+sidebar_label: Introduction
+---
+
+# DCR — C/C++ Build Tool & Package Manager
+
+<details>
+<summary>Quick reference</summary>
+
+```bash
+# Installation
+curl -fsSL https://dcr.dexoron.su/install.sh | sh
+
+# Create a project
+dcr new my-app
+cd my-app
+
+# Build and run
+dcr build
+dcr run
+
+# Run tests
+dcr test
+
+# Add a dependency
+dcr add fmt
+
+# Generate IDE files
+dcr gen vscode
+```
+
+</details>
+
+## Contents
+
+| Section                                               | Description                                   |
+| ----------------------------------------------------- | --------------------------------------------- |
+| [Getting Started](/docs/getting-started/installation) | Installation and first steps                  |
+| [Commands](/docs/commands/project-commands)           | All CLI commands                              |
+| [Reference](/docs/reference/dcr-toml)                 | Configuration, build, dependencies, platforms |
+| [Testing](/docs/testing/test-framework)               | Built-in test framework                       |
+| [Recipes](/docs/recipes/cross-to-windows)             | Common scenarios                              |
+| [IDE Integration](/docs/ide-integration)              | VS Code, CLion, compile_commands.json         |
+| [Self Update](/docs/self-update)                      | Auto-update                                   |
+| [FAQ](/docs/faq)                                      | Frequently asked questions                    |
+| [Changelog](/docs/changelog)                          | Version history                               |
+| [License](/docs/license)                              | DCR and vendored library licenses             |
+| [Contributing](/docs/contributing)                    | DCR development                               |
+
+## Features
+
+* **Incremental builds** — mtime + `.d` headers + SHA256 fingerprint
+* **Parallel compilation** — thread::scope, atomic task queue
+* **4 backends** — gcc/clang, MSVC/clang-cl, GAS (ARM), NASM (x86)
+* **7 project kinds** — bin, staticlib, sharedlib, efi, elf, none, custom
+* **Cross-compilation** — short names and full triples
+* **Profiles** — debug / release with field overrides
+* **Workspaces** — multi-package projects with topological sort
+* **Registry + Git + Path** — three dependency mechanisms
+* **IDE generation** — VS Code, CLion, compile_commands.json, JSON metadata
+* **pkg-config** — automatic system library discovery
+* **Per-command `--help`** — `dcr build --help`, `dcr new --help`, etc.
+* **Man pages** — `man dcr`, `man dcr-build`, `man dcr-new`

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

@@ -0,0 +1,91 @@
+---
+sidebar_label: Changelog
+---
+
+# Changelog
+
+## 0.7.1 (2026-06-02)
+
+### Added
+
+* **`--help` for all commands** — `dcr build --help`, `dcr run --help`, `dcr new --help`,
+  `dcr init --help`, `dcr clean --help`, `dcr add --help`, `dcr fmt --help`,
+  `dcr setup --help`, `dcr tree --help`, `dcr gen --help`, `dcr --update --help`,
+  `dcr test --help`. All output uses styled headers (green) and usage lines (cyan).
+* **Man pages** — 12 troff pages in `man/man1/`: `dcr.1`, `dcr-build.1`,
+  `dcr-run.1`, `dcr-new.1`, `dcr-init.1`, `dcr-clean.1`, `dcr-add.1`, `dcr-test.1`,
+  `dcr-gen.1`, `dcr-fmt.1`, `dcr-tree.1`, `dcr-setup.1`.
+* **Man pages in all packaging** — install.sh, install_bsd.sh, AUR PKGBUILD,
+  Debian (cargo-deb), RPM (cargo-generate-rpm), Nix (postInstall), Homebrew
+  (resource), Snap, GitHub Release assets.
+* **Project name validation** — `dcr init` and `dcr new` now validate names before
+  creating files. Only ASCII letters, digits, `_` and `-` are allowed.
+* **`documentation` and `homepage` fields** — added to `Cargo.toml`.
+* **Release profile optimizations** — `opt-level = "z"`, LTO, `codegen-units = 1`,
+  `panic = "abort"`, `strip = true` for smaller binaries.
+* **Linux i686, armv7, riscv64 targets** — added to release workflow and install scripts.
+* **Linux musl i686, armv7 targets** — cross-compiled via zigbuild in CI.
+* **AUR packages** — `dcr-dev`, `dcr-dev-bin` publishing workflow.
+* **Snap publishing** — automated Snapcraft publishing in CI.
+* **Snap badge** — in README.
+
+### Changed
+
+* **`validate_package_name` made public** — callable from CLI commands.
+* **README platform table** — reorganized: libc variants as separate OS rows,
+  removed extra columns. Linux architecture list updated.
+* **`gen.rs` no-args output** — now uses styled output instead of raw `eprintln!`.
+* **`tree.rs`, `fmt.rs`, and `setup.rs`** — now accept arguments for `--help`.
+* **README install commands** — `| bash` → `| sh` for POSIX compatibility.
+
+### Fixed
+
+* **`dcr new \<invalid-name>` creates directory then fails** — validation now
+  happens before any file operations.
+* **`dcr init` on invalid directory name** — same fix.
+* **Man pages missing in installed packages** — now shipped in all formats.
+* **Windows drive letter false positive** — in dependency file parser.
+* **CRLF (`\r\n`) breaks dependency parser** — now handles mixed line endings.
+* **Newline after backslash not consumed** — in `parse_d_file` escape handling.
+
+## 0.7.0 (2026-06-01)
+
+### Added
+
+* **OpenBSD and NetBSD target support** — full platform routing with dynamic target triples using `std::env::consts::ARCH` and `std::env::consts::OS`. Affects `build`, `run`, `clean` commands and the platform module.
+* **`src/platform/bsd.rs`** — new BSD platform module (shared by FreeBSD, OpenBSD, NetBSD) providing `bin_path`, `lib_path`, `elf_path`, `efi_path`, `shared_lib_path`.
+* **`build.out_dir` config option** — custom output directory that overrides the default `target/\<triple>/\<profile>` path for final artifacts. Supported in `build`, `run`, and config validation.
+* **`dcr fmt` command** — new CLI command that formats all C/C++ source files (`*.c`, `*.cpp`, `*.h`, `*.hpp`) in `src/` and `tests/` using `clang-format`.
+* **Incremental linking** — `needs_link()` in `common.rs` checks if any object file is newer than the linked output, skipping unnecessary relinking. Implemented for all backends (`unix_cc`, `msvc`, `gas`, `nasm`).
+* **`build.kind = "none"` and `"custom"`** — two new project kinds for special build scenarios that don't produce standard artifacts.
+* **`install_bsd.sh`** — POSIX-compliant installation script for BSD systems (FreeBSD, OpenBSD, NetBSD) with binary download and source build modes.
+* **Linux ARM64 support in `install.sh`** — added `Linux:aarch64|Linux:arm64` target detection for pre-built binary downloads.
+* **BSD OS detection in `install.sh`** — detects FreeBSD, OpenBSD, NetBSD and determines target triple.
+* **`rust-toolchain.toml`** — explicit toolchain pinning to `stable` channel.
+* **Integration tests** — `build_with_target_config` (verifies `build.target = "linux"`) and `build_with_out_dir` (validates custom output directory).
+* **`get_build_string_with_profile` made `pub`** — so `run.rs` can determine custom output directory configuration.
+
+### Changed
+
+* **`build.target` semantics changed** — now strictly contains a target triple (e.g., `x86_64-unknown-linux-gnu`) or short name (`linux`, `macos`, `windows`). No longer used as custom output directory — this functionality moved to `build.out_dir`.
+* **`build.standard` made optional** — changed from `String` to `Option\<String>`. Validation only enforces non-empty for non-ASM languages. Skipped in `dcr.toml` output if empty.
+* **`dcr run` with `out_dir`** — now determines target directory respecting `build.out_dir` via `get_build_string_with_profile()` from `build.rs`.
+* **`collect_sources()` returns empty vector** instead of error when no sources are found, allowing `kind = "none"` or `kind = "custom"` projects with no source files.
+* **CI/CD release workflow refactored** — `git2` made target-specific (no vendored-openssl on Windows), Zig-based cross-compilation for non-x86_64 Linux targets, Arch Linux package version cleanup (dashes → dots), `gmake` symlink for NetBSD.
+* **README compatibility table** — FreeBSD, OpenBSD, NetBSD build/run status upgraded from "community/best-effort" to "officially supported".
+* **Documentation updated** — `build-section.md` describes new `build.target` and `build.out_dir` fields. `target-directory.md` rewritten to clarify the distinction.
+
+### Fixed
+
+* **stdout/stderr not inherited in `dcr run`** — child process output was captured and manually printed, breaking interactive programs. Fixed by switching to `Command::status()`.
+* **Race condition in release CI** — matrix build jobs could upload assets to a release that didn't exist yet. Fixed by adding a dedicated `create-release` job.
+* **Release GHA — stable toolchain override** — fixed Rust toolchain override issues in CI.
+* **Arch Linux package version sanitization** — version strings with dashes (e.g., `0.7.0-dev`) are invalid for `pkgver`. Fixed by replacing dashes with dots.
+* **GPG permissions after Docker** — Docker operations changed GPG directory ownership. Fixed by running `chown` after Docker commands.
+* **RPM artifact paths** — RPM artifacts were placed in `rpm/x86_64/` instead of `fedora/x86_64/`. Fixed in Dexoron Packages Index workflow.
+* **JSON parsing reliability in `install.sh`** — added `jq` as primary parser with `python3` fallback for dev channel release lookup.
+
+### Removed
+
+* **`format_roots()` helper function** — removed from `common.rs`. Was only used by the old error handling path in `collect_sources()`.
+* **Per-distribution artifact download steps** — three separate `actions/download-artifact` steps replaced with unified `gh release download --clobber`.

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

@@ -0,0 +1,42 @@
+---
+sidebar_label: Build commands (build, run, clean)
+---
+
+# Build Commands
+
+## `dcr build`
+
+Builds the project according to `dcr.toml`.
+
+```bash
+dcr build                         # debug profile
+dcr build --release               # release build
+dcr build --debug                 # explicit debug
+dcr build --target aarch64-unknown-linux-gnu
+dcr build --force                 # full rebuild
+dcr build --clean                 # clean + build
+dcr build --verbose               # show compilation commands
+dcr build --workspace pkg-a       # build specific workspace package
+```
+
+Artifacts: `target/\<triple>/\<profile>/\<binary-name>` (Linux with explicit target).
+
+## `dcr run`
+
+Builds (if sources are newer than artifacts) and runs the binary.
+
+```bash
+dcr run
+dcr run --release
+```
+
+## `dcr clean`
+
+Removes `target/` directory (or `target/\<target>/\<profile>`).
+
+```bash
+dcr clean
+dcr clean --release               # target/release/ only
+dcr clean --target windows        # target/x86_64-pc-windows-msvc/
+dcr clean --all                   # clean all workspace packages
+```

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

@@ -0,0 +1,53 @@
+---
+sidebar_label: Dependency commands (add, tree)
+---
+
+# Dependency Commands
+
+## `dcr add \<name> [source]`
+
+Adds a dependency to `dcr.toml`.
+
+```bash
+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
+```
+
+Source prefixes:
+
+* `path:` — local path
+* `git:` — generic git URL
+* `github:` — expands to `https://github.com/\<user>/\<repo>`
+* `gitlab:` — expands to `https://gitlab.com/\<user>/\<repo>`
+* `http://` / `https://` / `git@` — full URL
+
+Flags:
+
+* `--branch \<name>` — git branch
+* `--tag \<name>` — git tag
+* `--rev \<hash>` — git commit
+
+If source is omitted — DCR searches connected registries.
+
+## `dcr tree`
+
+Displays the project dependency tree.
+
+```bash
+dcr tree
+```
+
+Example output:
+
+```
+my-app v0.1.0
+├── fmt (registry)
+│   └── spdlog (registry)
+└── catch2 (registry)
+```
+
+For path dependencies, recursively shows their own dependencies (from their `dcr.toml`).

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

@@ -0,0 +1,73 @@
+---
+sidebar_label: Gen commands (vscode, clion, ...)
+---
+
+# Gen Commands
+
+## `dcr gen \<target>`
+
+Generates IDE integration files.
+
+### vscode
+
+```bash
+dcr gen vscode
+```
+
+Creates:
+
+* `.vscode/tasks.json` — `build` task (dcr build)
+* `.vscode/launch.json` — debug launch configuration
+* `.vscode/settings.json` — C/C++ settings (clangd paths, includes)
+* `.vscode/extensions.json` — recommended extensions (vscode-clangd, vscode-lldb)
+
+### clion
+
+```bash
+dcr gen clion
+```
+
+Creates:
+
+* `.idea/externalTools.xml` — external tools (build, run, clean, test)
+* `.idea/customTargets.xml` — custom build targets
+* `.idea/misc.xml` — C/C++ project settings
+* `.idea/runConfigurations/\<name>.xml` — per-binary run configurations
+
+### compile-commands
+
+```bash
+dcr gen compile-commands
+```
+
+Generates `compile_commands.json` — standard format for clangd, cpptools, static analyzers.
+
+### project-info
+
+```bash
+dcr gen project-info
+```
+
+Outputs JSON array with project metadata:
+
+```json
+[
+  {
+    "name": "my-app",
+    "version": "0.1.0",
+    "root": "/path/to/project",
+    "profile": "debug",
+    "language": "c",
+    "standard": "c17",
+    "cxx_standard": null,
+    "compiler": "/usr/bin/clang",
+    "kind": "bin",
+    "sources": ["src/main.c"],
+    "include_dirs": ["src"],
+    "lib_dirs": [],
+    "libs": [],
+    "cflags": ["-std=c17", "-O0", "-g"],
+    "ldflags": []
+  }
+]
+```

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

@@ -0,0 +1,31 @@
+---
+sidebar_label: Project commands (new, init)
+---
+
+# Project Commands
+
+## `dcr new \<name>`
+
+Creates a new project with a standard structure and `dcr.toml`. The `name` argument is required.
+
+Only ASCII letters, digits, underscores `_` and hyphens `-` are allowed in the project name.
+
+```bash
+dcr new my-app
+```
+
+Generates:
+
+* `dcr.toml` with basic fields
+* `src/main.c` with a `main` template
+
+## `dcr init`
+
+Initializes a DCR project in the current (empty) directory.
+
+```bash
+mkdir app && cd app
+dcr init
+```
+
+The project name is taken from the current directory name. The directory name must follow the same naming rules as `dcr new`.

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

@@ -0,0 +1,60 @@
+---
+sidebar_label: Quality commands (test, fmt)
+---
+
+# Quality Commands
+
+## `dcr test`
+
+Runs tests.
+
+```bash
+dcr test                          # debug profile
+dcr test --release                # release profile
+dcr test --debug                  # explicit debug
+dcr test --help                   # detailed help
+```
+
+Before first use, initialize tests:
+
+```bash
+dcr test --init
+```
+
+This creates `tests/dcr_test.h` (framework) and `tests/test.c` (template).
+
+What `dcr test` does:
+
+1. Builds the project
+2. Collects `tests/*.c` files (`.c` only, not `.cpp`)
+3. Compiles and links each test file
+4. Runs each test binary
+5. Prints summary: TOTAL, PASS, SKIP, FAIL
+6. Returns non-zero exit code on any FAIL
+
+## `dcr fmt`
+
+Formats C/C++ source files using `clang-format`.
+
+```bash
+dcr fmt
+```
+
+Processes: `src/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}` and `tests/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}`.
+
+Uses `.clang-format` at the project root (if present), otherwise default clang-format style.
+
+## `dcr lint`
+
+Runs `clang-tidy` on C/C++ source files for static analysis.
+
+```bash
+dcr lint              # show diagnostics
+dcr lint --fix        # apply fixes automatically
+dcr lint --help       # detailed help
+```
+
+Processes: `src/**/*.{c,cpp,cxx,cc}` and `tests/**/*.{c,cpp,cxx,cc}`.
+
+Without `--fix`, clang-tidy reports warnings and errors without modifying files.
+With `--fix`, clang-tidy applies automatic suggestions in place.

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

@@ -0,0 +1,51 @@
+---
+sidebar_label: System commands (setup, --help, ...)
+---
+
+# System Commands
+
+## `dcr setup`
+
+Shows configured registries from `~/.dcr/config.toml`.
+
+```bash
+dcr setup
+```
+
+If `~/.dcr/config.toml` is not found, DCR returns an error. Create it manually:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+## `dcr --help`
+
+Shows help for all commands.
+
+```bash
+dcr --help
+```
+
+## `dcr --version`
+
+Shows version and target triple.
+
+```bash
+dcr --version       # dcr 0.7.0 (x86_64-unknown-linux-gnu)
+```
+
+## `dcr --update`
+
+Self-update. Downloads the latest release binary from GitHub Releases and replaces the current one.
+
+```bash
+dcr --update
+```
+
+Features:
+
+* Auto-detects platform and architecture
+* Warns if installed via AUR (use package manager instead)
+* Works on Linux, macOS, Windows

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

@@ -0,0 +1,51 @@
+---
+sidebar_label: Contributing
+---
+
+# Contributing
+
+## Setup
+
+```bash
+git clone https://github.com/dexoron/dcr
+cd dcr
+cargo build
+```
+
+## Code style
+
+All code must be formatted with `cargo fmt`:
+
+```bash
+cargo fmt
+```
+
+## Linting
+
+```bash
+cargo clippy --all-targets -- -D warnings
+```
+
+## Tests
+
+```bash
+cargo test --all-targets
+```
+
+## PR process
+
+1. Fork the repository
+2. Create a branch: `git checkout -b feature/description`
+3. Make changes
+4. Run `cargo fmt && cargo clippy && cargo test`
+5. Open a Pull Request
+
+## CI
+
+CI runs:
+
+* `cargo fmt --check`
+* `cargo clippy --all-targets -- -D warnings`
+* `cargo test --all-targets`
+* Build on Linux, macOS, Windows
+* Integration tests

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

@@ -0,0 +1,81 @@
+---
+sidebar_label: FAQ
+---
+
+# FAQ
+
+## Registry not found
+
+```
+error: registry not found
+```
+
+**Solution:** Make sure `~/.dcr/config.toml` exists:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+And check `DCR_INDEX_PATH`:
+
+```bash
+echo $DCR_INDEX_PATH
+```
+
+## Compiler not found
+
+```
+error: compiler not found
+```
+
+**Solution:** Ensure a compiler is installed and available in PATH.
+
+```bash
+which gcc
+which clang
+```
+
+Or specify explicitly via `[toolchain]` in `dcr.toml`.
+
+## openssl-sys build failed
+
+When building DCR from source:
+
+```
+error: failed to run custom build command for openssl-sys
+```
+
+**Solution:** Install OpenSSL development headers:
+
+```bash
+# Ubuntu/Debian
+sudo apt install libssl-dev
+
+# Fedora
+sudo dnf install openssl-devel
+
+# macOS
+brew install openssl
+```
+
+## Ctrl+C during build
+
+DCR handles SIGINT: interrupts the current compilation and exits with non-zero code.
+
+## How to create a library?
+
+See [Library Recipe](/docs/recipes/library-project).
+
+## How to cross-compile to Windows?
+
+See [Cross-Compile Recipe](/docs/recipes/cross-to-windows).
+
+## How to create a multi-package project?
+
+See [Workspace Recipe](/docs/recipes/multi-package-workspace).
+
+## 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/first-steps.mdx.mdx

@@ -0,0 +1,72 @@
+---
+sidebar_label: First steps
+---
+
+# First Steps
+
+## Create a project
+
+```bash
+dcr new my-app
+cd my-app
+```
+
+Structure:
+
+```
+my-app/
+├── dcr.toml
+└── src/
+    └── main.c
+```
+
+`dcr.toml`:
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "none"
+
+[build]
+language = "c"
+standard = "c11"
+compiler = "clang"
+kind = "bin"
+```
+
+## Build
+
+```bash
+dcr build
+```
+
+Output — `target/\<triple>/debug/my-app` (Linux) or `target/debug/my-app.exe` (Windows).
+
+Build profiles:
+
+```bash
+dcr build --release       # release build
+dcr build --debug         # debug (default)
+```
+
+## Run
+
+```bash
+dcr run
+```
+
+Builds (if needed) and runs the binary.
+
+## First test
+
+```bash
+dcr test --init      # create test template
+dcr test             # run tests
+```
+
+## Formatting
+
+```bash
+dcr fmt              # clang-format with .clang-format
+```

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

@@ -0,0 +1,109 @@
+---
+sidebar_label: Installation
+---
+
+# Installation
+
+## Linux (Dexoron Packages)
+
+Configure your package manager at https://pkg.dexoron.su and install:
+
+**Arch Linux**
+
+```sh
+sudo pacman -Sy dcr
+```
+
+**Debian/Ubuntu**
+
+```sh
+sudo apt update && sudo apt install dcr
+```
+
+**Fedora/RHEL**
+
+```sh
+sudo dnf install dcr
+```
+
+## Arch Linux (AUR)
+
+```sh
+yay -S dcr
+```
+
+## macOS / Linux (Homebrew)
+
+```sh
+brew tap dexoron/dexoron
+brew install dcr
+```
+
+## Snap (Linux)
+
+```sh
+sudo snap install dcrup
+```
+
+## Nix (flake)
+
+```sh
+nix run github:dexoron/dcr
+# or install to profile:
+nix profile install github:dexoron/dcr
+```
+
+## Cargo (crates.io)
+
+```sh
+cargo install dcr
+```
+
+## Linux / macOS (script)
+
+```sh
+curl -fsSL https://dcr.dexoron.su/install.sh | sh
+```
+
+## BSD (script)
+
+```sh
+curl -fsSL https://dcr.dexoron.su/install_bsd.sh | sh
+```
+
+## Windows (PowerShell)
+
+```powershell
+irm https://dcr.dexoron.su/install.ps1 | iex
+```
+
+## From source
+
+```sh
+git clone https://github.com/dexoron/dcr.git
+cd dcr && cargo build --release
+ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
+```
+
+## Post-install
+
+Verify the installation:
+
+```bash
+dcr --version
+```
+
+Man pages are available after installation:
+
+```bash
+man dcr
+man dcr-build
+```
+
+To use the registry, create `~/.dcr/config.toml`:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```

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

@@ -0,0 +1,51 @@
+---
+sidebar_label: IDE Integration
+---
+
+# IDE Integration
+
+## VS Code
+
+```bash
+dcr gen vscode
+```
+
+Generates in `.vscode/`:
+
+| File              | Purpose                                      |
+| ----------------- | -------------------------------------------- |
+| `tasks.json`      | `build` task (dcr build)                     |
+| `launch.json`     | Debug launch configuration                   |
+| `settings.json`   | clangd/IntelliSense: include paths, standard |
+| `extensions.json` | Recommends vscode-clangd, vscode-lldb        |
+
+## CLion
+
+```bash
+dcr gen clion
+```
+
+Generates in `.idea/`:
+
+| File                                             | Purpose                                   |
+| ------------------------------------------------ | ----------------------------------------- |
+| `externalTools.xml`                              | Build, Run, Clean, Test as external tools |
+| `customTargets.xml`                              | Custom build targets                      |
+| `misc.xml`                                       | C/C++ project settings                    |
+| `runConfigurations/\<name>.xml` | Per-binary run configurations             |
+
+## compile_commands.json
+
+```bash
+dcr gen compile-commands
+```
+
+Generates `compile_commands.json` at project root. Standard format for clangd, C/C++ IntelliSense, static analyzers.
+
+## project-info
+
+```bash
+dcr gen project-info
+```
+
+Outputs JSON array with project metadata (see [gen-commands](/docs/commands/gen-commands)).

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

@@ -0,0 +1,46 @@
+---
+sidebar_label: License
+---
+
+# License
+
+## DCR
+
+DCR itself is [GPL-3.0-or-later](https://spdx.org/licenses/GPL-3.0-or-later.html) licensed.
+
+> **Note:** DCR is a build tool, not a library. The GPL applies only to DCR's own source code. Projects built with DCR are not subject to DCR's license — their licensing is determined solely by their own code and dependencies.
+
+## Vendored libraries
+
+DCR statically links the following C libraries through its vendored Rust dependencies:
+
+| Library                                    | License            | Bundled by                    |
+| ------------------------------------------ | ------------------ | ----------------------------- |
+| [libgit2](https://libgit2.org)             | MIT OR Apache-2.0  | `git2` / `libgit2-sys`        |
+| [libssh2](https://libssh2.org)             | MIT OR Apache-2.0  | `libgit2-sys`                 |
+| [zlib](https://zlib.net)                   | MIT OR Apache-2.0  | `libgit2-sys`                 |
+| [OpenSSL](https://openssl.org)             | Apache-2.0         | `openssl-sys` / `openssl-src` |
+| [ring](https://github.com/briansmith/ring) | Apache-2.0 AND ISC | `rustls`                      |
+
+## Rust dependencies
+
+DCR is written in Rust. The following notable Rust crates are statically linked:
+
+| Crate                                         | License                  |
+| --------------------------------------------- | ------------------------ |
+| [`reqwest`](https://crates.io/crates/reqwest) | MIT OR Apache-2.0        |
+| [`rustls`](https://crates.io/crates/rustls)   | Apache-2.0 OR ISC OR MIT |
+| [`serde`](https://crates.io/crates/serde)     | MIT OR Apache-2.0        |
+| [`toml`](https://crates.io/crates/toml)       | MIT OR Apache-2.0        |
+| [`sha2`](https://crates.io/crates/sha2)       | MIT OR Apache-2.0        |
+| [`git2`](https://crates.io/crates/git2)       | MIT OR Apache-2.0        |
+| [`openssl`](https://crates.io/crates/openssl) | Apache-2.0               |
+| [`tokio`](https://crates.io/crates/tokio)     | MIT                      |
+| [`hyper`](https://crates.io/crates/hyper)     | MIT                      |
+| [`ctrlc`](https://crates.io/crates/ctrlc)     | MIT OR Apache-2.0        |
+
+Full dependency tree (143 packages) is available in [`Cargo.lock`](https://github.com/dexoron/dcr/blob/main/Cargo.lock). The overwhelming majority are dual-licensed under MIT OR Apache-2.0.
+
+## Additional credits
+
+* DCR's CLI design and project model are inspired by [Cargo](https://doc.rust-lang.org/cargo/).

docs-crowdin-export/de-DE/docs/recipes/cross-to-windows.mdx.mdx

@@ -0,0 +1,49 @@
+---
+sidebar_label: Cross-compile to Windows
+---
+
+# Cross-Compile to Windows from Linux
+
+Building a Windows binary on Linux using mingw-w64.
+
+## Install toolchain
+
+```bash
+# Ubuntu/Debian
+sudo apt install mingw-w64
+
+# Fedora
+sudo dnf install mingw64-gcc mingw64-binutils
+```
+
+## Configuration
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "none"
+
+[build]
+language = "c"
+standard = "c11"
+compiler = "clang"
+kind = "bin"
+target = "x86_64-pc-windows-gnu"    # explicit mingw, not msvc
+```
+
+## Build
+
+```bash
+dcr build --target x86_64-pc-windows-gnu --release
+```
+
+Artifact: `target/x86_64-pc-windows-gnu/release/my-app.exe`.
+
+## Custom toolchain
+
+```toml
+[toolchain]
+cc = "x86_64-w64-mingw32-gcc"
+cxx = "x86_64-w64-mingw32-g++"
+```

docs-crowdin-export/de-DE/docs/recipes/library-project.mdx.mdx

@@ -0,0 +1,70 @@
+---
+sidebar_label: Library project
+---
+
+# Library Project
+
+Creating a static library and using it in another project.
+
+## Step 1: Create the library
+
+```bash
+dcr new my-lib
+cd my-lib
+```
+
+`dcr.toml`:
+
+```toml
+[package]
+name = "my-lib"
+version = "0.1.0"
+type = "none"
+
+[build]
+language = "c"
+standard = "c11"
+kind = "staticlib"
+```
+
+`src/my_lib.h`:
+
+```c
+#ifndef MY_LIB_H
+#define MY_LIB_H
+int add(int a, int b);
+#endif
+```
+
+`src/my_lib.c`:
+
+```c
+#include "my_lib.h"
+int add(int a, int b) { return a + b; }
+```
+
+## Step 2: Build
+
+```bash
+dcr build --release
+```
+
+Artifacts:
+
+* `target/\<triple>/release/libmy-lib.a` (Linux)
+* `target/release/my-lib.lib` (Windows)
+* `target/include/` — header files
+
+## Step 3: Use in another project
+
+```bash
+dcr new my-app
+cd my-app
+dcr add my-lib ../my-lib
+```
+
+Automatically:
+
+* Adds include path to `target/include/` of the library
+* Adds lib path to `target/\<triple>/release/`
+* Links `libmy-lib.a` / `my-lib.lib`

docs-crowdin-export/de-DE/docs/recipes/multi-package-workspace.mdx.mdx

@@ -0,0 +1,102 @@
+---
+sidebar_label: Multi-package workspace
+---
+
+# Multi-Package Workspace
+
+A project with three packages: two libraries and a binary.
+
+## Structure
+
+```
+workspace/
+├── dcr.toml              # root workspace
+├── lib-core/
+│   ├── dcr.toml
+│   └── src/core.c
+├── lib-utils/
+│   ├── dcr.toml
+│   └── src/utils.c
+└── app/
+    ├── dcr.toml
+    └── src/main.c
+```
+
+## Root dcr.toml
+
+```toml
+[package]
+name = "my-workspace"
+version = "0.1.0"
+type = "none"
+
+[build]
+inherit = true
+language = "c"
+standard = "c11"
+
+[workspace.lib-core]
+path = "lib-core"
+
+[workspace.lib-utils]
+path = "lib-utils"
+deps = ["lib-core"]
+
+[workspace.app]
+path = "app"
+deps = ["lib-core", "lib-utils"]
+main = true
+```
+
+## Packages
+
+`lib-core/dcr.toml`:
+
+```toml
+[package]
+name = "lib-core"
+version = "0.1.0"
+type = "none"
+
+[build]
+kind = "staticlib"
+```
+
+`lib-utils/dcr.toml`:
+
+```toml
+[package]
+name = "lib-utils"
+version = "0.1.0"
+type = "none"
+
+[build]
+kind = "staticlib"
+```
+
+`app/dcr.toml`:
+
+```toml
+[package]
+name = "app"
+version = "0.1.0"
+type = "none"
+
+[build]
+kind = "bin"
+```
+
+## Build
+
+```bash
+cd workspace
+dcr build                     # builds everything in correct order
+dcr build --workspace app     # only app (lib-core and lib-utils built as deps)
+dcr run                       # builds and runs main package
+```
+
+Build order (topological sort):
+
+1. `lib-core`
+2. `lib-utils` (depends on lib-core)
+3. `app` (depends on lib-core, lib-utils)

docs-crowdin-export/de-DE/docs/reference/build-profiles.mdx.mdx

@@ -0,0 +1,82 @@
+---
+sidebar_label: Build profiles
+---
+
+# Build Profiles
+
+Profiles allow overriding `[build]` fields for specific build modes.
+
+## Configuration
+
+```toml
+[build]
+language = "c"
+standard = "c17"
+cflags = ["-Wall"]
+
+[build.debug]
+cflags = ["-O0", "-g"]
+
+[build.release]
+cflags = ["-O3", "-DNDEBUG"]
+```
+
+## Merge rules
+
+Fields from `[build.\<profile>]` are merged on top of `[build]`:
+
+* **Scalar fields** (strings, numbers, bools) — replaced
+* **Arrays** (`cflags`, `ldflags`, ...) — **appended** (extend the `[build]` array)
+
+Set `inherit = false` to disable array inheritance (only profile's own arrays are used).
+
+## Built-in profiles
+
+The default flags for each profile are composed from three config fields:
+
+| Field       | debug default      | release default |
+| ----------- | ------------------ | --------------- |
+| `opt_level` | `"0"`              | `"3"`           |
+| `debug`     | `true`             | `false`         |
+| `warnings`  | `["all", "extra"]` | `[]`            |
+
+Which produce the equivalent compiler flags:
+
+| Profile   | Effective flags                                            |
+| --------- | ---------------------------------------------------------- |
+| `debug`   | `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG` |
+| `release` | `-O3 -DNDEBUG`                                             |
+
+Additional build options can be toggled per-profile:
+
+```toml
+[build.release]
+opt_level = "z"
+lto = true
+strip = true
+panic = "abort"
+codegen-units = "1"
+
+[build.debug]
+opt_level = "1"
+debug = false
+warnings = ["all", "error"]
+```
+
+## Target-specific profiles
+
+```toml
+[build.linux]
+cflags = ["-DLINUX"]
+
+[build.windows.debug]
+cflags = ["-DWIN32", "-O0", "-g"]
+```
+
+Application order (highest priority first):
+
+1. `[build.\<target>.\<profile>]`
+2. `[build.\<profile>.\<target>]`
+3. `[build.\<target>]`
+4. `[build.\<profile>]`
+5. `[build]`

docs-crowdin-export/de-DE/docs/reference/build-system.mdx.mdx

@@ -0,0 +1,131 @@
+---
+sidebar_label: Build system
+---
+
+# Build System
+
+## Compiler Backends
+
+DCR supports 7 compilation backends. Selection is automatic based on file extension and `build.compiler` value.
+
+| Backend   | Files                             | When used                             |
+| --------- | --------------------------------- | ------------------------------------- |
+| `unix_cc` | `.c`, `.cpp`, `.cxx`, `.cc`, `.S` | gcc/clang on Linux/macOS/BSD          |
+| `msvc`    | `.c`, `.cpp`, `.cxx`, `.cc`       | Windows (cl, clang-cl)                |
+| `gas`     | `.s`                              | ARM/ARM64 assembler (no preprocessor) |
+| `nasm`    | `.asm`, `.s`                      | x86/x86_64 NASM assembler             |
+| `masm`    | `.asm`                            | MASM (ml/ml64) on Windows             |
+| `fasm`    | `.asm`, `.fasm`                   | Flat Assembler                        |
+| `llvm_ir` | `.ll`                             | LLVM IR via `llc -filetype=obj`       |
+
+## Qt Support
+
+DCR provides native Qt support for automatic meta-object handling (MOC, UIC, RCC).
+
+Enable it by setting `build.qt = true` in `dcr.toml`. DCR will automatically detect Qt-related files (`.ui`, `.qrc`, `.h` with `Q_OBJECT`) and process them.
+
+```toml
+[build]
+qt = true
+```
+
+*Note: Requires `qt6` modules (Core, Widgets, Gui, Svg) installed via `pkg-config`.*
+
+Advanced customization is still possible via `build.steps` if special handling is needed:
+
+```toml
+[build.steps]
+moc = "moc {in} -o {out}"
+```
+
+### Unix CC
+
+* Compiler resolved via `resolve_compiler()`: `DCR_COMPILER` > `DCR_CC` > `[toolchain]` > `build.compiler` > `PATH`
+* Supports `.d` files for header dependency tracking
+* Flags: `-std=`, `-MMD -MF`, `-c -o`, `-I`, `-L`, `-l`
+* Conditional flags based on config:
+  * `freestanding` or bare-metal target: `-ffreestanding` (compile), `-nostdlib -static` (link)
+  * `lto`: `-flto` (compile + link)
+  * `panic = "abort"`: `-fno-exceptions` (C++ only), `-fno-unwind-tables`, `-fno-asynchronous-unwind-tables`
+
+### MSVC
+
+* Supports cl.exe and clang-cl.exe
+* Flags: `/std:`, `/Fo:`, `/Fe:`, `/I`, `/link`
+
+### GAS / NASM / MASM / FASM / LLVM-IR
+
+* GAS: `-I`, `-c -o`, `--defsym`
+* NASM: `-I`, `-o`, `-D`, `-f` (format: win64/elf64/macho64/macho32/elf32)
+* MASM: `/nologo /c /Fo\<obj> <source>`
+* FASM: `<source> \<output>` (output path is the object file)
+* LLVM IR: `-filetype=obj <source> -o \<output>`
+
+## Incremental Builds
+
+Three levels of incrementality:
+
+1. **mtime** — if output is newer than all inputs, skip
+2. **`.d` files** — header change tracking (including transitive)
+3. **SHA256 fingerprint** — recompile if compiler flags changed (stored in `.dcr_fingerprint`)
+
+## Parallel Compilation
+
+* `thread::scope` for thread pool
+* Atomic task queue (`AtomicU64`)
+* Mutex on stdout (`OUTPUT_MUTEX`)
+* Thread count = `available_parallelism()`, capped by `build.codegen-units` if set
+
+## Build Kinds
+
+| Kind        | Type                            | Path (Linux example)                                                                                                       |
+| ----------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `bin`       | Executable                      | `target/\<triple>/\<profile>/\<name>` (.exe on Windows)                 |
+| `staticlib` | Static library                  | `target/\<triple>/\<profile>/lib\<name>.a` (.lib)                       |
+| `sharedlib` | Dynamic library                 | `target/\<triple>/\<profile>/lib\<name>.so` (.dll/.dylib)               |
+| `efi`       | UEFI application                | `target/\<triple>/\<profile>/\<name>.efi`                               |
+| `elf`       | ELF without stdlib              | `target/\<triple>/\<profile>/\<name>`                                   |
+| `none`      | Compile only, no link           | —                                                                                                                          |
+| `custom`    | Full filename+extension control | `target/\<triple>/\<profile>/\<filename>.\<extension>` |
+
+## Build Steps
+
+DCR supports pre-build and post-build steps:
+
+* `build.steps` — commands before compilation
+* `build.post_steps` — commands after compilation
+
+Substitutions: `{stem}`, `{in}`, `{out}`, `{profile}`, `{version}`, `{name}`.
+
+Example Qt codegen via build steps:
+
+```toml
+[build.steps]
+moc = "moc {in} -o {out}"
+```
+
+## pkg-config
+
+Automatic lookup (read from raw config):
+
+```toml
+[build]
+pkg_config = ["sdl2", "gl"]
+```
+
+DCR runs `pkg-config --cflags sdl2 gl` and `pkg-config --libs sdl2 gl` and adds results to compiler/linker flags.
+
+## Variable Substitution
+
+Supported variables:
+
+| Variable                | Description                  |
+| ----------------------- | ---------------------------- |
+| `{version}`             | Package version              |
+| `{version_major}`       | Major version part           |
+| `{version_minor}`       | Minor version part           |
+| `{version_patch}`       | Patch version                |
+| `{version_suffix}`      | Suffix (e.g., `-rc1`)        |
+| `{version_suffix_dash}` | Suffix with dash             |
+| `{profile}`             | Profile name (debug/release) |
+| `{name}`                | Package name                 |

docs-crowdin-export/de-DE/docs/reference/cross-compilation.mdx.mdx

@@ -0,0 +1,70 @@
+---
+sidebar_label: Cross-compilation
+---
+
+# Cross-Compilation
+
+## Short Names
+
+DCR supports short platform names:
+
+| Short Name | Full Triple                |
+| ---------- | -------------------------- |
+| `linux`    | `x86_64-unknown-linux-gnu` |
+| `macos`    | `x86_64-apple-darwin`      |
+| `windows`  | `x86_64-pc-windows-msvc`   |
+
+```bash
+dcr build --target windows
+```
+
+## Full Triples
+
+```bash
+dcr build --target aarch64-unknown-linux-gnu
+dcr build --target x86_64-pc-windows-gnu      # mingw
+dcr build --target armv7-unknown-linux-gnueabihf
+```
+
+## clang --target
+
+When using clang, DCR injects `--target=\<triple>` into CFLAGS.
+
+```toml
+[build]
+compiler = "clang"
+target = "aarch64-unknown-linux-gnu"
+# Auto: cflags += ["--target=aarch64-unknown-linux-gnu"]
+```
+
+## Bare-Metal / Freestanding
+
+For targets containing `none`, `-elf`, `eabi`, or `baremetal`, DCR automatically:
+
+1. **Disables default flags** — no system include paths, no `-l` libc
+2. **Injects `-ffreestanding`** at compile time and `-nostdlib -static` at link time
+
+You can also enable freestanding mode explicitly:
+
+```toml
+[build]
+freestanding = true
+```
+
+```bash
+dcr build --target aarch64-none-elf
+```
+
+## Target Directory
+
+On Linux with explicit target:
+
+```
+target/<triple>/<profile>/
+```
+
+On macOS/Windows or without target:
+
+```
+target/<profile>/
+```

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

@@ -0,0 +1,152 @@
+---
+sidebar_label: dcr.toml overview
+---
+
+# dcr.toml
+
+Main project configuration file. Located at the project root.
+
+## Structure
+
+```toml
+[package]
+# required fields
+
+[build]
+# build settings
+
+[build.debug]       # optional: debug override
+[build.release]     # optional: release override
+
+[build.linux]       # optional: Linux override
+[build.windows]     # optional: Windows override
+[build.windows.debug]  # target + profile combination
+
+[toolchain]
+# compiler/linker paths
+
+[dependencies]
+# project dependencies
+
+[workspace]
+# multi-package configuration
+
+[run]
+# run settings
+```
+
+## [package]
+
+| Field     | Required | Description             |
+| --------- | -------- | ----------------------- |
+| `name`    | yes      | Project name            |
+| `version` | yes      | Semantic version        |
+| `type`    | yes      | `app`, `lib`, `none`    |
+| `license` | no       | SPDX license identifier |
+| `author`  | no       | Author                  |
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "app"
+license = "MIT"
+author = "John Doe"
+```
+
+## [build]
+
+...
+
+* `build.qt` — (bool) Enable automatic Qt meta-object handling (MOC, UIC, RCC). Requires `qt6` modules installed via `pkg-config`.
+
+| Field            | Default                                     | Description                                                           |
+| ---------------- | ------------------------------------------- | --------------------------------------------------------------------- |
+| `language`       | `"c"`                                       | `"c"`, `"c++"`, `"cpp"`, `"cxx"`, `"asm"`                             |
+| `standard`       | `"c11"`                                     | C standard (`c11`, `c17`, `c23`)                                      |
+| `cxx_standard`   | `"c++20"`                                   | C++ standard (`c++17`, `c++20`, `c++23`)                              |
+| `compiler`       | `"clang"`                                   | Preferred compiler                                                    |
+| `kind`           | `"bin"`                                     | `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, `custom`       |
+| `target`         | host                                        | Target triple for cross-compilation                                   |
+| `platform`       | `"native"`                                  | `native`, `efi`                                                       |
+| `cflags`         | `[]`                                        | Additional C/C++/ASM flags                                            |
+| `ldflags`        | `[]`                                        | Additional linker flags                                               |
+| `filename`       | `""`                                        | Custom output file name                                               |
+| `extension`      | `""`                                        | Custom file extension                                                 |
+| `roots`          | `["src"]`                                   | Source root directories                                               |
+| `exclude`        | `[]`                                        | Exclude patterns                                                      |
+| `include`        | `[]`                                        | Additional include directories                                        |
+| `src_disable`    | `false`                                     | Disable auto source discovery                                         |
+| `inherit`        | `false`                                     | Inherit build from workspace root                                     |
+| `clean`          | `[]`                                        | Glob patterns for custom clean paths                                  |
+| `out_dir`        | `""`                                        | Custom output directory                                               |
+| `workspace_only` | `false`                                     | Workspace-only, not built standalone                                  |
+| `freestanding`   | `false`                                     | Compile in freestanding mode (`-ffreestanding` + `-nostdlib -static`) |
+| `opt_level`      | `"0"` (debug) / `"3"` (release)             | Optimization level: `0`-`3`, `"s"`, `"z"`                             |
+| `debug`          | `true` (debug) / `false` (release)          | Emit debug symbols (`-g`)                                             |
+| `lto`            | `false`                                     | Link-time optimization (`-flto` for both compiler and linker)         |
+| `strip`          | `false`                                     | Strip symbols from output (`-s` in ldflags)                           |
+| `warnings`       | `["all", "extra"]` (debug) / `[]` (release) | Warning flags (e.g. `"all"`, `"extra"`, `"pedantic"`)                 |
+| `panic`          | `""`                                        | Panic strategy: `"abort"` disables exceptions and unwind tables       |
+| `codegen-units`  | `""`                                        | Max parallel compilation jobs (`"0"` = auto)                          |
+| `qt`             | `false`                                     | Enable automatic Qt meta-object handling (MOC, UIC, RCC)              |
+
+Settings from raw config (not in typed struct):
+
+* `pkg_config` — list of pkg-config packages
+* `ldscript` — linker script path
+* `build.steps` / `build.post_steps` — codegen steps
+
+Example:
+
+```toml
+[build]
+language = "c++"
+standard = "c23"
+cxx_standard = "c++23"
+compiler = "clang"
+kind = "sharedlib"
+cflags = ["-Wall", "-Wextra"]
+opt_level = "z"
+lto = true
+strip = true
+panic = "abort"
+codegen-units = "2"
+```
+
+## [toolchain]
+
+```toml
+[toolchain]
+cc = "/usr/bin/clang"
+cxx = "/usr/bin/clang++"
+as = "/usr/bin/as"
+ar = "/usr/bin/ar"
+ld = "/usr/bin/ld.lld"
+```
+
+Raw config also supports `uic`, `moc`, `rcc` for Qt codegen.
+
+## [dependencies]
+
+See [dependencies](/docs/reference/dependencies).
+
+## [run]
+
+```toml
+[run]
+cmd = "./target/{profile}/{name}"
+```
+
+Substitutions:
+
+* `{version}` — package version
+* `{version_major}`, `{version_minor}`, `{version_patch}`, `{version_suffix}`, `{version_suffix_dash}` — version parts
+* `{profile}` — debug / release
+* `{name}` — package name
+
+Default `cmd` = `./target/{profile}/{name}` (macOS/Windows) or `./target/\<triple>/\<profile>/\<name>` (Linux).
+
+## [workspace]
+
+See [workspaces](/docs/reference/workspaces).

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

@@ -0,0 +1,84 @@
+---
+sidebar_label: Dependencies
+---
+
+# Dependencies
+
+## Formats
+
+The `[dependencies]` section supports three formats:
+
+### String (registry)
+
+```toml
+[dependencies]
+fmt = "10.1.1"
+spdlog = "1.12"
+catch2 = "3.4.0"
+```
+
+The version string is used as-is for registry lookup.
+
+### Table (git)
+
+```toml
+[dependencies]
+fmt = { git = "https://github.com/fmtlib/fmt", tag = "10.1.1" }
+```
+
+Fields: `git`, `branch`, `tag`, `rev`.
+
+### Table (path)
+
+```toml
+[dependencies]
+mylib = { path = "../mylib" }
+```
+
+## Registry
+
+DCR uses a package registry for dependency lookup by name.
+
+```toml
+# ~/.dcr/config.toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+Registry priority: order in `config.toml`. The `DCR_INDEX_PATH` variable overrides the path to `index.json`.
+
+## Git dependencies
+
+DCR clones git repositories via `git2`:
+
+* `branch` — switch to a branch
+* `tag` — switch to a tag
+* `rev` — switch to a specific commit
+* `features` — feature flags (parsed, but does not affect build)
+
+Cache path: `~/.dcr/git/\<hash>/`.
+
+## Path dependencies
+
+Local paths. DCR automatically discovers include and lib directories from the neighbor's `dcr.toml`.
+
+```toml
+[dependencies]
+mylib = { path = "/abs/path/to/lib" }
+mylib = { path = "../relative/path" }
+```
+
+## 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`.
+
+## 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

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

@@ -0,0 +1,60 @@
+---
+sidebar_label: Environment variables
+---
+
+# Environment Variables
+
+## DCR_COMPILER
+
+Overrides the compiler for all languages. **Highest priority.**
+
+```bash
+export DCR_COMPILER=clang
+dcr build
+```
+
+Compiler resolution priority:
+
+1. `DCR_COMPILER` (env)
+2. `DCR_CC` / `DCR_CXX` / `DCR_AS` (env)
+3. `[toolchain]` (dcr.toml)
+4. `build.compiler` (dcr.toml)
+5. `PATH`
+
+## DCR_CC / DCR_CXX / DCR_AS
+
+Per-language override (lower priority than `DCR_COMPILER`, higher than `[toolchain]`).
+
+```bash
+export DCR_CC=gcc-14
+export DCR_CXX=g++-14
+export DCR_AS=arm-linux-gnueabihf-as
+```
+
+## DCR_LD / DCR_AR
+
+Override linker and archiver.
+
+```bash
+export DCR_LD=ld.lld
+export DCR_AR=llvm-ar
+```
+
+## DCR_DEBUG
+
+Enables debug mode — prints all compilation commands to stderr before execution.
+
+```bash
+export DCR_DEBUG=1
+dcr build
+```
+
+## DCR_INDEX_PATH
+
+Overrides the path to the registry `index.json`.
+
+```bash
+export DCR_INDEX_PATH=/custom/path/index.json
+```
+
+Default: `~/.dcr/index.json`.

docs-crowdin-export/de-DE/docs/reference/platform-support.mdx.mdx

@@ -0,0 +1,51 @@
+---
+sidebar_label: Platform support
+---
+
+# Platform Support
+
+## Target Triples
+
+DCR normalizes target triples. Short platform names are expanded to full triples.
+
+### Linux
+
+```
+target/<arch>-unknown-linux-gnu/<profile>/
+```
+
+Architectures: `x86_64`, `aarch64` (host-detected).
+
+Artifact type: ELF. Extensions: `.so` (sharedlib), `.a` (staticlib).
+
+### macOS
+
+```
+target/<profile>/
+```
+
+Architectures: `x86_64`, `aarch64` (host-detected).
+
+Extensions: `.dylib` (sharedlib), `.a` (staticlib).
+
+### Windows
+
+```
+target/<profile>/
+```
+
+Architectures: `x86_64`, `aarch64`.
+
+Extensions: `.exe` (bin), `.lib` (staticlib), `.dll` (sharedlib), `.efi` (UEFI).
+
+### BSD
+
+```
+target/<arch>-unknown-<os>/<profile>/
+```
+
+Supported systems: `freebsd`, `openbsd`, `netbsd`, `dragonfly`.
+
+## Host Detection
+
+DCR uses `std::env::consts::ARCH` and `std::env::consts::OS` for host platform detection. Used as fallback when `target` is not specified.

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

@@ -0,0 +1,67 @@
+---
+sidebar_label: Workspaces
+---
+
+# Workspaces
+
+Workspaces allow managing multiple packages in a single repository.
+
+## Configuration
+
+```toml
+[workspace.lib-core]
+path = "lib-core"
+
+[workspace.lib-utils]
+path = "lib-utils"
+deps = ["lib-core"]
+
+[workspace.app]
+path = "app"
+deps = ["lib-core", "lib-utils"]
+main = true
+```
+
+### Member fields
+
+| Field  | Description                                      |
+| ------ | ------------------------------------------------ |
+| `path` | Path to the package (relative to workspace root) |
+| `deps` | Dependencies on other members                    |
+| `main` | Mark as the main package                         |
+
+## Topological sort
+
+DCR automatically sorts packages by dependencies: package A is built before B if B depends on A.
+
+Cyclic dependencies are detected and cause an error.
+
+## Build
+
+```bash
+dcr build                    # build all packages in dependency order
+dcr build --workspace app    # build only app (dependencies built automatically)
+```
+
+When building a workspace, member outputs (libraries) are automatically added to include/lib paths of dependent packages.
+
+## Clean
+
+```bash
+dcr clean                    # clean only root target/
+dcr clean --all              # clean target/ of all packages
+```
+
+## Inheritance
+
+If a member has `inherit = true` in its `[build]` section, fields from the root `[build]` are merged into the member:
+
+```toml
+# root dcr.toml
+[build]
+inherit = true
+language = "c"
+standard = "c17"
+
+# member inherits language and standard
+```

docs-crowdin-export/de-DE/docs/self-update.mdx.mdx

@@ -0,0 +1,46 @@
+---
+sidebar_label: Self Update
+---
+
+# Self Update
+
+## dcr --update
+
+Automatic update to the latest version. Downloads a binary (not an archive) from GitHub Releases and replaces the current executable.
+
+```bash
+dcr --update
+```
+
+## How it works
+
+1. DCR detects the current platform and architecture
+2. Fetches the latest release from `api.github.com/repos/dexoron/dcr/releases/latest`
+3. Compares versions
+4. Downloads the matching asset (direct binary URL, not archive)
+5. Replaces the current executable via `self_replace`
+
+## Asset naming
+
+Pattern: `dcr-\<triple>` or `dcr-\<triple>.exe`
+
+| Platform       | Asset name                       |
+| -------------- | -------------------------------- |
+| Linux x86_64   | `dcr-x86_64-unknown-linux-gnu`   |
+| macOS x86_64   | `dcr-x86_64-apple-darwin`        |
+| macOS ARM64    | `dcr-aarch64-apple-darwin`       |
+| Windows x86_64 | `dcr-x86_64-pc-windows-msvc.exe` |
+
+## AUR
+
+If DCR was installed via AUR, `--update` shows a warning:
+
+```
+Update via package manager: yay/paru -Syu {package_name} or sudo pacman -Syu {package_name}
+```
+
+## Errors
+
+* Cannot detect platform — error
+* Cannot fetch release — error with URL
+* No write permission — error (use `sudo` or manual install)

docs-crowdin-export/de-DE/docs/testing/running-tests.mdx.mdx

@@ -0,0 +1,45 @@
+---
+sidebar_label: Running tests
+---
+
+# Running Tests
+
+## Execution
+
+```bash
+dcr test
+```
+
+Builds the project, then compiles and runs test files from `tests/`.
+
+## Profiles
+
+```bash
+dcr test                     # debug (default)
+dcr test --release           # release
+dcr test --debug             # explicit debug
+```
+
+## Output
+
+```
+=====================
+  Testsuite summary
+=====================
+TOTAL: 5
+PASS: 3
+SKIP: 1
+FAIL: 1
+=====================
+```
+
+## Exit code
+
+* 0 — all tests passed (FAIL = 0)
+* 1 — test failures or build error
+
+## What gets built
+
+* All `.c` files from `tests/` (`.cpp` not supported)
+* Include path: `tests/` (for `dcr_test.h`)
+* Linked with project if `package.type = "lib"` or `kind = "staticlib"`/`"sharedlib"`

docs-crowdin-export/de-DE/docs/testing/test-framework.mdx.mdx

@@ -0,0 +1,69 @@
+---
+sidebar_label: Test framework (EXPECT, TEST, ...)
+---
+
+# Test Framework
+
+DCR has a built-in minimal test framework for C.
+
+## Macros
+
+### `EXPECT(expr)`
+
+Asserts that an expression is true.
+
+```c
+EXPECT(1 + 1 == 2);
+EXPECT(ptr != NULL);
+```
+
+### `SKIP(reason)`
+
+Skips a test with a message.
+
+```c
+SKIP("not implemented on Windows");
+```
+
+### `TEST(name)`
+
+Defines a test.
+
+```c
+TEST(addition) {
+    EXPECT(1 + 1 == 2);
+    EXPECT(2 + 2 == 4);
+}
+```
+
+### `TEST_CASE(name)`
+
+Registers a test case.
+
+```c
+TEST_CASE(math) {
+    EXPECT(1 + 1 == 2);
+}
+```
+
+## Initialization
+
+```bash
+dcr test --init
+```
+
+Creates:
+
+* `tests/dcr_test.h` — framework header (do not edit)
+* `tests/test.c` — template with example test
+
+## Structure
+
+```
+tests/
+├── dcr_test.h      # framework (do not edit)
+├── test.c          # main tests
+└── ...             # additional .c test files
+```
+
+Only `.c` files are compiled (`.cpp` is not supported).

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

@@ -0,0 +1,63 @@
+---
+sidebar_label: Introduction
+---
+
+# DCR — C/C++ Build Tool & Package Manager
+
+<details>
+<summary>Quick reference</summary>
+
+```bash
+# Installation
+curl -fsSL https://dcr.dexoron.su/install.sh | sh
+
+# Create a project
+dcr new my-app
+cd my-app
+
+# Build and run
+dcr build
+dcr run
+
+# Run tests
+dcr test
+
+# Add a dependency
+dcr add fmt
+
+# Generate IDE files
+dcr gen vscode
+```
+
+</details>
+
+## Contents
+
+| Section                                               | Description                                   |
+| ----------------------------------------------------- | --------------------------------------------- |
+| [Getting Started](/docs/getting-started/installation) | Installation and first steps                  |
+| [Commands](/docs/commands/project-commands)           | All CLI commands                              |
+| [Reference](/docs/reference/dcr-toml)                 | Configuration, build, dependencies, platforms |
+| [Testing](/docs/testing/test-framework)               | Built-in test framework                       |
+| [Recipes](/docs/recipes/cross-to-windows)             | Common scenarios                              |
+| [IDE Integration](/docs/ide-integration)              | VS Code, CLion, compile_commands.json         |
+| [Self Update](/docs/self-update)                      | Auto-update                                   |
+| [FAQ](/docs/faq)                                      | Frequently asked questions                    |
+| [Changelog](/docs/changelog)                          | Version history                               |
+| [License](/docs/license)                              | DCR and vendored library licenses             |
+| [Contributing](/docs/contributing)                    | DCR development                               |
+
+## Features
+
+* **Incremental builds** — mtime + `.d` headers + SHA256 fingerprint
+* **Parallel compilation** — thread::scope, atomic task queue
+* **4 backends** — gcc/clang, MSVC/clang-cl, GAS (ARM), NASM (x86)
+* **7 project kinds** — bin, staticlib, sharedlib, efi, elf, none, custom
+* **Cross-compilation** — short names and full triples
+* **Profiles** — debug / release with field overrides
+* **Workspaces** — multi-package projects with topological sort
+* **Registry + Git + Path** — three dependency mechanisms
+* **IDE generation** — VS Code, CLion, compile_commands.json, JSON metadata
+* **pkg-config** — automatic system library discovery
+* **Per-command `--help`** — `dcr build --help`, `dcr new --help`, etc.
+* **Man pages** — `man dcr`, `man dcr-build`, `man dcr-new`

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

@@ -0,0 +1,91 @@
+---
+sidebar_label: Changelog
+---
+
+# Changelog
+
+## 0.7.1 (2026-06-02)
+
+### Added
+
+* **`--help` for all commands** — `dcr build --help`, `dcr run --help`, `dcr new --help`,
+  `dcr init --help`, `dcr clean --help`, `dcr add --help`, `dcr fmt --help`,
+  `dcr setup --help`, `dcr tree --help`, `dcr gen --help`, `dcr --update --help`,
+  `dcr test --help`. All output uses styled headers (green) and usage lines (cyan).
+* **Man pages** — 12 troff pages in `man/man1/`: `dcr.1`, `dcr-build.1`,
+  `dcr-run.1`, `dcr-new.1`, `dcr-init.1`, `dcr-clean.1`, `dcr-add.1`, `dcr-test.1`,
+  `dcr-gen.1`, `dcr-fmt.1`, `dcr-tree.1`, `dcr-setup.1`.
+* **Man pages in all packaging** — install.sh, install_bsd.sh, AUR PKGBUILD,
+  Debian (cargo-deb), RPM (cargo-generate-rpm), Nix (postInstall), Homebrew
+  (resource), Snap, GitHub Release assets.
+* **Project name validation** — `dcr init` and `dcr new` now validate names before
+  creating files. Only ASCII letters, digits, `_` and `-` are allowed.
+* **`documentation` and `homepage` fields** — added to `Cargo.toml`.
+* **Release profile optimizations** — `opt-level = "z"`, LTO, `codegen-units = 1`,
+  `panic = "abort"`, `strip = true` for smaller binaries.
+* **Linux i686, armv7, riscv64 targets** — added to release workflow and install scripts.
+* **Linux musl i686, armv7 targets** — cross-compiled via zigbuild in CI.
+* **AUR packages** — `dcr-dev`, `dcr-dev-bin` publishing workflow.
+* **Snap publishing** — automated Snapcraft publishing in CI.
+* **Snap badge** — in README.
+
+### Changed
+
+* **`validate_package_name` made public** — callable from CLI commands.
+* **README platform table** — reorganized: libc variants as separate OS rows,
+  removed extra columns. Linux architecture list updated.
+* **`gen.rs` no-args output** — now uses styled output instead of raw `eprintln!`.
+* **`tree.rs`, `fmt.rs`, and `setup.rs`** — now accept arguments for `--help`.
+* **README install commands** — `| bash` → `| sh` for POSIX compatibility.
+
+### Fixed
+
+* **`dcr new \<invalid-name>` creates directory then fails** — validation now
+  happens before any file operations.
+* **`dcr init` on invalid directory name** — same fix.
+* **Man pages missing in installed packages** — now shipped in all formats.
+* **Windows drive letter false positive** — in dependency file parser.
+* **CRLF (`\r\n`) breaks dependency parser** — now handles mixed line endings.
+* **Newline after backslash not consumed** — in `parse_d_file` escape handling.
+
+## 0.7.0 (2026-06-01)
+
+### Added
+
+* **OpenBSD and NetBSD target support** — full platform routing with dynamic target triples using `std::env::consts::ARCH` and `std::env::consts::OS`. Affects `build`, `run`, `clean` commands and the platform module.
+* **`src/platform/bsd.rs`** — new BSD platform module (shared by FreeBSD, OpenBSD, NetBSD) providing `bin_path`, `lib_path`, `elf_path`, `efi_path`, `shared_lib_path`.
+* **`build.out_dir` config option** — custom output directory that overrides the default `target/\<triple>/\<profile>` path for final artifacts. Supported in `build`, `run`, and config validation.
+* **`dcr fmt` command** — new CLI command that formats all C/C++ source files (`*.c`, `*.cpp`, `*.h`, `*.hpp`) in `src/` and `tests/` using `clang-format`.
+* **Incremental linking** — `needs_link()` in `common.rs` checks if any object file is newer than the linked output, skipping unnecessary relinking. Implemented for all backends (`unix_cc`, `msvc`, `gas`, `nasm`).
+* **`build.kind = "none"` and `"custom"`** — two new project kinds for special build scenarios that don't produce standard artifacts.
+* **`install_bsd.sh`** — POSIX-compliant installation script for BSD systems (FreeBSD, OpenBSD, NetBSD) with binary download and source build modes.
+* **Linux ARM64 support in `install.sh`** — added `Linux:aarch64|Linux:arm64` target detection for pre-built binary downloads.
+* **BSD OS detection in `install.sh`** — detects FreeBSD, OpenBSD, NetBSD and determines target triple.
+* **`rust-toolchain.toml`** — explicit toolchain pinning to `stable` channel.
+* **Integration tests** — `build_with_target_config` (verifies `build.target = "linux"`) and `build_with_out_dir` (validates custom output directory).
+* **`get_build_string_with_profile` made `pub`** — so `run.rs` can determine custom output directory configuration.
+
+### Changed
+
+* **`build.target` semantics changed** — now strictly contains a target triple (e.g., `x86_64-unknown-linux-gnu`) or short name (`linux`, `macos`, `windows`). No longer used as custom output directory — this functionality moved to `build.out_dir`.
+* **`build.standard` made optional** — changed from `String` to `Option\<String>`. Validation only enforces non-empty for non-ASM languages. Skipped in `dcr.toml` output if empty.
+* **`dcr run` with `out_dir`** — now determines target directory respecting `build.out_dir` via `get_build_string_with_profile()` from `build.rs`.
+* **`collect_sources()` returns empty vector** instead of error when no sources are found, allowing `kind = "none"` or `kind = "custom"` projects with no source files.
+* **CI/CD release workflow refactored** — `git2` made target-specific (no vendored-openssl on Windows), Zig-based cross-compilation for non-x86_64 Linux targets, Arch Linux package version cleanup (dashes → dots), `gmake` symlink for NetBSD.
+* **README compatibility table** — FreeBSD, OpenBSD, NetBSD build/run status upgraded from "community/best-effort" to "officially supported".
+* **Documentation updated** — `build-section.md` describes new `build.target` and `build.out_dir` fields. `target-directory.md` rewritten to clarify the distinction.
+
+### Fixed
+
+* **stdout/stderr not inherited in `dcr run`** — child process output was captured and manually printed, breaking interactive programs. Fixed by switching to `Command::status()`.
+* **Race condition in release CI** — matrix build jobs could upload assets to a release that didn't exist yet. Fixed by adding a dedicated `create-release` job.
+* **Release GHA — stable toolchain override** — fixed Rust toolchain override issues in CI.
+* **Arch Linux package version sanitization** — version strings with dashes (e.g., `0.7.0-dev`) are invalid for `pkgver`. Fixed by replacing dashes with dots.
+* **GPG permissions after Docker** — Docker operations changed GPG directory ownership. Fixed by running `chown` after Docker commands.
+* **RPM artifact paths** — RPM artifacts were placed in `rpm/x86_64/` instead of `fedora/x86_64/`. Fixed in Dexoron Packages Index workflow.
+* **JSON parsing reliability in `install.sh`** — added `jq` as primary parser with `python3` fallback for dev channel release lookup.
+
+### Removed
+
+* **`format_roots()` helper function** — removed from `common.rs`. Was only used by the old error handling path in `collect_sources()`.
+* **Per-distribution artifact download steps** — three separate `actions/download-artifact` steps replaced with unified `gh release download --clobber`.

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

@@ -0,0 +1,42 @@
+---
+sidebar_label: Build commands (build, run, clean)
+---
+
+# Build Commands
+
+## `dcr build`
+
+Builds the project according to `dcr.toml`.
+
+```bash
+dcr build                         # debug profile
+dcr build --release               # release build
+dcr build --debug                 # explicit debug
+dcr build --target aarch64-unknown-linux-gnu
+dcr build --force                 # full rebuild
+dcr build --clean                 # clean + build
+dcr build --verbose               # show compilation commands
+dcr build --workspace pkg-a       # build specific workspace package
+```
+
+Artifacts: `target/\<triple>/\<profile>/\<binary-name>` (Linux with explicit target).
+
+## `dcr run`
+
+Builds (if sources are newer than artifacts) and runs the binary.
+
+```bash
+dcr run
+dcr run --release
+```
+
+## `dcr clean`
+
+Removes `target/` directory (or `target/\<target>/\<profile>`).
+
+```bash
+dcr clean
+dcr clean --release               # target/release/ only
+dcr clean --target windows        # target/x86_64-pc-windows-msvc/
+dcr clean --all                   # clean all workspace packages
+```

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

@@ -0,0 +1,53 @@
+---
+sidebar_label: Dependency commands (add, tree)
+---
+
+# Dependency Commands
+
+## `dcr add \<name> [source]`
+
+Adds a dependency to `dcr.toml`.
+
+```bash
+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
+```
+
+Source prefixes:
+
+* `path:` — local path
+* `git:` — generic git URL
+* `github:` — expands to `https://github.com/\<user>/\<repo>`
+* `gitlab:` — expands to `https://gitlab.com/\<user>/\<repo>`
+* `http://` / `https://` / `git@` — full URL
+
+Flags:
+
+* `--branch \<name>` — git branch
+* `--tag \<name>` — git tag
+* `--rev \<hash>` — git commit
+
+If source is omitted — DCR searches connected registries.
+
+## `dcr tree`
+
+Displays the project dependency tree.
+
+```bash
+dcr tree
+```
+
+Example output:
+
+```
+my-app v0.1.0
+├── fmt (registry)
+│   └── spdlog (registry)
+└── catch2 (registry)
+```
+
+For path dependencies, recursively shows their own dependencies (from their `dcr.toml`).

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

@@ -0,0 +1,73 @@
+---
+sidebar_label: Gen commands (vscode, clion, ...)
+---
+
+# Gen Commands
+
+## `dcr gen \<target>`
+
+Generates IDE integration files.
+
+### vscode
+
+```bash
+dcr gen vscode
+```
+
+Creates:
+
+* `.vscode/tasks.json` — `build` task (dcr build)
+* `.vscode/launch.json` — debug launch configuration
+* `.vscode/settings.json` — C/C++ settings (clangd paths, includes)
+* `.vscode/extensions.json` — recommended extensions (vscode-clangd, vscode-lldb)
+
+### clion
+
+```bash
+dcr gen clion
+```
+
+Creates:
+
+* `.idea/externalTools.xml` — external tools (build, run, clean, test)
+* `.idea/customTargets.xml` — custom build targets
+* `.idea/misc.xml` — C/C++ project settings
+* `.idea/runConfigurations/\<name>.xml` — per-binary run configurations
+
+### compile-commands
+
+```bash
+dcr gen compile-commands
+```
+
+Generates `compile_commands.json` — standard format for clangd, cpptools, static analyzers.
+
+### project-info
+
+```bash
+dcr gen project-info
+```
+
+Outputs JSON array with project metadata:
+
+```json
+[
+  {
+    "name": "my-app",
+    "version": "0.1.0",
+    "root": "/path/to/project",
+    "profile": "debug",
+    "language": "c",
+    "standard": "c17",
+    "cxx_standard": null,
+    "compiler": "/usr/bin/clang",
+    "kind": "bin",
+    "sources": ["src/main.c"],
+    "include_dirs": ["src"],
+    "lib_dirs": [],
+    "libs": [],
+    "cflags": ["-std=c17", "-O0", "-g"],
+    "ldflags": []
+  }
+]
+```

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

@@ -0,0 +1,31 @@
+---
+sidebar_label: Project commands (new, init)
+---
+
+# Project Commands
+
+## `dcr new \<name>`
+
+Creates a new project with a standard structure and `dcr.toml`. The `name` argument is required.
+
+Only ASCII letters, digits, underscores `_` and hyphens `-` are allowed in the project name.
+
+```bash
+dcr new my-app
+```
+
+Generates:
+
+* `dcr.toml` with basic fields
+* `src/main.c` with a `main` template
+
+## `dcr init`
+
+Initializes a DCR project in the current (empty) directory.
+
+```bash
+mkdir app && cd app
+dcr init
+```
+
+The project name is taken from the current directory name. The directory name must follow the same naming rules as `dcr new`.

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

@@ -0,0 +1,60 @@
+---
+sidebar_label: Quality commands (test, fmt)
+---
+
+# Quality Commands
+
+## `dcr test`
+
+Runs tests.
+
+```bash
+dcr test                          # debug profile
+dcr test --release                # release profile
+dcr test --debug                  # explicit debug
+dcr test --help                   # detailed help
+```
+
+Before first use, initialize tests:
+
+```bash
+dcr test --init
+```
+
+This creates `tests/dcr_test.h` (framework) and `tests/test.c` (template).
+
+What `dcr test` does:
+
+1. Builds the project
+2. Collects `tests/*.c` files (`.c` only, not `.cpp`)
+3. Compiles and links each test file
+4. Runs each test binary
+5. Prints summary: TOTAL, PASS, SKIP, FAIL
+6. Returns non-zero exit code on any FAIL
+
+## `dcr fmt`
+
+Formats C/C++ source files using `clang-format`.
+
+```bash
+dcr fmt
+```
+
+Processes: `src/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}` and `tests/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}`.
+
+Uses `.clang-format` at the project root (if present), otherwise default clang-format style.
+
+## `dcr lint`
+
+Runs `clang-tidy` on C/C++ source files for static analysis.
+
+```bash
+dcr lint              # show diagnostics
+dcr lint --fix        # apply fixes automatically
+dcr lint --help       # detailed help
+```
+
+Processes: `src/**/*.{c,cpp,cxx,cc}` and `tests/**/*.{c,cpp,cxx,cc}`.
+
+Without `--fix`, clang-tidy reports warnings and errors without modifying files.
+With `--fix`, clang-tidy applies automatic suggestions in place.

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

@@ -0,0 +1,51 @@
+---
+sidebar_label: System commands (setup, --help, ...)
+---
+
+# System Commands
+
+## `dcr setup`
+
+Shows configured registries from `~/.dcr/config.toml`.
+
+```bash
+dcr setup
+```
+
+If `~/.dcr/config.toml` is not found, DCR returns an error. Create it manually:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+## `dcr --help`
+
+Shows help for all commands.
+
+```bash
+dcr --help
+```
+
+## `dcr --version`
+
+Shows version and target triple.
+
+```bash
+dcr --version       # dcr 0.7.0 (x86_64-unknown-linux-gnu)
+```
+
+## `dcr --update`
+
+Self-update. Downloads the latest release binary from GitHub Releases and replaces the current one.
+
+```bash
+dcr --update
+```
+
+Features:
+
+* Auto-detects platform and architecture
+* Warns if installed via AUR (use package manager instead)
+* Works on Linux, macOS, Windows

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

@@ -0,0 +1,51 @@
+---
+sidebar_label: Contributing
+---
+
+# Contributing
+
+## Setup
+
+```bash
+git clone https://github.com/dexoron/dcr
+cd dcr
+cargo build
+```
+
+## Code style
+
+All code must be formatted with `cargo fmt`:
+
+```bash
+cargo fmt
+```
+
+## Linting
+
+```bash
+cargo clippy --all-targets -- -D warnings
+```
+
+## Tests
+
+```bash
+cargo test --all-targets
+```
+
+## PR process
+
+1. Fork the repository
+2. Create a branch: `git checkout -b feature/description`
+3. Make changes
+4. Run `cargo fmt && cargo clippy && cargo test`
+5. Open a Pull Request
+
+## CI
+
+CI runs:
+
+* `cargo fmt --check`
+* `cargo clippy --all-targets -- -D warnings`
+* `cargo test --all-targets`
+* Build on Linux, macOS, Windows
+* Integration tests

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

@@ -0,0 +1,81 @@
+---
+sidebar_label: FAQ
+---
+
+# FAQ
+
+## Registry not found
+
+```
+error: registry not found
+```
+
+**Solution:** Make sure `~/.dcr/config.toml` exists:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+And check `DCR_INDEX_PATH`:
+
+```bash
+echo $DCR_INDEX_PATH
+```
+
+## Compiler not found
+
+```
+error: compiler not found
+```
+
+**Solution:** Ensure a compiler is installed and available in PATH.
+
+```bash
+which gcc
+which clang
+```
+
+Or specify explicitly via `[toolchain]` in `dcr.toml`.
+
+## openssl-sys build failed
+
+When building DCR from source:
+
+```
+error: failed to run custom build command for openssl-sys
+```
+
+**Solution:** Install OpenSSL development headers:
+
+```bash
+# Ubuntu/Debian
+sudo apt install libssl-dev
+
+# Fedora
+sudo dnf install openssl-devel
+
+# macOS
+brew install openssl
+```
+
+## Ctrl+C during build
+
+DCR handles SIGINT: interrupts the current compilation and exits with non-zero code.
+
+## How to create a library?
+
+See [Library Recipe](/docs/recipes/library-project).
+
+## How to cross-compile to Windows?
+
+See [Cross-Compile Recipe](/docs/recipes/cross-to-windows).
+
+## How to create a multi-package project?
+
+See [Workspace Recipe](/docs/recipes/multi-package-workspace).
+
+## 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/first-steps.mdx.mdx

@@ -0,0 +1,72 @@
+---
+sidebar_label: First steps
+---
+
+# First Steps
+
+## Create a project
+
+```bash
+dcr new my-app
+cd my-app
+```
+
+Structure:
+
+```
+my-app/
+├── dcr.toml
+└── src/
+    └── main.c
+```
+
+`dcr.toml`:
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "none"
+
+[build]
+language = "c"
+standard = "c11"
+compiler = "clang"
+kind = "bin"
+```
+
+## Build
+
+```bash
+dcr build
+```
+
+Output — `target/\<triple>/debug/my-app` (Linux) or `target/debug/my-app.exe` (Windows).
+
+Build profiles:
+
+```bash
+dcr build --release       # release build
+dcr build --debug         # debug (default)
+```
+
+## Run
+
+```bash
+dcr run
+```
+
+Builds (if needed) and runs the binary.
+
+## First test
+
+```bash
+dcr test --init      # create test template
+dcr test             # run tests
+```
+
+## Formatting
+
+```bash
+dcr fmt              # clang-format with .clang-format
+```

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

@@ -0,0 +1,109 @@
+---
+sidebar_label: Installation
+---
+
+# Installation
+
+## Linux (Dexoron Packages)
+
+Configure your package manager at https://pkg.dexoron.su and install:
+
+**Arch Linux**
+
+```sh
+sudo pacman -Sy dcr
+```
+
+**Debian/Ubuntu**
+
+```sh
+sudo apt update && sudo apt install dcr
+```
+
+**Fedora/RHEL**
+
+```sh
+sudo dnf install dcr
+```
+
+## Arch Linux (AUR)
+
+```sh
+yay -S dcr
+```
+
+## macOS / Linux (Homebrew)
+
+```sh
+brew tap dexoron/dexoron
+brew install dcr
+```
+
+## Snap (Linux)
+
+```sh
+sudo snap install dcrup
+```
+
+## Nix (flake)
+
+```sh
+nix run github:dexoron/dcr
+# or install to profile:
+nix profile install github:dexoron/dcr
+```
+
+## Cargo (crates.io)
+
+```sh
+cargo install dcr
+```
+
+## Linux / macOS (script)
+
+```sh
+curl -fsSL https://dcr.dexoron.su/install.sh | sh
+```
+
+## BSD (script)
+
+```sh
+curl -fsSL https://dcr.dexoron.su/install_bsd.sh | sh
+```
+
+## Windows (PowerShell)
+
+```powershell
+irm https://dcr.dexoron.su/install.ps1 | iex
+```
+
+## From source
+
+```sh
+git clone https://github.com/dexoron/dcr.git
+cd dcr && cargo build --release
+ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
+```
+
+## Post-install
+
+Verify the installation:
+
+```bash
+dcr --version
+```
+
+Man pages are available after installation:
+
+```bash
+man dcr
+man dcr-build
+```
+
+To use the registry, create `~/.dcr/config.toml`:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```

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

@@ -0,0 +1,51 @@
+---
+sidebar_label: IDE Integration
+---
+
+# IDE Integration
+
+## VS Code
+
+```bash
+dcr gen vscode
+```
+
+Generates in `.vscode/`:
+
+| File              | Purpose                                      |
+| ----------------- | -------------------------------------------- |
+| `tasks.json`      | `build` task (dcr build)                     |
+| `launch.json`     | Debug launch configuration                   |
+| `settings.json`   | clangd/IntelliSense: include paths, standard |
+| `extensions.json` | Recommends vscode-clangd, vscode-lldb        |
+
+## CLion
+
+```bash
+dcr gen clion
+```
+
+Generates in `.idea/`:
+
+| File                                             | Purpose                                   |
+| ------------------------------------------------ | ----------------------------------------- |
+| `externalTools.xml`                              | Build, Run, Clean, Test as external tools |
+| `customTargets.xml`                              | Custom build targets                      |
+| `misc.xml`                                       | C/C++ project settings                    |
+| `runConfigurations/\<name>.xml` | Per-binary run configurations             |
+
+## compile_commands.json
+
+```bash
+dcr gen compile-commands
+```
+
+Generates `compile_commands.json` at project root. Standard format for clangd, C/C++ IntelliSense, static analyzers.
+
+## project-info
+
+```bash
+dcr gen project-info
+```
+
+Outputs JSON array with project metadata (see [gen-commands](/docs/commands/gen-commands)).

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

@@ -0,0 +1,46 @@
+---
+sidebar_label: License
+---
+
+# License
+
+## DCR
+
+DCR itself is [GPL-3.0-or-later](https://spdx.org/licenses/GPL-3.0-or-later.html) licensed.
+
+> **Note:** DCR is a build tool, not a library. The GPL applies only to DCR's own source code. Projects built with DCR are not subject to DCR's license — their licensing is determined solely by their own code and dependencies.
+
+## Vendored libraries
+
+DCR statically links the following C libraries through its vendored Rust dependencies:
+
+| Library                                    | License            | Bundled by                    |
+| ------------------------------------------ | ------------------ | ----------------------------- |
+| [libgit2](https://libgit2.org)             | MIT OR Apache-2.0  | `git2` / `libgit2-sys`        |
+| [libssh2](https://libssh2.org)             | MIT OR Apache-2.0  | `libgit2-sys`                 |
+| [zlib](https://zlib.net)                   | MIT OR Apache-2.0  | `libgit2-sys`                 |
+| [OpenSSL](https://openssl.org)             | Apache-2.0         | `openssl-sys` / `openssl-src` |
+| [ring](https://github.com/briansmith/ring) | Apache-2.0 AND ISC | `rustls`                      |
+
+## Rust dependencies
+
+DCR is written in Rust. The following notable Rust crates are statically linked:
+
+| Crate                                         | License                  |
+| --------------------------------------------- | ------------------------ |
+| [`reqwest`](https://crates.io/crates/reqwest) | MIT OR Apache-2.0        |
+| [`rustls`](https://crates.io/crates/rustls)   | Apache-2.0 OR ISC OR MIT |
+| [`serde`](https://crates.io/crates/serde)     | MIT OR Apache-2.0        |
+| [`toml`](https://crates.io/crates/toml)       | MIT OR Apache-2.0        |
+| [`sha2`](https://crates.io/crates/sha2)       | MIT OR Apache-2.0        |
+| [`git2`](https://crates.io/crates/git2)       | MIT OR Apache-2.0        |
+| [`openssl`](https://crates.io/crates/openssl) | Apache-2.0               |
+| [`tokio`](https://crates.io/crates/tokio)     | MIT                      |
+| [`hyper`](https://crates.io/crates/hyper)     | MIT                      |
+| [`ctrlc`](https://crates.io/crates/ctrlc)     | MIT OR Apache-2.0        |
+
+Full dependency tree (143 packages) is available in [`Cargo.lock`](https://github.com/dexoron/dcr/blob/main/Cargo.lock). The overwhelming majority are dual-licensed under MIT OR Apache-2.0.
+
+## Additional credits
+
+* DCR's CLI design and project model are inspired by [Cargo](https://doc.rust-lang.org/cargo/).

docs-crowdin-export/pl-PL/docs/recipes/cross-to-windows.mdx.mdx

@@ -0,0 +1,49 @@
+---
+sidebar_label: Cross-compile to Windows
+---
+
+# Cross-Compile to Windows from Linux
+
+Building a Windows binary on Linux using mingw-w64.
+
+## Install toolchain
+
+```bash
+# Ubuntu/Debian
+sudo apt install mingw-w64
+
+# Fedora
+sudo dnf install mingw64-gcc mingw64-binutils
+```
+
+## Configuration
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "none"
+
+[build]
+language = "c"
+standard = "c11"
+compiler = "clang"
+kind = "bin"
+target = "x86_64-pc-windows-gnu"    # explicit mingw, not msvc
+```
+
+## Build
+
+```bash
+dcr build --target x86_64-pc-windows-gnu --release
+```
+
+Artifact: `target/x86_64-pc-windows-gnu/release/my-app.exe`.
+
+## Custom toolchain
+
+```toml
+[toolchain]
+cc = "x86_64-w64-mingw32-gcc"
+cxx = "x86_64-w64-mingw32-g++"
+```

docs-crowdin-export/pl-PL/docs/recipes/library-project.mdx.mdx

@@ -0,0 +1,70 @@
+---
+sidebar_label: Library project
+---
+
+# Library Project
+
+Creating a static library and using it in another project.
+
+## Step 1: Create the library
+
+```bash
+dcr new my-lib
+cd my-lib
+```
+
+`dcr.toml`:
+
+```toml
+[package]
+name = "my-lib"
+version = "0.1.0"
+type = "none"
+
+[build]
+language = "c"
+standard = "c11"
+kind = "staticlib"
+```
+
+`src/my_lib.h`:
+
+```c
+#ifndef MY_LIB_H
+#define MY_LIB_H
+int add(int a, int b);
+#endif
+```
+
+`src/my_lib.c`:
+
+```c
+#include "my_lib.h"
+int add(int a, int b) { return a + b; }
+```
+
+## Step 2: Build
+
+```bash
+dcr build --release
+```
+
+Artifacts:
+
+* `target/\<triple>/release/libmy-lib.a` (Linux)
+* `target/release/my-lib.lib` (Windows)
+* `target/include/` — header files
+
+## Step 3: Use in another project
+
+```bash
+dcr new my-app
+cd my-app
+dcr add my-lib ../my-lib
+```
+
+Automatically:
+
+* Adds include path to `target/include/` of the library
+* Adds lib path to `target/\<triple>/release/`
+* Links `libmy-lib.a` / `my-lib.lib`

docs-crowdin-export/pl-PL/docs/recipes/multi-package-workspace.mdx.mdx

@@ -0,0 +1,102 @@
+---
+sidebar_label: Multi-package workspace
+---
+
+# Multi-Package Workspace
+
+A project with three packages: two libraries and a binary.
+
+## Structure
+
+```
+workspace/
+├── dcr.toml              # root workspace
+├── lib-core/
+│   ├── dcr.toml
+│   └── src/core.c
+├── lib-utils/
+│   ├── dcr.toml
+│   └── src/utils.c
+└── app/
+    ├── dcr.toml
+    └── src/main.c
+```
+
+## Root dcr.toml
+
+```toml
+[package]
+name = "my-workspace"
+version = "0.1.0"
+type = "none"
+
+[build]
+inherit = true
+language = "c"
+standard = "c11"
+
+[workspace.lib-core]
+path = "lib-core"
+
+[workspace.lib-utils]
+path = "lib-utils"
+deps = ["lib-core"]
+
+[workspace.app]
+path = "app"
+deps = ["lib-core", "lib-utils"]
+main = true
+```
+
+## Packages
+
+`lib-core/dcr.toml`:
+
+```toml
+[package]
+name = "lib-core"
+version = "0.1.0"
+type = "none"
+
+[build]
+kind = "staticlib"
+```
+
+`lib-utils/dcr.toml`:
+
+```toml
+[package]
+name = "lib-utils"
+version = "0.1.0"
+type = "none"
+
+[build]
+kind = "staticlib"
+```
+
+`app/dcr.toml`:
+
+```toml
+[package]
+name = "app"
+version = "0.1.0"
+type = "none"
+
+[build]
+kind = "bin"
+```
+
+## Build
+
+```bash
+cd workspace
+dcr build                     # builds everything in correct order
+dcr build --workspace app     # only app (lib-core and lib-utils built as deps)
+dcr run                       # builds and runs main package
+```
+
+Build order (topological sort):
+
+1. `lib-core`
+2. `lib-utils` (depends on lib-core)
+3. `app` (depends on lib-core, lib-utils)

docs-crowdin-export/pl-PL/docs/reference/build-profiles.mdx.mdx

@@ -0,0 +1,82 @@
+---
+sidebar_label: Build profiles
+---
+
+# Build Profiles
+
+Profiles allow overriding `[build]` fields for specific build modes.
+
+## Configuration
+
+```toml
+[build]
+language = "c"
+standard = "c17"
+cflags = ["-Wall"]
+
+[build.debug]
+cflags = ["-O0", "-g"]
+
+[build.release]
+cflags = ["-O3", "-DNDEBUG"]
+```
+
+## Merge rules
+
+Fields from `[build.\<profile>]` are merged on top of `[build]`:
+
+* **Scalar fields** (strings, numbers, bools) — replaced
+* **Arrays** (`cflags`, `ldflags`, ...) — **appended** (extend the `[build]` array)
+
+Set `inherit = false` to disable array inheritance (only profile's own arrays are used).
+
+## Built-in profiles
+
+The default flags for each profile are composed from three config fields:
+
+| Field       | debug default      | release default |
+| ----------- | ------------------ | --------------- |
+| `opt_level` | `"0"`              | `"3"`           |
+| `debug`     | `true`             | `false`         |
+| `warnings`  | `["all", "extra"]` | `[]`            |
+
+Which produce the equivalent compiler flags:
+
+| Profile   | Effective flags                                            |
+| --------- | ---------------------------------------------------------- |
+| `debug`   | `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG` |
+| `release` | `-O3 -DNDEBUG`                                             |
+
+Additional build options can be toggled per-profile:
+
+```toml
+[build.release]
+opt_level = "z"
+lto = true
+strip = true
+panic = "abort"
+codegen-units = "1"
+
+[build.debug]
+opt_level = "1"
+debug = false
+warnings = ["all", "error"]
+```
+
+## Target-specific profiles
+
+```toml
+[build.linux]
+cflags = ["-DLINUX"]
+
+[build.windows.debug]
+cflags = ["-DWIN32", "-O0", "-g"]
+```
+
+Application order (highest priority first):
+
+1. `[build.\<target>.\<profile>]`
+2. `[build.\<profile>.\<target>]`
+3. `[build.\<target>]`
+4. `[build.\<profile>]`
+5. `[build]`

docs-crowdin-export/pl-PL/docs/reference/build-system.mdx.mdx

@@ -0,0 +1,131 @@
+---
+sidebar_label: Build system
+---
+
+# Build System
+
+## Compiler Backends
+
+DCR supports 7 compilation backends. Selection is automatic based on file extension and `build.compiler` value.
+
+| Backend   | Files                             | When used                             |
+| --------- | --------------------------------- | ------------------------------------- |
+| `unix_cc` | `.c`, `.cpp`, `.cxx`, `.cc`, `.S` | gcc/clang on Linux/macOS/BSD          |
+| `msvc`    | `.c`, `.cpp`, `.cxx`, `.cc`       | Windows (cl, clang-cl)                |
+| `gas`     | `.s`                              | ARM/ARM64 assembler (no preprocessor) |
+| `nasm`    | `.asm`, `.s`                      | x86/x86_64 NASM assembler             |
+| `masm`    | `.asm`                            | MASM (ml/ml64) on Windows             |
+| `fasm`    | `.asm`, `.fasm`                   | Flat Assembler                        |
+| `llvm_ir` | `.ll`                             | LLVM IR via `llc -filetype=obj`       |
+
+## Qt Support
+
+DCR provides native Qt support for automatic meta-object handling (MOC, UIC, RCC).
+
+Enable it by setting `build.qt = true` in `dcr.toml`. DCR will automatically detect Qt-related files (`.ui`, `.qrc`, `.h` with `Q_OBJECT`) and process them.
+
+```toml
+[build]
+qt = true
+```
+
+*Note: Requires `qt6` modules (Core, Widgets, Gui, Svg) installed via `pkg-config`.*
+
+Advanced customization is still possible via `build.steps` if special handling is needed:
+
+```toml
+[build.steps]
+moc = "moc {in} -o {out}"
+```
+
+### Unix CC
+
+* Compiler resolved via `resolve_compiler()`: `DCR_COMPILER` > `DCR_CC` > `[toolchain]` > `build.compiler` > `PATH`
+* Supports `.d` files for header dependency tracking
+* Flags: `-std=`, `-MMD -MF`, `-c -o`, `-I`, `-L`, `-l`
+* Conditional flags based on config:
+  * `freestanding` or bare-metal target: `-ffreestanding` (compile), `-nostdlib -static` (link)
+  * `lto`: `-flto` (compile + link)
+  * `panic = "abort"`: `-fno-exceptions` (C++ only), `-fno-unwind-tables`, `-fno-asynchronous-unwind-tables`
+
+### MSVC
+
+* Supports cl.exe and clang-cl.exe
+* Flags: `/std:`, `/Fo:`, `/Fe:`, `/I`, `/link`
+
+### GAS / NASM / MASM / FASM / LLVM-IR
+
+* GAS: `-I`, `-c -o`, `--defsym`
+* NASM: `-I`, `-o`, `-D`, `-f` (format: win64/elf64/macho64/macho32/elf32)
+* MASM: `/nologo /c /Fo\<obj> <source>`
+* FASM: `<source> \<output>` (output path is the object file)
+* LLVM IR: `-filetype=obj <source> -o \<output>`
+
+## Incremental Builds
+
+Three levels of incrementality:
+
+1. **mtime** — if output is newer than all inputs, skip
+2. **`.d` files** — header change tracking (including transitive)
+3. **SHA256 fingerprint** — recompile if compiler flags changed (stored in `.dcr_fingerprint`)
+
+## Parallel Compilation
+
+* `thread::scope` for thread pool
+* Atomic task queue (`AtomicU64`)
+* Mutex on stdout (`OUTPUT_MUTEX`)
+* Thread count = `available_parallelism()`, capped by `build.codegen-units` if set
+
+## Build Kinds
+
+| Kind        | Type                            | Path (Linux example)                                                                                                       |
+| ----------- | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `bin`       | Executable                      | `target/\<triple>/\<profile>/\<name>` (.exe on Windows)                 |
+| `staticlib` | Static library                  | `target/\<triple>/\<profile>/lib\<name>.a` (.lib)                       |
+| `sharedlib` | Dynamic library                 | `target/\<triple>/\<profile>/lib\<name>.so` (.dll/.dylib)               |
+| `efi`       | UEFI application                | `target/\<triple>/\<profile>/\<name>.efi`                               |
+| `elf`       | ELF without stdlib              | `target/\<triple>/\<profile>/\<name>`                                   |
+| `none`      | Compile only, no link           | —                                                                                                                          |
+| `custom`    | Full filename+extension control | `target/\<triple>/\<profile>/\<filename>.\<extension>` |
+
+## Build Steps
+
+DCR supports pre-build and post-build steps:
+
+* `build.steps` — commands before compilation
+* `build.post_steps` — commands after compilation
+
+Substitutions: `{stem}`, `{in}`, `{out}`, `{profile}`, `{version}`, `{name}`.
+
+Example Qt codegen via build steps:
+
+```toml
+[build.steps]
+moc = "moc {in} -o {out}"
+```
+
+## pkg-config
+
+Automatic lookup (read from raw config):
+
+```toml
+[build]
+pkg_config = ["sdl2", "gl"]
+```
+
+DCR runs `pkg-config --cflags sdl2 gl` and `pkg-config --libs sdl2 gl` and adds results to compiler/linker flags.
+
+## Variable Substitution
+
+Supported variables:
+
+| Variable                | Description                  |
+| ----------------------- | ---------------------------- |
+| `{version}`             | Package version              |
+| `{version_major}`       | Major version part           |
+| `{version_minor}`       | Minor version part           |
+| `{version_patch}`       | Patch version                |
+| `{version_suffix}`      | Suffix (e.g., `-rc1`)        |
+| `{version_suffix_dash}` | Suffix with dash             |
+| `{profile}`             | Profile name (debug/release) |
+| `{name}`                | Package name                 |

docs-crowdin-export/pl-PL/docs/reference/cross-compilation.mdx.mdx

@@ -0,0 +1,70 @@
+---
+sidebar_label: Cross-compilation
+---
+
+# Cross-Compilation
+
+## Short Names
+
+DCR supports short platform names:
+
+| Short Name | Full Triple                |
+| ---------- | -------------------------- |
+| `linux`    | `x86_64-unknown-linux-gnu` |
+| `macos`    | `x86_64-apple-darwin`      |
+| `windows`  | `x86_64-pc-windows-msvc`   |
+
+```bash
+dcr build --target windows
+```
+
+## Full Triples
+
+```bash
+dcr build --target aarch64-unknown-linux-gnu
+dcr build --target x86_64-pc-windows-gnu      # mingw
+dcr build --target armv7-unknown-linux-gnueabihf
+```
+
+## clang --target
+
+When using clang, DCR injects `--target=\<triple>` into CFLAGS.
+
+```toml
+[build]
+compiler = "clang"
+target = "aarch64-unknown-linux-gnu"
+# Auto: cflags += ["--target=aarch64-unknown-linux-gnu"]
+```
+
+## Bare-Metal / Freestanding
+
+For targets containing `none`, `-elf`, `eabi`, or `baremetal`, DCR automatically:
+
+1. **Disables default flags** — no system include paths, no `-l` libc
+2. **Injects `-ffreestanding`** at compile time and `-nostdlib -static` at link time
+
+You can also enable freestanding mode explicitly:
+
+```toml
+[build]
+freestanding = true
+```
+
+```bash
+dcr build --target aarch64-none-elf
+```
+
+## Target Directory
+
+On Linux with explicit target:
+
+```
+target/<triple>/<profile>/
+```
+
+On macOS/Windows or without target:
+
+```
+target/<profile>/
+```

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

@@ -0,0 +1,152 @@
+---
+sidebar_label: dcr.toml overview
+---
+
+# dcr.toml
+
+Main project configuration file. Located at the project root.
+
+## Structure
+
+```toml
+[package]
+# required fields
+
+[build]
+# build settings
+
+[build.debug]       # optional: debug override
+[build.release]     # optional: release override
+
+[build.linux]       # optional: Linux override
+[build.windows]     # optional: Windows override
+[build.windows.debug]  # target + profile combination
+
+[toolchain]
+# compiler/linker paths
+
+[dependencies]
+# project dependencies
+
+[workspace]
+# multi-package configuration
+
+[run]
+# run settings
+```
+
+## [package]
+
+| Field     | Required | Description             |
+| --------- | -------- | ----------------------- |
+| `name`    | yes      | Project name            |
+| `version` | yes      | Semantic version        |
+| `type`    | yes      | `app`, `lib`, `none`    |
+| `license` | no       | SPDX license identifier |
+| `author`  | no       | Author                  |
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "app"
+license = "MIT"
+author = "John Doe"
+```
+
+## [build]
+
+...
+
+* `build.qt` — (bool) Enable automatic Qt meta-object handling (MOC, UIC, RCC). Requires `qt6` modules installed via `pkg-config`.
+
+| Field            | Default                                     | Description                                                           |
+| ---------------- | ------------------------------------------- | --------------------------------------------------------------------- |
+| `language`       | `"c"`                                       | `"c"`, `"c++"`, `"cpp"`, `"cxx"`, `"asm"`                             |
+| `standard`       | `"c11"`                                     | C standard (`c11`, `c17`, `c23`)                                      |
+| `cxx_standard`   | `"c++20"`                                   | C++ standard (`c++17`, `c++20`, `c++23`)                              |
+| `compiler`       | `"clang"`                                   | Preferred compiler                                                    |
+| `kind`           | `"bin"`                                     | `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, `custom`       |
+| `target`         | host                                        | Target triple for cross-compilation                                   |
+| `platform`       | `"native"`                                  | `native`, `efi`                                                       |
+| `cflags`         | `[]`                                        | Additional C/C++/ASM flags                                            |
+| `ldflags`        | `[]`                                        | Additional linker flags                                               |
+| `filename`       | `""`                                        | Custom output file name                                               |
+| `extension`      | `""`                                        | Custom file extension                                                 |
+| `roots`          | `["src"]`                                   | Source root directories                                               |
+| `exclude`        | `[]`                                        | Exclude patterns                                                      |
+| `include`        | `[]`                                        | Additional include directories                                        |
+| `src_disable`    | `false`                                     | Disable auto source discovery                                         |
+| `inherit`        | `false`                                     | Inherit build from workspace root                                     |
+| `clean`          | `[]`                                        | Glob patterns for custom clean paths                                  |
+| `out_dir`        | `""`                                        | Custom output directory                                               |
+| `workspace_only` | `false`                                     | Workspace-only, not built standalone                                  |
+| `freestanding`   | `false`                                     | Compile in freestanding mode (`-ffreestanding` + `-nostdlib -static`) |
+| `opt_level`      | `"0"` (debug) / `"3"` (release)             | Optimization level: `0`-`3`, `"s"`, `"z"`                             |
+| `debug`          | `true` (debug) / `false` (release)          | Emit debug symbols (`-g`)                                             |
+| `lto`            | `false`                                     | Link-time optimization (`-flto` for both compiler and linker)         |
+| `strip`          | `false`                                     | Strip symbols from output (`-s` in ldflags)                           |
+| `warnings`       | `["all", "extra"]` (debug) / `[]` (release) | Warning flags (e.g. `"all"`, `"extra"`, `"pedantic"`)                 |
+| `panic`          | `""`                                        | Panic strategy: `"abort"` disables exceptions and unwind tables       |
+| `codegen-units`  | `""`                                        | Max parallel compilation jobs (`"0"` = auto)                          |
+| `qt`             | `false`                                     | Enable automatic Qt meta-object handling (MOC, UIC, RCC)              |
+
+Settings from raw config (not in typed struct):
+
+* `pkg_config` — list of pkg-config packages
+* `ldscript` — linker script path
+* `build.steps` / `build.post_steps` — codegen steps
+
+Example:
+
+```toml
+[build]
+language = "c++"
+standard = "c23"
+cxx_standard = "c++23"
+compiler = "clang"
+kind = "sharedlib"
+cflags = ["-Wall", "-Wextra"]
+opt_level = "z"
+lto = true
+strip = true
+panic = "abort"
+codegen-units = "2"
+```
+
+## [toolchain]
+
+```toml
+[toolchain]
+cc = "/usr/bin/clang"
+cxx = "/usr/bin/clang++"
+as = "/usr/bin/as"
+ar = "/usr/bin/ar"
+ld = "/usr/bin/ld.lld"
+```
+
+Raw config also supports `uic`, `moc`, `rcc` for Qt codegen.
+
+## [dependencies]
+
+See [dependencies](/docs/reference/dependencies).
+
+## [run]
+
+```toml
+[run]
+cmd = "./target/{profile}/{name}"
+```
+
+Substitutions:
+
+* `{version}` — package version
+* `{version_major}`, `{version_minor}`, `{version_patch}`, `{version_suffix}`, `{version_suffix_dash}` — version parts
+* `{profile}` — debug / release
+* `{name}` — package name
+
+Default `cmd` = `./target/{profile}/{name}` (macOS/Windows) or `./target/\<triple>/\<profile>/\<name>` (Linux).
+
+## [workspace]
+
+See [workspaces](/docs/reference/workspaces).

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

@@ -0,0 +1,84 @@
+---
+sidebar_label: Dependencies
+---
+
+# Dependencies
+
+## Formats
+
+The `[dependencies]` section supports three formats:
+
+### String (registry)
+
+```toml
+[dependencies]
+fmt = "10.1.1"
+spdlog = "1.12"
+catch2 = "3.4.0"
+```
+
+The version string is used as-is for registry lookup.
+
+### Table (git)
+
+```toml
+[dependencies]
+fmt = { git = "https://github.com/fmtlib/fmt", tag = "10.1.1" }
+```
+
+Fields: `git`, `branch`, `tag`, `rev`.
+
+### Table (path)
+
+```toml
+[dependencies]
+mylib = { path = "../mylib" }
+```
+
+## Registry
+
+DCR uses a package registry for dependency lookup by name.
+
+```toml
+# ~/.dcr/config.toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+Registry priority: order in `config.toml`. The `DCR_INDEX_PATH` variable overrides the path to `index.json`.
+
+## Git dependencies
+
+DCR clones git repositories via `git2`:
+
+* `branch` — switch to a branch
+* `tag` — switch to a tag
+* `rev` — switch to a specific commit
+* `features` — feature flags (parsed, but does not affect build)
+
+Cache path: `~/.dcr/git/\<hash>/`.
+
+## Path dependencies
+
+Local paths. DCR automatically discovers include and lib directories from the neighbor's `dcr.toml`.
+
+```toml
+[dependencies]
+mylib = { path = "/abs/path/to/lib" }
+mylib = { path = "../relative/path" }
+```
+
+## 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`.
+
+## 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

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

@@ -0,0 +1,60 @@
+---
+sidebar_label: Environment variables
+---
+
+# Environment Variables
+
+## DCR_COMPILER
+
+Overrides the compiler for all languages. **Highest priority.**
+
+```bash
+export DCR_COMPILER=clang
+dcr build
+```
+
+Compiler resolution priority:
+
+1. `DCR_COMPILER` (env)
+2. `DCR_CC` / `DCR_CXX` / `DCR_AS` (env)
+3. `[toolchain]` (dcr.toml)
+4. `build.compiler` (dcr.toml)
+5. `PATH`
+
+## DCR_CC / DCR_CXX / DCR_AS
+
+Per-language override (lower priority than `DCR_COMPILER`, higher than `[toolchain]`).
+
+```bash
+export DCR_CC=gcc-14
+export DCR_CXX=g++-14
+export DCR_AS=arm-linux-gnueabihf-as
+```
+
+## DCR_LD / DCR_AR
+
+Override linker and archiver.
+
+```bash
+export DCR_LD=ld.lld
+export DCR_AR=llvm-ar
+```
+
+## DCR_DEBUG
+
+Enables debug mode — prints all compilation commands to stderr before execution.
+
+```bash
+export DCR_DEBUG=1
+dcr build
+```
+
+## DCR_INDEX_PATH
+
+Overrides the path to the registry `index.json`.
+
+```bash
+export DCR_INDEX_PATH=/custom/path/index.json
+```
+
+Default: `~/.dcr/index.json`.

docs-crowdin-export/pl-PL/docs/reference/platform-support.mdx.mdx

@@ -0,0 +1,51 @@
+---
+sidebar_label: Platform support
+---
+
+# Platform Support
+
+## Target Triples
+
+DCR normalizes target triples. Short platform names are expanded to full triples.
+
+### Linux
+
+```
+target/<arch>-unknown-linux-gnu/<profile>/
+```
+
+Architectures: `x86_64`, `aarch64` (host-detected).
+
+Artifact type: ELF. Extensions: `.so` (sharedlib), `.a` (staticlib).
+
+### macOS
+
+```
+target/<profile>/
+```
+
+Architectures: `x86_64`, `aarch64` (host-detected).
+
+Extensions: `.dylib` (sharedlib), `.a` (staticlib).
+
+### Windows
+
+```
+target/<profile>/
+```
+
+Architectures: `x86_64`, `aarch64`.
+
+Extensions: `.exe` (bin), `.lib` (staticlib), `.dll` (sharedlib), `.efi` (UEFI).
+
+### BSD
+
+```
+target/<arch>-unknown-<os>/<profile>/
+```
+
+Supported systems: `freebsd`, `openbsd`, `netbsd`, `dragonfly`.
+
+## Host Detection
+
+DCR uses `std::env::consts::ARCH` and `std::env::consts::OS` for host platform detection. Used as fallback when `target` is not specified.

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

@@ -0,0 +1,67 @@
+---
+sidebar_label: Workspaces
+---
+
+# Workspaces
+
+Workspaces allow managing multiple packages in a single repository.
+
+## Configuration
+
+```toml
+[workspace.lib-core]
+path = "lib-core"
+
+[workspace.lib-utils]
+path = "lib-utils"
+deps = ["lib-core"]
+
+[workspace.app]
+path = "app"
+deps = ["lib-core", "lib-utils"]
+main = true
+```
+
+### Member fields
+
+| Field  | Description                                      |
+| ------ | ------------------------------------------------ |
+| `path` | Path to the package (relative to workspace root) |
+| `deps` | Dependencies on other members                    |
+| `main` | Mark as the main package                         |
+
+## Topological sort
+
+DCR automatically sorts packages by dependencies: package A is built before B if B depends on A.
+
+Cyclic dependencies are detected and cause an error.
+
+## Build
+
+```bash
+dcr build                    # build all packages in dependency order
+dcr build --workspace app    # build only app (dependencies built automatically)
+```
+
+When building a workspace, member outputs (libraries) are automatically added to include/lib paths of dependent packages.
+
+## Clean
+
+```bash
+dcr clean                    # clean only root target/
+dcr clean --all              # clean target/ of all packages
+```
+
+## Inheritance
+
+If a member has `inherit = true` in its `[build]` section, fields from the root `[build]` are merged into the member:
+
+```toml
+# root dcr.toml
+[build]
+inherit = true
+language = "c"
+standard = "c17"
+
+# member inherits language and standard
+```

docs-crowdin-export/pl-PL/docs/self-update.mdx.mdx

@@ -0,0 +1,46 @@
+---
+sidebar_label: Self Update
+---
+
+# Self Update
+
+## dcr --update
+
+Automatic update to the latest version. Downloads a binary (not an archive) from GitHub Releases and replaces the current executable.
+
+```bash
+dcr --update
+```
+
+## How it works
+
+1. DCR detects the current platform and architecture
+2. Fetches the latest release from `api.github.com/repos/dexoron/dcr/releases/latest`
+3. Compares versions
+4. Downloads the matching asset (direct binary URL, not archive)
+5. Replaces the current executable via `self_replace`
+
+## Asset naming
+
+Pattern: `dcr-\<triple>` or `dcr-\<triple>.exe`
+
+| Platform       | Asset name                       |
+| -------------- | -------------------------------- |
+| Linux x86_64   | `dcr-x86_64-unknown-linux-gnu`   |
+| macOS x86_64   | `dcr-x86_64-apple-darwin`        |
+| macOS ARM64    | `dcr-aarch64-apple-darwin`       |
+| Windows x86_64 | `dcr-x86_64-pc-windows-msvc.exe` |
+
+## AUR
+
+If DCR was installed via AUR, `--update` shows a warning:
+
+```
+Update via package manager: yay/paru -Syu {package_name} or sudo pacman -Syu {package_name}
+```
+
+## Errors
+
+* Cannot detect platform — error
+* Cannot fetch release — error with URL
+* No write permission — error (use `sudo` or manual install)

docs-crowdin-export/pl-PL/docs/testing/running-tests.mdx.mdx

@@ -0,0 +1,45 @@
+---
+sidebar_label: Running tests
+---
+
+# Running Tests
+
+## Execution
+
+```bash
+dcr test
+```
+
+Builds the project, then compiles and runs test files from `tests/`.
+
+## Profiles
+
+```bash
+dcr test                     # debug (default)
+dcr test --release           # release
+dcr test --debug             # explicit debug
+```
+
+## Output
+
+```
+=====================
+  Testsuite summary
+=====================
+TOTAL: 5
+PASS: 3
+SKIP: 1
+FAIL: 1
+=====================
+```
+
+## Exit code
+
+* 0 — all tests passed (FAIL = 0)
+* 1 — test failures or build error
+
+## What gets built
+
+* All `.c` files from `tests/` (`.cpp` not supported)
+* Include path: `tests/` (for `dcr_test.h`)
+* Linked with project if `package.type = "lib"` or `kind = "staticlib"`/`"sharedlib"`

docs-crowdin-export/pl-PL/docs/testing/test-framework.mdx.mdx

@@ -0,0 +1,69 @@
+---
+sidebar_label: Test framework (EXPECT, TEST, ...)
+---
+
+# Test Framework
+
+DCR has a built-in minimal test framework for C.
+
+## Macros
+
+### `EXPECT(expr)`
+
+Asserts that an expression is true.
+
+```c
+EXPECT(1 + 1 == 2);
+EXPECT(ptr != NULL);
+```
+
+### `SKIP(reason)`
+
+Skips a test with a message.
+
+```c
+SKIP("not implemented on Windows");
+```
+
+### `TEST(name)`
+
+Defines a test.
+
+```c
+TEST(addition) {
+    EXPECT(1 + 1 == 2);
+    EXPECT(2 + 2 == 4);
+}
+```
+
+### `TEST_CASE(name)`
+
+Registers a test case.
+
+```c
+TEST_CASE(math) {
+    EXPECT(1 + 1 == 2);
+}
+```
+
+## Initialization
+
+```bash
+dcr test --init
+```
+
+Creates:
+
+* `tests/dcr_test.h` — framework header (do not edit)
+* `tests/test.c` — template with example test
+
+## Structure
+
+```
+tests/
+├── dcr_test.h      # framework (do not edit)
+├── test.c          # main tests
+└── ...             # additional .c test files
+```
+
+Only `.c` files are compiled (`.cpp` is not supported).

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

@@ -0,0 +1,53 @@
+---
+sidebar_label: Введение
+---
+
+# DCR — Инструмент сборки C/C++ & Пакетный менеджер
+
+<details>
+<summary>Быстрая справка</summary>
+
+```bash
+# Установка(Linux/MacOS скрипт)
+curl -fsSL https://dcr.dexoron.su/install.sh | sh
+
+# Создать проект
+dcr new my-app
+cd my-app
+
+# Собрать и запустить
+dcr run
+```
+
+</details>
+
+## Содержание
+
+| Раздел                                                | Описание                                     |
+| ----------------------------------------------------- | -------------------------------------------- |
+| [Getting Started](/docs/getting-started/installation) | Установка и первые шаги                      |
+| [Commands](/docs/commands/project-commands)           | Все CLI-команды DCR                          |
+| [Reference](/docs/reference/dcr-toml)                 | Конфигурация, сборка, зависимости, платформы |
+| [Testing](/docs/testing/test-framework)               | Встроенный фреймворк тестирования            |
+| [Recipes](/docs/recipes/cross-to-windows)             | Типовые сценарии                             |
+| [IDE Integration](/docs/ide-integration)              | VS Code, CLion, compile_commands.json        |
+| [Self Update](/docs/self-update)                      | Автообновление                               |
+| [FAQ](/docs/faq)                                      | Частые вопросы                               |
+| [Changelog](/docs/changelog)                          | История версий                               |
+| [License](/docs/license)                              | Лицензии DCR и вендорных библиотек           |
+| [Contributing](/docs/contributing)                    | Разработка DCR                               |
+
+## Особенности
+
+* **Инкрементальная сборка** — mtime + `.d` headers + SHA256 fingerprint
+* **Параллельная компиляция** — thread::scope, атомарная очередь задач
+* **4 бэкенда** — gcc/clang, MSVC/clang-cl, GAS, NASM
+* **7 типов проекта** — bin, staticlib, sharedlib, efi, elf, none, custom
+* **Cross-compilation** — short names (linux, windows, macos) и полные triples
+* **Профили** — debug / release с переопределением любого поля
+* **Workspaces** — мультипакетные проекты с топологической сортировкой
+* **Registry + Git + Path** — три механизма зависимостей
+* **Генерация IDE** — VS Code, CLion, compile_commands.json, JSON metadata
+* **pkg-config** — автоматический поиск системных библиотек
+* **Per-command `--help`** — `dcr build --help`, `dcr new --help`, etc.
+* **Man pages** — `man dcr`, `man dcr-build`, `man dcr-new`

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

@@ -0,0 +1,91 @@
+---
+sidebar_label: Changelog
+---
+
+# Changelog
+
+## 0.7.1 (2026-06-02)
+
+### Добавлено:
+
+* **`--help` for all commands** — `dcr build --help`, `dcr run --help`, `dcr new --help`,
+  `dcr init --help`, `dcr clean --help`, `dcr add --help`, `dcr fmt --help`,
+  `dcr setup --help`, `dcr tree --help`, `dcr gen --help`, `dcr --update --help`,
+  `dcr test --help`. All output uses styled headers (green) and usage lines (cyan).
+* **Man pages** — 12 troff pages in `man/man1/`: `dcr.1`, `dcr-build.1`,
+  `dcr-run.1`, `dcr-new.1`, `dcr-init.1`, `dcr-clean.1`, `dcr-add.1`, `dcr-test.1`,
+  `dcr-gen.1`, `dcr-fmt.1`, `dcr-tree.1`, `dcr-setup.1`.
+* **Man pages in all packaging** — install.sh, install_bsd.sh, AUR PKGBUILD,
+  Debian (cargo-deb), RPM (cargo-generate-rpm), Nix (postInstall), Homebrew
+  (resource), Snap, GitHub Release assets.
+* **Project name validation** — `dcr init` and `dcr new` now validate names before
+  creating files. Only ASCII letters, digits, `_` and `-` are allowed.
+* **`documentation` and `homepage` fields** — added to `Cargo.toml`.
+* **Release profile optimizations** — `opt-level = "z"`, LTO, `codegen-units = 1`,
+  `panic = "abort"`, `strip = true` for smaller binaries.
+* **Linux i686, armv7, riscv64 targets** — added to release workflow and install scripts.
+* **Linux musl i686, armv7 targets** — cross-compiled via zigbuild in CI.
+* **AUR packages** — `dcr-dev`, `dcr-dev-bin` publishing workflow.
+* **Snap publishing** — automated Snapcraft publishing in CI.
+* **Snap badge** — in README.
+
+### Изменено:
+
+* **`validate_package_name` made public** — callable from CLI commands.
+* **README platform table** — reorganized: libc variants as separate OS rows,
+  removed extra columns. Linux architecture list updated.
+* **`gen.rs` no-args output** — now uses styled output instead of raw `eprintln!`.
+* **`tree.rs`, `fmt.rs`, and `setup.rs`** — now accept arguments for `--help`.
+* **README install commands** — `| bash` → `| sh` for POSIX compatibility.
+
+### Исправлено:
+
+* **`dcr new \<invalid-name>` creates directory then fails** — validation now
+  happens before any file operations.
+* **`dcr init` on invalid directory name** — same fix.
+* **Man pages missing in installed packages** — now shipped in all formats.
+* **Windows drive letter false positive** — in dependency file parser.
+* **CRLF (`\r\n`) breaks dependency parser** — now handles mixed line endings.
+* **Newline after backslash not consumed** — in `parse_d_file` escape handling.
+
+## 0.7.0 (2026-06-01)
+
+### Added
+
+* **Поддержка целевых платформ OpenBSD и NetBSD** — полная маршрутизация по платформам с динамически генерируемыми тройками целевых параметров с использованием `std::env::consts::ARCH` и `std::env::consts::OS`. Затрагивает команды `build`, `run`, `clean` и модуль платформы.
+* **`src/platform/bsd.rs`** — новый специальный модуль платформы BSD, общий для FreeBSD, OpenBSD и NetBSD, предоставляющий `bin_path`, `lib_path`, `elf_path`, `efi_path` и `shared_lib_path`.
+* **`Параметр конфигурации build.out_dir`** — настраиваемый каталог вывода, который переопределяет путь по умолчанию `target/\<triple>/\<profile>` для конечных артефактов. Поддерживается в `build`, `run` и при проверке конфигурации.
+* **Команда `dcr fmt`** — новая команда CLI, которая форматирует все исходные файлы C/C++ (`*.c`, `*.cpp`, `*.h`, `*.hpp`) в `src/` и `tests/` с помощью `clang-format`.
+* **Инкрементальная компоновка** — функция `needs_link()` в `common.rs`, которая проверяет, не является ли какой-либо объектный файл более новым, чем скомпонованный результат, пропуская ненужную повторную компоновку. Реализовано для всех бэкэндов (`unix_cc`, `msvc`, `gas`, `nasm`).
+* **`build.kind = «none»` и `«custom»`** — два новых типа проектов для специальных сценариев сборки, при которых не создается стандартный артефакт.
+* **`install_bsd.sh`** — специальный скрипт установки, совместимый с POSIX, для систем BSD (FreeBSD, OpenBSD, NetBSD) с режимами загрузки бинарных файлов и сборки из исходного кода.
+* **Поддержка Linux ARM64 в `install.sh`** — добавлено определение целевой тройки `Linux:aarch64|Linux:arm64` для загрузки готовых бинарных файлов.
+* **Обнаружение ОС BSD в `install.sh`** — обнаружение FreeBSD, OpenBSD, NetBSD и определение целевой тройки.
+* **`rust-toolchain.toml`** — явное привязывание инструментария к каналу `stable`.
+* **Интеграционные тесты** — `build_with_target_config` (проверяет `build.target = «linux»`) и `build_with_out_dir` (проверяет настраиваемый каталог вывода).
+* **`get_build_string_with_profile` стал `pub`** — чтобы `run.rs` мог определять конфигурацию настраиваемого каталога вывода.
+
+### Changed
+
+* **Изменена семантика `build.target`** — теперь строго содержит тройку целей (например, `x86_64-unknown-linux-gnu`) или короткое имя (`linux`, `macos`, `windows`). Больше не используется в качестве пользовательского каталога вывода — эта функциональность перенесена в `build.out_dir`.
+* **`build.standard` стал опциональным** — изменен с `String` на `Option\<String>`. Проверка обеспечивает только непустоту для языков, отличных от ASM. Пропускается в выводе `dcr.toml`, если пуст.
+* **`dcr run` с `out_dir`** — теперь определяет целевой каталог с учетом `build.out_dir`, если он настроен, через `get_build_string_with_profile()` из `build.rs`.
+* **`collect_sources()` возвращает пустой вектор** вместо ошибки, если не найдено ни одного исходного файла, что позволяет проектам с `kind = «none»` или `kind = «custom»` не иметь исходных файлов.
+* **Рефакторинг рабочего процесса выпуска CI/CD** — `git2` стал целевым (без vendored-openssl на Windows), кросс-компиляция на основе Zig для целей Linux, отличных от x86_64, очистка версий пакетов Arch Linux (тире → точки), символьная ссылка `gmake` для NetBSD.
+* **Таблица совместимости README** — статус сборки/работы на FreeBSD, OpenBSD, NetBSD повышен с «сообщество/по возможности» до «официально поддерживается».
+* **Обновлена документация** — `build-section.md` описывает новые поля `build.target` и `build.out_dir`. `target-directory.md` переписан для уточнения различия.
+
+### Fixed
+
+* **stdout/stderr `dcr run` не наследуются** — вывод дочернего процесса захватывался и выводился вручную, что приводило к сбоям интерактивных программ. Исправлено путем перехода на `Command::status()`.
+* **Условие гонки в CI релиза** — задания матрицы сборки могли загружать ресурсы в релиз, который еще не существовал. Исправлено добавлением специального задания `create-release`.
+* **Релиз GHA — переопределение стабильного набора инструментов** — устранены проблемы с переопределением набора инструментов Rust в CI.
+* **Очистка версий пакетов Arch Linux** — строки версий с дефисами (например, `0.7.0-dev`) являются недопустимыми для `pkgver` в Arch Linux. Исправлено путем замены дефисов точками.
+* **Права доступа GPG после Docker** — операции Docker изменяли владельца каталога GPG. Исправлено путем запуска `chown` после команд Docker.
+* **Пути к артефактам пакетов RPM** — артефакты RPM размещались в `rpm/x86_64/` вместо `fedora/x86_64/`. Исправлено в рабочем процессе Dexoron Packages Index.
+* **Надежность разбора JSON в `install.sh`** — добавлен `jq` в качестве основного парсера с резервным вариантом `python3` для поиска релизов в канале dev.
+
+### Удалено:
+
+* **Вспомогательная функция `format_roots()`** — удалена из `common.rs`. Использовалась только старым путем обработки ошибок в `collect_sources()`.
+* **Отдельные шаги загрузки артефактов для каждой дистрибуции** — три отдельных шага `actions/download-artifact` заменены на унифицированный `gh release download --clobber`.

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

@@ -0,0 +1,43 @@
+---
+sidebar_label: Команды сборки (build, run, clean)
+---
+
+# Команды сборки
+
+## `dcr build`
+
+Собирает проект по `dcr.toml`.
+
+```bash
+dcr build                         # debug профиль
+dcr build --release               # release профиль
+dcr build --debug                 # явно debug
+dcr build --profile custom        # произвольный профиль
+dcr build --target aarch64-unknown-linux-gnu
+dcr build --force                 # пересобрать всё с нуля
+dcr build --clean                 # clean + build
+dcr build --verbose               # показать команды компиляции
+dcr build --workspace pkg-a       # собрать конкретный пакет в workspace
+```
+
+Артефакты: `target/\<triple>/\<profile>/\<binary-name>` (Linux с явным целевым объектом).
+
+## `dcr run`
+
+Собирает (если исходники новее артефакта) и запускает бинарник.
+
+```bash
+dcr run
+dcr run --release
+```
+
+## `dcr clean`
+
+Удаляет директорию `target/`(или `target/\<target>/\<profile>`).
+
+```bash
+dcr clean
+dcr clean --release               # очистить target/release/
+dcr clean --target windows        # очистить target/x86_64-pc-windows-msvc/
+dcr clean --all        # очистить все пакеты workspace
+```

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

@@ -0,0 +1,53 @@
+---
+sidebar_label: Команды зависимостей (add, tree)
+---
+
+# Команды зависимостей
+
+## `dcr add \<name> [source]`
+
+Добавляет зависимость в `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
+```
+
+Префиксы источника:
+
+* `path:` — локальный путь
+* `git:` — URL адрес git-репозитория
+* `github:` — расширение `https://github.com/\<user>/\<repo>`
+* `gitlab:` — расширение `https://gitlab.com/\<user>/\<repo>`
+* `http://` / `https://` / `git@` — полный URL
+
+Флаги:
+
+* `--branch \<name>` — git ветка
+* `--tag \<name>` — git tag
+* `--rev \<hash>` — git commit
+
+Если источник не указан — DCR выполняет поиск в подключенных реестрах.
+
+## `dcr tree`
+
+Показывает дерево зависимостей проекта.
+
+```bash
+dcr tree
+```
+
+Пример вывода:
+
+```
+my-app v0.1.0
+├── fmt (registry)
+│   └── spdlog (registry)
+└── catch2 (registry)
+```
+
+В случае path зависимостей, рекурсивно отображает их собственные зависимости (из файла `dcr.toml`).

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

@@ -0,0 +1,73 @@
+---
+sidebar_label: Gen команды (vscode, clion, ...)
+---
+
+# Gen команды
+
+## `dcr gen \<target>`
+
+Генерирует файл интеграции с IDE.
+
+### vscode
+
+```bash
+dcr gen vscode
+```
+
+Создаёт:
+
+* `.vscode/tasks.json` — `build` задача (dcr build)
+* `.vscode/launch.json` — конфигурация запуска отладки
+* `.vscode/settings.json` — настройки C/C++ (clangd пути, includes)
+* `.vscode/extensions.json` — рекомендуемые расширения (vscode-clangd, vscode-lldb)
+
+### clion
+
+```bash
+dcr gen clion
+```
+
+Создаёт:
+
+* `.idea/externalTools.xml` — внешние инструменты (build, run, clean, test)
+* `.idea/customTargets.xml` — пользовательские цели сборки
+* `.idea/misc.xml` — настройки C/C++ проекта
+* `.idea/runConfigurations/\<name>.xml` — конфигурация запуска
+
+### compile-commands
+
+```bash
+dcr gen compile-commands
+```
+
+Генерирует `compile_commands.json` — стандартный формат для clangd, cpptools, статических анализаторов.
+
+### project-info
+
+```bash
+dcr gen project-info
+```
+
+Выводит JSON с метаданными проекта:
+
+```json
+[
+  {
+    "name": "my-app",
+    "version": "0.1.0",
+    "root": "/path/to/project",
+    "profile": "debug",
+    "language": "c",
+    "standard": "c17",
+    "cxx_standard": null,
+    "compiler": "/usr/bin/clang",
+    "kind": "bin",
+    "sources": ["src/main.c"],
+    "include_dirs": ["src"],
+    "lib_dirs": [],
+    "libs": [],
+    "cflags": ["-std=c17", "-O0", "-g"],
+    "ldflags": []
+  }
+]
+```

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

@@ -0,0 +1,31 @@
+---
+sidebar_label: Команды проекта (new, init)
+---
+
+# Команды проекта
+
+## `dcr new \<name>`
+
+Создает новый проект со стандартной структурой и `dcr.toml`. Аргумент `name` является обязательным.
+
+В названии проекта допускаются только ASCII буквы, цифры и подчеркивания `_` и дефисы `-`.
+
+```bash
+dcr new my-app
+```
+
+Генерирует:
+
+* `dcr.toml` с базовыми полями
+* `src/main.c` с основным шаблоном
+
+## `dcr init`
+
+Инициализирует проект DCR в текущем (пустом) каталоге.
+
+```bash
+mkdir app && cd app
+dcr init
+```
+
+Название проекта взято из имени текущего каталога. Имя каталога должно соответствовать тем же правилам именования, что и в `dcr new`.

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

@@ -0,0 +1,60 @@
+---
+sidebar_label: Команды качества (test, fmt)
+---
+
+# Команды качества
+
+## `dcr test`
+
+Запускает тесты.
+
+```bash
+dcr test                          # debug профиль
+dcr test --release                # release профиль
+dcr test --debug                  # явный debug
+dcr test --help                   # подробная справка
+```
+
+Перед первым запуском нужно инициализировать тесты:
+
+```bash
+dcr test --init
+```
+
+Это создаёт `tests/dcr_test.h` (фреймворк) и `tests/test.c` (шаблон).
+
+Что делает `dcr test`:
+
+1. Builds the project
+2. Collects `tests/*.c` files (`.c` only, not `.cpp`)
+3. Compiles and links each test file
+4. Runs each test binary
+5. Prints summary: TOTAL, PASS, SKIP, FAIL
+6. Возвращает ненулевой код при наличии FAIL
+
+## `dcr fmt`
+
+Форматирует исходный код C/C++ через `clang-format`.
+
+```bash
+dcr fmt
+```
+
+Processes: `src/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}` and `tests/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}`.
+
+Используется файл `.clang-format` в корне проекта (если есть), иначе дефолтный стиль DCR.
+
+## `dcr lint`
+
+Runs `clang-tidy` on C/C++ source files for static analysis.
+
+```bash
+dcr lint              # show diagnostics
+dcr lint --fix        # apply fixes automatically
+dcr lint --help       # detailed help
+```
+
+Processes: `src/**/*.{c,cpp,cxx,cc}` and `tests/**/*.{c,cpp,cxx,cc}`.
+
+Without `--fix`, clang-tidy reports warnings and errors without modifying files.
+With `--fix`, clang-tidy applies automatic suggestions in place.

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

@@ -0,0 +1,52 @@
+---
+sidebar_label: Системные команды (setup, --help, ...)
+---
+
+# Системные команды
+
+## `dcr setup`
+
+`~/.dcr/config.toml` — конфигурация реестров
+
+```bash
+dcr setup
+```
+
+If `~/.dcr/config.toml` is not found, DCR returns an error. Create it manually:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+## `dcr --help`
+
+Shows help for all commands.
+
+```bash
+dcr --help
+dcr build --help    # справка по конкретной команде
+```
+
+## `dcr --version`
+
+Shows version and target triple.
+
+```bash
+dcr --version       # dcr 0.7.0
+```
+
+## `dcr --update`
+
+Самообновление. Скачивает последний релиз с GitHub Releases и заменяет текущий бинарник.
+
+```bash
+dcr --update
+```
+
+Особенности:
+
+* Определяет платформу и архитектуру автоматически
+* Warns if installed via AUR (use package manager instead)
+* Работает на Linux, macOS, Windows

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

@@ -0,0 +1,51 @@
+---
+sidebar_label: Contributing
+---
+
+# Contributing
+
+## Setup
+
+```bash
+git clone https://github.com/dexoron/dcr
+cd dcr
+cargo build
+```
+
+## Code style
+
+Весь код форматируется через `cargo fmt`:
+
+```bash
+cargo fmt
+```
+
+## Линтер
+
+```bash
+cargo clippy --all-targets -- -D warnings
+```
+
+## Тесты
+
+```bash
+cargo test --all-targets
+```
+
+## PR process
+
+1. Форкните репозиторий
+2. Создайте ветку: `git checkout -b feature/description`
+3. Внесите изменения
+4. Запустите `cargo fmt && cargo clippy --all-targets -- -D warnings && cargo test --all-targets`
+5. Откройте Pull Request
+
+## CI
+
+В CI запускаются:
+
+* `cargo fmt --check`
+* `cargo clippy --all-targets -- -D warnings`
+* `cargo test --all-targets`
+* Сборка под Linux, macOS, Windows, FreeBSD, OpenBSD, NetBSD
+* Интеграционные тесты

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

@@ -0,0 +1,81 @@
+---
+sidebar_label: Часто задаваемые вопросы
+---
+
+# Часто задаваемые вопросы
+
+## Registry not found
+
+```
+error: registry not found
+```
+
+**Solution:** Make sure `~/.dcr/config.toml` exists:
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+Если реестр кастомный, проверьте `DCR_INDEX_PATH`:
+
+```bash
+echo $DCR_INDEX_PATH
+```
+
+## Compiler not found
+
+```
+error: compiler not found
+```
+
+**Решение:** Убедитесь, что компилятор установлен и доступен в PATH.
+
+```bash
+which gcc
+which clang
+```
+
+Или укажите явно через `[toolchain]` или `DCR_COMPILER`.
+
+## openssl-sys build failed
+
+При сборке DCR из исходников:
+
+```
+error: failed to run custom build command for openssl-sys
+```
+
+**Решение:** Установите OpenSSL development headers:
+
+```bash
+# Ubuntu/Debian
+sudo apt install libssl-dev
+
+# Fedora
+sudo dnf install openssl-devel
+
+# macOS
+brew install openssl
+```
+
+## Ctrl+C во время сборки
+
+DCR корректно обрабатывает SIGINT: прерывает текущую компиляцию и завершает процесс с ненулевым кодом.
+
+## Как создать библиотеку?
+
+[Library Recipe](/docs/recipes/library-project).
+
+## How to cross-compile to Windows?
+
+См. [Cross-Compile Recipe](/docs/recipes/cross-to-windows).
+
+## Как сделать мультипакетный проект?
+
+См. [Workspace Recipe](/docs/recipes/multi-package-workspace).
+
+## Lock-файл устарел
+
+При изменении зависимостей `dcr.lock` автоматически обновляется при следующем `dcr add`. Если нужно принудительно обновить — удалите `dcr.lock` и выполните `dcr build`.

docs-crowdin-export/ru-RU/docs/getting-started/first-steps.mdx.mdx

@@ -0,0 +1,77 @@
+---
+sidebar_label: Первые шаги
+---
+
+# Первые шаги
+
+## Создать проект
+
+```bash
+dcr new my-app
+cd my-app
+```
+
+Будет создана структура:
+
+```
+my-app/
+├── dcr.toml
+└── src/
+    └── main.c
+```
+
+`dcr.toml`:
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "none"
+description=""
+author=""
+license = "GPL-3.0-or-later"
+
+[build]
+language = "c"
+standard = "c11"
+compiler = "clang"
+kind = "bin"
+
+[dependencies]
+```
+
+## Build
+
+```bash
+dcr build
+```
+
+Output — `target/\<triple>/debug/my-app` (Linux) or `target/debug/my-app.exe` (Windows).
+
+Профиль:
+
+```bash
+dcr build --release       # релизная сборка
+dcr build --debug         # дебажная (по умолчанию)
+```
+
+## Запустить
+
+```bash
+dcr run
+```
+
+Собирает (если нужно) и запускает бинарник.
+
+## First test
+
+```bash
+dcr test --init      # create test template
+dcr test             # run tests
+```
+
+## Форматирование
+
+```bash
+dcr fmt              # clang-format по .clang-format
+```

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

@@ -0,0 +1,111 @@
+---
+sidebar_label: Установка
+---
+
+# Установка
+
+## Linux (Dexoron Packages)
+
+Настройте менеджер пакетов на https://pkg.dexoron.su и установите:
+
+**Arch Linux**
+
+```sh
+sudo pacman -Sy dcr
+```
+
+**Debian/Ubuntu**
+
+```sh
+sudo apt update && sudo apt install dcr
+```
+
+**Fedora/RHEL**
+
+```sh
+sudo dnf install dcr
+```
+
+## Arch Linux (AUR)
+
+```sh
+yay -S dcr
+```
+
+## macOS / Linux (Homebrew)
+
+```sh
+brew tap dexoron/dexoron
+brew install dcr
+# or
+brew install dexoron/dexoron/dcr
+```
+
+## Snap (Linux)
+
+```sh
+sudo snap install dcrup
+```
+
+## Nix (flake)
+
+```sh
+nix run github:dexoron/dcr
+# or install to profile:
+nix profile install github:dexoron/dcr
+```
+
+## Cargo (crates.io)
+
+```sh
+cargo install dcr
+```
+
+## Linux / macOS (script)
+
+```sh
+curl -fsSL https://dcr.dexoron.su/install_bsd.sh | bash
+```
+
+## BSD (script)
+
+```sh
+curl -fsSL https://dcr.dexoron.su/install.sh | bash
+```
+
+## Windows (PowerShell)
+
+```powershell
+irm https://dcr.dexoron.su/install.ps1 | iex
+```
+
+## From source
+
+```sh
+git clone https://github.com/dexoron/dcr.git
+cd dcr && cargo build --release
+ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
+```
+
+## Post-install
+
+Verify the installation:
+
+```bash
+dcr setup
+```
+
+Man pages are available after installation:
+
+```bash
+man dcr
+man dcr-build
+```
+
+Команда создаёт `~/.dcr/` с дефолтным `config.toml` и скачивает публичный реестр.
+
+```toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```

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

@@ -0,0 +1,51 @@
+---
+sidebar_label: Интеграция с IDE
+---
+
+# Интеграция с IDE
+
+## VS Code
+
+```bash
+dcr gen vscode
+```
+
+Генерирует в `.vscode/`:
+
+| Файл              | Назначение                                  |
+| ----------------- | ------------------------------------------- |
+| `tasks.json`      | Задача `build` (dcr build)                  |
+| `launch.json`     | Debug-запуск бинарника                      |
+| `settings.json`   | clangd/IntelliSense: include пути, стандарт |
+| `extensions.json` | Рекомендует clangd, C/C++                   |
+
+## CLion
+
+```bash
+dcr gen clion
+```
+
+Генерирует в `.idea/`:
+
+| Файл                                      | Назначение                                      |
+| ----------------------------------------- | ----------------------------------------------- |
+| `externalTools.xml`                       | Build, Run, Clean, Test как внешние инструменты |
+| `customTargets.xml`                       | Кастомные цели сборки                           |
+| `misc.xml`                                | Настройки C/C++ проекта                         |
+| `runConfigurations/dcr_build_and_run.xml` | Per-binary run configurations                   |
+
+## compile_commands.json
+
+```bash
+dcr gen compile-commands
+```
+
+Генерирует `compile_commands.json` в корне проекта. Стандартный формат для:
+
+## project-info
+
+```bash
+dcr gen project-info
+```
+
+Выводит JSON с метаданными проекта (см. [gen-commands](/docs/commands/gen-commands)).

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

@@ -0,0 +1,46 @@
+---
+sidebar_label: Лицензия
+---
+
+# Лицензия
+
+## DCR
+
+DCR распространяется под лицензией [GPL-3.0-or-later](https://spdx.org/licenses/GPL-3.0-or-later.html).
+
+> **Важно:** DCR — инструмент сборки, а не библиотека. GPL распространяется только на исходный код самого DCR. Проекты, собранные с помощью DCR, не подпадают под лицензию DCR — их лицензирование определяется исключительно их собственным кодом и зависимостями.
+
+## Вендорные библиотеки
+
+DCR статически связывает следующие C-библиотеки через вендорные Rust-зависимости:
+
+| Библиотека                                 | Лицензия           | Bundled by                    |
+| ------------------------------------------ | ------------------ | ----------------------------- |
+| [libgit2](https://libgit2.org)             | MIT OR Apache-2.0  | `git2` / `libgit2-sys`        |
+| [libssh2](https://libssh2.org)             | MIT OR Apache-2.0  | `libgit2-sys`                 |
+| [zlib](https://zlib.net)                   | MIT OR Apache-2.0  | `libgit2-sys`                 |
+| [OpenSSL](https://openssl.org)             | Apache-2.0         | `openssl-sys` / `openssl-src` |
+| [ring](https://github.com/briansmith/ring) | Apache-2.0 AND ISC | `rustls`                      |
+
+## Rust-зависимости
+
+DCR написан на Rust. Ниже перечислены основные статически связываемые крейты:
+
+| Крейт                                         | Лицензия                 |
+| --------------------------------------------- | ------------------------ |
+| [`reqwest`](https://crates.io/crates/reqwest) | MIT OR Apache-2.0        |
+| [`rustls`](https://crates.io/crates/rustls)   | Apache-2.0 OR ISC OR MIT |
+| [`serde`](https://crates.io/crates/serde)     | MIT OR Apache-2.0        |
+| [`toml`](https://crates.io/crates/toml)       | MIT OR Apache-2.0        |
+| [`sha2`](https://crates.io/crates/sha2)       | MIT OR Apache-2.0        |
+| [`git2`](https://crates.io/crates/git2)       | MIT OR Apache-2.0        |
+| [`openssl`](https://crates.io/crates/openssl) | Apache-2.0               |
+| [`tokio`](https://crates.io/crates/tokio)     | MIT                      |
+| [`hyper`](https://crates.io/crates/hyper)     | MIT                      |
+| [`ctrlc`](https://crates.io/crates/ctrlc)     | MIT OR Apache-2.0        |
+
+Полное дерево зависимостей (143 пакета) доступно в [`Cargo.lock`](https://github.com/dexoron/dcr/blob/main/Cargo.lock). Подавляющее большинство имеют двойную лицензию MIT OR Apache-2.0.
+
+## Additional credits
+
+* Дизайн CLI и модель проектов DCR вдохновлены [Cargo](https://doc.rust-lang.org/cargo/).

docs-crowdin-export/ru-RU/docs/recipes/cross-to-windows.mdx.mdx

@@ -0,0 +1,47 @@
+---
+sidebar_label: Кросс-компиляция для Windows
+---
+
+# Кросс-компиляция для Windows на Linux
+
+Сборка Windows-бинаря на Linux с использованием mingw-w64.
+
+## Установка toolchain
+
+```bash
+# Ubuntu/Debian
+sudo apt install mingw-w64
+
+# Fedora
+sudo dnf install mingw64-gcc mingw64-binutils
+```
+
+## Конфигурация
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "app"
+
+[build]
+language = "c"
+standard = "c17"
+target = "windows"
+```
+
+## Сборка
+
+```bash
+dcr build --target windows --release
+```
+
+Артефакт: `target/x86_64-pc-windows-gnu/release/my-app.exe`.
+
+## Кастомный toolchain (опционально)
+
+```toml
+[toolchain]
+cc = "x86_64-w64-mingw32-gcc"
+cxx = "x86_64-w64-mingw32-g++"
+```

docs-crowdin-export/ru-RU/docs/recipes/library-project.mdx.mdx

@@ -0,0 +1,70 @@
+---
+sidebar_label: Проект библиотеки
+---
+
+# Проект библиотеки
+
+Создание статической библиотеки и её использование в другом проекте.
+
+## Шаг 1: Создать библиотеку
+
+```bash
+dcr new my-lib
+```
+
+`dcr.toml`:
+
+```toml
+[package]
+name = "my-lib"
+version = "0.1.0"
+type = "lib"
+
+[build]
+language = "c"
+standard = "c17"
+kind = "staticlib"
+```
+
+`src/my_lib.h`:
+
+```c
+#ifndef MY_LIB_H
+#define MY_LIB_H
+int add(int a, int b);
+#endif
+```
+
+`src/my_lib.c`:
+
+```c
+#include "my_lib.h"
+int add(int a, int b) { return a + b; }
+```
+
+## Шаг 2: Собрать
+
+```bash
+cd my-lib
+dcr build --release
+```
+
+Артефакты:
+
+* `target/release/libmy-lib.a` (Linux/macOS)
+* `target/release/my-lib.lib` (Windows)
+* `target/include/` — заголовочные файлы
+
+## Шаг 3: Использовать в проекте
+
+```bash
+dcr new my-app
+cd my-app
+dcr add ../my-lib
+```
+
+Автоматически:
+
+* Добавляется include path на `target/include/` библиотеки
+* Добавляется lib path на `target/release/`
+* Линкуется `libmy-lib.a` / `my-lib.lib`

docs-crowdin-export/ru-RU/docs/recipes/multi-package-workspace.mdx.mdx

@@ -0,0 +1,97 @@
+---
+sidebar_label: Рабочая область с несколькими пакетами
+---
+
+# Рабочая область с несколькими пакетами
+
+Проект из трёх пакетов: библиотека, утилита и основной бинарник.
+
+## Структура
+
+```
+workspace/
+├── dcr.toml              # корневой workspace
+├── lib-core/
+│   ├── dcr.toml
+│   └── src/lib.rs
+├── lib-utils/
+│   ├── dcr.toml
+│   └── src/utils.c
+└── app/
+    ├── dcr.toml
+    └── src/main.c
+```
+
+## Корневой dcr.toml
+
+```toml
+[package]
+name = "my-workspace"
+version = "0.1.0"
+type = "none"
+
+[build]
+inherit = true
+language = "c"
+standard = "c17"
+
+[workspace]
+members = [
+    { path = "lib-core" },
+    { path = "lib-utils", deps = ["lib-core"] },
+    { path = "app", deps = ["lib-core", "lib-utils"], main = true },
+]
+```
+
+## Пакеты
+
+`lib-core/dcr.toml`:
+
+```toml
+[package]
+name = "lib-core"
+version = "0.1.0"
+type = "lib"
+
+[build]
+kind = "staticlib"
+```
+
+`lib-utils/dcr.toml`:
+
+```toml
+[package]
+name = "lib-utils"
+version = "0.1.0"
+type = "lib"
+
+[build]
+kind = "staticlib"
+```
+
+`app/dcr.toml`:
+
+```toml
+[package]
+name = "app"
+version = "0.1.0"
+type = "app"
+
+[build]
+kind = "bin"
+```
+
+## Сборка
+
+```bash
+cd workspace
+dcr build                     # собирает всё в правильном порядке
+dcr build --workspace app     # только app (lib-core и lib-utils собираются как зависимости)
+dcr run                       # собирает и запускает main-пакет
+```
+
+Порядок сборки (топологическая сортировка):
+
+1. `lib-core`
+2. `lib-utils` (зависит от lib-core)
+3. `app` (зависит от lib-core, lib-utils)

docs-crowdin-export/ru-RU/docs/reference/build-profiles.mdx.mdx

@@ -0,0 +1,82 @@
+---
+sidebar_label: dcr build --profile lto
+---
+
+# Встроенные профили
+
+Профили позволяют переопределять любые поля секции `[build]` для конкретного режима сборки.
+
+## Конфигурация
+
+```toml
+[build]
+language = "c"
+standard = "c17"
+cflags = ["-Wall"]
+
+[build.debug]
+cflags = ["-O0", "-g"]
+
+[build.release]
+cflags = ["-O3", "-flto"]
+```
+
+## Правила
+
+Поля из `[build.\<profile>]` **мержатся поверх** `[build]`
+
+* **Scalar fields** (strings, numbers, bools) — replaced
+* Массивы (`cflags`, `ldflags`, ...) **заменяются полностью**, а не дополняются
+
+Set `inherit = false` to disable array inheritance (only profile's own arrays are used).
+
+## Кастомные профили
+
+The default flags for each profile are composed from three config fields:
+
+| Field       | Default cflags     | Профили сборки |
+| ----------- | ------------------ | -------------- |
+| `opt_level` | `-O0 -g`           | `"3"`          |
+| `debug`     | `true`             | `false`        |
+| `warnings`  | `["all", "extra"]` | `[]`           |
+
+Which produce the equivalent compiler flags:
+
+| Профиль   | Effective flags                                            |
+| --------- | ---------------------------------------------------------- |
+| `debug`   | `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG` |
+| `release` | `-O3 -DNDEBUG`                                             |
+
+Additional build options can be toggled per-profile:
+
+```toml
+[build.release]
+opt_level = "z"
+lto = true
+strip = true
+panic = "abort"
+codegen-units = "1"
+
+[build.debug]
+opt_level = "1"
+debug = false
+warnings = ["all", "error"]
+```
+
+## Target-specific профили
+
+```toml
+[build.linux]
+cflags = ["-DLINUX"]
+
+[build.windows.debug]
+cflags = ["-DWIN32", "-O0", "-g"]
+```
+
+Application order (highest priority first):
+
+1. `[build.\<target>.\<profile>]`
+2. `[build.\<profile>.\<target>]`
+3. ]`или`[build.\<target>]\`
+4. `[build.\<profile>]`.
+5. `[build]`

docs-crowdin-export/ru-RU/docs/reference/build-system.mdx.mdx

@@ -0,0 +1,131 @@
+---
+sidebar_label: Система сборки
+---
+
+# Build System
+
+## Compiler Backends
+
+DCR поддерживает 4 бэкенда компиляции. Выбор происходит автоматически на основе расширения файла и target triple.
+
+| Backend   | Файлы                                   | Когда используется              |
+| --------- | --------------------------------------- | ------------------------------- |
+| `unix_cc` | `.c`, `.cpp`, `.cxx`, `.cc`, `.s`, `.S` | gcc/clang на Linux/macOS/BSD    |
+| `msvc`    | `.c`, `.cpp`, `.cxx`, `.cc`             | Windows (cl, clang-cl)          |
+| `gas`     | `.s`, `.S`                              | ARM/ARM64 ассемблер             |
+| `nasm`    | `.asm`, `.s`                            | x86/x86_64 ассемблер            |
+| `masm`    | `.asm`                                  | MASM (ml/ml64) on Windows       |
+| `fasm`    | `.asm`, `.fasm`                         | Flat Assembler                  |
+| `llvm_ir` | `.ll`                                   | LLVM IR via `llc -filetype=obj` |
+
+## Qt Support
+
+DCR provides native Qt support for automatic meta-object handling (MOC, UIC, RCC).
+
+Enable it by setting `build.qt = true` in `dcr.toml`. DCR will automatically detect Qt-related files (`.ui`, `.qrc`, `.h` with `Q_OBJECT`) and process them.
+
+```toml
+[build]
+qt = true
+```
+
+*Note: Requires `qt6` modules (Core, Widgets, Gui, Svg) installed via `pkg-config`.*
+
+Advanced customization is still possible via `build.steps` if special handling is needed:
+
+```toml
+[build.steps]
+moc = "moc {in} -o {out}"
+```
+
+### Unix CC
+
+* Компилятор определяется через `resolve_compiler()`: CC/CXX из [toolchain], DCR_COMPILER/env, PATH
+* Поддерживает генерацию `.d` файлов для header dependency tracking
+* Флаги: `-std=`, `-MMD -MF`, `-c -o`, `-I`, `-L`, `-l`
+* Conditional flags based on config:
+  * `freestanding` or bare-metal target: `-ffreestanding` (compile), `-nostdlib -static` (link)
+  * `lto`: `-flto` (compile + link)
+  * `panic = "abort"`: `-fno-exceptions` (C++ only), `-fno-unwind-tables`, `-fno-asynchronous-unwind-tables`
+
+### MSVC
+
+* Поддерживает cl.exe и clang-cl.exe
+* Флаги: `/std:`, `/Fo:`, `/Fe:`, `/I`, `/link`
+
+### GAS / NASM
+
+* GAS: `-I`, `-c -o`, `--defsym`
+* NASM: `-I`, `-c -o`, `-D`, `-f` (формат: win64/elf64/macho64/macho32/elf32)
+* MASM: `/nologo /c /Fo\<obj> <source>`
+* FASM: `<source> \<output>` (output path is the object file)
+* LLVM IR: `-filetype=obj <source> -o \<output>`
+
+## Incremental Builds
+
+Три уровня инкрементальности:
+
+1. **mtime** — если выходной файл новее всех входных, файл не перекомпилируется
+2. **`.d` files** — отслеживание изменений в заголовочных файлах (включая транзитивные)
+3. **SHA256 fingerprint** — если флаги компиляции изменились, файл перекомпилируется (fingerprint хранится в `.dcr_fingerprint`)
+
+## Parallel Compilation
+
+* Используется `thread::scope` для создания пула потоков
+* Атомарная очередь задач (`AtomicU64`)
+* Мьютекс на запись в stdout (`OUTPUT_MUTEX`)
+* Thread count = `available_parallelism()`, capped by `build.codegen-units` if set
+
+## Build Kinds
+
+| Kind        | Тип                                  | Path (Linux example)                                                                            |
+| ----------- | ------------------------------------ | ----------------------------------------------------------------------------------------------- |
+| `bin`       | Executable                           | `target/\<profile>/\<name>` (.exe)                            |
+| `staticlib` | Статическая библиотека               | `target/\<profile>/lib\<name>.a` (.lib)                       |
+| `sharedlib` | Динамическая библиотека              | `target/\<profile>/lib\<name>.so` (.dll/.dylib)               |
+| `efi`       | UEFI приложение                      | `target/\<profile>/\<name>.efi`                               |
+| `elf`       | ELF без стандартной библиотеки       | `target/\<profile>/\<name>`                                   |
+| `none`      | Compile only, no link                | —                                                                                               |
+| `custom`    | Полный контроль filename + extension | `target/\<profile>/\<filename>.\<extension>` |
+
+## Build Steps
+
+DCR поддерживает pre-build и post-build шаги через Qt codegen:
+
+* `build.steps` — commands before compilation
+* `build.post_steps` — commands after compilation
+
+Подстановки: `{stem}`, `{in}`, `{out}`.
+
+`rcc` — Resource Compiler: `{stem}.qrc → qrc_{stem}.cpp`
+
+```toml
+[build.steps]
+moc = "moc {in} -o {out}"
+```
+
+## pkg-config
+
+Automatic lookup (read from raw config):
+
+```toml
+[build]
+pkg_config = ["sdl2", "gl"]
+```
+
+DCR вызывает `pkg-config --cflags sdl2 gl` и `pkg-config --libs sdl2 gl` и добавляет результат в флаги компиляции/линковки.
+
+## Variable Substitution
+
+Supported variables:
+
+| Variable                | Описание                        |
+| ----------------------- | ------------------------------- |
+| `{version}`             | Версия пакета                   |
+| `{version_major}`       | Major version part              |
+| `{version_minor}`       | Minor version part              |
+| `{version_patch}`       | Переменная                      |
+| `{version_suffix}`      | Suffix (e.g., `-rc1`)           |
+| `{version_suffix_dash}` | Suffix with dash                |
+| `{profile}`             | Имя профиля (debug/release/...) |
+| `{name}`                | Имя пакета                      |

docs-crowdin-export/ru-RU/docs/reference/cross-compilation.mdx.mdx

@@ -0,0 +1,70 @@
+---
+sidebar_label: Кросс-компиляция
+---
+
+# Кросс-компиляция
+
+## Short Names
+
+DCR поддерживает короткие имена платформ, которые автоматически раскрываются в полные triples:
+
+| Short Name | Full Triple                |
+| ---------- | -------------------------- |
+| `linux`    | `x86_64-unknown-linux-gnu` |
+| `macos`    | `x86_64-apple-darwin`      |
+| `windows`  | `x86_64-pc-windows-msvc`   |
+
+```bash
+dcr build --target windows
+```
+
+## Full Triples
+
+```bash
+dcr build --target aarch64-unknown-linux-gnu
+dcr build --target x86_64-pc-windows-gnu
+dcr build --target armv7-unknown-linux-gnueabihf
+```
+
+## clang --target
+
+При использовании clang DCR автоматически inject-ит `--target=\<triple>` в CFLAGS/CXXFLAGS.
+
+```toml
+[build]
+compiler = "clang"
+target = "aarch64-unknown-linux-gnu"
+# Авто: cflags = ["--target=aarch64-unknown-linux-gnu"]
+```
+
+## Bare-Metal
+
+For targets containing `none`, `-elf`, `eabi`, or `baremetal`, DCR automatically:
+
+1. Для none/elf/eabi/bare-metal target-ов отключаются DCR default флаги (нет `-I` системных путей, нет `-l` libc).
+2. **Injects `-ffreestanding`** at compile time and `-nostdlib -static` at link time
+
+You can also enable freestanding mode explicitly:
+
+```toml
+[build]
+freestanding = true
+```
+
+```bash
+dcr build --target aarch64-none-elf
+```
+
+## Target Directory
+
+On Linux with explicit target:
+
+```
+target/<triple>/<profile>/
+```
+
+On macOS/Windows or without target:
+
+```
+target/<profile>/
+```

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

@@ -0,0 +1,153 @@
+---
+sidebar_label: Обзор dcr.toml
+---
+
+# Обзор dcr.toml
+
+Основной конфигурационный файл проекта. Располагается в корне проекта.
+
+## Структура
+
+```toml
+[package]
+# обязательные поля
+
+[build]
+# настройки сборки
+
+[build.debug]       # опционально: переопределение для debug
+[build.release]     # опционально: переопределение для release
+
+[build.linux]       # опционально: переопределение для Linux
+[build.windows]     # опционально: переопределение для Windows
+[build.windows.debug]  # комбинация target + profile
+
+[toolchain]
+# пути к компиляторам/линкеру
+
+[dependencies]
+# зависимости проекта
+
+[workspace]
+# мультипакетная конфигурация
+
+[run]
+[run.release]     # опционально: переопределение для release
+# настройки запуска
+```
+
+## [package]
+
+| Поле      | Обязательное | Описание                    |
+| --------- | ------------ | --------------------------- |
+| `name`    | да           | Имя проекта                 |
+| `version` | да           | Семантическая версия        |
+| `type`    | да           | `app`, `lib`, `none`        |
+| `license` | нет          | SPDX-идентификатор лицензии |
+| `author`  | нет          | Автор                       |
+
+```toml
+[package]
+name = "my-app"
+version = "0.1.0"
+type = "app"
+license = "MIT"
+author = "John Doe"
+```
+
+## [build]
+
+...
+
+* `build.qt` — (bool) Enable automatic Qt meta-object handling (MOC, UIC, RCC). Requires `qt6` modules installed via `pkg-config`.
+
+| Поле             | По умолчанию                                | Описание                                                              |
+| ---------------- | ------------------------------------------- | --------------------------------------------------------------------- |
+| `language`       | `"c"`                                       | `"c"`, `"cxx"`, `"cpp"`                                               |
+| `standard`       | `"c11"`                                     | Стандарт C (`c11`, `c17`, `c23`)                                      |
+| `cxx_standard`   | `"c++20"`                                   | Стандарт C++ (`c++17`, `c++20`, `c++23`)                              |
+| `compiler`       | `cxxflags`                                  | Предпочитаемый компилятор                                             |
+| `kind`           | `"bin"`                                     | `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, `custom`       |
+| `target`         | хост                                        | Target triple для кросс-компиляции                                    |
+| `platform`       | `"native"`                                  | `native`, `efi`, `freestanding`                                       |
+| `cflags`         | `[]`                                        | Дополнительные флаги C++                                              |
+| `ldflags`        | `[]`                                        | Дополнительные флаги линковки                                         |
+| `filename`       | `""`                                        | Кастомное имя выходного файла                                         |
+| `extension`      | `""`                                        | Custom file extension                                                 |
+| `roots`          | `["src"]`                                   | Корневые директории с исходниками                                     |
+| `exclude`        | `[]`                                        | Паттерны исключений                                                   |
+| `include`        | `[]`                                        | Дополнительные include-директории                                     |
+| `src_disable`    | `false`                                     | Disable auto source discovery                                         |
+| `inherit`        | `false`                                     | Наследовать build от корня workspace                                  |
+| `clean`          | `[]`                                        | Glob patterns for custom clean paths                                  |
+| `out_dir`        | `""`                                        | Custom output directory                                               |
+| `workspace_only` | `false`                                     | Только для workspace, не собирать отдельно                            |
+| `freestanding`   | `false`                                     | Compile in freestanding mode (`-ffreestanding` + `-nostdlib -static`) |
+| `opt_level`      | `"0"` (debug) / `"3"` (release)             | Optimization level: `0`-`3`, `"s"`, `"z"`                             |
+| `ldscript`       | `true` (debug) / `false` (release)          | Emit debug symbols (`-g`)                                             |
+| `lto`            | `false`                                     | Link-time optimization (`-flto` for both compiler and linker)         |
+| `asflags`        | `false`                                     | Strip symbols from output (`-s` in ldflags)                           |
+| `true`           | `["all", "extra"]` (debug) / `[]` (release) | Warning flags (e.g. `"all"`, `"extra"`, `"pedantic"`)                 |
+| `panic`          | `""`                                        | Panic strategy: `"abort"` disables exceptions and unwind tables       |
+| `codegen-units`  | `""`                                        | Max parallel compilation jobs (`"0"` = auto)                          |
+| `qt`             | `false`                                     | Enable automatic Qt meta-object handling (MOC, UIC, RCC)              |
+
+Settings from raw config (not in typed struct):
+
+* Пакеты для pkg-config
+* Путь к linker script
+* `build.steps` / `build.post_steps` — codegen steps
+
+Example:
+
+```toml
+[build]
+language = ["cpp", "c"]
+standard = "c17"
+standard = "c23"
+cxx_standard = "c++23"
+compiler = "clang"
+kind = "sharedlib"
+cflags = ["-Wall", "-Wextra"]
+pkg_config = ["sdl2", "gl"]
+```
+
+## [toolchain]
+
+```toml
+[toolchain]
+cc = "/usr/bin/clang"
+cxx = "/usr/bin/clang++"
+as = "/usr/bin/as"
+ar = "/usr/bin/ar"
+ld = "/usr/bin/ld.lld"
+uic = "/usr/bin/uic"       # Qt
+moc = "/usr/bin/moc"       # Qt
+rcc = "/usr/bin/rcc"       # Qt
+```
+
+Raw config also supports `uic`, `moc`, `rcc` for Qt codegen.
+
+## [dependencies]
+
+См. [dependencies](/docs/reference/dependencies).
+
+## [run]
+
+```toml
+[run]
+cmd = "./target/{profile}/{name}"
+```
+
+Подстановки:
+
+* `{version}` — версия из [package]
+* `pkg_config`
+* `{profile}` — debug / release
+* `{name}` — имя из [package]
+
+По умолчанию `cmd` вычисляется как `./target/{profile}/{name}`.
+
+## [workspace]
+
+См. [workspaces](/docs/reference/workspaces).

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

@@ -0,0 +1,88 @@
+---
+sidebar_label: Зависимости
+---
+
+# Зависимости
+
+## Форматы
+
+В секции `[dependencies]` поддерживаются три формата:
+
+### String (registry)
+
+```toml
+[dependencies]
+fmt = "10.1.1"
+spdlog = "^1.12"
+catch2 = ">=3.0,<4.0"
+```
+
+The version string is used as-is for registry lookup.
+
+### Табличный (git)
+
+```toml
+[dependencies]
+fmt = { git = "https://github.com/fmtlib/fmt", tag = "10.1.1" }
+```
+
+Поля: `git`, `branch`, `tag`, `rev`, `features`.
+
+### Табличный (path)
+
+```toml
+[dependencies]
+mylib = { path = "../mylib" }
+```
+
+## Registry
+
+## RegistryDCR использует реестр пакетов для поиска зависимостей по имени.```toml
+# ~/.dcr/config.toml
+[registry]
+main = { url = "https://github.com/dcr-ports/dcr-index", priority = 1 }
+```
+
+```toml
+# ~/.dcr/config.toml
+[[registry]]
+name = "default"
+url = "https://index.dcr.pm"
+```
+
+Registry priority: order in `config.toml`. Переменная `DCR_INDEX_PATH` переопределяет путь к index.json.
+
+## Git-зависимости
+
+При добавлении git-зависимости DCR клонирует репозиторий через `git2`:
+
+* `branch` — переключиться на ветку
+* `tag` — переключиться на тег
+* `rev` — переключиться на конкретный коммит
+* `features` — feature flags (parsed, but does not affect build)
+
+Cache path: `~/.dcr/git/\<hash>/`.
+
+## Path-зависимости
+
+Локальные пути. DCR автоматически находит include и lib директории.
+
+```toml
+[dependencies]
+mylib = { path = "/abs/path/to/lib" }
+mylib = { path = "../relative/path" }
+```
+
+## dcr.lock
+
+Файл блокировки зависимостей. Содержит точные версии, хеши и источники.
+
+Created during `dcr build` when registry dependencies are present. Автоматически обновляется при `dcr add`.
+
+## Процесс резолва
+
+1. Загружаются все зависимости (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. Собираются include_dirs, lib_dirs, libs для передачи компилятору

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

@@ -0,0 +1,60 @@
+---
+sidebar_label: Переменные среды
+---
+
+# Переменные среды
+
+## DCR_COMPILER
+
+Переопределяет компилятор для всех языков. **Highest priority.**
+
+```bash
+export DCR_COMPILER=clang
+dcr build
+```
+
+Compiler resolution priority:
+
+1. `DCR_COMPILER` (env)
+2. `DCR_CC` / `DCR_CXX` / `DCR_AS` (env)
+3. `[toolchain]` (dcr.toml)
+4. `build.compiler` (dcr.toml)
+5. `PATH`
+
+## DCR_CC / DCR_CXX / DCR_AS
+
+Приоритет: `[toolchain]` > `DCR_COMPILER` > `DCR_CC` > `PATH`.
+
+```bash
+export DCR_CC=gcc-14
+export DCR_CXX=g++-14
+export DCR_AS=arm-linux-gnueabihf-as
+```
+
+## DCR_LD / DCR_AR
+
+Override linker and archiver.
+
+```bash
+export DCR_LD=ld.lld
+export DCR_AR=llvm-ar
+```
+
+## DCR_DEBUG
+
+Включает режим отладки — печатает все команды компиляции перед выполнением.
+
+```bash
+export DCR_DEBUG=1
+dcr build
+```
+
+## DCR_INDEX_PATH
+
+Переопределяет путь к index.json реестра.
+
+```bash
+export DCR_INDEX_PATH=/custom/path/index.json
+```
+
+По умолчанию: `~/.dcr/index.json`.

docs-crowdin-export/ru-RU/docs/reference/platform-support.mdx.mdx

@@ -0,0 +1,51 @@
+---
+sidebar_label: Поддержка платформ
+---
+
+# Поддержка платформ
+
+## Target Triples
+
+DCR нормализует target triple через `platform_triple::normalize_triple()`. Если задано имя платформы (short name), оно раскрывается в triple.
+
+### Linux
+
+```
+target/<arch>-unknown-linux-gnu/<profile>/
+```
+
+Поддержка архитектур: `x86_64`, `aarch64`.
+
+Artifact type: ELF. Расширения: `.so` для sharedlib, `.a` для staticlib
+
+### macOS
+
+```
+target/<profile>/
+```
+
+Поддержка архитектур: `x86_64`, `aarch64`.
+
+`.dylib` для sharedlib, `.a` для staticlib
+
+### Windows
+
+```
+target/<profile>/
+```
+
+Поддержка архитектур: `x86_64`, `aarch64`.
+
+Extensions: `.exe` (bin), `.lib` (staticlib), `.dll` (sharedlib), `.efi` (UEFI).
+
+### BSD
+
+```
+target/<arch>-unknown-<os>/<profile>/
+```
+
+Поддерживаемые системы: `freebsd`, `openbsd`, `netbsd`.
+
+## Определение хоста
+
+`platform_triple::host_triple()` возвращает тройку текущей системы. Используется как fallback, если `target` не указан.

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

@@ -0,0 +1,59 @@
+---
+sidebar_label: Рабочие пространства
+---
+
+# Рабочие пространства
+
+Workspaces позволяют управлять несколькими пакетами в одном репозитории.
+
+## Конфигурация
+
+```toml
+[workspace]
+members = [
+    { path = "pkg-a" },
+    { path = "pkg-b", deps = ["pkg-a"] },
+    { path = "pkg-c", deps = ["pkg-a", "pkg-b"], main = true },
+]
+```
+
+### Поля member
+
+| Поле   | Описание                                     |
+| ------ | -------------------------------------------- |
+| `path` | Путь к пакету (относительно корня workspace) |
+| `deps` | Зависимости от других member-ов              |
+| `main` | Пометить как главный пакет                   |
+
+## Топологическая сортировка
+
+DCR автоматически сортирует пакеты по зависимостям: пакет A собирается раньше B, если B зависит от A.
+
+Циклические зависимости обнаруживаются и приводят к ошибке.
+
+## Сборка
+
+```bash
+dcr build                    # собрать все пакеты
+dcr build --workspace pkg-a  # собрать только pkg-a
+```
+
+При сборке workspace выходные файлы member-ов (библиотеки) автоматически добавляются в include/lib пути зависимых пакетов.
+
+## Очистка
+
+```bash
+dcr clean                    # очистить только корневой target/
+dcr clean --all              # очистить target/ всех пакетов
+```
+
+## Наследование
+
+Если у member-а нет своей секции `[build]`, а в корневом `[build]` указано `inherit = true`:
+
+```toml
+[build]
+inherit = true
+language = "c"
+standard = "c17"
+```

docs-crowdin-export/ru-RU/docs/self-update.mdx.mdx

@@ -0,0 +1,46 @@
+---
+sidebar_label: Автоматическое обновление
+---
+
+# Автоматическое обновление
+
+## dcr --update
+
+Автоматическое обновление до последней версии. Downloads a binary (not an archive) from GitHub Releases and replaces the current executable.
+
+```bash
+dcr --update
+```
+
+## Как это работает
+
+1. DCR определяет текущую платформу и архитектуру
+2. Fetches the latest release from `api.github.com/repos/dexoron/dcr/releases/latest`
+3. Compares versions
+4. Downloads the matching asset (direct binary URL, not archive)
+5. Заменяет текущий исполняемый файл
+
+## Asset naming
+
+Шаблон: `dcr-\<triple>.\<ext> `
+
+| Платформа      | Asset name                            |
+| -------------- | ------------------------------------- |
+| Linux x86_64   | `dcr-x86_64-unknown-linux-gnu.tar.gz` |
+| macOS x86_64   | `dcr-x86_64-apple-darwin.tar.gz`      |
+| macOS ARM64    | `dcr-aarch64-apple-darwin.tar.gz`     |
+| Windows x86_64 | `dcr-x86_64-pc-windows-msvc.zip`      |
+
+## AUR
+
+Если DCR установлен через AUR, `--update` выводит предупреждение:
+
+```
+Update via package manager: yay/paru -Syu {package_name} or sudo pacman -Syu {package_name}
+```
+
+## Ошибки
+
+* Не удалось определить платформу — ошибка
+* Не удалось скачать релиз — ошибка с URL
+* Нет прав на запись бинарника — ошибка (нужен `sudo` или ручная установка)

docs-crowdin-export/ru-RU/docs/testing/running-tests.mdx.mdx

@@ -0,0 +1,45 @@
+---
+sidebar_label: Запуск тестов
+---
+
+# Запуск тестов
+
+## Execution
+
+```bash
+dcr test
+```
+
+Builds the project, then compiles and runs test files from `tests/`.
+
+## Profiles
+
+```bash
+dcr test                     # debug (по умолчанию)
+dcr test --release           # release
+dcr test --debug             # явно debug
+```
+
+## Вывод
+
+```
+=====================
+  Testsuite summary
+=====================
+TOTAL: 5
+PASS: 3
+SKIP: 1
+FAIL: 1
+=====================
+```
+
+## Код возврата
+
+* 0 — все тесты пройдены (FAIL = 0)
+* 1 — есть упавшие тесты
+
+## What gets built
+
+* Все C/C++ файлы из `tests/`
+* Include path: `tests/` (для `dcr_test.h`)
+* Линкуется с основным проектом (если `type = "lib"`)

docs-crowdin-export/ru-RU/docs/testing/test-framework.mdx.mdx

@@ -0,0 +1,69 @@
+---
+sidebar_label: Тестовая инфраструктура (EXPECT, TEST, ...)
+---
+
+# Тестовая инфраструктура
+
+DCR имеет встроенный минималистичный фреймворк для тестирования на C/C++.
+
+## Макросы
+
+### `EXPECT(expr, ...)`
+
+Проверяет, что выражение истинно.
+
+```c
+EXPECT(1 + 1 == 2);
+EXPECT(ptr != NULL, "ptr should not be NULL");
+```
+
+### `SKIP(...)`
+
+Пропускает тест с опциональным сообщением.
+
+```c
+SKIP("not implemented on Windows yet");
+```
+
+### `TEST(name)`
+
+Определяет тест.
+
+```c
+TEST(addition) {
+    EXPECT(1 + 1 == 2);
+    EXPECT(2 + 2 == 4);
+}
+```
+
+### `TEST_CASE(name, ...)`
+
+Registers a test case.
+
+```c
+TEST_CASE(math, a, b) {
+    EXPECT(a + b == b + a);
+}
+```
+
+## Инициализация
+
+```bash
+dcr test --init
+```
+
+Создаются файлы:
+
+* `tests/dcr_test.h` — заголовочный файл фреймворка
+* `tests/test.c` — шаблон с примером теста
+
+## Структура tests/
+
+```
+tests/
+├── dcr_test.h      # фреймворк (не редактировать)
+├── test.c          # основные тесты
+└── ...             # дополнительные .c файлы с тестами
+```
+
+Only `.c` files are compiled (`.cpp` is not supported).

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

@@ -0,0 +1,63 @@
+---
+sidebar_label: Introduction
+---
+
+# DCR — C/C++ Build Tool & Package Manager
+
+<details>
+<summary>Quick reference</summary>
+
+```bash
+# Installation
+curl -fsSL https://dcr.dexoron.su/install.sh | sh
+
+# Create a project
+dcr new my-app
+cd my-app
+
+# Build and run
+dcr build
+dcr run
+
+# Run tests
+dcr test
+
+# Add a dependency
+dcr add fmt
+
+# Generate IDE files
+dcr gen vscode
+```
+
+</details>
+
+## Contents
+
+| Section                                               | Description                                   |
+| ----------------------------------------------------- | --------------------------------------------- |
+| [Getting Started](/docs/getting-started/installation) | Installation and first steps                  |
+| [Commands](/docs/commands/project-commands)           | All CLI commands                              |
+| [Reference](/docs/reference/dcr-toml)                 | Configuration, build, dependencies, platforms |
+| [Testing](/docs/testing/test-framework)               | Built-in test framework                       |
+| [Recipes](/docs/recipes/cross-to-windows)             | Common scenarios                              |
+| [IDE Integration](/docs/ide-integration)              | VS Code, CLion, compile_commands.json         |
+| [Self Update](/docs/self-update)                      | Auto-update                                   |
+| [FAQ](/docs/faq)                                      | Frequently asked questions                    |
+| [Changelog](/docs/changelog)                          | Version history                               |
+| [License](/docs/license)                              | DCR and vendored library licenses             |
+| [Contributing](/docs/contributing)                    | DCR development                               |
+
+## Features
+
+* **Incremental builds** — mtime + `.d` headers + SHA256 fingerprint
+* **Parallel compilation** — thread::scope, atomic task queue
+* **4 backends** — gcc/clang, MSVC/clang-cl, GAS (ARM), NASM (x86)
+* **7 project kinds** — bin, staticlib, sharedlib, efi, elf, none, custom
+* **Cross-compilation** — short names and full triples
+* **Profiles** — debug / release with field overrides
+* **Workspaces** — multi-package projects with topological sort
+* **Registry + Git + Path** — three dependency mechanisms
+* **IDE generation** — VS Code, CLion, compile_commands.json, JSON metadata
+* **pkg-config** — automatic system library discovery
+* **Per-command `--help`** — `dcr build --help`, `dcr new --help`, etc.
+* **Man pages** — `man dcr`, `man dcr-build`, `man dcr-new`

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

@@ -0,0 +1,91 @@
+---
+sidebar_label: Changelog
+---
+
+# Changelog
+
+## 0.7.1 (2026-06-02)
+
+### Added
+
+* **`--help` for all commands** — `dcr build --help`, `dcr run --help`, `dcr new --help`,
+  `dcr init --help`, `dcr clean --help`, `dcr add --help`, `dcr fmt --help`,
+  `dcr setup --help`, `dcr tree --help`, `dcr gen --help`, `dcr --update --help`,
+  `dcr test --help`. All output uses styled headers (green) and usage lines (cyan).
+* **Man pages** — 12 troff pages in `man/man1/`: `dcr.1`, `dcr-build.1`,
+  `dcr-run.1`, `dcr-new.1`, `dcr-init.1`, `dcr-clean.1`, `dcr-add.1`, `dcr-test.1`,
+  `dcr-gen.1`, `dcr-fmt.1`, `dcr-tree.1`, `dcr-setup.1`.
+* **Man pages in all packaging** — install.sh, install_bsd.sh, AUR PKGBUILD,
+  Debian (cargo-deb), RPM (cargo-generate-rpm), Nix (postInstall), Homebrew
+  (resource), Snap, GitHub Release assets.
+* **Project name validation** — `dcr init` and `dcr new` now validate names before
+  creating files. Only ASCII letters, digits, `_` and `-` are allowed.
+* **`documentation` and `homepage` fields** — added to `Cargo.toml`.
+* **Release profile optimizations** — `opt-level = "z"`, LTO, `codegen-units = 1`,
+  `panic = "abort"`, `strip = true` for smaller binaries.
+* **Linux i686, armv7, riscv64 targets** — added to release workflow and install scripts.
+* **Linux musl i686, armv7 targets** — cross-compiled via zigbuild in CI.
+* **AUR packages** — `dcr-dev`, `dcr-dev-bin` publishing workflow.
+* **Snap publishing** — automated Snapcraft publishing in CI.
+* **Snap badge** — in README.
+
+### Changed
+
+* **`validate_package_name` made public** — callable from CLI commands.
+* **README platform table** — reorganized: libc variants as separate OS rows,
+  removed extra columns. Linux architecture list updated.
+* **`gen.rs` no-args output** — now uses styled output instead of raw `eprintln!`.
+* **`tree.rs`, `fmt.rs`, and `setup.rs`** — now accept arguments for `--help`.
+* **README install commands** — `| bash` → `| sh` for POSIX compatibility.
+
+### Fixed
+
+* **`dcr new \<invalid-name>` creates directory then fails** — validation now
+  happens before any file operations.
+* **`dcr init` on invalid directory name** — same fix.
+* **Man pages missing in installed packages** — now shipped in all formats.
+* **Windows drive letter false positive** — in dependency file parser.
+* **CRLF (`\r\n`) breaks dependency parser** — now handles mixed line endings.
+* **Newline after backslash not consumed** — in `parse_d_file` escape handling.
+
+## 0.7.0 (2026-06-01)
+
+### Added
+
+* **OpenBSD and NetBSD target support** — full platform routing with dynamic target triples using `std::env::consts::ARCH` and `std::env::consts::OS`. Affects `build`, `run`, `clean` commands and the platform module.
+* **`src/platform/bsd.rs`** — new BSD platform module (shared by FreeBSD, OpenBSD, NetBSD) providing `bin_path`, `lib_path`, `elf_path`, `efi_path`, `shared_lib_path`.
+* **`build.out_dir` config option** — custom output directory that overrides the default `target/\<triple>/\<profile>` path for final artifacts. Supported in `build`, `run`, and config validation.
+* **`dcr fmt` command** — new CLI command that formats all C/C++ source files (`*.c`, `*.cpp`, `*.h`, `*.hpp`) in `src/` and `tests/` using `clang-format`.
+* **Incremental linking** — `needs_link()` in `common.rs` checks if any object file is newer than the linked output, skipping unnecessary relinking. Implemented for all backends (`unix_cc`, `msvc`, `gas`, `nasm`).
+* **`build.kind = "none"` and `"custom"`** — two new project kinds for special build scenarios that don't produce standard artifacts.
+* **`install_bsd.sh`** — POSIX-compliant installation script for BSD systems (FreeBSD, OpenBSD, NetBSD) with binary download and source build modes.
+* **Linux ARM64 support in `install.sh`** — added `Linux:aarch64|Linux:arm64` target detection for pre-built binary downloads.
+* **BSD OS detection in `install.sh`** — detects FreeBSD, OpenBSD, NetBSD and determines target triple.
+* **`rust-toolchain.toml`** — explicit toolchain pinning to `stable` channel.
+* **Integration tests** — `build_with_target_config` (verifies `build.target = "linux"`) and `build_with_out_dir` (validates custom output directory).
+* **`get_build_string_with_profile` made `pub`** — so `run.rs` can determine custom output directory configuration.
+
+### Changed
+
+* **`build.target` semantics changed** — now strictly contains a target triple (e.g., `x86_64-unknown-linux-gnu`) or short name (`linux`, `macos`, `windows`). No longer used as custom output directory — this functionality moved to `build.out_dir`.
+* **`build.standard` made optional** — changed from `String` to `Option\<String>`. Validation only enforces non-empty for non-ASM languages. Skipped in `dcr.toml` output if empty.
+* **`dcr run` with `out_dir`** — now determines target directory respecting `build.out_dir` via `get_build_string_with_profile()` from `build.rs`.
+* **`collect_sources()` returns empty vector** instead of error when no sources are found, allowing `kind = "none"` or `kind = "custom"` projects with no source files.
+* **CI/CD release workflow refactored** — `git2` made target-specific (no vendored-openssl on Windows), Zig-based cross-compilation for non-x86_64 Linux targets, Arch Linux package version cleanup (dashes → dots), `gmake` symlink for NetBSD.
+* **README compatibility table** — FreeBSD, OpenBSD, NetBSD build/run status upgraded from "community/best-effort" to "officially supported".
+* **Documentation updated** — `build-section.md` describes new `build.target` and `build.out_dir` fields. `target-directory.md` rewritten to clarify the distinction.
+
+### Fixed
+
+* **stdout/stderr not inherited in `dcr run`** — child process output was captured and manually printed, breaking interactive programs. Fixed by switching to `Command::status()`.
+* **Race condition in release CI** — matrix build jobs could upload assets to a release that didn't exist yet. Fixed by adding a dedicated `create-release` job.
+* **Release GHA — stable toolchain override** — fixed Rust toolchain override issues in CI.
+* **Arch Linux package version sanitization** — version strings with dashes (e.g., `0.7.0-dev`) are invalid for `pkgver`. Fixed by replacing dashes with dots.
+* **GPG permissions after Docker** — Docker operations changed GPG directory ownership. Fixed by running `chown` after Docker commands.
+* **RPM artifact paths** — RPM artifacts were placed in `rpm/x86_64/` instead of `fedora/x86_64/`. Fixed in Dexoron Packages Index workflow.
+* **JSON parsing reliability in `install.sh`** — added `jq` as primary parser with `python3` fallback for dev channel release lookup.
+
+### Removed
+
+* **`format_roots()` helper function** — removed from `common.rs`. Was only used by the old error handling path in `collect_sources()`.
+* **Per-distribution artifact download steps** — three separate `actions/download-artifact` steps replaced with unified `gh release download --clobber`.

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

@@ -0,0 +1,42 @@
+---
+sidebar_label: Build commands (build, run, clean)
+---
+
+# Build Commands
+
+## `dcr build`
+
+Builds the project according to `dcr.toml`.
+
+```bash
+dcr build                         # debug profile
+dcr build --release               # release build
+dcr build --debug                 # explicit debug
+dcr build --target aarch64-unknown-linux-gnu
+dcr build --force                 # full rebuild
+dcr build --clean                 # clean + build
+dcr build --verbose               # show compilation commands
+dcr build --workspace pkg-a       # build specific workspace package
+```
+
+Artifacts: `target/\<triple>/\<profile>/\<binary-name>` (Linux with explicit target).
+
+## `dcr run`
+
+Builds (if sources are newer than artifacts) and runs the binary.
+
+```bash
+dcr run
+dcr run --release
+```
+
+## `dcr clean`
+
+Removes `target/` directory (or `target/\<target>/\<profile>`).
+
+```bash
+dcr clean
+dcr clean --release               # target/release/ only
+dcr clean --target windows        # target/x86_64-pc-windows-msvc/
+dcr clean --all                   # clean all workspace packages
+```