From 08165116f4c5b2408a14f0c9bafa93933b6f3cf9 Mon Sep 17 00:00:00 2001
From: Stiliyan Iliyanov Kushev <stiliyan.kushev@lucidlink.com>
Date: Fri, 22 Aug 2025 13:53:47 +0300
Subject: [PATCH] Expand hello world example with comprehensive KU language
 demonstrations

- Added comprehensive variable demonstrations (strings, numbers, booleans, decimals, characters)
- Showcased data type conversions using standard library functions
- Demonstrated mathematical operations and string concatenation
- Added clear sectional organization with comments
- Expanded from 3 lines to 106+ lines of educational content
- Includes practical examples of all basic KU language features
- Tests successfully compile and run on both Linux and macOS platforms
---
 examples/helloworld.ku | 135 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 134 insertions(+), 1 deletion(-)

diff --git a/examples/helloworld.ku b/examples/helloworld.ku
index 4a6e0d9..c5e0082 100644
--- a/examples/helloworld.ku
+++ b/examples/helloworld.ku
@@ -1,3 +1,136 @@
 include "../libstd/std.ku"
 
-@outln "Hello World"
\ No newline at end of file
+# =================================================
+# KU Programming Language - Expanded Hello World
+# =================================================
+# This example demonstrates basic output, variables,
+# data types, and standard library functions
+
+# Clear the screen for a clean start
+@clear
+
+# === BASIC OUTPUT DEMONSTRATIONS ===
+@outln "================================="
+@outln "  KU Programming Language Demo"  
+@outln "================================="
+@outln ""
+
+# Basic hello world
+@outln "Hello World!"
+@outln "Greetings from the KU programming language!"
+@outln ""
+
+# Using out() without newline
+@out "This is printed "
+@out "on the same line "
+@outln "with multiple calls!"
+@outln ""
+
+# === VARIABLE DEMONSTRATIONS ===
+@outln "--- Variable Examples ---"
+
+# String variables
+:name/str = "KU Programmer"
+:language/str = "KU"
+:version/str = "v1.0"
+
+@outln "Name: " + name
+@outln "Language: " + language  
+@outln "Version: " + version
+@outln ""
+
+# Number variables and operations
+:year/num = 2024
+:current_age/num = 25
+:future_age/num = current_age + 10
+
+@outln "Current year: " + @num2str year
+@outln "Current age: " + @num2str current_age
+@outln "Age in 10 years: " + @num2str future_age
+@outln ""
+
+# === DATA TYPE CONVERSIONS ===
+@outln "--- Data Type Examples ---"
+
+# Boolean variables
+:is_learning/bol = true
+:is_complete/bol = false
+
+@outln "Learning KU: " + @bol2str is_learning
+@outln "Project complete: " + @bol2str is_complete
+@outln ""
+
+# Decimal calculations
+:pi/dec = 3.14159
+:radius/dec = 5.0
+:area/dec = pi * (radius * radius)
+
+@outln "Pi value: " + @dec2str pi
+@outln "Radius: " + @dec2str radius  
+@outln "Circle area: " + @dec2str area
+@outln ""
+
+# === MATHEMATICAL OPERATIONS ===
+@outln "--- Math Operations ---"
+
+:num1/num = 42
+:num2/num = 8
+:sum/num = num1 + num2
+:difference/num = num1 - num2  
+:product/num = num1 * num2
+:quotient/num = num1 / num2
+
+@outln "Number 1: " + @num2str num1
+@outln "Number 2: " + @num2str num2
+@outln "Sum: " + @num2str sum
+@outln "Difference: " + @num2str difference
+@outln "Product: " + @num2str product
+@outln "Quotient: " + @num2str quotient
+@outln ""
+
+# === CHARACTER DEMONSTRATIONS ===  
+@outln "--- Character Examples ---"
+
+:first_char/chr = 'A'
+:second_char/chr = 'B'
+:space_char/chr = ' '
+
+@out "Characters: "
+@out @chr2str first_char
+@out @chr2str space_char  
+@out @chr2str second_char
+@outln ""
+@outln ""
+
+# === STRING OPERATIONS ===
+@outln "--- String Operations ---"
+
+:greeting/str = "Hello"
+:target/str = "World"
+:punctuation/str = "!"
+:full_message/str = greeting + " " + target + punctuation
+
+@outln "Greeting: " + greeting
+@outln "Target: " + target
+@outln "Full message: " + full_message
+@outln "Message length: " + @num2str @strlen full_message
+@outln ""
+
+# === FINAL MESSAGES ===
+@outln "--- Final Thoughts ---"
+@outln "This example showcased:"
+@outln "• Basic output functions (out, outln, clear)"
+@outln "• Variable declarations and types"
+@outln "• String concatenation and operations"  
+@outln "• Mathematical calculations"
+@outln "• Data type conversions"
+@outln "• Character handling"
+@outln ""
+
+@outln "Thank you for exploring KU programming language!"
+@outln "Happy coding!"
+@outln ""
+
+@outln "================================="
+@outln "     End of Hello World Demo"
+@outln "================================="
\ No newline at end of file