Merge pull request #31 from dexoron/dev

v0.8.4

.github/workflows/ci.yml

@@ -5,10 +5,18 @@ 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
@@ -18,11 +26,129 @@ 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: Lint
+      - name: Clippy (default features)
+        run: cargo clippy --all-targets -- -D warnings
+
+      - name: Clippy (all features)
         run: cargo clippy --all-targets --all-features -- -D warnings
 
-      - name: Check
+      - name: Check (all features)
         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 --target ${{ matrix.target }}
+            cargo zigbuild --release --features archive --target ${{ matrix.target }}
           else
-            cargo build --release --target ${{ matrix.target }}
+            cargo build --release --features archive --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 --target ${{ matrix.target }}
+            cargo zigbuild --release --features archive --target ${{ matrix.target }}
           else
-            cargo build --release --target ${{ matrix.target }}
+            cargo build --release --features archive --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 --target ${{ matrix.target }}
+            cargo zigbuild --release --features archive --target ${{ matrix.target }}
           else
-            cargo build --release --target ${{ matrix.target }}
+            cargo build --release --features archive --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
+          cargo build --release --features archive
           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
+            cargo build --release --locked --features archive
           }
           package() {
             cd "\$srcdir/dcr-${PKGVER_ORIG}"
@@ -454,7 +454,7 @@ jobs:
           targets: ${{ matrix.target }}
 
       - name: Build
-        run: cargo build --release --target ${{ matrix.target }}
+        run: cargo build --release --features archive --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
+            cargo build --release --features archive
 
       - 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
+            cargo build --release --features archive
 
       - 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
+            cargo build --release --features archive
 
       - name: Prepare NetBSD Artifact
         if: matrix.system == 'netbsd'
@@ -585,7 +585,7 @@ jobs:
           targets: ${{ matrix.target }}
 
       - name: Build
-        run: cargo build --release --target ${{ matrix.target }}
+        run: cargo build --release --features archive --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
+            cargo build --release --locked --features archive
           }
 
           package() {
@@ -919,7 +919,7 @@ jobs:
             cd "\$srcdir/dcr-${PKGVER_ORIG}"
             unset CFLAGS CXXFLAGS LDFLAGS
             export RUSTFLAGS="-C linker=cc"
-            cargo build --release --locked
+            cargo build --release --locked --features archive
           }
 
           package() {

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

@@ -0,0 +1,14 @@
+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,4 +5,6 @@ sandbox/**
 .cargo/
 .env
 
-personal/
+personal/
+.*
+!.gitignore

AGENTS.md

@@ -1,56 +0,0 @@
-# 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,5 +1,231 @@
 # Changelog
 
+## [0.8.4] - 2026-08-04 "Инфраструктура .dcr/ и интеграция с IDE / Internal .dcr/ Layout & IDE Integration"
+
+### RU
+
+**Добавлено:**
+
+- **Директория `.dcr/`** — единый machine-readable источник фактов о сборке для IDE/расширений:
+  - `.dcr/compile_commands.json`
+  - `.dcr/build-info.json` (`schemaVersion`, `artifact_path`, `profile`, …)
+  - `.dcr/toolchain.json` (compiler/debugger paths, moc/uic/rcc)
+  - `.dcr/ide/` (заготовки lock-файлов для расширений)
+- **`dcr gen project-info`** — поля `target`, `target_dir`, `artifact_path`, `artifact_kind`, `source_roots`, `include_globs`, `exclude_globs`; пути абсолютные/канонические.
+- **`dcr build --print-artifact-path`** — после успешной сборки одна строка absolute path на stdout.
+- **`dcr gen … --quiet` / `-q`** — без human-лога на stdout для `compile-commands` / `project-info`.
+- **`.clangd`** — при первом `gen` создаётся с `CompilationDatabase: .dcr` (маркер `# managed by dcr gen`); ручной `.clangd` не перезаписывается.
+- **Хелперы** `canonicalize_path`, `atomic_write`, `ensure_dcr_dir`; pure `resolve_artifact_path` через `platform::*`.
+- **`dcr new` / `dcr init`** — `.dcr/` в `.gitignore`.
+
+**Изменено (breaking):**
+
+- **`compile_commands.json` перенесён** из корня проекта в **`.dcr/compile_commands.json`**.  
+  clangd находит базу через `.clangd` / `clangd.arguments --compile-commands-dir=.dcr`.  
+  CLion `misc.xml` и VSCode `settings.json` обновлены под новый путь.
+- **Атомарная запись** `compile_commands.json` (tmp + rename).
+- **`gen vscode` / `gen clion` launch/run** — `program`/`executable` через тот же artifact resolver, что `project-info` / `build-info.json` (Linux triple, Windows `.exe`, custom `target`/`filename`).
+
+**Исправлено:**
+
+- Launch-конфиги больше не указывают `target/<profile>/<name>` без triple на Linux.
+- Симлинки/mount: root и пути в compile database канонизируются best-effort.
+
+### EN
+
+**Added:**
+
+- **`.dcr/` directory** — shared machine-readable build facts for IDE integrations:
+  - `.dcr/compile_commands.json`
+  - `.dcr/build-info.json` (`schemaVersion`, `artifact_path`, `profile`, …)
+  - `.dcr/toolchain.json` (compiler/debugger paths, moc/uic/rcc)
+  - `.dcr/ide/` (placeholder for IDE lock files)
+- **`dcr gen project-info`** — `target`, `target_dir`, `artifact_path`, `artifact_kind`, `source_roots`, `include_globs`, `exclude_globs`; absolute/canonical paths.
+- **`dcr build --print-artifact-path`** — one absolute artifact path line on stdout after a successful build.
+- **`dcr gen … --quiet` / `-q`** — suppress human success logs for gen subcommands.
+- **`.clangd`** — created on first gen with `CompilationDatabase: .dcr` (`# managed by dcr gen`); custom `.clangd` is not overwritten.
+- **Helpers** `canonicalize_path`, `atomic_write`, `ensure_dcr_dir`; pure `resolve_artifact_path` via `platform::*`.
+- **`dcr new` / `dcr init`** — add `.dcr/` to `.gitignore`.
+
+**Changed (breaking):**
+
+- **`compile_commands.json` moved** from project root to **`.dcr/compile_commands.json`**.  
+  clangd discovers it via `.clangd` / `--compile-commands-dir=.dcr`.  
+  CLion and VSCode generators updated accordingly.
+- **Atomic write** for compile_commands (tmp + rename).
+- **`gen vscode` / `gen clion` launch/run** — use the same artifact path resolver as `project-info` / `build-info.json`.
+
+**Fixed:**
+
+- Launch configs no longer hardcode `target/<profile>/<name>` without the Linux triple segment.
+- Symlink/mount roots: best-effort canonicalize for root and compile database paths.
+
+## [0.8.3] - 2026-08-03 "Конфигурация host target, аргументы run и нативные пути артефактов / Host Target Config, Run Args & Native Artifact Paths"
+
+### RU
+
+**Добавлено:**
+
+- **`dcr run -- <args>...`** — cargo-style: всё после bare `--` передаётся собранному бинарнику  
+  (`dcr run --release -- --test_help`). Работает и для прямого запуска, и для `[run].cmd`.
+- **Интеграционные / unit-тесты** — host target sections применяют `ldflags` без `--target`; проброс аргументов после `--`; парсер `split_double_dash`.
+
+**Изменено:**
+
+- **Native-сборка резолвит host triple** — без `--target` / без `build.target` конфиг-секции вида  
+  `[build.x86_64-unknown-linux-gnu]` (и аналоги host) снова применяются (`cflags` / `ldflags` / toolchain).  
+  Раньше target был «пустым», секции молча игнорировались, а артефакты уже лежали под host triple — линковка без `-L`/`-l`.
+- **Пустой target** — `normalize_target_os("")` больше не warn'ит `Unknown target ''`.
+- **`dcr run --help` / man `dcr-run`** — документирован разделитель `--` и forwarding args.
+
+**Исправлено:**
+
+- **Нативные пути артефактов на Windows и macOS** — без явного `--target` / `build.target` артефакты снова сохраняются в `target/<profile>`, поэтому `dcr run` и flat-bin находят результат сборки.
+- Target-specific `ldflags` на native Linux/macOS/Windows (host triple) не доходили до линкера.
+- Ложный warning на пустой target string.
+
+### EN
+
+**Added:**
+
+- **`dcr run -- <args>...`** — cargo-style: arguments after a bare `--` are forwarded to the built binary  
+  (`dcr run --release -- --test_help`). Works for direct binary runs and `[run].cmd`.
+- **Tests** — host target sections apply `ldflags` without CLI `--target`; run-arg forwarding; `split_double_dash` unit tests.
+
+**Changed:**
+
+- **Native builds resolve the host triple** — without `--target` / without package `build.target`, host sections such as  
+  `[build.x86_64-unknown-linux-gnu]` (and host equivalents) apply again (`cflags` / `ldflags` / toolchain).  
+  Previously the target was empty, those sections were silently ignored while artifacts already used the host triple path — link failed without `-L`/`-l` (e.g. sandbox micro-lang + `libsct-elf`).
+- **Empty target** — `normalize_target_os("")` no longer warns `Unknown target ''`.
+- **`dcr run --help` / man `dcr-run`** — document `--` and argument forwarding.
+
+**Fixed:**
+
+- **Native artifact paths on Windows and macOS** — without an explicit `--target` / `build.target`, artifacts again use `target/<profile>`, so `dcr run` and flat-bin find the build output.
+- Target-specific `ldflags` on native host builds not reaching the linker.
+- Spurious warning for an empty target string.
+
+## [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
@@ -95,25 +321,31 @@
 ### RU
 
 **Добавлено:**
+
 - Учтён `target_env` в `default_target_triple()` — Linux (gnu/musl) и Windows (msvc/gnu) теперь используют правильное окружение, а не хардкод.
 
 **Исправлено:**
+
 - **Сборка на macOS Apple Silicon падала с `_main` undefined** — `--target=` теперь передаётся и в ldflags, не только в cflags. `default_target_triple()` на macOS использует `std::env::consts::ARCH` вместо хардкода `x86_64`.
 - **Бейджи GitHub Stars и GPL-3.0 не рендерились в README** — блок бейджей переведён на чистый HTML.
 
 **Изменено:**
+
 - Вычисление таргета по умолчанию вынесено в общую функцию `default_target_triple()` — устранено дублирование в build, run, clean.
 
 ### EN
 
 **Added:**
+
 - `default_target_triple()` now respects `target_env` — Linux (gnu/musl) and Windows (msvc/gnu) use the correct environment instead of hardcoded values.
 
 **Fixed:**
+
 - **macOS Apple Silicon builds failed with `_main` undefined** — `--target=` is now passed to ldflags, not just cflags. `default_target_triple()` uses `std::env::consts::ARCH` on macOS instead of hardcoded `x86_64`.
 - **GitHub Stars and GPL-3.0 badges not rendering in README** — badge block converted to pure HTML.
 
 **Changed:**
+
 - Default target resolution extracted into shared `default_target_triple()` — removed duplication across build, run, clean.
 
 ## [0.7.1] - 2026-06-02 "Мультиархитектурное расширение / The Multi-Arch Expansion"
@@ -121,6 +353,7 @@
 ### RU
 
 **Добавлено:**
+
 - Вывод `--help` для всех команд с цветным форматированием.
 - man-страницы (12 штук в `man/man1/`) и их установка во всех пакетах.
 - Валидация имен проектов в `dcr init` и `dcr new` (только ASCII буквы, цифры, `_` и `-`).
@@ -131,6 +364,7 @@
 - Пакеты AUR (`dcr-dev`, `dcr-dev-bin`) и сборка Snap в CI.
 
 **Изменено:**
+
 - Функция `validate_package_name` стала публичной.
 - Команды `gen`, `tree`, `fmt`, `setup` больше не игнорируют аргументы и используют цветной вывод.
 - Инструкция в README изменена с `| bash` на `| sh` для POSIX.
@@ -148,6 +382,7 @@
 ### EN
 
 **Added:**
+
 - `--help` for all commands with styled headers and usage lines.
 - Man pages (12 troff man pages in `man/man1/`) and their installation across all packaging formats.
 - Project name validation in `dcr init` and `dcr new` (ASCII letters, digits, `_`, `-` only).
@@ -158,6 +393,7 @@
 - AUR packages (`dcr-dev`, `dcr-dev-bin`) and Snap build in CI.
 
 **Changed:**
+
 - `validate_package_name` made public and callable from CLI commands directly.
 - `gen.rs`, `tree.rs`, `fmt.rs`, `setup.rs` no longer ignore arguments and use styled output.
 - README install instructions changed from `| bash` to `| sh` for POSIX compatibility.
@@ -334,6 +570,7 @@ Added:
   ```
 
   Produces `KERNEL.EFI` (works for `bin`, `staticlib`, and `sharedlib`).
+
 - Automatic injection of `--target=<build.target>` into compiler flags when `build.target` is set in `dcr.toml`. This greatly simplifies clang-based cross-compilation (especially for bare-metal targets like `aarch64-none-elf`).
 - Bare-metal targets (containing `none`, `-elf`, `eabi`, `baremetal`) no longer receive DCR's internal default flags (`-g`, `-Wall`, `-Wextra`, `-fno-omit-frame-pointer`, `-DDCR_DEBUG`, etc.). Prevents unwanted sections (`.comment`, debug info, etc.) that break custom linker scripts when `inherit = true`.
 - `build.ldscript` in `dcr.toml` — linker script path passed as `-T <path>` to the linker. Essential for bare-metal/embedded/freestanding targets.
@@ -368,28 +605,28 @@ Fixed:
 
 - Path dependencies now work correctly: `dcr add` stores them as `{ path =
 "./..." }` tables, `is_registry_dep` properly distinguishes registry strings
-from path/git strings, and `deps/mod.rs` resolves both table-form and
+  from path/git strings, and `deps/mod.rs` resolves both table-form and
-legacy string-form path dependencies
+  legacy string-form path dependencies
 - Registry dependency paths no longer hardcoded to `project_root/dcr-index`;
-now use `package_root_from_registry_info()` which resolves relative to the
+  now use `package_root_from_registry_info()` which resolves relative to the
-registry cache root (`~/.dcr/`)
+  registry cache root (`~/.dcr/`)
 - Registry dependencies are now actually built: `build_project_at()` is
-called when `include_dir` or `lib_dir` is missing
+  called when `include_dir` or `lib_dir` is missing
 
 Added:
 
 - `SIGINT`/`Ctrl+C` handler via `ctrlc` crate — `dcr build` now checks
-`BUILD_INTERRUPTED` flag at key points and aborts cleanly
+  `BUILD_INTERRUPTED` flag at key points and aborts cleanly
 - `utils/build.rs` — extracted shared utilities: `parse_version_info`,
-`normalize_target_os`, `resolve_compiler`, `primary_language`,
+  `normalize_target_os`, `resolve_compiler`, `primary_language`,
-`resolve_pkg_config_flags` and config helpers. Eliminates code duplication
+  `resolve_pkg_config_flags` and config helpers. Eliminates code duplication
-between `cli/build.rs`, `cli/run.rs`, `cli/clean.rs`, `cli/gen.rs`
+  between `cli/build.rs`, `cli/run.rs`, `cli/clean.rs`, `cli/gen.rs`
 - `utils/fs.rs::with_dir` — extracted common directory-scoped execution
 - `run_command_sync_output` in `builder/common.rs` with global `OUTPUT_MUTEX`
-— synchronized compiler output across all backends (unix_cc, gas, nasm, msvc)
+  — synchronized compiler output across all backends (unix_cc, gas, nasm, msvc)
 - New helper functions in `deps/register.rs`: `get_registry_cache_root`,
-`package_root_from_registry_info`, `registry_include_dir`, `registry_lib_dir`,
+  `package_root_from_registry_info`, `registry_include_dir`, `registry_lib_dir`,
-`path_from_string_dep`
+  `path_from_string_dep`
 - Unit tests for `register.rs` (`is_registry_dep`, `package_root_from_registry_info`),
   `deps/mod.rs` (`path_dep_path`, `push_default_lib_dirs`),
   `utils/build.rs` (`normalize_target_os`, `parse_version_info`)

Cargo.lock

@@ -2,18 +2,39 @@
 # 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"
@@ -38,6 +59,28 @@ 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"
@@ -50,6 +93,19 @@ 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"
@@ -98,15 +154,17 @@ dependencies = [
 
 [[package]]
 name = "dcr"
-version = "0.7.4"
+version = "0.8.4"
 dependencies = [
  "ctrlc",
+ "fatfs",
  "glob",
  "self-replace",
  "serde",
  "serde_json",
  "sha2",
  "toml",
+ "toml_edit",
  "ureq",
 ]
 
@@ -126,7 +184,7 @@ version = "0.3.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1e0e367e4e7da84520dedcac1901e4da967309406d1e51017ae1abfb97adbd38"
 dependencies = [
- "bitflags",
+ "bitflags 2.11.1",
  "block2",
  "libc",
  "objc2",
@@ -165,6 +223,24 @@ 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"
@@ -180,6 +256,30 @@ 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"
@@ -230,6 +330,30 @@ 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"
@@ -357,6 +481,17 @@ 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"
@@ -399,12 +534,21 @@ version = "0.31.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "cf20d2fde8ff38632c426f1165ed7436270b44f199fc55284c38276f9db47c3d"
 dependencies = [
- "bitflags",
+ "bitflags 2.11.1",
  "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"
@@ -438,6 +582,12 @@ 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"
@@ -487,7 +637,7 @@ version = "1.1.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b6fe4565b9518b83ef4f91bb47ce29620ca828bd32cb7e408f0062e9930ba190"
 dependencies = [
- "bitflags",
+ "bitflags 2.11.1",
  "errno",
  "libc",
  "linux-raw-sys",
@@ -525,6 +675,12 @@ 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"
@@ -540,7 +696,7 @@ version = "2.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "897b2245f0b511c87893af39b033e5ca9cce68824c4d7e7630b5a1d339658d02"
 dependencies = [
- "bitflags",
+ "bitflags 2.11.1",
  "core-foundation",
  "core-foundation-sys",
  "libc",
@@ -637,6 +793,18 @@ 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"
@@ -703,12 +871,18 @@ dependencies = [
  "indexmap",
  "serde_core",
  "serde_spanned",
- "toml_datetime",
+ "toml_datetime 1.1.1+spec-1.1.0",
  "toml_parser",
  "toml_writer",
- "winnow",
+ "winnow 1.0.3",
 ]
 
+[[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"
@@ -718,15 +892,33 @@ 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",
+ "winnow 1.0.3",
 ]
 
+[[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"
@@ -808,6 +1000,51 @@ 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"
@@ -836,18 +1073,71 @@ version = "0.244.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "47b807c72e1bac69382b3a6fb3dbe8ea4c0ed87ff5629b8685ae6b9a611028fe"
 dependencies = [
- "bitflags",
+ "bitflags 2.11.1",
  "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"
@@ -930,6 +1220,15 @@ 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"
@@ -1000,7 +1299,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9d66ea20e9553b30172b5e831994e35fbde2d165325bec84fc43dbf6f4eb9cb2"
 dependencies = [
  "anyhow",
- "bitflags",
+ "bitflags 2.11.1",
  "indexmap",
  "log",
  "serde",

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "dcr"
-version = "0.7.4"
+version = "0.8.4"
 edition = "2024"
 build = "build.rs"
 description = "DCR is a utility for managing C/C++ projects in a Cargo-like style."
@@ -59,6 +59,10 @@ 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"] }
@@ -66,8 +70,10 @@ 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,32 +34,6 @@
 
 <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>
 
@@ -103,21 +77,28 @@ cargo install dcr
 </td>
 </tr>
 <tr>
-<td><b>Linux / macOS (script)</b></td>
+<td><b>dcrup (Linux / macOS / BSD / Windows(Bash))</b></td>
 <td>
 
 ```sh
-curl -fsSL https://dcr.dexoron.su/install.sh | sh
+curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
+export PATH="$HOME/.dcr/bin:$PATH"
+dcrup install stable
 ```
 
 </td>
 </tr>
 <tr>
-<td><b>BSD (script)</b></td>
+<td><b>dcrup (Windows PowerShell)</b></td>
 <td>
 
-```sh
+```powershell
-curl -fsSL https://dcr.dexoron.su/install_bsd.sh | sh
+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
 ```
 
 </td>
@@ -133,16 +114,6 @@ curl -fsSL https://dcr.dexoron.su/install_bsd.sh | sh
 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>
@@ -151,7 +122,7 @@ irm https://dcr.dexoron.su/install.ps1 | iex
 
 ```sh
 git clone https://github.com/dexoron/dcr.git
-cd dcr && cargo build --release
+cd dcr && cargo build --release --features archive
 ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
 ```
 

TODO.md

@@ -1,65 +0,0 @@
-# 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

@@ -0,0 +1,13 @@
+@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

@@ -0,0 +1,367 @@
+#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

@@ -0,0 +1,599 @@
+#!/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

@@ -1,67 +0,0 @@
----
-sidebar_label: Introduction
----
-
-# DCR — C/C++ Build Tool & Package Manager
-
-<details>
-<summary>Quick reference</summary>
-
-```bash
-# Installation (dcrup)
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
-export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable                 # auto: cf → gh → sf → ya
-# dcrup install stable --mirror cf   # CloudFlare / GitHub / SourceForge / Yandex
-
-# 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
-* **7 backends** — gcc/clang (unix_cc), MSVC/clang-cl (msvc), GAS, NASM, MASM, FASM, LLVM IR
-* **8 project kinds** — bin, staticlib, sharedlib, efi, elf, none, custom, flat-bin
-* **Disk images** — optional `[archive]` packs FAT12/16/32 images after build
-* **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

@@ -1,287 +0,0 @@
----
-sidebar_label: Changelog
----
-
-# Changelog
-
-## 0.9.1 (2026-09-13)
-
-* **`pkg-config` dependencies** — declare `fmt = { pkg-config = "fmt" }` or multiple package names in `[dependencies]`; DCR applies `.pc` compiler/linker flags and records the resolved package in `dcr.lock`.
-* **`dcr add` support for `pkg-config`** — easily add system package dependencies with `dcr add fmt pkg-config:fmt` or `dcr add openssl pkg:openssl,libcrypto`.
-* **`dcr tree` & IDE integration** — `pkg-config` packages are marked in `dcr tree` and resolved into compiler flags in `dcr gen` (`compile_commands.json`).
-* **Fixed `dcr new` in non-ASCII / spaced paths** — initializing projects from folders with non-ASCII characters or spaces no longer fails validation.
-
-## 0.9.0 (2026-08-31)
-
-* **Download mirrors in `dcrup`** — `--mirror auto|cf|gh|sf|ya` and `DCRUP_MIRROR`.
-  Default `auto` tries **cf → gh → sf → ya** (CloudFlare CDN, GitHub, SourceForge, Yandex CDN).
-* **Complete Path/Git dependencies** — DCR packages from `path` and `git` are built before their consumer. Git sources are cached in `~/.dcr/git`, support `branch`/`tag`/`rev`, and record the exact commit in `dcr.lock`.
-* **Build and prebuild modes** — `path` and `git` dependencies can build a DCR package from `dcr.toml` or link existing `include`/`lib`/`libs` artifacts; `mode = "build"` / `"prebuild"` selects explicitly when both forms are present.
-* **Prebuilt dependency examples** — documentation now shows the `dcr-math-lib` Git repository and recommended build/prebuilt layouts for both `git` and `path`.
-* **Transitive dependency builds and cycle reporting** — DCR recursively builds DCR packages and reports a clear dependency chain for cycles.
-* **Bare path arguments for `dcr add`** — `dcr add mylib ../mylib` now works in addition to the explicit `path:` form.
-* **Removed `install.sh` / `install.ps1` / `install_bsd.sh`** — superseded by `dcrup`.
-
-## 0.8.5 (2026-08-08)
-
-* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
-  `dcr new` / `dcr init` write the current version. On config load:
-  * missing / empty pin → warn "add dcr-version";
-  * dcr older than pin → warn "update dcr";
-  * dcr newer than pin → warn "check changelog, update pin";
-  * equal → silent.
-    Commands do not fail, warning only (once per path per process).
-
-## 0.8.4 (2026-08-04)
-
-**Added:**
-
-* **`.dcr/` directory** — shared machine-readable build facts for IDE integrations:
-  * `.dcr/compile_commands.json`
-  * `.dcr/build-info.json` (`schemaVersion`, `artifact_path`, `profile`, …)
-  * `.dcr/toolchain.json` (compiler/debugger paths, moc/uic/rcc)
-  * `.dcr/ide/` (placeholder for IDE lock files)
-* **`dcr gen project-info`** — `target`, `target_dir`, `artifact_path`, `artifact_kind`, `source_roots`, `include_globs`, `exclude_globs`; absolute/canonical paths.
-* **`dcr build --print-artifact-path`** — one absolute artifact path line on stdout after a successful build.
-* **`dcr gen … --quiet` / `-q`** — suppress human success logs for gen subcommands.
-* **`.clangd`** — created on first gen with `CompilationDatabase: .dcr` (`# managed by dcr gen`); custom `.clangd` is not overwritten.
-* **Helpers** `canonicalize_path`, `atomic_write`, `ensure_dcr_dir`; pure `resolve_artifact_path` via `platform::*`.
-* **`dcr new` / `dcr init`** — add `.dcr/` to `.gitignore`.
-
-**Changed (breaking):**
-
-* **`compile_commands.json` moved** from project root to **`.dcr/compile_commands.json`**.\
-  clangd discovers it via `.clangd` / `--compile-commands-dir=.dcr`.\
-  CLion and VSCode generators updated accordingly.
-* **Atomic write** for compile_commands (tmp + rename).
-* **`gen vscode` / `gen clion` launch/run** — use the same artifact path resolver as `project-info` / `build-info.json`.
-
-**Fixed:**
-
-* Launch configs no longer hardcode `target/\<profile>/\<name>` without the Linux triple segment.
-* Symlink/mount roots: best-effort canonicalize for root and compile database paths.
-
-## 0.8.3 (2026-08-03)
-
-### Added
-
-* **`dcr run -- \<args>...`** — cargo-style argument forwarding after a bare `--`\
-  (`dcr run --release -- --test_help`). Applies to direct binary runs and `[run].cmd`.
-* **Tests** — host target section `ldflags` without CLI `--target`; run-arg forwarding; `split_double_dash` unit tests.
-
-### Changed
-
-* **Native builds resolve the host triple** — without `--target` / package `build.target`, host sections such as\
-  `[build.x86_64-unknown-linux-gnu]` apply again (`cflags` / `ldflags` / toolchain).\
-  Previously the target was empty and those sections were ignored while artifacts already used the host triple path.
-* **Empty target** — no more `Unknown target ''` warning.
-* **`dcr run --help` / man `dcr-run`** — document `--` forwarding.
-
-### Fixed
-
-* **Native artifact paths on Windows and macOS** — without an explicit `--target` / `build.target`, artifacts use `target/\<profile>`, so `dcr run` and flat-bin find the build output.
-* Target-specific `ldflags` missing on native host builds (e.g. micro-lang + `libsct-elf`).
-* Spurious empty-target warning.
-
-## 0.8.2 (2026-07-22)
-
-### Added
-
-* **Compile progress `[N/M]`** — live TTY status line (`compile  pkg v0.1.0  [12/41]`) so long mono-package builds do not look hung.
-* **DCR status style** — fixed-width verbs: `project`, `compile`, `dep`, `ready`, `pack`, `done`, `run`.
-* **Cargo feature `archive`** — optional FAT packing via `fatfs` (`cargo build --features archive`). Release CI builds with the feature; without it `[archive]` fails with a clear message.
-* **Tests** — `flat_bin_nasm_build`, package `build.target` without CLI `--target`, stricter workspace `clean --all`.
-* **CI expansion** — unit + integration on Linux/macOS/Windows, archive feature job, rust-cache, clippy default + all-features (see `.github/workflows/ci.yml`).
-
-### Changed
-
-* **No forced host triple from CLI** — without `--target`, package/member `build.target` is honored (bare-metal / ISO `post_steps` paths).
-* **Relative include/lib flags** (`-I`, `-i`, `-isystem`, `-idirafter`, `-L`, `-T`) absolutized against the package root under workspace builds.
-* **`dcr clean --all`** — no spam for members without a local `target/` (shared root `target/`).
-* **`error` / `warn`** — red / yellow on stderr; CLI fully English (`Hint:`).
-* **Help / man** — list `add`, `lint`, `setup`; unknown command exits with code 1.
-* **Tool NotFound** — `linker not found: ld.lld …` / `{tool} not found …` instead of raw `os error 2`.
-
-## 0.8.1 (2026-07-20)
-
-### Added
-
-* **`build.kind = "flat-bin"`** — raw binary (default `.bin`) for OS-dev payloads:
-  * **NASM** — `-f bin` → `\<stem>.bin`
-  * **FASM** — direct output (`format binary` in source)
-  * **GAS / MASM / LLC** — object → `objcopy -O binary` → `\<stem>.bin`
-  * **C/C++** — objects → freestanding link → `objcopy -O binary` → `\<name>.bin`
-  * Requires `llvm-objcopy` / `objcopy` / `gobjcopy` except for NASM/FASM direct emit
-* **`[archive]` section** — FAT12/16/32 disk images after build (`output`, `format`, `size`, `offset`, `label`, `bootsector`, `layout`). From 0.8.2 requires feature `archive`.
-* **Single-file `build.roots`** — a root may be a single source or header file, not only a directory.
-
-### Changed
-
-* **`--force`** also re-runs `build.steps` and `build.post_steps`.
-* **`dcr run` on workspace-only root** — if `[run].cmd` is set, run that after build; otherwise delegate to a workspace member.
-
-## 0.8.0 (2026-07-18)
-
-### 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.cxx]`, `[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)
-
-### Added
-
-* **Native Qt support** — automatic meta-object handling (MOC, UIC, RCC) added when `build.qt = true` is set in `dcr.toml`.
-* **`dcr lint` command** — C/C++ static analysis via `clang-tidy`. Supports `--fix` for automatic fixes. Respects `build.roots` and `build.src_disable` from config.
-* **Three new assembler backends**:
-  * **MASM** (`compiler = "ml"` / `"ml64"`) — Microsoft Macro Assembler.
-  * **FASM** (`compiler = "fasm"`) — Flat Assembler.
-  * **LLVM IR** (`compiler = "llc"`) — compiles `.ll` files via `llc -filetype=obj`.
-* **Shared ASM pipeline** — linking and archiving logic consolidated into `core/builder/asm.rs`. Adding a new assembler backend now takes ~30 lines.
-* **Filesystem utilities** — `to_hex()` and `home_dir()` extracted to `utils/fs.rs`.
-* **Build utilities** — `normalize_target()`, `normalize_kind()`, `normalize_platform()`, `default_profile_flags()` extracted to `utils/build.rs`.
-* **Backend helpers** — `asm_lang_flag()`, `source_extensions()`, `elapsed_secs()` added to `core/builder/common.rs`.
-* **Full Bare-Metal / Freestanding Automation** — introduced the `build.freestanding = true` configuration option. When enabled (or when a bare-metal target is detected), DCR automatically injects `-ffreestanding` during compilation and both `-nostdlib` and `-static` during linking.
-* **Artifact Optimization (LTO & Strip)** — added `build.lto` (auto-injects `-flto` for compiler and linker) and `build.strip` (automatically strips debug symbols via linker `-s` flag) options to `dcr.toml`.
-* **Compilation Thread Control** — added the `build.codegen-units` option to strictly limit the maximum number of parallel jobs utilized by the custom `parallel_build` worker pool.
-* **Panic Behavior Management** — added `build.panic = "abort"` support. For C++ targets, it automatically strips exception handling and unwind tables via `-fno-exceptions`, `-fno-unwind-tables`, and `-fno-asynchronous-unwind-tables`.
-
-### Changed
-
-* **Intelligent Default Flags Generation** — automated injection of fallback optimization (`-O3`/`-O0`), debug (`-g`), and warning (`-Wall -Wextra`) flags is now suppressed for bare-metal and freestanding builds if `build.cflags` are overridden.
-* **Centralized Bare-Metal Detection** — relocated the `is_bare_metal_target` helper to common build utilities (`src/utils/build.rs`) for unified access across the building core.
-* **Architectural Refactoring**:
-  * Renamed `src/config.rs` to `src/templates.rs`.
-  * Started consolidation of configuration and build orchestration logic.
-
-## 0.7.3 (2026-06-13)
-
-### Added
-
-* **`--vcs` option for `new` and `init` commands** — introduced explicit version control system selection via `--vcs \<git|none>`.
-* **Git metadata integration in `--version`** — the CLI now appends the current short commit hash and a `-dirty` suffix if there are uncommitted changes in the DCR repository.
-* **Automatic `.gitignore` generation** — Git repository initialization now automatically writes a `.gitignore` file excluding the `/target` directory.
-* **Nested repository prevention** — automatic Git initialization is now skipped if `dcr new` or `dcr init` is executed inside an already existing Git repository.
-* **VCS verification tests** — added `new_vcs_options_work` and `init_vcs_options_work` integration tests to ensure reliable repository behavior.
-
-### Changed
-
-* **Complete removal of `git2` dependency** — all Git actions (dependency fetching, VCS setup, status checks) are now delegated to the system `git` executable via `Command`. This simplifies compilation and drops the need for `vendored` and `openssl` features.
-* **Migrated from `reqwest` to `ureq`** — replaced the heavy `reqwest` crate in `flag_update.rs` with the lightweight synchronous `ureq 2.10` client, reducing overhead and the final binary size.
-
-## 0.7.2 (2026-06-07)
-
-### Added
-
-* `default_target_triple()` now respects `target_env` — Linux (gnu/musl) and Windows (msvc/gnu) use the correct environment instead of hardcoded values.
-
-### Fixed
-
-* **macOS Apple Silicon builds failed with `_main` undefined** — `--target=` is now passed to ldflags, not just cflags. `default_target_triple()` uses `std::env::consts::ARCH` on macOS instead of hardcoded `x86_64`.
-* **GitHub Stars and GPL-3.0 badges not rendering in README** — badge block converted to pure HTML.
-
-### Changed
-
-* Default target resolution extracted into shared `default_target_triple()` — removed duplication across build, run, clean.
-
-## 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

@@ -1,47 +0,0 @@
----
-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 (also re-runs build.steps / post_steps)
-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).
-
-With `[archive]` in `dcr.toml`, a FAT disk image is packed after a successful build.
-
-## `dcr run`
-
-Builds (if sources are newer than artifacts) and runs the binary.
-
-```bash
-dcr run
-dcr run --release
-dcr run --force                   # force rebuild then run
-```
-
-On a **workspace-only** root: if `[run].cmd` is set, that command is used after build; otherwise DCR delegates to a workspace member.
-
-## `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

@@ -1,61 +0,0 @@
----
-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
-dcr add fmt pkg-config:fmt     # system package via pkg-config
-dcr add openssl pkg:openssl,libcrypto # multiple pkg-config packages
-```
-
-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>`
-* `pkg-config:` / `pkg:` — one or more packages resolved by `pkg-config`
-* `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. A bare relative or absolute path is accepted as a path dependency.
-
-For `pkg-config` dependencies, the referenced packages must already be installed
-and provide `.pc` files. DCR invokes `pkg-config` during the build (using
-`PATH` and `PKG_CONFIG_PATH`) and forwards the returned compiler and linker
-flags; it does not download or build these packages.
-
-## `dcr tree`
-
-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

@@ -1,73 +0,0 @@
----
-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

@@ -1,40 +0,0 @@
----
-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
-dcr new my-app --vcs none
-```
-
-Flags:
-
-* `--vcs \<git|none>` — Initialize version control system (defaults to `git` if available, or `none`).
-
-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
-dcr init
-dcr init --vcs none
-```
-
-Flags:
-
-* `--vcs \<git|none>` — Initialize version control system (defaults to `git` if available, or `none`).
-
-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

@@ -1,60 +0,0 @@
----
-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

@@ -1,51 +0,0 @@
----
-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.default]
-url = "https://index.dcr.pm"
-priority = 1
-```
-
-## `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

@@ -1,53 +0,0 @@
----
-sidebar_label: Contributing
----
-
-# Contributing
-
-## Setup
-
-```bash
-git clone https://github.com/dexoron/dcr
-# or a source mirror: GitVerse / SourceCraft / SourceForge / GitLab (see README)
-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 (see `.github/workflows/ci.yml`):
-
-* `cargo fmt --check`
-* `cargo clippy` (default + `--all-features`)
-* `cargo check --all-targets --all-features`
-* Unit + integration tests on Linux, macOS, Windows
-* Extra Linux job with `--features archive` (FAT images)
-* Tools on runners: clang, nasm, clang-format/tidy (Linux)

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

@@ -1,75 +0,0 @@
----
-sidebar_label: FAQ
----
-
-# FAQ
-
-## Registry not found
-
-```
-error: registry not found
-```
-
-**Solution:** Make sure `~/.dcr/config.toml` exists:
-
-```toml
-[registry.default]
-url = "https://index.dcr.pm"
-priority = 1
-```
-
-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`.
-
-## 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).
-
-## Bootloader / pure NASM OS image
-
-Use `kind = "flat-bin"` (NASM `-f bin`) and optional `[archive]` for a FAT disk image.
-
-See [OS-dev recipe](/docs/recipes/os-flat-bin-archive).
-
-## How do I choose a download mirror?
-
-`dcrup install` uses `--mirror auto` by default and tries **cf → gh → sf → ya**.
-
-```bash
-dcrup install stable --mirror cf
-export DCRUP_MIRROR=ya
-```
-
-## Lock file
-
-`dcr.lock` is created during builds (`dcr build`) when registry dependencies are present. To force an update — delete `dcr.lock` and run `dcr build`.

docs-crowdin-export/de-DE/docs/getting-started/first-steps.mdx.mdx

@@ -1,79 +0,0 @@
----
-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
-```
-
-## Linting
-
-```bash
-dcr lint             # clang-tidy checks
-dcr lint --fix       # apply fixes automatically
-```

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

@@ -1,153 +0,0 @@
----
-sidebar_label: Installation
----
-
-# Installation
-
-## dcrup (recommended)
-
-Install and switch DCR versions (stable / dev / night, pin `0.8.2`, optional build from source).
-
-### Linux / macOS / BSD / Windows (bash)
-
-```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
-export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable
-```
-
-Non-interactive install of DCR in one shot:
-
-```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- install stable
-export PATH="$HOME/.dcr/bin:$PATH"
-```
-
-### Windows (PowerShell)
-
-```powershell
-irm https://ps1.dcr-tool.ru | iex
-# or download then run:
-# irm https://ps1.dcr-tool.ru -OutFile dcrup.ps1
-# powershell -File .\dcrup.ps1 self-install
-# $env:Path += ";$env:USERPROFILE\.dcr\bin"
-dcrup install stable
-```
-
-Optional cmd bootstrap (if you prefer `curl` of the cmd shim):
-
-```bat
-curl -fsSL -o dcrup.cmd https://cmd.dcr-tool.ru
-```
-
-After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows `dcrup.cmd`).
-
-### Common dcrup commands
-
-```sh
-dcrup install stable              # latest stable prebuilt (auto: cf → gh → sf → ya)
-dcrup install 0.8.2               # pin → 0.8.2@stable
-dcrup install 0.8.2@dev
-dcrup install stable --libc musl  # Linux: musl asset (default: gnu)
-dcrup install stable --mirror cf  # CloudFlare CDN
-dcrup install stable --mirror ya  # Yandex CDN (RU fallback)
-dcrup install stable --build      # cargo build --features archive
-dcrup install night               # always build from branch dev HEAD
-dcrup default 0.8.2
-dcrup update
-dcrup list
-dcrup show
-dcrup which
-```
-
-Layout: `~/.dcr/toolchains/\<id>/dcr` and `~/.dcr/bin/dcr` → active version.
-
-### Download mirrors
-
-Prebuilt installs try **cf → gh → sf → ya** unless you pin a host.
-
-| Code | URL                                                                                                          | Notes                      |
-| ---- | ------------------------------------------------------------------------------------------------------------ | -------------------------- |
-| `cf` | `https://cdn-global.dcr-tool.ru/\<tag>/\<asset>`                           | CloudFlare CDN (worldwide) |
-| `gh` | `https://github.com/dexoron/dcr/releases/download/\<tag>/\<asset>`         | GitHub Releases            |
-| `sf` | `https://sourceforge.net/projects/dcr-tool/files/\<tag>/\<asset>/download` | SourceForge                |
-| `ya` | `https://cdn-ru.dcr-tool.ru/\<tag>/\<asset>`                               | Yandex CDN (RU fallback)   |
-
-```sh
-dcrup install stable --mirror auto   # default
-export DCRUP_MIRROR=cf               # persist for this shell
-```
-
----
-
-## Arch Linux (AUR)
-
-```sh
-yay -S dcr
-```
-
-## macOS / Linux (Homebrew)
-
-```sh
-brew tap dexoron/dexoron
-brew install dcr
-```
-
-## Snap (Linux)
-
-```sh
-sudo snap install dcrup
-```
-
-> If classic Snap Store publishing is unavailable, install the `.snap` from [GitHub Releases](https://github.com/dexoron/dcr/releases/latest) with `--dangerous`.
-
-## Nix (flake)
-
-```sh
-nix run github:dexoron/dcr
-nix profile install github:dexoron/dcr
-```
-
-## Cargo (crates.io)
-
-```sh
-cargo install dcr
-```
-
-Note: crates.io builds may omit optional features. For FAT disk images (`[archive]`), prefer release binaries or:
-
-```sh
-cargo install dcr --features archive
-```
-
-## From source
-
-```sh
-git clone https://github.com/dexoron/dcr.git
-cd dcr
-cargo build --release --features archive
-ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
-# or manage versions with dcrup install night / --build
-```
-
-## Post-install
-
-```bash
-dcr --version
-dcrup show    # if installed via dcrup
-```
-
-Man pages (package installs / release assets):
-
-```bash
-man dcr
-man dcr-build
-```
-
-Registry (optional) — `~/.dcr/config.toml`:
-
-```toml
-[registry.default]
-url = "https://index.dcr.pm"
-priority = 1
-```

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

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

@@ -1,33 +0,0 @@
----
-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.
-
-## Rust dependencies
-
-DCR is written in Rust. The following notable Rust crates are statically linked:
-
-| Crate                                                   | License           |
-| ------------------------------------------------------- | ----------------- |
-| [`ureq`](https://crates.io/crates/ureq)                 | MIT OR Apache-2.0 |
-| [`serde`](https://crates.io/crates/serde)               | MIT OR Apache-2.0 |
-| [`toml`](https://crates.io/crates/toml)                 | MIT OR Apache-2.0 |
-| [`toml_edit`](https://crates.io/crates/toml_edit)       | MIT OR Apache-2.0 |
-| [`serde_json`](https://crates.io/crates/serde_json)     | MIT OR Apache-2.0 |
-| [`sha2`](https://crates.io/crates/sha2)                 | MIT OR Apache-2.0 |
-| [`glob`](https://crates.io/crates/glob)                 | MIT OR Apache-2.0 |
-| [`self-replace`](https://crates.io/crates/self-replace) | MIT OR Apache-2.0 |
-| [`ctrlc`](https://crates.io/crates/ctrlc)               | MIT OR Apache-2.0 |
-
-Full dependency tree 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

@@ -1,49 +0,0 @@
----
-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

@@ -1,70 +0,0 @@
----
-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

@@ -1,103 +0,0 @@
----
-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_only = true
-
-[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

@@ -1,82 +0,0 @@
----
-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

@@ -1,136 +0,0 @@
----
-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; **`bin` when `kind = "flat-bin"`**)
-* 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>`                    |
-| `flat-bin`  | Raw binary                      | ASM: `\<stem>.bin` (NASM `-f bin` / FASM / GAS·MASM·LLC via objcopy); C/C++: `\<name>.bin` (link + objcopy) |
-
-## Disk images (`[archive]`)
-
-After a successful build, if `[archive]` is present in `dcr.toml`, DCR formats a FAT volume and copies files from `layout` into the image. See [dcr.toml → archive](/docs/reference/dcr-toml#archive).
-
-## 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

@@ -1,64 +0,0 @@
----
-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
-
-By default, the compilation output directories are structured as follows:
-
-* **Linux and BSD**: Always output to `target/\<triple>/\<profile>/` (using host triple if no target is specified).
-* **macOS and Windows (without target)**: Output to `target/\<profile>/`.
-* **macOS and Windows (with explicit target)**: Output to `target/\<triple>/\<profile>/`.

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

@@ -1,284 +0,0 @@
----
-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
-
-[archive]
-# optional: pack FAT disk image after build
-```
-
-## [package]
-
-| Field         | Required | Description                                                                                                     |
-| ------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `name`        | yes      | Project name                                                                                                    |
-| `version`     | yes      | Semantic version of the **project**                                                                             |
-| `dcr-version` | no       | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `type`        | no       | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `license`     | no       | SPDX license identifier                                                                                         |
-| `author`      | no       | Author                                                                                                          |
-
-```toml
-[package]
-name = "my-app"
-version = "0.1.0"
-dcr-version = "0.8.4"
-type = "app"
-license = "MIT"
-author = "John Doe"
-```
-
-### `package.dcr-version`
-
-Optional pin of the DCR CLI the project was written for. On every `dcr.toml` load:
-
-| Situation                      | Behaviour                                                  |
-| ------------------------------ | ---------------------------------------------------------- |
-| Field missing / empty          | Warning: add `dcr-version` (set by `dcr new` / `dcr init`) |
-| Running dcr **older** than pin | Warning: upgrade dcr (`dcr --update`)                      |
-| Running dcr **newer** than pin | Warning: review changelog, bump the pin when ready         |
-| Equal                          | Silent                                                     |
-| Invalid semver                 | Warning once, field ignored                                |
-
-Never fails the command — warnings only. Pre-release suffixes (`1.0.0-dev`) are ignored for comparison (`1.0.0-dev` ≡ `1.0.0`).
-
-## [build]
-
-...
-
-* `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"`, `"llvm_ir"`, `"llvm-ir"`, `"ll"` (optional, defaults to `"c"`) |
-| `standard`       | `"c11"`       | C standard (`c11`, `c17`, `c23`)                                                                          |
-| `cxx_standard`   | —             | C++ standard (`c++17`, `c++20`, `c++23`)                                                                  |
-| `compiler`       | `"clang"`     | Preferred compiler (optional, defaults to `"clang"`)                                                      |
-| `kind`           | `"bin"`       | `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, `custom`, `flat-bin`                               |
-| `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 (for `flat-bin`, default is `bin`)                                                  |
-| `roots`          | `["src"]`     | Source roots: directories and/or individual source/header files                                           |
-| `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 (no `language`/`compiler` required)                                  |
-| `freestanding`   | `false`       | Compile in freestanding mode (`-ffreestanding` + `-nostdlib -static`)                                     |
-| `opt_level`      | —             | Optimization level: `0`-`3`, `"s"`, `"z"` (derived from profile if omitted)                               |
-| `debug`          | profile-based | Emit debug symbols (`-g`): `true` in debug, `false` in release                                            |
-| `lto`            | `false`       | Link-time optimization (`-flto` for both compiler and linker)                                             |
-| `strip`          | `false`       | Strip symbols from output (`-s` in ldflags)                                                               |
-| `warnings`       | `[]`          | Warning flags (e.g. `"all"`, `"extra"`, `"pedantic"`); engine adds `-Wall -Wextra` in debug if empty      |
-| `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 packages queried for build-wide compiler/linker flags
-
-Dependencies can also declare a system package directly, for example
-`fmt = { pkg-config = "fmt" }`. This records the package in `dcr.lock` and applies
-the flags returned by `pkg-config --cflags` and `pkg-config --libs`.
-
-* `ldscript` — linker script path
-* `build.steps` / `build.post_steps` — codegen steps
-
-## Per-language overrides: `[build.c]`, `[build.cxx]`, `[build.asm]`, `[build.llvm_ir]`
-
-Each language can have its own table that overrides the flat `[build]` settings:
-
-```toml
-[build]
-compiler = "clang"
-standard = "c11"
-
-[build.c]
-standard = "c23"
-compiler = "gcc"
-
-[build.cxx]
-standard = "c++23"
-compiler = "g++"
-
-[build.asm]
-compiler = "nasm"
-flags = ["-felf64"]
-
-[build.llvm_ir]
-compiler = "llc"
-```
-
-The flat `[build]` acts as fallback; per-language tables take precedence for their language.
-
-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).
-
-## [archive]
-
-Optional post-build step: format a FAT volume and copy built artifacts into a disk image. Runs after a successful package build (and after workspace member builds that define `[archive]`).
-
-Requires DCR built with the `archive` Cargo feature (`cargo build --features archive`). Release binaries include this feature.
-
-| Field        | Required | Description                                                                                 |
-| ------------ | -------- | ------------------------------------------------------------------------------------------- |
-| `output`     | yes      | Image path relative to project root (`{profile}` allowed)                                   |
-| `format`     | yes      | `fat12`, `fat16`, or `fat32`                                                                |
-| `size`       | no       | Image size: bytes or `K`/`KB`/`M`/`MB`/`G`/`GB` (default `1474560` ≈ 1.44 MiB)              |
-| `offset`     | no       | Byte offset of the FAT volume inside the image (default `0`)                                |
-| `label`      | no       | Volume label (max 11 chars, default `VOLUME`)                                               |
-| `bootsector` | no       | Path to a 512-byte boot sector written at offset 0 when `offset` is 0 (`{profile}` allowed) |
-| `layout`     | no       | List of `{ from, to }` entries (files or globs → path inside the volume)                    |
-
-```toml
-[archive]
-output = "target/{profile}/disk.img"
-format = "fat12"
-size = "1440K"
-label = "MYOS"
-bootsector = "target/{profile}/boot.bin"
-
-[[archive.layout]]
-from = "target/{profile}/kernel.bin"
-to = "KERNEL.BIN"
-
-[[archive.layout]]
-from = "assets/*"
-to = "/"
-```
-
-Typical pairing with `kind = "flat-bin"` (NASM `-f bin`) for bootloaders and pure-ASM OS images.
-
-## `flat-bin` (kind)
-
-Produces a raw binary (default extension `bin`) for boot sectors, kernels, and freestanding payloads.
-
-### Assemblers
-
-| Tool | Language / compiler                        | How flat-bin is produced                     |
-| ---- | ------------------------------------------ | -------------------------------------------- |
-| NASM | `language = "asm"`, `compiler = "nasm"`    | `-f bin` → `\<stem>.bin`    |
-| FASM | `compiler = "fasm"`                        | direct write (use `format binary` in source) |
-| GAS  | `compiler = "as"` / `"gas"`                | assemble → `objcopy -O binary`               |
-| MASM | `compiler = "ml"` / `"ml64"`               | assemble → `objcopy -O binary`               |
-| LLC  | `language = "llvm_ir"`, `compiler = "llc"` | `-filetype=obj` → `objcopy -O binary`        |
-
-```toml
-[build]
-language = "asm"
-compiler = "nasm"
-kind = "flat-bin"
-extension = "bin"
-roots = ["src/boot.asm"]
-```
-
-### C / C++
-
-Compile all sources, link with `-nostdlib -static` (plus your `ldflags` / `ldscript`), then convert the intermediate ELF/PE with `objcopy -O binary` to `\<filename|name>.bin`.
-
-```toml
-[build]
-language = "c"
-compiler = "clang"
-kind = "flat-bin"
-freestanding = true
-filename = "kernel"
-extension = "bin"
-ldscript = "linker.ld"
-ldflags = ["-T", "linker.ld"]
-```
-
-Notes:
-
-* Multi-file **ASM** packages emit one `\<stem>.bin` per source; **C/C++** emit a single project binary.
-* `objcopy` tools tried in order: `llvm-objcopy`, `objcopy`, `gobjcopy`.
-* Incompatible with `build.qt = true`.
-* `dcr run` rejects `flat-bin` (not a host executable).

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

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

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

@@ -1,84 +0,0 @@
----
-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`.
-
-## DCRUP_MIRROR
-
-Download mirror for `dcrup` (prebuilt binaries only).
-
-```bash
-export DCRUP_MIRROR=auto   # cf → gh → sf → ya (default)
-export DCRUP_MIRROR=cf     # CloudFlare CDN
-export DCRUP_MIRROR=gh     # GitHub Releases
-export DCRUP_MIRROR=sf     # SourceForge
-export DCRUP_MIRROR=ya     # Yandex CDN (RU fallback)
-```
-
-CLI override: `dcrup install stable --mirror cf`.
-
-## DCRUP_HOME / DCRUP_BIN / DCRUP_REPO
-
-Installer layout and source clone URL:
-
-```bash
-export DCRUP_HOME=~/.dcr
-export DCRUP_BIN=~/.dcr/bin
-export DCRUP_REPO=https://github.com/dexoron/dcr
-```

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

@@ -1,53 +0,0 @@
----
-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-<env>/<profile>/
-```
-
-Architectures: `x86_64`, `aarch64`, `i686`, `armv7`, `riscv64` (host-detected).
-Environments: `gnu` (default), `musl`.
-
-Artifact type: ELF. Extensions: `.so` (sharedlib), `.a` (staticlib).
-
-### macOS
-
-```
-target/<profile>/ (default) or target/<triple>/<profile>/ (with target)
-```
-
-Architectures: `x86_64`, `aarch64` (host-detected).
-
-Extensions: `.dylib` (sharedlib), `.a` (staticlib).
-
-### Windows
-
-```
-target/<profile>/ (default) or target/<triple>/<profile>/ (with target)
-```
-
-Architectures: `x86_64`, `aarch64`.
-Environments: `msvc` (default), `gnu` (MinGW).
-
-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

@@ -1,88 +0,0 @@
----
-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, DCR automatically injects include and library paths of dependent workspace members:
-
-* **Include Paths**: Automatically resolves and injects header directories of dependencies, including the member's `src/` directory, local `include/` directory, and the packaged `target/include` directory.
-* **Library Paths**: Injects compiled library search paths (`target/lib` as well as target-specific build folders) to allow automatic linking with member libraries.
-
-## 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
-```
-
-## Workspace-only root (no build of its own)
-
-A workspace root can set `workspace_only = true` — it won't be built itself, and doesn't need `language` or `compiler`:
-
-```toml
-[package]
-name = "my-workspace"
-version = "0.1.0"
-
-[build]
-workspace_only = true
-kind = "bin"
-
-[workspace]
-lib-core = { path = "lib-core" }
-app = { path = "app", deps = ["lib-core"] }
-```

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

@@ -1,46 +0,0 @@
----
-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

@@ -1,45 +0,0 @@
----
-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

@@ -1,69 +0,0 @@
----
-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

@@ -1,67 +0,0 @@
----
-sidebar_label: Introduction
----
-
-# DCR — C/C++ Build Tool & Package Manager
-
-<details>
-<summary>Quick reference</summary>
-
-```bash
-# Installation (dcrup)
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
-export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable                 # auto: cf → gh → sf → ya
-# dcrup install stable --mirror cf   # CloudFlare / GitHub / SourceForge / Yandex
-
-# 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
-* **7 backends** — gcc/clang (unix_cc), MSVC/clang-cl (msvc), GAS, NASM, MASM, FASM, LLVM IR
-* **8 project kinds** — bin, staticlib, sharedlib, efi, elf, none, custom, flat-bin
-* **Disk images** — optional `[archive]` packs FAT12/16/32 images after build
-* **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

@@ -1,287 +0,0 @@
----
-sidebar_label: Changelog
----
-
-# Changelog
-
-## 0.9.1 (2026-09-13)
-
-* **`pkg-config` dependencies** — declare `fmt = { pkg-config = "fmt" }` or multiple package names in `[dependencies]`; DCR applies `.pc` compiler/linker flags and records the resolved package in `dcr.lock`.
-* **`dcr add` support for `pkg-config`** — easily add system package dependencies with `dcr add fmt pkg-config:fmt` or `dcr add openssl pkg:openssl,libcrypto`.
-* **`dcr tree` & IDE integration** — `pkg-config` packages are marked in `dcr tree` and resolved into compiler flags in `dcr gen` (`compile_commands.json`).
-* **Fixed `dcr new` in non-ASCII / spaced paths** — initializing projects from folders with non-ASCII characters or spaces no longer fails validation.
-
-## 0.9.0 (2026-08-31)
-
-* **Download mirrors in `dcrup`** — `--mirror auto|cf|gh|sf|ya` and `DCRUP_MIRROR`.
-  Default `auto` tries **cf → gh → sf → ya** (CloudFlare CDN, GitHub, SourceForge, Yandex CDN).
-* **Complete Path/Git dependencies** — DCR packages from `path` and `git` are built before their consumer. Git sources are cached in `~/.dcr/git`, support `branch`/`tag`/`rev`, and record the exact commit in `dcr.lock`.
-* **Build and prebuild modes** — `path` and `git` dependencies can build a DCR package from `dcr.toml` or link existing `include`/`lib`/`libs` artifacts; `mode = "build"` / `"prebuild"` selects explicitly when both forms are present.
-* **Prebuilt dependency examples** — documentation now shows the `dcr-math-lib` Git repository and recommended build/prebuilt layouts for both `git` and `path`.
-* **Transitive dependency builds and cycle reporting** — DCR recursively builds DCR packages and reports a clear dependency chain for cycles.
-* **Bare path arguments for `dcr add`** — `dcr add mylib ../mylib` now works in addition to the explicit `path:` form.
-* **Removed `install.sh` / `install.ps1` / `install_bsd.sh`** — superseded by `dcrup`.
-
-## 0.8.5 (2026-08-08)
-
-* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
-  `dcr new` / `dcr init` write the current version. On config load:
-  * missing / empty pin → warn "add dcr-version";
-  * dcr older than pin → warn "update dcr";
-  * dcr newer than pin → warn "check changelog, update pin";
-  * equal → silent.
-    Commands do not fail, warning only (once per path per process).
-
-## 0.8.4 (2026-08-04)
-
-**Added:**
-
-* **`.dcr/` directory** — shared machine-readable build facts for IDE integrations:
-  * `.dcr/compile_commands.json`
-  * `.dcr/build-info.json` (`schemaVersion`, `artifact_path`, `profile`, …)
-  * `.dcr/toolchain.json` (compiler/debugger paths, moc/uic/rcc)
-  * `.dcr/ide/` (placeholder for IDE lock files)
-* **`dcr gen project-info`** — `target`, `target_dir`, `artifact_path`, `artifact_kind`, `source_roots`, `include_globs`, `exclude_globs`; absolute/canonical paths.
-* **`dcr build --print-artifact-path`** — one absolute artifact path line on stdout after a successful build.
-* **`dcr gen … --quiet` / `-q`** — suppress human success logs for gen subcommands.
-* **`.clangd`** — created on first gen with `CompilationDatabase: .dcr` (`# managed by dcr gen`); custom `.clangd` is not overwritten.
-* **Helpers** `canonicalize_path`, `atomic_write`, `ensure_dcr_dir`; pure `resolve_artifact_path` via `platform::*`.
-* **`dcr new` / `dcr init`** — add `.dcr/` to `.gitignore`.
-
-**Changed (breaking):**
-
-* **`compile_commands.json` moved** from project root to **`.dcr/compile_commands.json`**.\
-  clangd discovers it via `.clangd` / `--compile-commands-dir=.dcr`.\
-  CLion and VSCode generators updated accordingly.
-* **Atomic write** for compile_commands (tmp + rename).
-* **`gen vscode` / `gen clion` launch/run** — use the same artifact path resolver as `project-info` / `build-info.json`.
-
-**Fixed:**
-
-* Launch configs no longer hardcode `target/\<profile>/\<name>` without the Linux triple segment.
-* Symlink/mount roots: best-effort canonicalize for root and compile database paths.
-
-## 0.8.3 (2026-08-03)
-
-### Added
-
-* **`dcr run -- \<args>...`** — cargo-style argument forwarding after a bare `--`\
-  (`dcr run --release -- --test_help`). Applies to direct binary runs and `[run].cmd`.
-* **Tests** — host target section `ldflags` without CLI `--target`; run-arg forwarding; `split_double_dash` unit tests.
-
-### Changed
-
-* **Native builds resolve the host triple** — without `--target` / package `build.target`, host sections such as\
-  `[build.x86_64-unknown-linux-gnu]` apply again (`cflags` / `ldflags` / toolchain).\
-  Previously the target was empty and those sections were ignored while artifacts already used the host triple path.
-* **Empty target** — no more `Unknown target ''` warning.
-* **`dcr run --help` / man `dcr-run`** — document `--` forwarding.
-
-### Fixed
-
-* **Native artifact paths on Windows and macOS** — without an explicit `--target` / `build.target`, artifacts use `target/\<profile>`, so `dcr run` and flat-bin find the build output.
-* Target-specific `ldflags` missing on native host builds (e.g. micro-lang + `libsct-elf`).
-* Spurious empty-target warning.
-
-## 0.8.2 (2026-07-22)
-
-### Added
-
-* **Compile progress `[N/M]`** — live TTY status line (`compile  pkg v0.1.0  [12/41]`) so long mono-package builds do not look hung.
-* **DCR status style** — fixed-width verbs: `project`, `compile`, `dep`, `ready`, `pack`, `done`, `run`.
-* **Cargo feature `archive`** — optional FAT packing via `fatfs` (`cargo build --features archive`). Release CI builds with the feature; without it `[archive]` fails with a clear message.
-* **Tests** — `flat_bin_nasm_build`, package `build.target` without CLI `--target`, stricter workspace `clean --all`.
-* **CI expansion** — unit + integration on Linux/macOS/Windows, archive feature job, rust-cache, clippy default + all-features (see `.github/workflows/ci.yml`).
-
-### Changed
-
-* **No forced host triple from CLI** — without `--target`, package/member `build.target` is honored (bare-metal / ISO `post_steps` paths).
-* **Relative include/lib flags** (`-I`, `-i`, `-isystem`, `-idirafter`, `-L`, `-T`) absolutized against the package root under workspace builds.
-* **`dcr clean --all`** — no spam for members without a local `target/` (shared root `target/`).
-* **`error` / `warn`** — red / yellow on stderr; CLI fully English (`Hint:`).
-* **Help / man** — list `add`, `lint`, `setup`; unknown command exits with code 1.
-* **Tool NotFound** — `linker not found: ld.lld …` / `{tool} not found …` instead of raw `os error 2`.
-
-## 0.8.1 (2026-07-20)
-
-### Added
-
-* **`build.kind = "flat-bin"`** — raw binary (default `.bin`) for OS-dev payloads:
-  * **NASM** — `-f bin` → `\<stem>.bin`
-  * **FASM** — direct output (`format binary` in source)
-  * **GAS / MASM / LLC** — object → `objcopy -O binary` → `\<stem>.bin`
-  * **C/C++** — objects → freestanding link → `objcopy -O binary` → `\<name>.bin`
-  * Requires `llvm-objcopy` / `objcopy` / `gobjcopy` except for NASM/FASM direct emit
-* **`[archive]` section** — FAT12/16/32 disk images after build (`output`, `format`, `size`, `offset`, `label`, `bootsector`, `layout`). From 0.8.2 requires feature `archive`.
-* **Single-file `build.roots`** — a root may be a single source or header file, not only a directory.
-
-### Changed
-
-* **`--force`** also re-runs `build.steps` and `build.post_steps`.
-* **`dcr run` on workspace-only root** — if `[run].cmd` is set, run that after build; otherwise delegate to a workspace member.
-
-## 0.8.0 (2026-07-18)
-
-### 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.cxx]`, `[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)
-
-### Added
-
-* **Native Qt support** — automatic meta-object handling (MOC, UIC, RCC) added when `build.qt = true` is set in `dcr.toml`.
-* **`dcr lint` command** — C/C++ static analysis via `clang-tidy`. Supports `--fix` for automatic fixes. Respects `build.roots` and `build.src_disable` from config.
-* **Three new assembler backends**:
-  * **MASM** (`compiler = "ml"` / `"ml64"`) — Microsoft Macro Assembler.
-  * **FASM** (`compiler = "fasm"`) — Flat Assembler.
-  * **LLVM IR** (`compiler = "llc"`) — compiles `.ll` files via `llc -filetype=obj`.
-* **Shared ASM pipeline** — linking and archiving logic consolidated into `core/builder/asm.rs`. Adding a new assembler backend now takes ~30 lines.
-* **Filesystem utilities** — `to_hex()` and `home_dir()` extracted to `utils/fs.rs`.
-* **Build utilities** — `normalize_target()`, `normalize_kind()`, `normalize_platform()`, `default_profile_flags()` extracted to `utils/build.rs`.
-* **Backend helpers** — `asm_lang_flag()`, `source_extensions()`, `elapsed_secs()` added to `core/builder/common.rs`.
-* **Full Bare-Metal / Freestanding Automation** — introduced the `build.freestanding = true` configuration option. When enabled (or when a bare-metal target is detected), DCR automatically injects `-ffreestanding` during compilation and both `-nostdlib` and `-static` during linking.
-* **Artifact Optimization (LTO & Strip)** — added `build.lto` (auto-injects `-flto` for compiler and linker) and `build.strip` (automatically strips debug symbols via linker `-s` flag) options to `dcr.toml`.
-* **Compilation Thread Control** — added the `build.codegen-units` option to strictly limit the maximum number of parallel jobs utilized by the custom `parallel_build` worker pool.
-* **Panic Behavior Management** — added `build.panic = "abort"` support. For C++ targets, it automatically strips exception handling and unwind tables via `-fno-exceptions`, `-fno-unwind-tables`, and `-fno-asynchronous-unwind-tables`.
-
-### Changed
-
-* **Intelligent Default Flags Generation** — automated injection of fallback optimization (`-O3`/`-O0`), debug (`-g`), and warning (`-Wall -Wextra`) flags is now suppressed for bare-metal and freestanding builds if `build.cflags` are overridden.
-* **Centralized Bare-Metal Detection** — relocated the `is_bare_metal_target` helper to common build utilities (`src/utils/build.rs`) for unified access across the building core.
-* **Architectural Refactoring**:
-  * Renamed `src/config.rs` to `src/templates.rs`.
-  * Started consolidation of configuration and build orchestration logic.
-
-## 0.7.3 (2026-06-13)
-
-### Added
-
-* **`--vcs` option for `new` and `init` commands** — introduced explicit version control system selection via `--vcs \<git|none>`.
-* **Git metadata integration in `--version`** — the CLI now appends the current short commit hash and a `-dirty` suffix if there are uncommitted changes in the DCR repository.
-* **Automatic `.gitignore` generation** — Git repository initialization now automatically writes a `.gitignore` file excluding the `/target` directory.
-* **Nested repository prevention** — automatic Git initialization is now skipped if `dcr new` or `dcr init` is executed inside an already existing Git repository.
-* **VCS verification tests** — added `new_vcs_options_work` and `init_vcs_options_work` integration tests to ensure reliable repository behavior.
-
-### Changed
-
-* **Complete removal of `git2` dependency** — all Git actions (dependency fetching, VCS setup, status checks) are now delegated to the system `git` executable via `Command`. This simplifies compilation and drops the need for `vendored` and `openssl` features.
-* **Migrated from `reqwest` to `ureq`** — replaced the heavy `reqwest` crate in `flag_update.rs` with the lightweight synchronous `ureq 2.10` client, reducing overhead and the final binary size.
-
-## 0.7.2 (2026-06-07)
-
-### Added
-
-* `default_target_triple()` now respects `target_env` — Linux (gnu/musl) and Windows (msvc/gnu) use the correct environment instead of hardcoded values.
-
-### Fixed
-
-* **macOS Apple Silicon builds failed with `_main` undefined** — `--target=` is now passed to ldflags, not just cflags. `default_target_triple()` uses `std::env::consts::ARCH` on macOS instead of hardcoded `x86_64`.
-* **GitHub Stars and GPL-3.0 badges not rendering in README** — badge block converted to pure HTML.
-
-### Changed
-
-* Default target resolution extracted into shared `default_target_triple()` — removed duplication across build, run, clean.
-
-## 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

@@ -1,47 +0,0 @@
----
-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 (also re-runs build.steps / post_steps)
-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).
-
-With `[archive]` in `dcr.toml`, a FAT disk image is packed after a successful build.
-
-## `dcr run`
-
-Builds (if sources are newer than artifacts) and runs the binary.
-
-```bash
-dcr run
-dcr run --release
-dcr run --force                   # force rebuild then run
-```
-
-On a **workspace-only** root: if `[run].cmd` is set, that command is used after build; otherwise DCR delegates to a workspace member.
-
-## `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

@@ -1,61 +0,0 @@
----
-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
-dcr add fmt pkg-config:fmt     # system package via pkg-config
-dcr add openssl pkg:openssl,libcrypto # multiple pkg-config packages
-```
-
-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>`
-* `pkg-config:` / `pkg:` — one or more packages resolved by `pkg-config`
-* `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. A bare relative or absolute path is accepted as a path dependency.
-
-For `pkg-config` dependencies, the referenced packages must already be installed
-and provide `.pc` files. DCR invokes `pkg-config` during the build (using
-`PATH` and `PKG_CONFIG_PATH`) and forwards the returned compiler and linker
-flags; it does not download or build these packages.
-
-## `dcr tree`
-
-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

@@ -1,73 +0,0 @@
----
-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

@@ -1,40 +0,0 @@
----
-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
-dcr new my-app --vcs none
-```
-
-Flags:
-
-* `--vcs \<git|none>` — Initialize version control system (defaults to `git` if available, or `none`).
-
-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
-dcr init
-dcr init --vcs none
-```
-
-Flags:
-
-* `--vcs \<git|none>` — Initialize version control system (defaults to `git` if available, or `none`).
-
-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

@@ -1,60 +0,0 @@
----
-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

@@ -1,51 +0,0 @@
----
-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.default]
-url = "https://index.dcr.pm"
-priority = 1
-```
-
-## `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

@@ -1,53 +0,0 @@
----
-sidebar_label: Contributing
----
-
-# Contributing
-
-## Setup
-
-```bash
-git clone https://github.com/dexoron/dcr
-# or a source mirror: GitVerse / SourceCraft / SourceForge / GitLab (see README)
-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 (see `.github/workflows/ci.yml`):
-
-* `cargo fmt --check`
-* `cargo clippy` (default + `--all-features`)
-* `cargo check --all-targets --all-features`
-* Unit + integration tests on Linux, macOS, Windows
-* Extra Linux job with `--features archive` (FAT images)
-* Tools on runners: clang, nasm, clang-format/tidy (Linux)

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

@@ -1,75 +0,0 @@
----
-sidebar_label: FAQ
----
-
-# FAQ
-
-## Registry not found
-
-```
-error: registry not found
-```
-
-**Solution:** Make sure `~/.dcr/config.toml` exists:
-
-```toml
-[registry.default]
-url = "https://index.dcr.pm"
-priority = 1
-```
-
-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`.
-
-## 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).
-
-## Bootloader / pure NASM OS image
-
-Use `kind = "flat-bin"` (NASM `-f bin`) and optional `[archive]` for a FAT disk image.
-
-See [OS-dev recipe](/docs/recipes/os-flat-bin-archive).
-
-## How do I choose a download mirror?
-
-`dcrup install` uses `--mirror auto` by default and tries **cf → gh → sf → ya**.
-
-```bash
-dcrup install stable --mirror cf
-export DCRUP_MIRROR=ya
-```
-
-## Lock file
-
-`dcr.lock` is created during builds (`dcr build`) when registry dependencies are present. To force an update — delete `dcr.lock` and run `dcr build`.

docs-crowdin-export/pl-PL/docs/getting-started/first-steps.mdx.mdx

@@ -1,79 +0,0 @@
----
-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
-```
-
-## Linting
-
-```bash
-dcr lint             # clang-tidy checks
-dcr lint --fix       # apply fixes automatically
-```

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

@@ -1,153 +0,0 @@
----
-sidebar_label: Installation
----
-
-# Installation
-
-## dcrup (recommended)
-
-Install and switch DCR versions (stable / dev / night, pin `0.8.2`, optional build from source).
-
-### Linux / macOS / BSD / Windows (bash)
-
-```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
-export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable
-```
-
-Non-interactive install of DCR in one shot:
-
-```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- install stable
-export PATH="$HOME/.dcr/bin:$PATH"
-```
-
-### Windows (PowerShell)
-
-```powershell
-irm https://ps1.dcr-tool.ru | iex
-# or download then run:
-# irm https://ps1.dcr-tool.ru -OutFile dcrup.ps1
-# powershell -File .\dcrup.ps1 self-install
-# $env:Path += ";$env:USERPROFILE\.dcr\bin"
-dcrup install stable
-```
-
-Optional cmd bootstrap (if you prefer `curl` of the cmd shim):
-
-```bat
-curl -fsSL -o dcrup.cmd https://cmd.dcr-tool.ru
-```
-
-After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows `dcrup.cmd`).
-
-### Common dcrup commands
-
-```sh
-dcrup install stable              # latest stable prebuilt (auto: cf → gh → sf → ya)
-dcrup install 0.8.2               # pin → 0.8.2@stable
-dcrup install 0.8.2@dev
-dcrup install stable --libc musl  # Linux: musl asset (default: gnu)
-dcrup install stable --mirror cf  # CloudFlare CDN
-dcrup install stable --mirror ya  # Yandex CDN (RU fallback)
-dcrup install stable --build      # cargo build --features archive
-dcrup install night               # always build from branch dev HEAD
-dcrup default 0.8.2
-dcrup update
-dcrup list
-dcrup show
-dcrup which
-```
-
-Layout: `~/.dcr/toolchains/\<id>/dcr` and `~/.dcr/bin/dcr` → active version.
-
-### Download mirrors
-
-Prebuilt installs try **cf → gh → sf → ya** unless you pin a host.
-
-| Code | URL                                                                                                          | Notes                      |
-| ---- | ------------------------------------------------------------------------------------------------------------ | -------------------------- |
-| `cf` | `https://cdn-global.dcr-tool.ru/\<tag>/\<asset>`                           | CloudFlare CDN (worldwide) |
-| `gh` | `https://github.com/dexoron/dcr/releases/download/\<tag>/\<asset>`         | GitHub Releases            |
-| `sf` | `https://sourceforge.net/projects/dcr-tool/files/\<tag>/\<asset>/download` | SourceForge                |
-| `ya` | `https://cdn-ru.dcr-tool.ru/\<tag>/\<asset>`                               | Yandex CDN (RU fallback)   |
-
-```sh
-dcrup install stable --mirror auto   # default
-export DCRUP_MIRROR=cf               # persist for this shell
-```
-
----
-
-## Arch Linux (AUR)
-
-```sh
-yay -S dcr
-```
-
-## macOS / Linux (Homebrew)
-
-```sh
-brew tap dexoron/dexoron
-brew install dcr
-```
-
-## Snap (Linux)
-
-```sh
-sudo snap install dcrup
-```
-
-> If classic Snap Store publishing is unavailable, install the `.snap` from [GitHub Releases](https://github.com/dexoron/dcr/releases/latest) with `--dangerous`.
-
-## Nix (flake)
-
-```sh
-nix run github:dexoron/dcr
-nix profile install github:dexoron/dcr
-```
-
-## Cargo (crates.io)
-
-```sh
-cargo install dcr
-```
-
-Note: crates.io builds may omit optional features. For FAT disk images (`[archive]`), prefer release binaries or:
-
-```sh
-cargo install dcr --features archive
-```
-
-## From source
-
-```sh
-git clone https://github.com/dexoron/dcr.git
-cd dcr
-cargo build --release --features archive
-ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
-# or manage versions with dcrup install night / --build
-```
-
-## Post-install
-
-```bash
-dcr --version
-dcrup show    # if installed via dcrup
-```
-
-Man pages (package installs / release assets):
-
-```bash
-man dcr
-man dcr-build
-```
-
-Registry (optional) — `~/.dcr/config.toml`:
-
-```toml
-[registry.default]
-url = "https://index.dcr.pm"
-priority = 1
-```

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

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

@@ -1,33 +0,0 @@
----
-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.
-
-## Rust dependencies
-
-DCR is written in Rust. The following notable Rust crates are statically linked:
-
-| Crate                                                   | License           |
-| ------------------------------------------------------- | ----------------- |
-| [`ureq`](https://crates.io/crates/ureq)                 | MIT OR Apache-2.0 |
-| [`serde`](https://crates.io/crates/serde)               | MIT OR Apache-2.0 |
-| [`toml`](https://crates.io/crates/toml)                 | MIT OR Apache-2.0 |
-| [`toml_edit`](https://crates.io/crates/toml_edit)       | MIT OR Apache-2.0 |
-| [`serde_json`](https://crates.io/crates/serde_json)     | MIT OR Apache-2.0 |
-| [`sha2`](https://crates.io/crates/sha2)                 | MIT OR Apache-2.0 |
-| [`glob`](https://crates.io/crates/glob)                 | MIT OR Apache-2.0 |
-| [`self-replace`](https://crates.io/crates/self-replace) | MIT OR Apache-2.0 |
-| [`ctrlc`](https://crates.io/crates/ctrlc)               | MIT OR Apache-2.0 |
-
-Full dependency tree 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

@@ -1,49 +0,0 @@
----
-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

@@ -1,70 +0,0 @@
----
-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

@@ -1,103 +0,0 @@
----
-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_only = true
-
-[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/recipes/os-flat-bin-archive.mdx.mdx

@@ -1,89 +0,0 @@
----
-sidebar_label: OS-dev (flat-bin + archive)
----
-
-# Pure ASM / boot image (flat-bin + archive)
-
-Minimal OS-dev style pipeline: assemble raw binaries with NASM, then pack a FAT floppy/image with an optional boot sector.
-
-## Project layout
-
-```
-myos/
-  dcr.toml
-  src/
-    boot.asm      # boot sector (512 bytes)
-    kernel.asm    # payload
-```
-
-For multiple flat artifacts, use a **workspace** (one member per binary) or separate packages; a single `flat-bin` package produces one binary per source stem.
-
-## Boot package (`flat-bin`)
-
-```toml
-[package]
-name = "boot"
-version = "0.1.0"
-
-[build]
-language = "asm"
-compiler = "nasm"
-kind = "flat-bin"
-extension = "bin"
-roots = ["src/boot.asm"]
-```
-
-```bash
-dcr build
-# → target/<…>/debug/boot.bin  (NASM -f bin, no link)
-```
-
-## Disk image after build
-
-```toml
-[archive]
-output = "target/{profile}/disk.img"
-format = "fat12"
-size = "1440K"
-label = "MYOS"
-bootsector = "target/{profile}/boot.bin"
-
-[[archive.layout]]
-from = "target/{profile}/kernel.bin"
-to = "KERNEL.BIN"
-```
-
-* `format`: `fat12`, `fat16`, or `fat32`
-* `size`: bytes or `K`/`KB`/`M`/`MB`/`G`/`GB` (default ~1.44 MiB)
-* `bootsector`: written only when `offset` is omitted or `0`
-* `from` may be a glob; `{profile}` is substituted in paths
-
-## C kernel → flat binary
-
-```toml
-[build]
-language = "c"
-compiler = "clang"
-kind = "flat-bin"
-freestanding = true
-filename = "kernel"
-extension = "bin"
-ldflags = ["-T", "linker.ld"]
-```
-
-Pipeline: objects → temporary linked ELF → `objcopy -O binary` → `kernel.bin`. Requires `objcopy` / `llvm-objcopy` in PATH.
-
-## Other assemblers
-
-| Tool     | Notes                                                                                   |
-| -------- | --------------------------------------------------------------------------------------- |
-| **FASM** | Write `format binary` in the source; DCR writes `\<stem>.bin` directly |
-| **GAS**  | Assemble `.s` → obj → `objcopy -O binary`                                               |
-| **LLC**  | `language = "llvm_ir"` → obj → objcopy                                                  |
-| **MASM** | COFF obj → objcopy (needs binutils/LLVM objcopy)                                        |
-
-## Notes
-
-* Single-file `roots` are supported: `roots = ["src/boot.asm"]`.
-* `--force` re-runs `build.steps` / `build.post_steps` as well as recompilation.
-* Prefer `kind = "elf"` if you need a relocatable ELF kernel without stripping to raw binary.

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

@@ -1,82 +0,0 @@
----
-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

@@ -1,136 +0,0 @@
----
-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; **`bin` when `kind = "flat-bin"`**)
-* 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>`                    |
-| `flat-bin`  | Raw binary                      | ASM: `\<stem>.bin` (NASM `-f bin` / FASM / GAS·MASM·LLC via objcopy); C/C++: `\<name>.bin` (link + objcopy) |
-
-## Disk images (`[archive]`)
-
-After a successful build, if `[archive]` is present in `dcr.toml`, DCR formats a FAT volume and copies files from `layout` into the image. See [dcr.toml → archive](/docs/reference/dcr-toml#archive).
-
-## 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

@@ -1,64 +0,0 @@
----
-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
-
-By default, the compilation output directories are structured as follows:
-
-* **Linux and BSD**: Always output to `target/\<triple>/\<profile>/` (using host triple if no target is specified).
-* **macOS and Windows (without target)**: Output to `target/\<profile>/`.
-* **macOS and Windows (with explicit target)**: Output to `target/\<triple>/\<profile>/`.

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

@@ -1,284 +0,0 @@
----
-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
-
-[archive]
-# optional: pack FAT disk image after build
-```
-
-## [package]
-
-| Field         | Required | Description                                                                                                     |
-| ------------- | -------- | --------------------------------------------------------------------------------------------------------------- |
-| `name`        | yes      | Project name                                                                                                    |
-| `version`     | yes      | Semantic version of the **project**                                                                             |
-| `dcr-version` | no       | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `type`        | no       | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `license`     | no       | SPDX license identifier                                                                                         |
-| `author`      | no       | Author                                                                                                          |
-
-```toml
-[package]
-name = "my-app"
-version = "0.1.0"
-dcr-version = "0.8.4"
-type = "app"
-license = "MIT"
-author = "John Doe"
-```
-
-### `package.dcr-version`
-
-Optional pin of the DCR CLI the project was written for. On every `dcr.toml` load:
-
-| Situation                      | Behaviour                                                  |
-| ------------------------------ | ---------------------------------------------------------- |
-| Field missing / empty          | Warning: add `dcr-version` (set by `dcr new` / `dcr init`) |
-| Running dcr **older** than pin | Warning: upgrade dcr (`dcr --update`)                      |
-| Running dcr **newer** than pin | Warning: review changelog, bump the pin when ready         |
-| Equal                          | Silent                                                     |
-| Invalid semver                 | Warning once, field ignored                                |
-
-Never fails the command — warnings only. Pre-release suffixes (`1.0.0-dev`) are ignored for comparison (`1.0.0-dev` ≡ `1.0.0`).
-
-## [build]
-
-...
-
-* `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"`, `"llvm_ir"`, `"llvm-ir"`, `"ll"` (optional, defaults to `"c"`) |
-| `standard`       | `"c11"`       | C standard (`c11`, `c17`, `c23`)                                                                          |
-| `cxx_standard`   | —             | C++ standard (`c++17`, `c++20`, `c++23`)                                                                  |
-| `compiler`       | `"clang"`     | Preferred compiler (optional, defaults to `"clang"`)                                                      |
-| `kind`           | `"bin"`       | `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, `custom`, `flat-bin`                               |
-| `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 (for `flat-bin`, default is `bin`)                                                  |
-| `roots`          | `["src"]`     | Source roots: directories and/or individual source/header files                                           |
-| `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 (no `language`/`compiler` required)                                  |
-| `freestanding`   | `false`       | Compile in freestanding mode (`-ffreestanding` + `-nostdlib -static`)                                     |
-| `opt_level`      | —             | Optimization level: `0`-`3`, `"s"`, `"z"` (derived from profile if omitted)                               |
-| `debug`          | profile-based | Emit debug symbols (`-g`): `true` in debug, `false` in release                                            |
-| `lto`            | `false`       | Link-time optimization (`-flto` for both compiler and linker)                                             |
-| `strip`          | `false`       | Strip symbols from output (`-s` in ldflags)                                                               |
-| `warnings`       | `[]`          | Warning flags (e.g. `"all"`, `"extra"`, `"pedantic"`); engine adds `-Wall -Wextra` in debug if empty      |
-| `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 packages queried for build-wide compiler/linker flags
-
-Dependencies can also declare a system package directly, for example
-`fmt = { pkg-config = "fmt" }`. This records the package in `dcr.lock` and applies
-the flags returned by `pkg-config --cflags` and `pkg-config --libs`.
-
-* `ldscript` — linker script path
-* `build.steps` / `build.post_steps` — codegen steps
-
-## Per-language overrides: `[build.c]`, `[build.cxx]`, `[build.asm]`, `[build.llvm_ir]`
-
-Each language can have its own table that overrides the flat `[build]` settings:
-
-```toml
-[build]
-compiler = "clang"
-standard = "c11"
-
-[build.c]
-standard = "c23"
-compiler = "gcc"
-
-[build.cxx]
-standard = "c++23"
-compiler = "g++"
-
-[build.asm]
-compiler = "nasm"
-flags = ["-felf64"]
-
-[build.llvm_ir]
-compiler = "llc"
-```
-
-The flat `[build]` acts as fallback; per-language tables take precedence for their language.
-
-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).
-
-## [archive]
-
-Optional post-build step: format a FAT volume and copy built artifacts into a disk image. Runs after a successful package build (and after workspace member builds that define `[archive]`).
-
-Requires DCR built with the `archive` Cargo feature (`cargo build --features archive`). Release binaries include this feature.
-
-| Field        | Required | Description                                                                                 |
-| ------------ | -------- | ------------------------------------------------------------------------------------------- |
-| `output`     | yes      | Image path relative to project root (`{profile}` allowed)                                   |
-| `format`     | yes      | `fat12`, `fat16`, or `fat32`                                                                |
-| `size`       | no       | Image size: bytes or `K`/`KB`/`M`/`MB`/`G`/`GB` (default `1474560` ≈ 1.44 MiB)              |
-| `offset`     | no       | Byte offset of the FAT volume inside the image (default `0`)                                |
-| `label`      | no       | Volume label (max 11 chars, default `VOLUME`)                                               |
-| `bootsector` | no       | Path to a 512-byte boot sector written at offset 0 when `offset` is 0 (`{profile}` allowed) |
-| `layout`     | no       | List of `{ from, to }` entries (files or globs → path inside the volume)                    |
-
-```toml
-[archive]
-output = "target/{profile}/disk.img"
-format = "fat12"
-size = "1440K"
-label = "MYOS"
-bootsector = "target/{profile}/boot.bin"
-
-[[archive.layout]]
-from = "target/{profile}/kernel.bin"
-to = "KERNEL.BIN"
-
-[[archive.layout]]
-from = "assets/*"
-to = "/"
-```
-
-Typical pairing with `kind = "flat-bin"` (NASM `-f bin`) for bootloaders and pure-ASM OS images.
-
-## `flat-bin` (kind)
-
-Produces a raw binary (default extension `bin`) for boot sectors, kernels, and freestanding payloads.
-
-### Assemblers
-
-| Tool | Language / compiler                        | How flat-bin is produced                     |
-| ---- | ------------------------------------------ | -------------------------------------------- |
-| NASM | `language = "asm"`, `compiler = "nasm"`    | `-f bin` → `\<stem>.bin`    |
-| FASM | `compiler = "fasm"`                        | direct write (use `format binary` in source) |
-| GAS  | `compiler = "as"` / `"gas"`                | assemble → `objcopy -O binary`               |
-| MASM | `compiler = "ml"` / `"ml64"`               | assemble → `objcopy -O binary`               |
-| LLC  | `language = "llvm_ir"`, `compiler = "llc"` | `-filetype=obj` → `objcopy -O binary`        |
-
-```toml
-[build]
-language = "asm"
-compiler = "nasm"
-kind = "flat-bin"
-extension = "bin"
-roots = ["src/boot.asm"]
-```
-
-### C / C++
-
-Compile all sources, link with `-nostdlib -static` (plus your `ldflags` / `ldscript`), then convert the intermediate ELF/PE with `objcopy -O binary` to `\<filename|name>.bin`.
-
-```toml
-[build]
-language = "c"
-compiler = "clang"
-kind = "flat-bin"
-freestanding = true
-filename = "kernel"
-extension = "bin"
-ldscript = "linker.ld"
-ldflags = ["-T", "linker.ld"]
-```
-
-Notes:
-
-* Multi-file **ASM** packages emit one `\<stem>.bin` per source; **C/C++** emit a single project binary.
-* `objcopy` tools tried in order: `llvm-objcopy`, `objcopy`, `gobjcopy`.
-* Incompatible with `build.qt = true`.
-* `dcr run` rejects `flat-bin` (not a host executable).

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

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

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

@@ -1,84 +0,0 @@
----
-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`.
-
-## DCRUP_MIRROR
-
-Download mirror for `dcrup` (prebuilt binaries only).
-
-```bash
-export DCRUP_MIRROR=auto   # cf → gh → sf → ya (default)
-export DCRUP_MIRROR=cf     # CloudFlare CDN
-export DCRUP_MIRROR=gh     # GitHub Releases
-export DCRUP_MIRROR=sf     # SourceForge
-export DCRUP_MIRROR=ya     # Yandex CDN (RU fallback)
-```
-
-CLI override: `dcrup install stable --mirror cf`.
-
-## DCRUP_HOME / DCRUP_BIN / DCRUP_REPO
-
-Installer layout and source clone URL:
-
-```bash
-export DCRUP_HOME=~/.dcr
-export DCRUP_BIN=~/.dcr/bin
-export DCRUP_REPO=https://github.com/dexoron/dcr
-```

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

@@ -1,53 +0,0 @@
----
-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-<env>/<profile>/
-```
-
-Architectures: `x86_64`, `aarch64`, `i686`, `armv7`, `riscv64` (host-detected).
-Environments: `gnu` (default), `musl`.
-
-Artifact type: ELF. Extensions: `.so` (sharedlib), `.a` (staticlib).
-
-### macOS
-
-```
-target/<profile>/ (default) or target/<triple>/<profile>/ (with target)
-```
-
-Architectures: `x86_64`, `aarch64` (host-detected).
-
-Extensions: `.dylib` (sharedlib), `.a` (staticlib).
-
-### Windows
-
-```
-target/<profile>/ (default) or target/<triple>/<profile>/ (with target)
-```
-
-Architectures: `x86_64`, `aarch64`.
-Environments: `msvc` (default), `gnu` (MinGW).
-
-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

@@ -1,88 +0,0 @@
----
-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, DCR automatically injects include and library paths of dependent workspace members:
-
-* **Include Paths**: Automatically resolves and injects header directories of dependencies, including the member's `src/` directory, local `include/` directory, and the packaged `target/include` directory.
-* **Library Paths**: Injects compiled library search paths (`target/lib` as well as target-specific build folders) to allow automatic linking with member libraries.
-
-## 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
-```
-
-## Workspace-only root (no build of its own)
-
-A workspace root can set `workspace_only = true` — it won't be built itself, and doesn't need `language` or `compiler`:
-
-```toml
-[package]
-name = "my-workspace"
-version = "0.1.0"
-
-[build]
-workspace_only = true
-kind = "bin"
-
-[workspace]
-lib-core = { path = "lib-core" }
-app = { path = "app", deps = ["lib-core"] }
-```

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

@@ -1,46 +0,0 @@
----
-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

@@ -1,45 +0,0 @@
----
-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

@@ -1,69 +0,0 @@
----
-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

@@ -1,67 +0,0 @@
----
-sidebar_label: Введение
----
-
-# DCR — Инструмент сборки C/C++ & Пакетный менеджер
-
-<details>
-<summary>Быстрая справка</summary>
-
-```bash
-# Installation (dcrup)
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
-export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable                 # auto: cf → gh → sf → ya
-# dcrup install stable --mirror cf   # CloudFlare / GitHub / SourceForge / Yandex
-
-# 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>
-
-## Содержание
-
-| Раздел                                              | Описание                                     |
-| --------------------------------------------------- | -------------------------------------------- |
-| [Начало работы](/docs/getting-started/installation) | Установка и первые шаги                      |
-| [Команды](/docs/commands/project-commands)          | Все CLI-команды DCR                          |
-| [Ссылка](/docs/reference/dcr-toml)                  | Конфигурация, сборка, зависимости, платформы |
-| [Тестирование](/docs/testing/test-framework)        | Встроенный фреймворк тестирования            |
-| [Рецепты](/docs/recipes/cross-to-windows)           | Типовые сценарии                             |
-| [Интеграция с IDE](/docs/ide-integration)           | VS Code, CLion, compile_commands.json        |
-| [Автоматическое обновление](/docs/self-update)      | Автообновление                               |
-| [Часто задаваемые вопросы](/docs/faq)               | Частые вопросы                               |
-| [Журнал изменений](/docs/changelog)                 | История версий                               |
-| [Лицензия](/docs/license)                           | Лицензии DCR и вендорных библиотек           |
-| [Внести свой вклад](/docs/contributing)             | Разработка DCR                               |
-
-## Особенности
-
-* **Инкрементальная сборка** — mtime + `.d` headers + SHA256 fingerprint
-* **Параллельная компиляция** — thread::scope, атомарная очередь задач
-* **7 backends** — gcc/clang (unix_cc), MSVC/clang-cl (msvc), GAS, NASM, MASM, FASM, LLVM IR
-* **8 project kinds** — bin, staticlib, sharedlib, efi, elf, none, custom, flat-bin
-* **Disk images** — optional `[archive]` packs FAT12/16/32 images after build
-* **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** — автоматический поиск системных библиотек
-* **Команда `--help` для каждой команды** — `dcr build --help`, `dcr new --help` и т. д.
-* **Справочные страницы** — `man dcr`, `man dcr-build`, `man dcr-new`

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

@@ -1,287 +0,0 @@
----
-sidebar_label: Список изменений
----
-
-# Список изменений
-
-## 0.9.1 (2026-09-13)
-
-* **`pkg-config` dependencies** — declare `fmt = { pkg-config = "fmt" }` or multiple package names in `[dependencies]`; DCR applies `.pc` compiler/linker flags and records the resolved package in `dcr.lock`.
-* **`dcr add` support for `pkg-config`** — easily add system package dependencies with `dcr add fmt pkg-config:fmt` or `dcr add openssl pkg:openssl,libcrypto`.
-* **`dcr tree` & IDE integration** — `pkg-config` packages are marked in `dcr tree` and resolved into compiler flags in `dcr gen` (`compile_commands.json`).
-* **Fixed `dcr new` in non-ASCII / spaced paths** — initializing projects from folders with non-ASCII characters or spaces no longer fails validation.
-
-## 0.9.0 (2026-08-31)
-
-* **Download mirrors in `dcrup`** — `--mirror auto|cf|gh|sf|ya` and `DCRUP_MIRROR`.
-  Default `auto` tries **cf → gh → sf → ya** (CloudFlare CDN, GitHub, SourceForge, Yandex CDN).
-* **Complete Path/Git dependencies** — DCR packages from `path` and `git` are built before their consumer. Git sources are cached in `~/.dcr/git`, support `branch`/`tag`/`rev`, and record the exact commit in `dcr.lock`.
-* **Build and prebuild modes** — `path` and `git` dependencies can build a DCR package from `dcr.toml` or link existing `include`/`lib`/`libs` artifacts; `mode = "build"` / `"prebuild"` selects explicitly when both forms are present.
-* **Prebuilt dependency examples** — documentation now shows the `dcr-math-lib` Git repository and recommended build/prebuilt layouts for both `git` and `path`.
-* **Transitive dependency builds and cycle reporting** — DCR recursively builds DCR packages and reports a clear dependency chain for cycles.
-* **Bare path arguments for `dcr add`** — `dcr add mylib ../mylib` now works in addition to the explicit `path:` form.
-* **Removed `install.sh` / `install.ps1` / `install_bsd.sh`** — superseded by `dcrup`.
-
-## 0.8.5 (2026-08-08)
-
-* **`package.dcr-version`** — optional CLI version pin in `dcr.toml`.
-  `dcr new` / `dcr init` write the current version. On config load:
-  * missing / empty pin → warn "add dcr-version";
-  * dcr older than pin → warn "update dcr";
-  * dcr newer than pin → warn "check changelog, update pin";
-  * equal → silent.
-    Commands do not fail, warning only (once per path per process).
-
-## 0.8.4 (2026-08-04)
-
-**Added:**
-
-* **`.dcr/` directory** — shared machine-readable build facts for IDE integrations:
-  * `.dcr/compile_commands.json`
-  * `.dcr/build-info.json` (`schemaVersion`, `artifact_path`, `profile`, …)
-  * `.dcr/toolchain.json` (compiler/debugger paths, moc/uic/rcc)
-  * `.dcr/ide/` (placeholder for IDE lock files)
-* **`dcr gen project-info`** — `target`, `target_dir`, `artifact_path`, `artifact_kind`, `source_roots`, `include_globs`, `exclude_globs`; absolute/canonical paths.
-* **`dcr build --print-artifact-path`** — one absolute artifact path line on stdout after a successful build.
-* **`dcr gen … --quiet` / `-q`** — suppress human success logs for gen subcommands.
-* **`.clangd`** — created on first gen with `CompilationDatabase: .dcr` (`# managed by dcr gen`); custom `.clangd` is not overwritten.
-* **Helpers** `canonicalize_path`, `atomic_write`, `ensure_dcr_dir`; pure `resolve_artifact_path` via `platform::*`.
-* **`dcr new` / `dcr init`** — add `.dcr/` to `.gitignore`.
-
-**Changed (breaking):**
-
-* **`compile_commands.json` moved** from project root to **`.dcr/compile_commands.json`**.\
-  clangd discovers it via `.clangd` / `--compile-commands-dir=.dcr`.\
-  CLion and VSCode generators updated accordingly.
-* **Atomic write** for compile_commands (tmp + rename).
-* **`gen vscode` / `gen clion` launch/run** — use the same artifact path resolver as `project-info` / `build-info.json`.
-
-**Fixed:**
-
-* Launch configs no longer hardcode `target/\<profile>/\<name>` without the Linux triple segment.
-* Symlink/mount roots: best-effort canonicalize for root and compile database paths.
-
-## 0.8.3 (2026-08-03)
-
-### Добавлено:
-
-* **`dcr run -- \<args>...`** — cargo-style argument forwarding after a bare `--`\
-  (`dcr run --release -- --test_help`). Applies to direct binary runs and `[run].cmd`.
-* **Tests** — host target section `ldflags` without CLI `--target`; run-arg forwarding; `split_double_dash` unit tests.
-
-### Изменено:
-
-* **Native builds resolve the host triple** — without `--target` / package `build.target`, host sections such as\
-  `[build.x86_64-unknown-linux-gnu]` apply again (`cflags` / `ldflags` / toolchain).\
-  Previously the target was empty and those sections were ignored while artifacts already used the host triple path.
-* **Empty target** — no more `Unknown target ''` warning.
-* **`dcr run --help` / man `dcr-run`** — document `--` forwarding.
-
-### Исправлено:
-
-* **Native artifact paths on Windows and macOS** — without an explicit `--target` / `build.target`, artifacts use `target/\<profile>`, so `dcr run` and flat-bin find the build output.
-* Target-specific `ldflags` missing on native host builds (e.g. micro-lang + `libsct-elf`).
-* Spurious empty-target warning.
-
-## 0.8.2 (2026-07-22)
-
-### Добавлено
-
-* **Compile progress `[N/M]`** — live TTY status line (`compile  pkg v0.1.0  [12/41]`) so long mono-package builds do not look hung.
-* **DCR status style** — fixed-width verbs: `project`, `compile`, `dep`, `ready`, `pack`, `done`, `run`.
-* **Cargo feature `archive`** — optional FAT packing via `fatfs` (`cargo build --features archive`). Release CI builds with the feature; without it `[archive]` fails with a clear message.
-* **Tests** — `flat_bin_nasm_build`, package `build.target` without CLI `--target`, stricter workspace `clean --all`.
-* **CI expansion** — unit + integration on Linux/macOS/Windows, archive feature job, rust-cache, clippy default + all-features (see `.github/workflows/ci.yml`).
-
-### Изменено
-
-* **No forced host triple from CLI** — without `--target`, package/member `build.target` is honored (bare-metal / ISO `post_steps` paths).
-* **Relative include/lib flags** (`-I`, `-i`, `-isystem`, `-idirafter`, `-L`, `-T`) absolutized against the package root under workspace builds.
-* **`dcr clean --all`** — no spam for members without a local `target/` (shared root `target/`).
-* **`error` / `warn`** — red / yellow on stderr; CLI fully English (`Hint:`).
-* **Help / man** — list `add`, `lint`, `setup`; unknown command exits with code 1.
-* **Tool NotFound** — `linker not found: ld.lld …` / `{tool} not found …` instead of raw `os error 2`.
-
-## 0.8.1 (2026-07-20)
-
-### Added
-
-* **`build.kind = "flat-bin"`** — raw binary (default `.bin`) for OS-dev payloads:
-  * **NASM** — `-f bin` → `\<stem>.bin`
-  * **FASM** — direct output (`format binary` in source)
-  * **GAS / MASM / LLC** — object → `objcopy -O binary` → `\<stem>.bin`
-  * **C/C++** — objects → freestanding link → `objcopy -O binary` → `\<name>.bin`
-  * Requires `llvm-objcopy` / `objcopy` / `gobjcopy` except for NASM/FASM direct emit
-* **`[archive]` section** — FAT12/16/32 disk images after build (`output`, `format`, `size`, `offset`, `label`, `bootsector`, `layout`). From 0.8.2 requires feature `archive`.
-* **Single-file `build.roots`** — a root may be a single source or header file, not only a directory.
-
-### Changed
-
-* **`--force`** also re-runs `build.steps` and `build.post_steps`.
-* **`dcr run` on workspace-only root** — if `[run].cmd` is set, run that after build; otherwise delegate to a workspace member.
-
-## 0.8.0 (2026-07-18)
-
-### 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.cxx]`, `[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)
-
-### Added
-
-* **Native Qt support** — automatic meta-object handling (MOC, UIC, RCC) added when `build.qt = true` is set in `dcr.toml`.
-* **`dcr lint` command** — C/C++ static analysis via `clang-tidy`. Supports `--fix` for automatic fixes. Respects `build.roots` and `build.src_disable` from config.
-* **Three new assembler backends**:
-  * **MASM** (`compiler = "ml"` / `"ml64"`) — Microsoft Macro Assembler.
-  * **FASM** (`compiler = "fasm"`) — Flat Assembler.
-  * **LLVM IR** (`compiler = "llc"`) — compiles `.ll` files via `llc -filetype=obj`.
-* **Shared ASM pipeline** — linking and archiving logic consolidated into `core/builder/asm.rs`. Adding a new assembler backend now takes ~30 lines.
-* **Filesystem utilities** — `to_hex()` and `home_dir()` extracted to `utils/fs.rs`.
-* **Build utilities** — `normalize_target()`, `normalize_kind()`, `normalize_platform()`, `default_profile_flags()` extracted to `utils/build.rs`.
-* **Backend helpers** — `asm_lang_flag()`, `source_extensions()`, `elapsed_secs()` added to `core/builder/common.rs`.
-* **Full Bare-Metal / Freestanding Automation** — introduced the `build.freestanding = true` configuration option. When enabled (or when a bare-metal target is detected), DCR automatically injects `-ffreestanding` during compilation and both `-nostdlib` and `-static` during linking.
-* **Artifact Optimization (LTO & Strip)** — added `build.lto` (auto-injects `-flto` for compiler and linker) and `build.strip` (automatically strips debug symbols via linker `-s` flag) options to `dcr.toml`.
-* **Compilation Thread Control** — added the `build.codegen-units` option to strictly limit the maximum number of parallel jobs utilized by the custom `parallel_build` worker pool.
-* **Panic Behavior Management** — added `build.panic = "abort"` support. For C++ targets, it automatically strips exception handling and unwind tables via `-fno-exceptions`, `-fno-unwind-tables`, and `-fno-asynchronous-unwind-tables`.
-
-### Changed
-
-* **Intelligent Default Flags Generation** — automated injection of fallback optimization (`-O3`/`-O0`), debug (`-g`), and warning (`-Wall -Wextra`) flags is now suppressed for bare-metal and freestanding builds if `build.cflags` are overridden.
-* **Centralized Bare-Metal Detection** — relocated the `is_bare_metal_target` helper to common build utilities (`src/utils/build.rs`) for unified access across the building core.
-* **Architectural Refactoring**:
-  * Renamed `src/config.rs` to `src/templates.rs`.
-  * Started consolidation of configuration and build orchestration logic.
-
-## 0.7.3 (2026-06-13)
-
-### Added
-
-* **`--vcs` option for `new` and `init` commands** — introduced explicit version control system selection via `--vcs \<git|none>`.
-* **Git metadata integration in `--version`** — the CLI now appends the current short commit hash and a `-dirty` suffix if there are uncommitted changes in the DCR repository.
-* **Automatic `.gitignore` generation** — Git repository initialization now automatically writes a `.gitignore` file excluding the `/target` directory.
-* **Nested repository prevention** — automatic Git initialization is now skipped if `dcr new` or `dcr init` is executed inside an already existing Git repository.
-* **VCS verification tests** — added `new_vcs_options_work` and `init_vcs_options_work` integration tests to ensure reliable repository behavior.
-
-### Changed
-
-* **Complete removal of `git2` dependency** — all Git actions (dependency fetching, VCS setup, status checks) are now delegated to the system `git` executable via `Command`. This simplifies compilation and drops the need for `vendored` and `openssl` features.
-* **Migrated from `reqwest` to `ureq`** — replaced the heavy `reqwest` crate in `flag_update.rs` with the lightweight synchronous `ureq 2.10` client, reducing overhead and the final binary size.
-
-## 0.7.2 (2026-06-07)
-
-### Added
-
-* `default_target_triple()` now respects `target_env` — Linux (gnu/musl) and Windows (msvc/gnu) use the correct environment instead of hardcoded values.
-
-### Исправлено
-
-* **macOS Apple Silicon builds failed with `_main` undefined** — `--target=` is now passed to ldflags, not just cflags. `default_target_triple()` uses `std::env::consts::ARCH` on macOS instead of hardcoded `x86_64`.
-* **GitHub Stars and GPL-3.0 badges not rendering in README** — badge block converted to pure HTML.
-
-### Changed
-
-* Default target resolution extracted into shared `default_target_triple()` — removed duplication across build, run, clean.
-
-## 0.7.1 (02.06.2026)
-
-### Added
-
-* **`--help` для всех команд** — `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`. Во всех результатах вывода используются стилизованные заголовки (зелёного цвета) и строки с информацией об использовании (голубого цвета).
-* **Справочные страницы** — 12 страниц в формате troff в каталоге `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`.
-* **Справочные страницы во всех пакетах** — install.sh, install_bsd.sh, PKGBUILD из AUR,
-  Debian (cargo-deb), RPM (cargo-generate-rpm), Nix (postInstall), Homebrew
-  (ресурс), Snap, ресурсы релизов GitHub.
-* **Проверка имени проекта** — команды `dcr init` и `dcr new` теперь проверяют имена перед созданием файлов
-  . Допускаются только буквы ASCII, цифры, символы `_` и `-`.
-* **Поля `documentation` и `homepage`** — добавлены в файл `Cargo.toml`.
-* **Оптимизации профиля релиза** — `opt-level = "z"`, LTO, `codegen-units = 1`,
-  `panic = "abort"`, `strip = true` для уменьшения размера бинарных файлов.
-* **Платформы Linux i686, armv7, riscv64** — добавлены в рабочий процесс выпуска и скрипты установки.
-* **Платформы Linux musl i686 и armv7** — скомпилированы с помощью zigbuild в системе непрерывной интеграции (CI).
-* **Пакеты AUR** — рабочий процесс публикации `dcr-dev`, `dcr-dev-bin`.
-* **Публикация Snap** — автоматическая публикация Snapcraft в рамках непрерывной интеграции (CI).
-* **Значок Snap** — в файле README.
-
-### Changed
-
-* **`validate_package_name` стал общедоступным** — его можно вызывать из команд CLI.
-* **Таблица платформы README** — реорганизована: варианты libc вынесены в отдельные строки по ОС,
-  удалены лишние столбцы. Обновлен список архитектур Linux.
-* **Вывод `gen.rs` без аргументов** — теперь используется стилизованный вывод вместо необработанного `eprintln!`.
-* **`tree.rs`, `fmt.rs` и `setup.rs`** — теперь поддерживают аргументы для опции `--help`.
-* **Команды установки из файла README** — `| bash` → `| sh` для обеспечения совместимости с POSIX.
-
-### Fixed
-
-* **`dcr new \<invalid-name>` создает каталог, а затем завершается с ошибкой** — теперь проверка
-  выполняется до начала любых операций с файлами.
-* **`dcr init` при указании недопустимого имени каталога** — то же исправление.
-* **Отсутствующие справочные страницы в установленных пакетах** — теперь поставляются во всех форматах.
-* **Ложное срабатывание по букве диска Windows** — в модуле анализа файлов зависимостей.
-* **CRLF (`\r\n`) вызывает сбой в работе парсера зависимостей** — теперь поддерживается обработка смешанных символов окончания строк.
-* **Новая строка после обратного слеша не обработана** — при обработке экранирующих символов в функции `parse_d_file`.
-
-## 0.7.0 (01.06.2026)
-
-### 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

@@ -1,47 +0,0 @@
----
-sidebar_label: Команды сборки (build, run, clean)
----
-
-# Команды сборки
-
-## `dcr build`
-
-Собирает проект по `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 (also re-runs build.steps / post_steps)
-dcr build --clean                 # clean + build
-dcr build --verbose               # show compilation commands
-dcr build --workspace pkg-a       # build specific workspace package
-```
-
-Артефакты: `target/\<triple>/\<profile>/\<binary-name>` (Linux с явным целевым объектом).
-
-With `[archive]` in `dcr.toml`, a FAT disk image is packed after a successful build.
-
-## `dcr run`
-
-Собирает (если исходники новее артефакта) и запускает бинарник.
-
-```bash
-dcr run
-dcr run --release
-dcr run --force                   # force rebuild then run
-```
-
-On a **workspace-only** root: if `[run].cmd` is set, that command is used after build; otherwise DCR delegates to a workspace member.
-
-## `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

@@ -1,61 +0,0 @@
----
-sidebar_label: Команды зависимостей (add, tree)
----
-
-# Команды зависимостей
-
-## `dcr add \<name> [source]`
-
-Добавляет зависимость в `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
-dcr add fmt pkg-config:fmt     # system package via pkg-config
-dcr add openssl pkg:openssl,libcrypto # multiple pkg-config packages
-```
-
-Префиксы источника:
-
-* `path:` — локальный путь
-* `git:` — URL адрес git-репозитория
-* `github:` — расширение `https://github.com/\<user>/\<repo>`
-* `gitlab:` — расширение `https://gitlab.com/\<user>/\<repo>`
-* `pkg-config:` / `pkg:` — one or more packages resolved by `pkg-config`
-* `http://` / `https://` / `git@` — полный URL
-
-Флаги:
-
-* `--branch \<name>` — git ветка
-* `--tag \<name>` — git tag
-* `--rev \<hash>` — git commit
-
-Если источник не указан — DCR выполняет поиск в подключенных реестрах. A bare relative or absolute path is accepted as a path dependency.
-
-For `pkg-config` dependencies, the referenced packages must already be installed
-and provide `.pc` files. DCR invokes `pkg-config` during the build (using
-`PATH` and `PKG_CONFIG_PATH`) and forwards the returned compiler and linker
-flags; it does not download or build these packages.
-
-## `dcr tree`
-
-Показывает дерево зависимостей проекта.
-
-```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

@@ -1,73 +0,0 @@
----
-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

@@ -1,40 +0,0 @@
----
-sidebar_label: Команды проекта (new, init)
----
-
-# Команды проекта
-
-## `dcr new \<name>`
-
-Создает новый проект со стандартной структурой и `dcr.toml`. Аргумент `name` является обязательным.
-
-В названии проекта допускаются только ASCII буквы, цифры и подчеркивания `_` и дефисы `-`.
-
-```bash
-dcr new my-app
-dcr new my-app --vcs none
-```
-
-Flags:
-
-* `--vcs \<git|none>` — Initialize version control system (defaults to `git` if available, or `none`).
-
-Генерирует:
-
-* `dcr.toml` с базовыми полями
-* `src/main.c` с основным шаблоном
-
-## `dcr init`
-
-Инициализирует проект DCR в текущем (пустом) каталоге.
-
-```bash
-dcr init
-dcr init --vcs none
-```
-
-Flags:
-
-* `--vcs \<git|none>` — Initialize version control system (defaults to `git` if available, or `none`).
-
-Название проекта взято из имени текущего каталога. Имя каталога должно соответствовать тем же правилам именования, что и в `dcr new`.

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

@@ -1,60 +0,0 @@
----
-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. Собирает проект
-2. Собирает файлы `tests/*.c` (только `.c`, не `.cpp`)
-3. Компилирует и линкует каждый файл теста
-4. Запускает каждый бинарник тестов
-5. Вывод сводки: TOTAL, PASS, SKIP, FAIL
-6. Возвращает ненулевой код при наличии FAIL
-
-## `dcr fmt`
-
-Форматирует исходный код C/C++ через `clang-format`.
-
-```bash
-dcr fmt
-```
-
-Процессы: `src/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}` и `tests/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}`.
-
-Использует `.clang-format` в корне проекта (если таковой имеется), иначе стиль clang-format по умолчанию.
-
-## `dcr lint`
-
-Выполняет `clang-tidy` на C/C++ исходных файлах для статического анализа.
-
-```bash
-dcr lint              # отобразить диагностику
-dcr lint --fix        # автоматически применить исправления
-dcr lint --help       # подробная справка
-```
-
-Процессы: `src/**/*.{c,cpp,cxx,cc}` и `tests/**/*.{c,cpp,cxx,cc}`.
-
-Без параметра `--fix` clang-tidy выдает предупреждения и ошибки, не внося изменений в файлы.
-При параметре `--fix` clang-tidy автоматически вносит предложения по исправлениям на месте.

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

@@ -1,51 +0,0 @@
----
-sidebar_label: Системные команды (setup, --help, ...)
----
-
-# Системные команды
-
-## `dcr setup`
-
-`~/.dcr/config.toml` — конфигурация реестров
-
-```bash
-dcr setup
-```
-
-Если файл `~/.dcr/config.toml` не найден, DCR возвращает ошибку. Создайте его вручную:
-
-```toml
-[registry.default]
-url = "https://index.dcr.pm"
-priority = 1
-```
-
-## `dcr --help`
-
-Отображает справку по всем командам.
-
-```bash
-dcr --help
-```
-
-## `dcr --version`
-
-Отображает версию и целевую платформу.
-
-```bash
-dcr --version       # dcr 0.7.0 (x86_64-unknown-linux-gnu)
-```
-
-## `dcr --update`
-
-Автоматическое обновление. Загружает последнюю версию бинарного файла из раздела «Релизы» на GitHub и заменяет текущую версию.
-
-```bash
-dcr --update
-```
-
-Возможности:
-
-* Определяет платформу и архитектуру автоматически
-* Выдает предупреждение при установке через AUR (вместо этого используйте пакетный менеджер)
-* Работает на Linux, macOS, Windows

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

@@ -1,53 +0,0 @@
----
-sidebar_label: Вклад
----
-
-# Вклад
-
-## Настройка
-
-```bash
-git clone https://github.com/dexoron/dcr
-# or a source mirror: GitVerse / SourceCraft / SourceForge / GitLab (see README)
-cd dcr
-cargo build
-```
-
-## Стиль написания кода
-
-Весь код форматируется через `cargo fmt`:
-
-```bash
-формат груза
-```
-
-## Линтер
-
-```bash
-cargo clippy --all-targets -- -D warnings
-```
-
-## Тесты
-
-```bash
-тест cargo --all-targets
-```
-
-## Процесс связей с общественностью
-
-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 runs (see `.github/workflows/ci.yml`):
-
-* `cargo fmt --check`
-* `cargo clippy` (default + `--all-features`)
-* `cargo check --all-targets --all-features`
-* Unit + integration tests on Linux, macOS, Windows
-* Extra Linux job with `--features archive` (FAT images)
-* Tools on runners: clang, nasm, clang-format/tidy (Linux)

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

@@ -1,75 +0,0 @@
----
-sidebar_label: Часто задаваемые вопросы
----
-
-# Часто задаваемые вопросы
-
-## Реестр не найден
-
-```
-Ошибка: реестр не найден
-```
-
-**Решение:** Убедитесь, что файл `~/.dcr/config.toml` существует:
-
-```toml
-[registry.default]
-url = "https://index.dcr.pm"
-priority = 1
-```
-
-Если реестр кастомный, проверьте `DCR_INDEX_PATH`:
-
-```bash
-echo $DCR_INDEX_PATH
-```
-
-## Компилятор не найден
-
-```
-Ошибка: компилятор не найден
-```
-
-**Решение:** Убедитесь, что компилятор установлен и доступен в PATH.
-
-```bash
-какой gcc
-какой clang
-```
-
-Или укажите явно через `[toolchain]` или `DCR_COMPILER`.
-
-## Ctrl+C во время сборки
-
-DCR корректно обрабатывает SIGINT: прерывает текущую компиляцию и завершает процесс с ненулевым кодом.
-
-## Как создать библиотеку?
-
-[Library Recipe](/docs/recipes/library-project).
-
-## Как выполнить кросс-компиляцию для Windows?
-
-См. [Cross-Compile Recipe](/docs/recipes/cross-to-windows).
-
-## Как сделать мультипакетный проект?
-
-См. [Workspace Recipe](/docs/recipes/multi-package-workspace).
-
-## Bootloader / pure NASM OS image
-
-Use `kind = "flat-bin"` (NASM `-f bin`) and optional `[archive]` for a FAT disk image.
-
-See [OS-dev recipe](/docs/recipes/os-flat-bin-archive).
-
-## How do I choose a download mirror?
-
-`dcrup install` uses `--mirror auto` by default and tries **cf → gh → sf → ya**.
-
-```bash
-dcrup install stable --mirror cf
-export DCRUP_MIRROR=ya
-```
-
-## Lock-файл устарел
-
-При изменении зависимостей `dcr.lock` автоматически обновляется при следующем `dcr add`. Если нужно принудительно обновить — удалите `dcr.lock` и выполните `dcr build`.

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

@@ -1,79 +0,0 @@
----
-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"
-
-[build]
-language = "c"
-standard = "c11"
-compiler = "clang"
-kind = "bin"
-```
-
-## Сборка
-
-```bash
-dcr build
-```
-
-Результат — `target/\<triple>/debug/my-app` (Linux) или `target/debug/my-app.exe` (Windows).
-
-Профиль сборки:
-
-```bash
-dcr build --release       # release сборка
-dcr build --debug         # debug (по умолчанию)
-```
-
-## Запустить
-
-```bash
-dcr run
-```
-
-Собирает (если нужно) и запускает бинарник.
-
-## Первый тест
-
-```bash
-dcr test --init      # создать шаблон теста
-dcr test             # запустить тесты
-```
-
-## Форматирование
-
-```bash
-dcr fmt              # clang-format по .clang-format
-```
-
-## Linting
-
-```bash
-dcr lint             # clang-tidy checks
-dcr lint --fix       # apply fixes automatically
-```

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

@@ -1,153 +0,0 @@
----
-sidebar_label: Установка
----
-
-# Установка
-
-## dcrup (recommended)
-
-Install and switch DCR versions (stable / dev / night, pin `0.8.2`, optional build from source).
-
-### Linux / macOS / BSD / Windows (bash)
-
-```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
-export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable
-```
-
-Non-interactive install of DCR in one shot:
-
-```sh
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- install stable
-export PATH="$HOME/.dcr/bin:$PATH"
-```
-
-### Windows (PowerShell)
-
-```powershell
-irm https://ps1.dcr-tool.ru | iex
-# or download then run:
-# irm https://ps1.dcr-tool.ru -OutFile dcrup.ps1
-# powershell -File .\dcrup.ps1 self-install
-# $env:Path += ";$env:USERPROFILE\.dcr\bin"
-dcrup install stable
-```
-
-Optional cmd bootstrap (if you prefer `curl` of the cmd shim):
-
-```bat
-curl -fsSL -o dcrup.cmd https://cmd.dcr-tool.ru
-```
-
-After `self-install`, the command is **`dcrup`** (no `.sh` / `.ps1`): shims live in `~/.dcr/bin` (Unix) or `%USERPROFILE%\.dcr\bin` (Windows `dcrup.cmd`).
-
-### Common dcrup commands
-
-```sh
-dcrup install stable              # latest stable prebuilt (auto: cf → gh → sf → ya)
-dcrup install 0.8.2               # pin → 0.8.2@stable
-dcrup install 0.8.2@dev
-dcrup install stable --libc musl  # Linux: musl asset (default: gnu)
-dcrup install stable --mirror cf  # CloudFlare CDN
-dcrup install stable --mirror ya  # Yandex CDN (RU fallback)
-dcrup install stable --build      # cargo build --features archive
-dcrup install night               # always build from branch dev HEAD
-dcrup default 0.8.2
-dcrup update
-dcrup list
-dcrup show
-dcrup which
-```
-
-Layout: `~/.dcr/toolchains/\<id>/dcr` and `~/.dcr/bin/dcr` → active version.
-
-### Download mirrors
-
-Prebuilt installs try **cf → gh → sf → ya** unless you pin a host.
-
-| Code | URL                                                                                                          | Notes                      |
-| ---- | ------------------------------------------------------------------------------------------------------------ | -------------------------- |
-| `cf` | `https://cdn-global.dcr-tool.ru/\<tag>/\<asset>`                           | CloudFlare CDN (worldwide) |
-| `gh` | `https://github.com/dexoron/dcr/releases/download/\<tag>/\<asset>`         | GitHub Releases            |
-| `sf` | `https://sourceforge.net/projects/dcr-tool/files/\<tag>/\<asset>/download` | SourceForge                |
-| `ya` | `https://cdn-ru.dcr-tool.ru/\<tag>/\<asset>`                               | Yandex CDN (RU fallback)   |
-
-```sh
-dcrup install stable --mirror auto   # default
-export DCRUP_MIRROR=cf               # persist for this shell
-```
-
----
-
-## Arch Linux (AUR)
-
-```sh
-ура -S dcr
-```
-
-## macOS / Linux (Homebrew)
-
-```sh
-brew tap dexoron/dexoron
-brew install dcr
-```
-
-## Snap (Linux)
-
-```sh
-sudo snap install dcrup
-```
-
-> If classic Snap Store publishing is unavailable, install the `.snap` from [GitHub Releases](https://github.com/dexoron/dcr/releases/latest) with `--dangerous`.
-
-## Nix (flake)
-
-```sh
-nix run github:dexoron/dcr
-nix profile install github:dexoron/dcr
-```
-
-## Cargo (crates.io)
-
-```sh
-cargo install dcr
-```
-
-Note: crates.io builds may omit optional features. For FAT disk images (`[archive]`), prefer release binaries or:
-
-```sh
-cargo install dcr --features archive
-```
-
-## Из источника
-
-```sh
-git clone https://github.com/dexoron/dcr.git
-cd dcr
-cargo build --release --features archive
-ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
-# or manage versions with dcrup install night / --build
-```
-
-## После установки
-
-```bash
-dcr --version
-dcrup show    # if installed via dcrup
-```
-
-Man pages (package installs / release assets):
-
-```bash
-man dcr
-man dcr-build
-```
-
-Registry (optional) — `~/.dcr/config.toml`:
-
-```toml
-[registry.default]
-url = "https://index.dcr.pm"
-priority = 1
-```

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

@@ -1,58 +0,0 @@
----
-sidebar_label: Интеграция с IDE
----
-
-# Интеграция с IDE
-
-## VS Code
-
-Install the recommended [DCR extension by Dexoron-Labs](https://marketplace.visualstudio.com/items?itemName=Dexoron-Labs.dcr). Do not install Microsoft C/C++ extensions for DCR projects: DCR uses `clangd`. MS C/C++ is acceptable only when you need its debugger.
-
-Recommended companion extensions:
-
-* [Even Better TOML](https://marketplace.visualstudio.com/items?itemName=tamasfe.even-better-toml)
-* [CodeLLDB](https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb), or MS C/C++ for debugger support only
-
-```bash
-dcr gen vscode
-```
-
-Генерирует в `.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` | Конфигурации запуска для каждого бинарного файла |
-
-## compile_commands.json
-
-```bash
-dcr gen команды компиляции
-```
-
-Генерирует `compile_commands.json` в корне проекта. Стандартный формат для:
-
-## информация о проекте
-
-```bash
-dcr gen info-проекта
-```
-
-Выводит JSON с метаданными проекта (см. [gen-commands](/docs/commands/gen-commands)).

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

@@ -1,33 +0,0 @@
----
-sidebar_label: Лицензия
----
-
-# Лицензия
-
-## DCR
-
-DCR распространяется под лицензией [GPL-3.0-or-later](https://spdx.org/licenses/GPL-3.0-or-later.html).
-
-> **Важно:** DCR — инструмент сборки, а не библиотека. GPL распространяется только на исходный код самого DCR. Проекты, собранные с помощью DCR, не подпадают под лицензию DCR — их лицензирование определяется исключительно их собственным кодом и зависимостями.
-
-## Rust-зависимости
-
-DCR написан на Rust. Ниже перечислены основные статически связываемые крейты:
-
-| Крейт                                                   | Лицензия           |
-| ------------------------------------------------------- | ------------------ |
-| [`ureq`](https://crates.io/crates/ureq)                 | MIT ИЛИ Apache-2.0 |
-| [`serde`](https://crates.io/crates/serde)               | MIT ИЛИ Apache-2.0 |
-| [`toml`](https://crates.io/crates/toml)                 | MIT ИЛИ Apache-2.0 |
-| [`toml_edit`](https://crates.io/crates/toml_edit)       | MIT OR Apache-2.0  |
-| [`serde_json`](https://crates.io/crates/serde_json)     | MIT ИЛИ Apache-2.0 |
-| [`sha2`](https://crates.io/crates/sha2)                 | MIT ИЛИ Apache-2.0 |
-| [`glob`](https://crates.io/crates/glob)                 | MIT ИЛИ Apache-2.0 |
-| [`self-replace`](https://crates.io/crates/self-replace) | MIT ИЛИ Apache-2.0 |
-| [`ctrlc`](https://crates.io/crates/ctrlc)               | MIT ИЛИ Apache-2.0 |
-
-Full dependency tree is available in [`Cargo.lock`](https://github.com/dexoron/dcr/blob/main/Cargo.lock). Подавляющее большинство имеют двойную лицензию MIT OR Apache-2.0.
-
-## Дополнительные благодарности
-
-* Дизайн CLI и модель проектов DCR вдохновлены [Cargo](https://doc.rust-lang.org/cargo/).

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

@@ -1,47 +0,0 @@
----
-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

@@ -1,70 +0,0 @@
----
-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

@@ -1,103 +0,0 @@
----
-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 = "c11"
-workspace_only = true
-
-[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
-```
-
-## Пакеты
-
-`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/recipes/os-flat-bin-archive.mdx.mdx

@@ -1,89 +0,0 @@
----
-sidebar_label: OS-dev (flat-bin + archive)
----
-
-# Pure ASM / boot image (flat-bin + archive)
-
-Minimal OS-dev style pipeline: assemble raw binaries with NASM, then pack a FAT floppy/image with an optional boot sector.
-
-## Project layout
-
-```
-myos/
-  dcr.toml
-  src/
-    boot.asm      # boot sector (512 bytes)
-    kernel.asm    # payload
-```
-
-For multiple flat artifacts, use a **workspace** (one member per binary) or separate packages; a single `flat-bin` package produces one binary per source stem.
-
-## Boot package (`flat-bin`)
-
-```toml
-[package]
-name = "boot"
-version = "0.1.0"
-
-[build]
-language = "asm"
-compiler = "nasm"
-kind = "flat-bin"
-extension = "bin"
-roots = ["src/boot.asm"]
-```
-
-```bash
-dcr build
-# → target/<…>/debug/boot.bin  (NASM -f bin, no link)
-```
-
-## Disk image after build
-
-```toml
-[archive]
-output = "target/{profile}/disk.img"
-format = "fat12"
-size = "1440K"
-label = "MYOS"
-bootsector = "target/{profile}/boot.bin"
-
-[[archive.layout]]
-from = "target/{profile}/kernel.bin"
-to = "KERNEL.BIN"
-```
-
-* `format`: `fat12`, `fat16`, or `fat32`
-* `size`: bytes or `K`/`KB`/`M`/`MB`/`G`/`GB` (default ~1.44 MiB)
-* `bootsector`: written only when `offset` is omitted or `0`
-* `from` may be a glob; `{profile}` is substituted in paths
-
-## C kernel → flat binary
-
-```toml
-[build]
-language = "c"
-compiler = "clang"
-kind = "flat-bin"
-freestanding = true
-filename = "kernel"
-extension = "bin"
-ldflags = ["-T", "linker.ld"]
-```
-
-Pipeline: objects → temporary linked ELF → `objcopy -O binary` → `kernel.bin`. Requires `objcopy` / `llvm-objcopy` in PATH.
-
-## Other assemblers
-
-| Tool     | Notes                                                                                   |
-| -------- | --------------------------------------------------------------------------------------- |
-| **FASM** | Write `format binary` in the source; DCR writes `\<stem>.bin` directly |
-| **GAS**  | Assemble `.s` → obj → `objcopy -O binary`                                               |
-| **LLC**  | `language = "llvm_ir"` → obj → objcopy                                                  |
-| **MASM** | COFF obj → objcopy (needs binutils/LLVM objcopy)                                        |
-
-## Notes
-
-* Single-file `roots` are supported: `roots = ["src/boot.asm"]`.
-* `--force` re-runs `build.steps` / `build.post_steps` as well as recompilation.
-* Prefer `kind = "elf"` if you need a relocatable ELF kernel without stripping to raw binary.

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

@@ -1,82 +0,0 @@
----
-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]`
-
-* **Скалярные поля** (строки, числа, логические значения) — заменены
-* Массивы (`cflags`, `ldflags`, ...) **заменяются полностью**, а не дополняются
-
-Установите `inherit = false`, чтобы отключить наследование массивов (будут использоваться только собственные массивы профиля).
-
-## Кастомные профили
-
-Флаги по умолчанию для каждого профиля формируются из трёх полей конфигурации:
-
-| Поле             | Default cflags     | Профили сборки |
-| ---------------- | ------------------ | -------------- |
-| `opt_level`      | `-O0 -g`           | `"3"`          |
-| `debug`          | `true`             | `false`        |
-| `предупреждения` | `["all", "extra"]` | `[]`           |
-
-Которые генерируют соответствующие флаги компилятора:
-
-| Профиль | Действующие флаги                                          |
-| ------- | ---------------------------------------------------------- |
-| `debug` | `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG` |
-| `релиз` | `-O3 -DNDEBUG`                                             |
-
-Дополнительные параметры сборки можно включать или отключать для каждого профиля:
-
-```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"]
-```
-
-Порядок применения (в порядке убывания приоритета):
-
-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

@@ -1,136 +0,0 @@
----
-sidebar_label: Система сборки
----
-
-# Система сборки
-
-## Бэкенды компилятора
-
-DCR поддерживает 4 бэкенда компиляции. Выбор происходит автоматически на основе расширения файла и target triple.
-
-| Бэкенд    | Файлы                                   | Когда используется                    |
-| --------- | --------------------------------------- | ------------------------------------- |
-| `unix_cc` | `.c`, `.cpp`, `.cxx`, `.cc`, `.s`, `.S` | gcc/clang на Linux/macOS/BSD          |
-| `msvc`    | `.c`, `.cpp`, `.cxx`, `.cc`             | Windows (cl, clang-cl)                |
-| `газ`     | `.s`, `.S`                              | ARM/ARM64 ассемблер                   |
-| `nasm`    | `.asm`, `.s`                            | x86/x86_64 ассемблер                  |
-| `masm`    | `.asm`                                  | MASM (ml/ml64) в Windows              |
-| `fasm`    | `.asm`, `.fasm`                         | Сборщик плоских деталей               |
-| `llvm_ir` | `.ll`                                   | LLVM IR с помощью `llc -filetype=obj` |
-
-## Поддержка Qt
-
-DCR обеспечивает встроенную поддержку Qt для автоматической обработки метаобъектов (MOC, UIC, RCC).
-
-Чтобы включить эту функцию, установите значение `build.qt = true` в файле `dcr.toml`. DCR автоматически обнаружит файлы, связанные с Qt (`.ui`, `.qrc`, `.h` с `Q_OBJECT`), и обработает их.
-
-```toml
-[build]
-qt = true
-```
-
-*Примечание: Требуется установка модулей `qt6` (Core, Widgets, Gui, Svg) с помощью `pkg-config`.*
-
-Если требуется специальная обработка, по-прежнему можно выполнить расширенную настройку с помощью файла `build.steps`:
-
-```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`
-* Условные флаги, зависящие от настроек:
-  * `freestanding` или целевая среда «bare-metal»: `-ffreestanding` (компиляция), `-nostdlib -static` (линковка)
-  * `lto`: `-flto` (компиляция + линковка)
-  * `panic = "abort"`: `-fno-exceptions` (только для C++), `-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`, `-o`, `-D`, `-f` (format: win64/elf64/macho64/macho32/elf32; **`bin` when `kind = "flat-bin"`**)
-* MASM: `/nologo /c /Fo\<obj> <source>`
-* FASM: `<source> \<output>` (путь вывода — объектный файл)
-* LLVM IR: `-filetype=obj <source> -o \<output>`
-
-## Инкрементные сборки
-
-Три уровня инкрементальности:
-
-1. **mtime** — если выходной файл новее всех входных, файл не перекомпилируется
-2. **`.d` files** — отслеживание изменений в заголовочных файлах (включая транзитивные)
-3. **SHA256 fingerprint** — если флаги компиляции изменились, файл перекомпилируется (fingerprint хранится в `.dcr_fingerprint`)
-
-## Параллельная компиляция
-
-* Используется `thread::scope` для создания пула потоков
-* Атомарная очередь задач (`AtomicU64`)
-* Мьютекс на запись в stdout (`OUTPUT_MUTEX`)
-* Количество потоков = `available_parallelism()`, ограниченное значением `build.codegen-units`, если оно задано
-
-## Типы сборок
-
-| Тип                | Тип                                  | Путь (пример для Linux)                                                                                                                       |
-| ------------------ | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
-| `bin`              | Исполняемый файл                     | `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 без стандартной библиотеки       | `target/\<profile>/\<name>`                                                                                 |
-| `нет`              | Только компиляция, без линковки      | —                                                                                                                                             |
-| `пользовательский` | Полный контроль filename + extension | `target/\<profile>/\<filename>.\<extension>`                                               |
-| `flat-bin`         | Raw binary                           | ASM: `\<stem>.bin` (NASM `-f bin` / FASM / GAS·MASM·LLC via objcopy); C/C++: `\<name>.bin` (link + objcopy) |
-
-## Disk images (`[archive]`)
-
-After a successful build, if `[archive]` is present in `dcr.toml`, DCR formats a FAT volume and copies files from `layout` into the image. See [dcr.toml → archive](/docs/reference/dcr-toml#archive).
-
-## Этапы сборки
-
-DCR поддерживает pre-build и post-build шаги через Qt codegen:
-
-* `build.steps` — команды, выполняемые перед компиляцией
-* `build.post_steps` — команды, выполняемые после компиляции
-
-Подстановки: `{stem}`, `{in}`, `{out}`.
-
-`rcc` — Resource Compiler: `{stem}.qrc → qrc_{stem}.cpp`
-
-```toml
-[build.steps]
-moc = "moc {in} -o {out}"
-```
-
-## pkg-config
-
-Автоматический поиск (чтение из исходного файла конфигурации):
-
-```toml
-[build]
-pkg_config = ["sdl2", "gl"]
-```
-
-DCR вызывает `pkg-config --cflags sdl2 gl` и `pkg-config --libs sdl2 gl` и добавляет результат в флаги компиляции/линковки.
-
-## Подстановка переменных
-
-Поддерживаемые переменные:
-
-| Переменная              | Описание                                  |
-| ----------------------- | ----------------------------------------- |
-| `{version}`             | Версия пакета                             |
-| `{version_major}`       | Часть, обозначающая основную версию       |
-| `{version_minor}`       | Часть, обозначающая второстепенную версию |
-| `{version_patch}`       | Переменная                                |
-| `{version_suffix}`      | Суффикс (например, `-rc1`)                |
-| `{version_suffix_dash}` | Суффикс с тире                            |
-| `{profile}`             | Имя профиля (debug/release/...)           |
-| `{name}`                | Имя пакета                                |

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

@@ -1,64 +0,0 @@
----
-sidebar_label: Кросс-компиляция
----
-
-# Кросс-компиляция
-
-## Сокращённые названия
-
-DCR поддерживает короткие имена платформ, которые автоматически раскрываются в полные triples:
-
-| Краткое название | Полный тройной             |
-| ---------------- | -------------------------- |
-| `linux`          | `x86_64-unknown-linux-gnu` |
-| `macos`          | `x86_64-apple-darwin`      |
-| `windows`        | `x86_64-pc-windows-msvc`   |
-
-```bash
-dcr build --target windows
-```
-
-## Полные тройки
-
-```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
-
-Для целевых платформ, содержащих значения `none`, `-elf`, `eabi` или `baremetal`, DCR автоматически:
-
-1. Для none/elf/eabi/bare-metal target-ов отключаются DCR default флаги (нет `-I` системных путей, нет `-l` libc).
-2. **Вставляет `-ffreestanding`** на этапе компиляции и `-nostdlib -static` на этапе линковки
-
-Кроме того, можно явно включить автономный режим:
-
-```toml
-[build]
-freestanding = true
-```
-
-```bash
-dcr build --target aarch64-none-elf
-```
-
-## Целевой каталог
-
-By default, the compilation output directories are structured as follows:
-
-* **Linux and BSD**: Always output to `target/\<triple>/\<profile>/` (using host triple if no target is specified).
-* **macOS and Windows (without target)**: Output to `target/\<profile>/`.
-* **macOS and Windows (with explicit target)**: Output to `target/\<triple>/\<profile>/`.

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

@@ -1,284 +0,0 @@
----
-sidebar_label: Обзор dcr.toml
----
-
-# Обзор dcr.toml
-
-Основной конфигурационный файл проекта. Располагается в корне проекта.
-
-## Структура
-
-```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
-
-[archive]
-# optional: pack FAT disk image after build
-```
-
-## [пакет]
-
-| Поле          | Обязательное | Описание                                                                                                        |
-| ------------- | ------------ | --------------------------------------------------------------------------------------------------------------- |
-| `имя`         | да           | Имя проекта                                                                                                     |
-| `версия`      | да           | Semantic version of the **project**                                                                             |
-| `dcr-version` | no           | Semver of the **dcr tool** this project targets. Written by `dcr new` / `dcr init` to the current tool version. |
-| `тип`         | нет          | `app`, `lib`, `none` (defaults to `"none"`)                                                                     |
-| `лицензия`    | нет          | SPDX-идентификатор лицензии                                                                                     |
-| `автор`       | no           | Автор                                                                                                           |
-
-```toml
-[package]
-name = "my-app"
-version = "0.1.0"
-dcr-version = "0.8.4"
-type = "app"
-license = "MIT"
-author = "John Doe"
-```
-
-### `package.dcr-version`
-
-Optional pin of the DCR CLI the project was written for. On every `dcr.toml` load:
-
-| Situation                      | Behaviour                                                  |
-| ------------------------------ | ---------------------------------------------------------- |
-| Field missing / empty          | Warning: add `dcr-version` (set by `dcr new` / `dcr init`) |
-| Running dcr **older** than pin | Warning: upgrade dcr (`dcr --update`)                      |
-| Running dcr **newer** than pin | Warning: review changelog, bump the pin when ready         |
-| Equal                          | Silent                                                     |
-| Invalid semver                 | Warning once, field ignored                                |
-
-Never fails the command — warnings only. Pre-release suffixes (`1.0.0-dev`) are ignored for comparison (`1.0.0-dev` ≡ `1.0.0`).
-
-## [сборка]
-
-...
-
-* `build.qt` — (bool) Включить автоматическую обработку метаобъектов Qt (MOC, UIC, RCC). Требуется установка модулей `qt6` с помощью `pkg-config`.
-
-| Поле                     | По умолчанию  | Описание                                                                                                  |
-| ------------------------ | ------------- | --------------------------------------------------------------------------------------------------------- |
-| `язык`                   | `"c"`         | `"c"`, `"c++"`, `"cpp"`, `"cxx"`, `"asm"`, `"llvm_ir"`, `"llvm-ir"`, `"ll"` (optional, defaults to `"c"`) |
-| `стандартный`            | `"c11"`       | Стандарт C (`c11`, `c17`, `c23`)                                                                          |
-| `cxx_standard`           | —             | Стандарт C++ (`c++17`, `c++20`, `c++23`)                                                                  |
-| `компилятор`             | `cxxflags`    | Preferred compiler (optional, defaults to `"clang"`)                                                      |
-| `тип`                    | `"bin"`       | `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, `custom`, `flat-bin`                               |
-| `target`                 | хост          | Target triple для кросс-компиляции                                                                        |
-| `платформа`              | `"нативный"`  | `native`, `efi`, `freestanding`                                                                           |
-| `cflags`                 | `[]`          | Дополнительные флаги C++                                                                                  |
-| `ldflags`                | `[]`          | Дополнительные флаги линковки                                                                             |
-| `имя файла`              | `""`          | Кастомное имя выходного файла                                                                             |
-| `расширение`             | `""`          | Custom file extension (for `flat-bin`, default is `bin`)                                                  |
-| `корни`                  | `["src"]`     | Source roots: directories and/or individual source/header files                                           |
-| `exclude`                | `[]`          | Паттерны исключений                                                                                       |
-| `include`                | `[]`          | Дополнительные include-директории                                                                         |
-| `src_disable`            | `false`       | Отключить автоматический поиск источников                                                                 |
-| `наследовать`            | `false`       | Наследовать build от корня workspace                                                                      |
-| `clean`                  | `[]`          | Шаблоны Glob для настраиваемых чистых путей                                                               |
-| `out_dir`                | `""`          | Пользовательский каталог для вывода данных                                                                |
-| `только рабочая область` | `false`       | Workspace-only, not built standalone (no `language`/`compiler` required)                                  |
-| `отдельно стоящий`       | `false`       | Компилировать в автономном режиме (`-ffreestanding` + `-nostdlib -static`)                                |
-| `opt_level`              | —             | Optimization level: `0`-`3`, `"s"`, `"z"` (derived from profile if omitted)                               |
-| `ldscript`               | profile-based | Emit debug symbols (`-g`): `true` in debug, `false` in release                                            |
-| `lto`                    | `false`       | Оптимизация на этапе компоновки (`-flto` как для компилятора, так и для компоновщика)                     |
-| `asflags`                | `false`       | Удалить символы из вывода (опция `-s` в ldflags)                                                          |
-| `true`                   | `[]`          | Warning flags (e.g. `"all"`, `"extra"`, `"pedantic"`); engine adds `-Wall -Wextra` in debug if empty      |
-| `panic`                  | `""`          | Стратегия «Паника»: `"abort"` отключает исключения и таблицы развертки                                    |
-| `codegen-units`          | `""`          | Максимальное количество параллельных заданий компиляции (`"0"` = автоматически)                           |
-| `qt`                     | `false`       | Включить автоматическую обработку метаобъектов Qt (MOC, UIC, RCC)                                         |
-
-Параметры из исходного файла конфигурации (не в виде типизированной структуры):
-
-* `pkg_config` — list of packages queried for build-wide compiler/linker flags
-
-Dependencies can also declare a system package directly, for example
-`fmt = { pkg-config = "fmt" }`. This records the package in `dcr.lock` and applies
-the flags returned by `pkg-config --cflags` and `pkg-config --libs`.
-
-* Путь к linker script
-* `build.steps` / `build.post_steps` — этапы генерации кода
-
-## Per-language overrides: `[build.c]`, `[build.cxx]`, `[build.asm]`, `[build.llvm_ir]`
-
-Each language can have its own table that overrides the flat `[build]` settings:
-
-```toml
-[build]
-compiler = "clang"
-standard = "c11"
-
-[build.c]
-standard = "c23"
-compiler = "gcc"
-
-[build.cxx]
-standard = "c++23"
-compiler = "g++"
-
-[build.asm]
-compiler = "nasm"
-flags = ["-felf64"]
-
-[build.llvm_ir]
-compiler = "llc"
-```
-
-The flat `[build]` acts as fallback; per-language tables take precedence for their language.
-
-Пример:
-
-```toml
-[build]
-language = ["cpp", "c"]
-standard = "c17"
-standard = "c23"
-cxx_standard = "c++23"
-compiler = "clang"
-kind = "sharedlib"
-cflags = ["-Wall", "-Wextra"]
-pkg_config = ["sdl2", "gl"]
-```
-
-## [набор инструментов]
-
-```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 также поддерживает `uic`, `moc` и `rcc` для генерации кода Qt.
-
-## [зависимости]
-
-См. [dependencies](/docs/reference/dependencies).
-
-## [запустить]
-
-```toml
-[запустить]
-cmd = "./target/{profile}/{name}"
-```
-
-Подстановки:
-
-* `{version}` — версия из [package]
-* `pkg_config`
-* `{profile}` — отладочная / релизная версия
-* `{name}` — имя из [package]
-
-По умолчанию `cmd` вычисляется как `./target/{profile}/{name}`.
-
-## [рабочая область]
-
-См. [workspaces](/docs/reference/workspaces).
-
-## [archive]
-
-Optional post-build step: format a FAT volume and copy built artifacts into a disk image. Runs after a successful package build (and after workspace member builds that define `[archive]`).
-
-Requires DCR built with the `archive` Cargo feature (`cargo build --features archive`). Release binaries include this feature.
-
-| Field        | Required | Description                                                                                 |
-| ------------ | -------- | ------------------------------------------------------------------------------------------- |
-| `output`     | yes      | Image path relative to project root (`{profile}` allowed)                                   |
-| `format`     | yes      | `fat12`, `fat16`, or `fat32`                                                                |
-| `size`       | no       | Image size: bytes or `K`/`KB`/`M`/`MB`/`G`/`GB` (default `1474560` ≈ 1.44 MiB)              |
-| `offset`     | no       | Byte offset of the FAT volume inside the image (default `0`)                                |
-| `label`      | no       | Volume label (max 11 chars, default `VOLUME`)                                               |
-| `bootsector` | no       | Path to a 512-byte boot sector written at offset 0 when `offset` is 0 (`{profile}` allowed) |
-| `layout`     | no       | List of `{ from, to }` entries (files or globs → path inside the volume)                    |
-
-```toml
-[archive]
-output = "target/{profile}/disk.img"
-format = "fat12"
-size = "1440K"
-label = "MYOS"
-bootsector = "target/{profile}/boot.bin"
-
-[[archive.layout]]
-from = "target/{profile}/kernel.bin"
-to = "KERNEL.BIN"
-
-[[archive.layout]]
-from = "assets/*"
-to = "/"
-```
-
-Typical pairing with `kind = "flat-bin"` (NASM `-f bin`) for bootloaders and pure-ASM OS images.
-
-## `flat-bin` (kind)
-
-Produces a raw binary (default extension `bin`) for boot sectors, kernels, and freestanding payloads.
-
-### Assemblers
-
-| Tool | Language / compiler                        | How flat-bin is produced                     |
-| ---- | ------------------------------------------ | -------------------------------------------- |
-| NASM | `language = "asm"`, `compiler = "nasm"`    | `-f bin` → `\<stem>.bin`    |
-| FASM | `compiler = "fasm"`                        | direct write (use `format binary` in source) |
-| GAS  | `compiler = "as"` / `"gas"`                | assemble → `objcopy -O binary`               |
-| MASM | `compiler = "ml"` / `"ml64"`               | assemble → `objcopy -O binary`               |
-| LLC  | `language = "llvm_ir"`, `compiler = "llc"` | `-filetype=obj` → `objcopy -O binary`        |
-
-```toml
-[build]
-language = "asm"
-compiler = "nasm"
-kind = "flat-bin"
-extension = "bin"
-roots = ["src/boot.asm"]
-```
-
-### C / C++
-
-Compile all sources, link with `-nostdlib -static` (plus your `ldflags` / `ldscript`), then convert the intermediate ELF/PE with `objcopy -O binary` to `\<filename|name>.bin`.
-
-```toml
-[build]
-language = "c"
-compiler = "clang"
-kind = "flat-bin"
-freestanding = true
-filename = "kernel"
-extension = "bin"
-ldscript = "linker.ld"
-ldflags = ["-T", "linker.ld"]
-```
-
-Notes:
-
-* Multi-file **ASM** packages emit one `\<stem>.bin` per source; **C/C++** emit a single project binary.
-* `objcopy` tools tried in order: `llvm-objcopy`, `objcopy`, `gobjcopy`.
-* Incompatible with `build.qt = true`.
-* `dcr run` rejects `flat-bin` (not a host executable).

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

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

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

@@ -1,84 +0,0 @@
----
-sidebar_label: Переменные среды
----
-
-# Переменные среды
-
-## DCR_COMPILER
-
-Переопределяет компилятор для всех языков. **Наивысший приоритет.**
-
-```bash
-export DCR_COMPILER=clang
-dcr build
-```
-
-Приоритет разрешения компилятора:
-
-1. `DCR_COMPILER` (переменная среды)
-2. `DCR_CC` / `DCR_CXX` / `DCR_AS` (переменная среды)
-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
-
-Переопределить линкер и архиватор.
-
-```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`.
-
-## DCRUP_MIRROR
-
-Download mirror for `dcrup` (prebuilt binaries only).
-
-```bash
-export DCRUP_MIRROR=auto   # cf → gh → sf → ya (default)
-export DCRUP_MIRROR=cf     # CloudFlare CDN
-export DCRUP_MIRROR=gh     # GitHub Releases
-export DCRUP_MIRROR=sf     # SourceForge
-export DCRUP_MIRROR=ya     # Yandex CDN (RU fallback)
-```
-
-CLI override: `dcrup install stable --mirror cf`.
-
-## DCRUP_HOME / DCRUP_BIN / DCRUP_REPO
-
-Installer layout and source clone URL:
-
-```bash
-export DCRUP_HOME=~/.dcr
-export DCRUP_BIN=~/.dcr/bin
-export DCRUP_REPO=https://github.com/dexoron/dcr
-```

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

@@ -1,53 +0,0 @@
----
-sidebar_label: Поддержка платформ
----
-
-# Поддержка платформ
-
-## Тройные цели
-
-DCR нормализует target triple через `platform_triple::normalize_triple()`. Если задано имя платформы (short name), оно раскрывается в triple.
-
-### Linux
-
-```
-target/<arch>-unknown-linux-<env>/<profile>/
-```
-
-Architectures: `x86_64`, `aarch64`, `i686`, `armv7`, `riscv64` (host-detected).
-Environments: `gnu` (default), `musl`.
-
-Тип артефакта: ELF. Расширения: `.so` для sharedlib, `.a` для staticlib
-
-### macOS
-
-```
-target/<profile>/ (default) or target/<triple>/<profile>/ (with target)
-```
-
-Поддержка архитектур: `x86_64`, `aarch64`.
-
-`.dylib` для sharedlib, `.a` для staticlib
-
-### Windows
-
-```
-target/<profile>/ (default) or target/<triple>/<profile>/ (with target)
-```
-
-Поддержка архитектур: `x86_64`, `aarch64`.
-Environments: `msvc` (default), `gnu` (MinGW).
-
-Расширения: `.exe` (бинарный файл), `.lib` (статическая библиотека), `.dll` (общая библиотека), `.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

@@ -1,80 +0,0 @@
----
-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
-```
-
-When building a workspace, DCR automatically injects include and library paths of dependent workspace members:
-
-* **Include Paths**: Automatically resolves and injects header directories of dependencies, including the member's `src/` directory, local `include/` directory, and the packaged `target/include` directory.
-* **Library Paths**: Injects compiled library search paths (`target/lib` as well as target-specific build folders) to allow automatic linking with member libraries.
-
-## Очистка
-
-```bash
-dcr clean                    # очистить только корневой target/
-dcr clean --all              # очистить target/ всех пакетов
-```
-
-## Наследование
-
-Если у member-а нет своей секции `[build]`, а в корневом `[build]` указано `inherit = true`:
-
-```toml
-[build]
-inherit = true
-language = "c"
-standard = "c17"
-```
-
-## Workspace-only root (no build of its own)
-
-A workspace root can set `workspace_only = true` — it won't be built itself, and doesn't need `language` or `compiler`:
-
-```toml
-[package]
-name = "my-workspace"
-version = "0.1.0"
-
-[build]
-workspace_only = true
-kind = "bin"
-
-[workspace]
-lib-core = { path = "lib-core" }
-app = { path = "app", deps = ["lib-core"] }
-```

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

@@ -1,46 +0,0 @@
----
-sidebar_label: Автоматическое обновление
----
-
-# Автоматическое обновление
-
-## dcr --update
-
-Автоматическое обновление до последней версии. Загружает бинарный файл (не архив) из раздела «Релизы» на GitHub и заменяет им текущий исполняемый файл.
-
-```bash
-dcr --update
-```
-
-## Как это работает
-
-1. DCR определяет текущую платформу и архитектуру
-2. Загружает последнюю версию с `api.github.com/repos/dexoron/dcr/releases/latest`
-3. Сравнивает версии
-4. Загружает соответствующий ресурс (прямой URL-адрес двоичного файла, а не архива)
-5. Заменяет текущий исполняемый файл
-
-## Названия активов
-
-Шаблон: `dcr-\<triple>.\<ext> `
-
-| Платформа      | Название актива                       |
-| -------------- | ------------------------------------- |
-| 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` выводит предупреждение:
-
-```
-Обновление через менеджер пакетов: yay/paru -Syu {package_name} или sudo pacman -Syu {package_name}
-```
-
-## Ошибки
-
-* Не удалось определить платформу — ошибка
-* Не удалось скачать релиз — ошибка с URL
-* Нет прав на запись бинарника — ошибка (нужен `sudo` или ручная установка)

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

@@ -1,45 +0,0 @@
----
-sidebar_label: Запуск тестов
----
-
-# Запуск тестов
-
-## Выполнение
-
-```bash
-Тест DCR
-```
-
-Выполняет сборку проекта, а затем компилирует и запускает тестовые файлы из каталога `tests/`.
-
-## Профили
-
-```bash
-dcr test                     # debug (по умолчанию)
-dcr test --release           # release
-dcr test --debug             # явно debug
-```
-
-## Вывод
-
-```
-=====================
-  Сводка результатов набора тестов
-=====================
-ИСПОЛЬЗОВАНО: 5
-ПРОЙДЕНО: 3
-ПРОПУЩЕНО: 1
-НЕ ПРОЙДЕНО: 1
-=====================
-```
-
-## Код возврата
-
-* 0 — все тесты пройдены (FAIL = 0)
-* 1 — есть упавшие тесты
-
-## Что строится
-
-* Все C/C++ файлы из `tests/`
-* Include path: `tests/` (для `dcr_test.h`)
-* Линкуется с основным проектом (если `type = "lib"`)

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

@@ -1,69 +0,0 @@
----
-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(имя)`
-
-Определяет тест.
-
-```c
-TEST(сложение) {
-    EXPECT(1 + 1 == 2);
-    EXPECT(2 + 2 == 4);
-}
-```
-
-### `TEST_CASE(name, ...)`
-
-Регистрирует тестовый случай.
-
-```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 файлы с тестами
-```
-
-Компилируются только файлы с расширением `.c` (файлы с расширением `.cpp` не поддерживаются).

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

@@ -1,67 +0,0 @@
----
-sidebar_label: Introduction
----
-
-# DCR — C/C++ Build Tool & Package Manager
-
-<details>
-<summary>Quick reference</summary>
-
-```bash
-# Installation (dcrup)
-curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
-export PATH="$HOME/.dcr/bin:$PATH"
-dcrup install stable                 # auto: cf → gh → sf → ya
-# dcrup install stable --mirror cf   # CloudFlare / GitHub / SourceForge / Yandex
-
-# 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
-* **7 backends** — gcc/clang (unix_cc), MSVC/clang-cl (msvc), GAS, NASM, MASM, FASM, LLVM IR
-* **8 project kinds** — bin, staticlib, sharedlib, efi, elf, none, custom, flat-bin
-* **Disk images** — optional `[archive]` packs FAT12/16/32 images after build
-* **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`