Changelog

• async function calls now spawn task workers immediately via pthread.
• await now joins unfinished tasks and reuses the stored result on subsequent awaits.
• async { ... } blocks now compile to real task runners with captured environments.

• await_timeout(ms) returns Option<T> and performs a timed join.
• cancel() marks task as done and provides a safe default result for later await.

• Built-in effect requirements are enforced for IO/thread-sensitive APIs.
• Calls to user functions/methods now propagate declared effects.
• Non-annotated functions now get effect inference from the call graph.
• Invalid combinations (@Pure + explicit effects / @Pure + @Any) now fail at type-check time.

• Supports typed extern signatures without function bodies.
• Supports variadic extern declarations (e.g. extern function printf(fmt: String, ...): Integer;).
• Supports explicit ABI and symbol aliasing (e.g. extern(c, "puts") function c_puts(...): Integer;, extern(system, "printf") ...).
• Enforces FFI-safe extern signatures and variadic argument types at type-check time.
• Extern callsites now use C ABI argument lowering (no Arden env pointer).

• Parser/typechecker/codegen support for Ptr<T> declarations and extern interop.
• Ptr<T> is now accepted as an FFI-safe extern signature type.

• Supports common C prototypes and variadic signatures.
• Supports stdout output or --output <file> generation.

• examples/single_file/tooling_and_ffi/26_effect_system/26_effect_system.arden
• examples/single_file/tooling_and_ffi/27_extern_c_interop/27_extern_c_interop.arden
• examples/single_file/tooling_and_ffi/28_async_runtime_control/28_async_runtime_control.arden
• examples/single_file/tooling_and_ffi/29_effect_inference_and_any/29_effect_inference_and_any.arden
• examples/single_file/tooling_and_ffi/30_extern_variadic_printf/30_extern_variadic_printf.arden
• examples/single_file/tooling_and_ffi/31_extern_abi_link_name/31_extern_abi_link_name.arden
• examples/single_file/tooling_and_ffi/32_extern_safe_wrapper/32_extern_safe_wrapper.arden
• examples/single_file/tooling_and_ffi/33_extern_ptr_types/33_extern_ptr_types.arden
• examples/single_file/tooling_and_ffi/34_bindgen_workflow/34_bindgen_workflow.arden
• examples/README.md (coverage index)

Module Dot Syntax: Added semantic/codegen support for Module.function(...) while keeping Module__function(...) compatibility.

Enum Variant Constructors: Added enum metadata and constructor support for Enum.Variant(...) in codegen/type checking.

LSP Diagnostics on Edit: Added diagnostics publication on open/change (lexer/parser errors) and baseline go-to-definition symbol lookup.

Integration Test Coverage: Added tests for multi-file project rewrite edge cases:

• Shadowed local function identifiers are not mangled.
• Imported class constructor and module field accesses are mangled deterministically.
• Shadowed module identifiers are not mangled.

Range Type: Full iterator-based range type for numeric sequences

• Range<T> generic type with range(start, end) and range(start, end, step) functions
• Iterator protocol with has_next() and next() methods
• Support for ascending and descending ranges (negative steps)
• LLVM struct-based implementation with heap allocation
• New example: examples/single_file/stdlib_and_system/25_range_types/25_range_types.arden
• Documentation: docs/features/ranges.md

Testing Framework: Full testing framework with attributes and assertions

• @Test attribute to mark test functions
• @Ignore attribute to skip tests (with optional reason: @Ignore("not ready"))
• @Before, @After for setup/teardown around each test
• @BeforeAll, @AfterAll for suite-level setup/teardown
• New CLI command: arden test - Discover and run all @Test functions
• Assertion functions: assert(), assert_eq(), assert_ne(), assert_true(), assert_false(), fail()
• New example: examples/single_file/tooling_and_ffi/24_test_attributes/24_test_attributes.arden

LSP (Language Server Protocol): Arden now has a built-in LSP server for IDE integration

• New CLI command: arden lsp - Start the language server
• Autocomplete support for keywords, types, and functions
• Hover documentation for language keywords
• Go to definition support (prepared)

Improved Error Messages: Better developer experience with helpful error messages

• "Did you mean?" suggestions for typos using Levenshtein distance
• Contextual hints for missing imports
• Color-coded error output with source location

Range Type Implementation:

• Added Type::Range(Box<Type>) to AST
• Added ResolvedType::Range(Box<ResolvedType>) to typeck
• Parser support for Range<T> syntax
• LLVM codegen: struct { i64, i64, i64, i64 } (start, end, step, current)
• create_range(), range_has_next(), range_next() helper functions
• compile_range_method() for method calls

Added test_runner.rs module for test discovery and execution

Added Attribute enum to AST for function annotations

Added @ token to lexer

Updated parser to parse attributes before function declarations

Added parser unit tests for attribute parsing

Added assert functions to codegen with proper LLVM generation

Added lsp.rs module with tower-lsp integration

Added fuzzy string matching for error suggestions

Updated import_check.rs with suggestion engine

Multi-File Project Support: Arden now supports organizing code into projects with multiple source files.

• Project configuration via arden.toml
• New CLI commands: arden new, arden build, arden run, arden info
• Automatic merging and compilation of multiple source files
• Entry point configuration for main function location

Project Commands:

• arden new <name> - Create a new project with standard structure
• arden build - Build current project
• arden run - Build and run current project
• arden info - Display project information
• arden check [file] - Check project or specific file

• alwaysinline for small functions (≤3 params)
• nounwind for exception-free code
• willreturn for functions guaranteed to return

• codegen/core.rs (3876 lines): Main codegen logic
• codegen/types.rs (1590 lines): Built-in type implementations
• codegen/util.rs (1223 lines): Utilities and C library bindings

• Args.count(): Returns the number of arguments.
• Args.get(index): Retrieves a specific argument.

• Str.len(s): Get string length.
• Str.compare(a, b): Compare two strings.
• Str.concat(a, b): Concatenate two strings.
• Str.upper(s): Convert to uppercase (stub).
• Str.lower(s): Convert to lowercase.
• Str.trim(s): Remove leading/trailing whitespace.
• Str.contains(s, sub): Check if string contains substring.
• Str.startsWith(s, pre): Check if string starts with prefix.
• Str.endsWith(s, suf): Check if string ends with suffix.

• System.getenv(name): Get environment variables.
• System.shell(cmd): Run shell command (exit code).
• System.exec(cmd): Run shell command and capture stdout.
• System.cwd(): Get current working directory.
• System.os(): Get operating system name.
• System.exit(code): Terminate program with exit code.

• Time.now(format): Returns formatted local time.
• Time.unix(): Returns raw Unix timestamp.
• Time.sleep(ms): Suspends program execution.

• List.pop(): Remove and return the last element.

• File.read(path): Reads entire file to String.
• File.write(path, content): Writes content to file.
• File.exists(path): Checks for file existence.
• File.delete(path): Deletes a file.

• docs/getting_started/: Installation, Quick Start (Hello World), Editor Setup.
• docs/basics/: Syntax, Variables, Types, Control Flow.
• docs/features/: Functions, Classes, Interfaces, Enums, Modules.
• docs/advanced/: Ownership, Generics, Async/Await, Error Handling, Memory Management.
• docs/stdlib/: Standard Library Overview (Math, String).
• docs/compiler/: CLI Reference, Architecture internals.