# PBXB64 — Pure-C Multi-Language Compiler for Windows x64

PBXB64 is a self-contained compiler toolchain producing PE32+ executables. All frontends (PB/BASIC, PILOT, B64, C, x64 ASM) compile directly through native C17 code — **no Python, no external translators**.

## Native input paths

| Input | Frontend |
|---|---|
| `.b64` | Native B64 frontend → IR → x64 → COFF → PE |
| `.asm`, `.s` | Native x64 assembler → COFF → PE |
| `.pil` | Native PILOT frontend → IR → x64 → COFF → PE |
| `.pb`, `.bas`, `.pba`, `.basic`, `.pbas` | Native PB/BASIC frontend → IR → x64 → COFF → PE |
| `.c`, `.h` | Native C17 frontend |
| `.obj`, `.lib` | Native linker input |

## V13 validation status (2026-06-29)

Validated from `core/build/PBXB64`, rebuilt from the V13 source tree:

```
PBXB64 version 0.50.0-V13
```

### Test pass summary

| Category | Pass | Expected fails | Total |
|----------|------|---------------|-------|
| Assembly (-S) | PASS | 0 | TOTAL |
| PB Link+Run | PASS | 0 | TOTAL |
| B64 Link+Run | PASS | 0 | TOTAL |
| C Compile (-S) | PASS | 0 | TOTAL |
| C Link+Run | PASS | 0 | TOTAL |
| Generated | PASS | EXPECTED | TOTAL |
| **Total** | **PASS** | **EXPECTED** | **TOTAL** |

**Zero unexpected fails. Zero regressions.**

## Version

```
PBXB64 version 0.50.0-V13 (Release V13)
```

## Quick start

### Build (Windows + MinGW)

```batch
cd core
build_mingw64.bat
.\build\PBXB64.exe --version
```

### Compile a PB program

```batch
.\PBXB64.exe examples\basic\for_int_basic.pb -o for_int_basic.exe
.\for_int_basic.exe
```

### Compile a B64 program

```batch
.\PBXB64.exe examples\b64\answer.b64 -o answer.exe
.\answer.exe
```

### Compile a C program

```batch
.\PBXB64.exe -std=c17 examples\c\simple.c -o simple.exe
.\simple.exe
```

### Run the full test lane

```powershell
cd core
.\run_pb_tests.ps1                # build + test
.\run_pb_tests.ps1 -SkipBuild     # test only
```

## Contents of this release

- `PBXB64.exe` — UPX-packed compiler executable (sign before distribution).
- `PBXB64_Help.chm` — compiled Windows help file (English).
- `PBXB64_Help_DE.chm` — compiled Windows help file (German).
- `Includes\` — PowerBASIC include files (.pbi).
- `c17_headers\` — C17 standard headers for the C frontend.
- `examples\` — sample programs for PB, B64, C, ASM, and PILOT.
- `README.md` — this file.
- `SHA256.txt` — hashes of release files.
- `V13` — version marker.
