Finch 1.0.0

A small, fast programming language on LLVM with C-like syntax.

- Lexer, recursive-descent parser, single-pass type checker + LLVM IR codegen, O2 pipeline
- Types: int/float/bool/char/str, sized i8..u64/f32/f64, pointers ptr[T] with addr()/.value/null
- Functions (fn ... -> T), if/else, while, for..in, break/continue, Go-style operator precedence
- Implicit conversions only when lossless; literals adapt to their target type
- Runtime checks for division by zero, MIN/-1 and null .value
- C interop: import "header.h" via libclang, link "lib" with pkg-config, link-error advice
- Human-readable errors with source excerpts
- Test suite (34 tests), examples, docs for beginners/technicians/engineers in English and Polish

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

examples/types.fn

@@ -0,0 +1,31 @@
+// Sized numbers and pointers.
+
+fn double(ptr[int] p) {
+    p.value = p.value * 2
+}
+
+fn main() {
+    // everyday: int and float. For bytes and hardware: exact sizes.
+    u8 small = 255
+    i32 points = -1000
+    big := u64(0xFFFF_FFFF)
+    f32 half = 0.5
+
+    small += 1                       // u8 wraps around, like real hardware
+    print("u8 255 + 1 =", small)
+    print("points:", points, "big:", big, "half:", half)
+
+    i64 wide = points                // a smaller type fits into a bigger one by itself
+    print("wide:", wide)
+
+    // pointers: addr(x) gives you where x lives, p.value is what is there
+    int x = 21
+    p := addr(x)
+    double(p)
+    print("x is now", x)
+
+    ptr[int] nothing = null
+    if nothing == null {
+        print("nothing points nowhere")
+    }
+}