Repo Update

Release v0.2.0: Core language features and RTL foundation

This release establishes the foundational architecture and implements core
Object Pascal language features with the RTL wrapping strategy.

LANGUAGE FEATURES:
- Complete basic type system (Integer, Double, String, Boolean, Pointer, etc.)
- Type aliases and pointer type declarations
- Constants (typed and untyped) and variables (local/global)
- All arithmetic, comparison, logical, and bitwise operators
- Control flow: if/else, case, for, while, repeat-until
- Functions and procedures with multiple parameter passing modes
- Static arrays, records, enumerations, and pointers
- Memory management (New/Dispose)

RUNTIME LIBRARY (RTL):
- I/O functions (Write/WriteLn with variadic templates)
- Control flow wrappers (ForLoop, WhileLoop, RepeatUntil)
- Operator functions (Div, Mod, Shl, Shr)
- String class (np::String with UTF-16 and 1-based indexing)
- All Delphi semantics wrapped in np:: namespace

CODE GENERATION:
- Header (.h) and implementation (.cpp) file generation
- Namespace per unit
- RTL wrapping strategy: complexity in RTL, not codegen
- Forward declarations and proper includes

BUILD SYSTEM:
- Zig build integration for cross-platform compilation
- Multiple optimization modes (Debug, ReleaseSafe, ReleaseFast, ReleaseSmall)
- Program → executable, Library → .dll/.so/.dylib, Unit → .lib/.a
- Compiler directives support ({$optimization}, {$target}, etc.)

TOOLS:
- nitro CLI with build, run, clean, init, version, help commands

PLATFORMS:
- Windows x64, Linux x64, macOS x64

DOCUMENTATION:
- Updated README.md with documentation links (COVERAGE.md, DESIGN.md, MANUAL.md)
- Updated code examples to demonstrate RTL wrapping approach
- Added DelphiAST attribution
- Complete language coverage tracking (COVERAGE.md)
- Comprehensive design document (DESIGN.md)

ARCHITECTURE:
The core architectural principle is RTL wrapping: all Delphi constructs are
wrapped in C++ runtime library functions. This makes the code generator a
simple syntax translator while ensuring correct Delphi semantics. The
transpilation pipeline is: Pascal → C++ (via RTL) → Native Code (via Zig/LLVM).

Version: 0.2.0

Author: jarroddavis68

.gitignore

@@ -92,3 +92,9 @@ bin/run_unittests.cmd
 bin/results.txt
 _distro.cmd
 pack.yml
+bin/result.txt
+bin/test.json
+bin/test_small.json
+src/TASK.md
+src/TASK0.md
+src/TASK2.md

README.md

@@ -121,28 +121,25 @@ end.
 <td>
 
 ```cpp
-// Optimized C++ output
-#include <iostream>
+// Generated C++ with NitroPascal RTL
+#include "nitropascal_rtl.h"
 
 struct TPoint {
-  int32_t X;
-  int32_t Y;
+    int32_t X;
+    int32_t Y;
 };
 
 void PrintPoint(const TPoint& P) {
-  std::wcout << L"Point(" << P.X 
-             << L", " << P.Y << L")" 
-             << std::endl;
+    np::WriteLn("Point(", P.X, ", ", P.Y, ")");
 }
 
 int main() {
-  TPoint Point;
-  Point.X = 10;
-  Point.Y = 20;
-  PrintPoint(Point);
-  std::wcout << L"Hello from NitroPascal!" 
-             << std::endl;
-  return 0;
+    TPoint Point;
+    Point.X = 10;
+    Point.Y = 20;
+    PrintPoint(Point);
+    np::WriteLn("Hello from NitroPascal!");
+    return 0;
 }
 ```
 
