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/llvm.fn

@@ -0,0 +1,18 @@
+// Finch driving LLVM itself through the LLVM-C API: the first step toward
+// a compiler written in Finch. Builds a module with `answer() -> 42` and prints its IR.
+import "llvm-c/Core.h"
+link "LLVM"
+
+fn main() {
+    mod := LLVMModuleCreateWithName("from_finch")
+    i64t := LLVMInt64Type()
+    fnType := LLVMFunctionType(i64t, null, 0, 0)
+    f := LLVMAddFunction(mod, "answer", fnType)
+    entry := LLVMAppendBasicBlock(f, "entry")
+    b := LLVMCreateBuilder()
+    LLVMPositionBuilderAtEnd(b, entry)
+    LLVMBuildRet(b, LLVMConstInt(i64t, 42, 0))
+    LLVMDumpModule(mod)
+    LLVMDisposeBuilder(b)
+    LLVMDisposeModule(mod)
+}