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>

CMakeLists.txt

@@ -0,0 +1,37 @@
+cmake_minimum_required(VERSION 3.20)
+project(finch VERSION 1.0.0 LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+
+find_package(LLVM REQUIRED CONFIG)
+message(STATUS "Using LLVM ${LLVM_PACKAGE_VERSION}")
+
+add_executable(finch
+    src/main.cpp
+    src/lexer.cpp
+    src/parser.cpp
+    src/codegen.cpp
+    src/cimport.cpp
+)
+
+# libclang reads C headers for `import "stdio.h"`
+find_path(LIBCLANG_INCLUDE clang-c/Index.h HINTS ${LLVM_INCLUDE_DIRS})
+find_library(LIBCLANG NAMES clang libclang HINTS ${LLVM_LIBRARY_DIRS})
+if(NOT LIBCLANG_INCLUDE OR NOT LIBCLANG)
+    message(FATAL_ERROR "libclang not found (on Nix: run inside nix-shell)")
+endif()
+
+target_include_directories(finch SYSTEM PRIVATE ${LLVM_INCLUDE_DIRS} ${LIBCLANG_INCLUDE})
+target_compile_definitions(finch PRIVATE ${LLVM_DEFINITIONS} FINCH_VERSION="${PROJECT_VERSION}")
+target_compile_options(finch PRIVATE -Wall -Wextra)
+
+# Link the one shared libLLVM when available: libclang uses it too, and two copies
+# of LLVM in one process crash on exit.
+if(TARGET LLVM)
+    set(LLVM_LIBS LLVM)
+else()
+    llvm_map_components_to_libnames(LLVM_LIBS core support passes native)
+endif()
+target_link_libraries(finch PRIVATE ${LLVM_LIBS} ${LIBCLANG})