@@ -189,10 +186,12 @@ Download the latest release from the [Releases page](https://github.com/tinyBigG
 
 ## 📚 Documentation
 
+- **[Language Coverage](docs\COVERAGE.md)** - Supported Object Pascal features and implementation status
+- **[Design Document](docs\DESIGN.md)** - Complete architecture and implementation guide
+- **[User Manual](docs\MANUAL.md)** - Comprehensive guide for using NitroPascal
 - **[Third-Party Libraries](THIRD-PARTY.md)** - Open source libraries used by NitroPascal
 - **[Website](https://nitropascal.org)** - Official NitroPascal website
-- **API Reference** *(coming soon)*
-- **Language Guide** *(coming soon)*
+
 
 ## 🤝 Contributing
 
@@ -203,8 +202,6 @@ We welcome contributions! NitroPascal is in active development and there are man
 - 📖 Improve documentation
 - 🔧 Submit pull requests
 
-Please check our [Contributing Guidelines](CONTRIBUTING.md) *(coming soon)* for more details.
-
 ## 📄 License
 
 NitroPascal is licensed under the [BSD-3-Clause License](https://github.com/tinyBigGAMES/NitroPascal?tab=BSD-3-Clause-1-ov-file#BSD-3-Clause-1-ov-file).
@@ -225,6 +222,7 @@ This means you can use NitroPascal to build both open-source and proprietary app
 
 NitroPascal builds upon excellent open-source projects:
 
+- **[DelphiAST](https://github.com/RomanYankovsky/DelphiAST)** - Object Pascal parser
 - **[LLVM](https://github.com/llvm/llvm-project)** - Compiler infrastructure
 - **[Zig](https://github.com/ziglang/zig)** - Programming language and toolchain
 

THIRD-PARTY.md

@@ -6,6 +6,7 @@ NitroPascal is built on the shoulders of these excellent open-source projects. W
 
 | Library | Description | Repository |
 |---------|-------------|------------|
+| **DelphiAST** | Abstract Syntax Tree builder for Delphi - provides robust Pascal parsing capabilities | [GitHub](https://github.com/RomanYankovsky/DelphiAST) |
 | **LLVM** | The LLVM Compiler Infrastructure - modular and reusable compiler and toolchain technologies | [GitHub](https://github.com/llvm/llvm-project) |
 | **Zig** | A general-purpose programming language and toolchain for maintaining robust, optimal, and reusable software | [GitHub](https://github.com/ziglang/zig) |
 

config/postprocess_default.json

@@ -0,0 +1,74 @@
+{
+  "version": "1.0",
+  "description": "Default post-processing rules for NitroPascal C header conversion",
+  
+  "opaquePointerTypes": [
+    {
+      "pattern": "PFILE",
+      "baseName": "FILE_t",
+      "pointerName": "PFILE_t",
+      "baseType": "Pointer",
+      "comment": "C FILE handle from stdio.h"
+    },
+    {
+      "pattern": "Pva_list",
+      "baseName": "va_list_t",
+      "pointerName": "Pva_list_t",
+      "baseType": "Pointer",
+      "comment": "C va_list from stdarg.h"
+    }
+  ],
+  
+  "typeReplacements": [
+  ],
+  
+  "identifierReplacements": [
+    {
+      "find": "_file",
+      "replace": "AFile",
+      "scope": "parameters",
+      "comment": "Avoid underscore prefix in parameter names"
+    },
+    {
+      "find": "_type",
+      "replace": "AType",
+      "scope": "parameters",
+      "comment": "Avoid underscore prefix in parameter names"
+    },
+    {
+      "find": "_end",
+      "replace": "AEnd",
+      "scope": "fields",
+      "comment": "Avoid underscore prefix in field names"
+    },
+    {
+      "find": "_string",
+      "replace": "AString",
+      "scope": "fields",
+      "comment": "Avoid underscore prefix in field names"
+    }
+  ],
+  
+  "keywordEscapes": [
+    {
+      "keyword": "type",
+      "replacement": "AType"
+    },
+    {
+      "keyword": "file",
+      "replacement": "AFile"
+    },
+    {
+      "keyword": "name",
+      "replacement": "AName"
+    },
+    {
+      "keyword": "label",
+      "replacement": "ALabel"
+    },
+    {
+      "keyword": "packed",
+      "replacement": "APacked"
+    }
+  ]
+}