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/cimport.h

@@ -0,0 +1,37 @@
+#pragma once
+
+#include "ast.h"
+
+#include <string>
+#include <unordered_map>
+#include <vector>
+
+// What Finch learned from `import "something.h"`.
+
+struct CFunc {
+    std::string name;
+    std::string header;  // the import it came from
+    Type ret;
+    std::vector<Type> params;
+    bool variadic = false;
+    std::string unsupported;  // non-empty: why Finch can't call it (yet)
+};
+
+struct CConst {  // enum values and simple #define numbers
+    Type type;
+    long long i = 0;
+    double f = 0;
+};
+
+struct CGlobal {  // extern variables like stdout
+    Type type;
+};
+
+struct CImports {
+    std::unordered_map<std::string, CFunc> fns;
+    std::unordered_map<std::string, CConst> consts;
+    std::unordered_map<std::string, CGlobal> globals;
+};
+
+// `dir` is the folder of the .fn file, searched first for "local.h" headers.
+CImports importHeaders(const std::vector<Import> &imports, const std::string &dir);