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>

src/lexer.h

@@ -0,0 +1,34 @@
+#pragma once
+
+#include <string>
+#include <vector>
+
+enum class Tok {
+    End,
+    Ident, Int, Float, String, Char,
+
+    // keywords
+    Fn, Return, If, Else, While, For, In, Break, Continue, True, False, Null, Import, Link,
+
+    // punctuation
+    LParen, RParen, LBrace, RBrace, LBracket, RBracket, Comma, Dot, DotDot, Arrow,
+
+    // operators
+    Plus, Minus, Star, Slash, Percent,
+    Amp, Pipe, Caret, Tilde, Shl, Shr,             // & | ^ ~ << >>
+    Assign, Declare,                               // =  :=
+    PlusEq, MinusEq, StarEq, SlashEq, PercentEq,   // += -= *= /= %=
+    Eq, NotEq, Less, LessEq, Greater, GreaterEq,
+    And, Or, Not,
+};
+
+struct Token {
+    Tok kind;
+    std::string text;
+    int line;
+    int col;
+    bool newlineBefore;  // token starts a new line: ends the previous statement
+};
+
+std::vector<Token> lex(const std::string &src, const std::string &file);
+const char *tokName(Tok t);