chore: add more samples for new error handling and also update readme file

Author: aymaneelmaini

README.md

@@ -82,16 +82,41 @@ Or use the REPL for interactive mode.
 
 ## Project Structure
 
-- `Interpreter.kt`: Core execution engine with expression and statement visitors
-- `Expr.kt`: AST node definitions for expressions
-- `Stmt.kt`: AST node definitions for statements
-- `Scanner.kt`: Lexical analysis
-- `Parser.kt`: Syntax analysis and AST building
-- `Resolver.kt`: Static scope analysis
-- `Environment.kt`: Scope and variable storage
-- `LoxCallable.kt`: Interface for callable objects
-- `LoxClass.kt`, `LoxInstance.kt`: Object-oriented features
-- `Token.kt`: Token representation
+```
+src/main/kotlin/com/aymanetech/
+├── Lox.kt                      # Main entry point and REPL
+│
+├── lexer/                      # Lexical analysis
+│   ├── Scanner.kt
+│   ├── Token.kt
+│   └── TokenType.kt
+│
+├── parser/                     # Syntax analysis
+│   └── Parser.kt
+│
+├── ast/                        # Abstract Syntax Tree
+│   ├── Expr.kt
+│   └── Stmt.kt
+│
+├── resolver/                   # Semantic analysis
+│   └── Resolver.kt
+│
+├── interpreter/                # Runtime execution
+│   ├── Interpreter.kt
+│   ├── Environment.kt
+│   └── NativeFunctions.kt
+│
+└── runtime/                    # Runtime types and errors
+    ├── LoxCallable.kt
+    ├── LoxClass.kt
+    ├── LoxFunction.kt
+    ├── LoxInstance.kt
+    └── errors/
+        ├── ErrorHandler.kt
+        ├── DiagnosticReporter.kt
+        ├── RuntimeError.kt
+        └── RuntimeReturn.kt
+```
 
 ## References
 

samples/README.md

@@ -0,0 +1,74 @@
+# KLox Sample Programs
+
+This directory contains example programs demonstrating various features of the KLox language.
+
+## Valid Examples
+
+### Basic Programs
+- **fibonacci.lox** / **example_fibonacci.lox** - Recursive Fibonacci sequence calculator
+- **loops.lox** - For and while loop examples
+- **control_flow.lox** - If/else and control flow examples
+- **operators.lox** - Arithmetic, comparison, and logical operators
+- **functions.lox** - Function declaration and usage
+
+### Advanced Features
+- **closures.lox** - Demonstrates lexical scoping and closures
+- **anonymous_functions.lox** - Lambda/anonymous function examples
+
+### Object-Oriented Programming
+- **classes.lox** - Classes and methods
+- **inheritance.lox** - Class inheritance
+- **super.lox** - Superclass method calls
+- **static_methods.lox** - Static methods on classes
+
+### Native Functions
+- **native_lox.lox** - Using built-in clock() function
+- **native_input.lox** - Using input() for user input
+- **native_scan.lox** - Using scan() for reading input
+
+### Complete Examples
+- **example_quiz.lox** - Interactive quiz program
+- **example_user_db.lox** - User database example
+
+## Error Examples
+
+The `errors/` directory contains programs that demonstrate the beautiful error reporting system:
+
+### Parse Errors
+- **parse_error.lox** - Missing expression after operator
+
+### Runtime Errors
+- **runtime_error_division_by_zero.lox** - Division by zero
+- **runtime_error_undefined_variable.lox** - Accessing undefined variables
+- **type_error.lox** - Type mismatch in operations
+
+## Running Examples
+
+To run a valid example:
+```bash
+java -jar build/libs/klox.jar samples/fibonacci.lox
+```
+
+To see the beautiful error reporting in action:
+```bash
+java -jar build/libs/klox.jar samples/errors/parse_error.lox
+```
+
+To start the interactive REPL:
+```bash
+java -jar build/libs/klox.jar
+```
+
+## Features Demonstrated
+
+- ✓ Variables and scoping
+- ✓ Functions (named and anonymous)
+- ✓ Classes and inheritance
+- ✓ Closures
+- ✓ Loops (for, while)
+- ✓ Conditionals (if/else)
+- ✓ Operators (arithmetic, comparison, logical)
+- ✓ Native functions (clock, println, scan, input)
+- ✓ Static methods
+- ✓ Super keyword for parent class access
+- ✓ Beautiful Rust-style error reporting with source context

samples/closures.lox

@@ -0,0 +1,18 @@
+// Closure example
+// Demonstrates lexical scoping and closures
+
+fun makeCounter() {
+    var count = 0;
+
+    fun increment() {
+        count = count + 1;
+        return count;
+    }
+
+    return increment;
+}
+
+var counter = makeCounter();
+print counter();
+print counter();
+print counter();

samples/errors/parse_error.lox

@@ -0,0 +1,6 @@
+// This file demonstrates parse error reporting
+// Missing expression after the + operator
+
+var x = 10
+var y = 20 +
+print x

samples/errors/runtime_error_division_by_zero.lox

@@ -0,0 +1,7 @@
+// This file demonstrates runtime error reporting
+// Division by zero error
+
+var x = 10
+var y = "hello" + x
+var z = 5 / 0
+print z

samples/errors/runtime_error_undefined_variable.lox

@@ -0,0 +1,5 @@
+// This file demonstrates runtime error reporting
+// Undefined variable access
+
+var x = 10
+print x + undefinedVariable

samples/errors/type_error.lox

@@ -0,0 +1,7 @@
+// This file demonstrates runtime type error
+// Cannot add incompatible types in certain operations
+
+var x = "hello"
+var y = 10
+var z = x - y
+print z

samples/fibonacci.lox

@@ -0,0 +1,10 @@
+// Fibonacci sequence calculator
+// Demonstrates recursion and functions
+
+fun fibonacci(n) {
+    if (n <= 1) return n;
+    return fibonacci(n - 1) + fibonacci(n - 2);
+}
+
+print "Fibonacci of 10:";
+print fibonacci(10);

samples/klox

@@ -0,0 +1,14 @@
+// Loop examples
+// Demonstrates for and while loops
+
+print "Counting with for loop:";
+for (var i = 1; i <= 5; i = i + 1) {
+    print i;
+}
+
+print "Counting with while loop:";
+var j = 1;
+while (j <= 5) {
+    print j;
+    j = j + 1;
+}