IncludeCPP 4.2.2__py3-none-any.whl → 4.3.0__py3-none-any.whl

includecpp/core/cssl/CSSL_DOCUMENTATION.md

@@ -1,1682 +1,1720 @@
-# CSSL - C-Style Scripting Language
+    # CSSL - C-Style Scripting Language
 
-> Version 4.1.0 | A modern scripting language with C++-style syntax and unique features like CodeInfusion, BruteInjection, Python Interop, and Multi-Language Support.
+    > Version 4.1.0 | A modern scripting language with C++-style syntax and unique features like CodeInfusion, BruteInjection, Python Interop, and Multi-Language Support.
 
----
+    ---
 
-## Table of Contents
+    ## Table of Contents
 
-1. [Quick Start](#quick-start)
-2. [Syntax Basics](#syntax-basics)
-3. [Data Types](#data-types)
-4. [Variables & Globals](#variables--globals)
-5. [Operators](#operators)
-6. [Control Flow](#control-flow)
-7. [Functions](#functions)
-8. [Classes & OOP](#classes--oop)
-9. [Container Types](#container-types)
-10. [Built-in Functions](#built-in-functions)
-11. [CodeInfusion](#codeinfusion)
-12. [BruteInjection](#bruteinjection)
-13. [Value Capture](#value-capture)
-14. [Module System](#module-system)
-15. [Multi-Language Support](#multi-language-support)
-16. [Error Handling](#error-handling)
-17. [Quick Reference](#quick-reference)
+    1. [Quick Start](#quick-start)
+    2. [Syntax Basics](#syntax-basics)
+    3. [Data Types](#data-types)
+    4. [Variables & Globals](#variables--globals)
+    5. [Operators](#operators)
+    6. [Control Flow](#control-flow)
+    7. [Functions](#functions)
+    8. [Classes & OOP](#classes--oop)
+    9. [Container Types](#container-types)
+    10. [Built-in Functions](#built-in-functions)
+    11. [CodeInfusion](#codeinfusion)
+    12. [BruteInjection](#bruteinjection)
+    13. [Value Capture](#value-capture)
+    14. [Module System](#module-system)
+    15. [Multi-Language Support](#multi-language-support)
+    16. [Error Handling](#error-handling)
+    17. [Quick Reference](#quick-reference)
 
----
+    ---
 
-## Quick Start
+    ## Quick Start
 
-### Installation
+    ### Installation
 
-```bash
-pip install includecpp
-```
+    ```bash
+    pip install includecpp
+    ```
 
-### Python Usage
+    ### Python Usage
 
-```python
-from includecpp import CSSL
+    ```python
+    from includecpp import CSSL
 
-# Execute CSSL code
-CSSL.run('''
-    printl("Hello CSSL!");
-''')
+    # Execute CSSL code
+    CSSL.run('''
+        printl("Hello CSSL!");
+    ''')
 
-# With parameters and return value
-result = CSSL.run('''
-    string name = parameter.get(0);
-    printl("Hello " + name);
-    parameter.return(true);
-''', "World")
+    # With parameters and return value
+    result = CSSL.run('''
+        string name = parameter.get(0);
+        printl("Hello " + name);
+        parameter.return(true);
+    ''', "World")
 
-print(result)  # True
-```
+    print(result)  # True
+    ```
 
-### CLI Execution
+    ### CLI Execution
 
-```bash
-# Execute CSSL file
-python -m includecpp cssl exec myfile.cssl
+    ```bash
+    # Execute CSSL file
+    python -m includecpp cssl exec myfile.cssl
 
-# Create module from Python file
-python -m includecpp cssl makemodule mylib.py -o mylib.cssl-mod
-```
+    # Create module from Python file
+    python -m includecpp cssl makemodule mylib.py -o mylib.cssl-mod
+    ```
 
-### First Script
-
-```cssl
-// Variables
-string name = "CSSL";
-int version = 3;
-
-// Output
-printl("Welcome to " + name);
-
-// Function
-void greet(string msg) {
-    printl(msg);
-}
+    ### First Script
 
-greet("Hello World!");
-```
+    ```cssl
+    // Variables
+    string name = "CSSL";
+    int version = 3;
 
----
+    // Output
+    printl("Welcome to " + name);
 
-## Syntax Basics
+    // Function
+    void greet(string msg) {
+        printl(msg);
+    }
+
+    greet("Hello World!");
+    ```
+
+    ---
+
+    ## Syntax Basics
+
+    ### Comments
+
+    ```cssl
+    // Single-line comment (C-style)
+    # Single-line comment (Python-style)
+    ```
+
+    ### Semicolons
+
+    Semicolons are optional but recommended for clarity.
 
-### Comments
+    ```cssl
+    printl("Hello")    // Works
+    printl("Hello");   // Also works (recommended)
+    ```
 
-```cssl
-// Single-line comment (C-style)
-# Single-line comment (Python-style)
-```
+    ### I/O Functions
 
-### Semicolons
+    ```cssl
+    // Output
+    printl("Text");              // Print with newline
+    print("No newline");         // Print without newline
+    debug("Debug info");         // Print with [DEBUG] prefix
+    error("Error message");      // Print with [ERROR] prefix
+    warn("Warning");             // Print with [WARN] prefix
+    log("INFO", "Message");      // Print with custom prefix
 
-Semicolons are optional but recommended for clarity.
+    // Input
+    string name = input("Enter your name: ");
+    int age = int(input("Enter your age: "));
+    string raw = input();        // Without prompt
+    ```
 
-```cssl
-printl("Hello")    // Works
-printl("Hello");   // Also works (recommended)
-```
+    ---
 
-### I/O Functions
+    ## Data Types
 
-```cssl
-// Output
-printl("Text");              // Print with newline
-print("No newline");         // Print without newline
-debug("Debug info");         // Print with [DEBUG] prefix
-error("Error message");      // Print with [ERROR] prefix
-warn("Warning");             // Print with [WARN] prefix
-log("INFO", "Message");      // Print with custom prefix
+    ### Primitive Types
 
-// Input
-string name = input("Enter your name: ");
-int age = int(input("Enter your age: "));
-string raw = input();        // Without prompt
-```
+    | Type | Description | Example |
+    |------|-------------|---------|
+    | `int` | Integer | `int x = 42;` |
+    | `float` | Floating point | `float f = 3.14;` |
+    | `string` | Text string | `string s = "Hello";` |
+    | `bool` | Boolean | `bool b = true;` |
+    | `dynamic` | Any type (flexible) | `dynamic x = "text";` |
+    | `void` | No return value | `void func() { }` |
+    | `null` | Absence of value | `dynamic x = null;` |
 
----
+    ### Generic Container Types
 
-## Data Types
+    | Type | Description | Example |
+    |------|-------------|---------|
+    | `stack<T>` | LIFO stack | `stack<string> names;` |
+    | `vector<T>` | Dynamic array | `vector<int> nums;` |
+    | `array<T>` | Standard array | `array<float> values;` |
+    | `map<K,V>` | Ordered key-value | `map<string, int> ages;` |
+    | `list` | Python-like list | `list items = [1, 2, 3];` |
+    | `dict` | Dictionary | `dict data = {"a": 1};` |
+    | `datastruct<T>` | Universal container | `datastruct<string> data;` |
+    | `iterator<T>` | Programmable iterator | `iterator<int> it;` |
+    | `shuffled<T>` | Multi-value returns | `shuffled<string> results;` |
+    | `combo<T>` | Filter/search space | `combo<string> search;` |
 
-### Primitive Types
+    ### Type Conversion
 
-| Type | Description | Example |
-|------|-------------|---------|
-| `int` | Integer | `int x = 42;` |
-| `float` | Floating point | `float f = 3.14;` |
-| `string` | Text string | `string s = "Hello";` |
-| `bool` | Boolean | `bool b = true;` |
-| `dynamic` | Any type (flexible) | `dynamic x = "text";` |
-| `void` | No return value | `void func() { }` |
-| `null` | Absence of value | `dynamic x = null;` |
+    ```cssl
+    int("42");        // String to int: 42
+    float("3.14");    // String to float: 3.14
+    str(42);          // Int to string: "42"
+    bool(1);          // Int to bool: true
+    int("ff", 16);    // Hex to int: 255
+    ```
 
-### Generic Container Types
+    ### Type Checking
 
-| Type | Description | Example |
-|------|-------------|---------|
-| `stack<T>` | LIFO stack | `stack<string> names;` |
-| `vector<T>` | Dynamic array | `vector<int> nums;` |
-| `array<T>` | Standard array | `array<float> values;` |
-| `map<K,V>` | Ordered key-value | `map<string, int> ages;` |
-| `list` | Python-like list | `list items = [1, 2, 3];` |
-| `dict` | Dictionary | `dict data = {"a": 1};` |
-| `datastruct<T>` | Universal container | `datastruct<string> data;` |
-| `iterator<T>` | Programmable iterator | `iterator<int> it;` |
-| `shuffled<T>` | Multi-value returns | `shuffled<string> results;` |
-| `combo<T>` | Filter/search space | `combo<string> search;` |
+    ```cssl
+    typeof(42);           // "int"
+    typeof("hello");      // "str"
+    isinstance(42, "int"); // true
+    isint(42);            // true
+    isstr("hello");       // true
+    isnull(null);         // true
+    ```
 
-### Type Conversion
+    ---
 
-```cssl
-int("42");        // String to int: 42
-float("3.14");    // String to float: 3.14
-str(42);          // Int to string: "42"
-bool(1);          // Int to bool: true
-int("ff", 16);    // Hex to int: 255
-```
+    ## Variables & Globals
 
-### Type Checking
+    ### Scope Behavior
 
-```cssl
-typeof(42);           // "int"
-typeof("hello");      // "str"
-isinstance(42, "int"); // true
-isint(42);            // true
-isstr("hello");       // true
-isnull(null);         // true
-```
+    Variables are **local by default**. Each function/class has its own scope - variables defined inside a function only exist within that function.
 
----
+    ```cssl
+    define myFunction() {
+        string name = "Alice";  // Local to myFunction
+        printl(name);           // Works
+    }
+
+    myFunction();
+    // printl(name);  // Error! 'name' doesn't exist here
 
-## Variables & Globals
+    // Same variable name in different scopes = different variables
+    string name = "Bob";
 
-### Scope Behavior
+    define otherFunction() {
+        string name = "Charlie";  // Different variable, local to otherFunction
+        printl(name);             // "Charlie"
+    }
 
-Variables are **local by default**. Each function/class has its own scope - variables defined inside a function only exist within that function.
+    otherFunction();
+    printl(name);  // "Bob" - outer scope unchanged
+    ```
 
-```cssl
-define myFunction() {
-    string name = "Alice";  // Local to myFunction
-    printl(name);           // Works
-}
-
-myFunction();
-// printl(name);  // Error! 'name' doesn't exist here
-
-// Same variable name in different scopes = different variables
-string name = "Bob";
-
-define otherFunction() {
-    string name = "Charlie";  // Different variable, local to otherFunction
-    printl(name);             // "Charlie"
-}
-
-otherFunction();
-printl(name);  // "Bob" - outer scope unchanged
-```
-
-### Everything is Local by Default
+    ### Everything is Local by Default
 
-All elements (variables, functions, classes) are **local by default** and must be explicitly marked global.
-
-| Element | Local (default) | Global |
-|---------|-----------------|--------|
-| **Variables** | `string x = "text";` | `global x = "text";` or `@x = "text";` |
-| **Functions** | `define myFunc() { }` | `global define myFunc() { }` or `define @myFunc() { }` |
-| **Typed functions** | `void myFunc() { }` | `global void myFunc() { }` or `void @myFunc() { }` |
-| **Classes** | `class MyClass { }` | `global class MyClass { }` or `class @MyClass { }` |
+    All elements (variables, functions, classes) are **local by default** and must be explicitly marked global.
 
-### Local Variables
+    | Element | Local (default) | Global |
+    |---------|-----------------|--------|
+    | **Variables** | `string x = "text";` | `global x = "text";` or `@x = "text";` |
+    | **Functions** | `define myFunc() { }` | `global define myFunc() { }` or `define @myFunc() { }` |
+    | **Typed functions** | `void myFunc() { }` | `global void myFunc() { }` or `void @myFunc() { }` |
+    | **Classes** | `class MyClass { }` | `global class MyClass { }` or `class @MyClass { }` |
 
-```cssl
-string name = "Alice";
-int count = 10;
-float price = 19.99;
-bool active = true;
-```
+    ### Local Variables
 
-### Global Variables
+    ```cssl
+    string name = "Alice";
+    int count = 10;
+    float price = 19.99;
+    bool active = true;
+    ```
 
-Use `global` keyword or `@`/`r@` prefix to create/access global variables:
+    ### Global Variables
 
-```cssl
-// Declaration with 'global' keyword
-global myGlobal = "visible everywhere";
+    Use `global` keyword or `@`/`r@` prefix to create/access global variables:
 
-// Access with '@' prefix
-printl(@myGlobal);
+    ```cssl
+    // Declaration with 'global' keyword
+    global myGlobal = "visible everywhere";
 
-// Direct global assignment with @ or r@
-@anotherGlobal = "also global";
-r@yetAnother = "and this too";
+    // Access with '@' prefix
+    printl(@myGlobal);
 
-// Always read globals with @
-printl(@x);
-```
+    // Direct global assignment with @ or r@
+    @anotherGlobal = "also global";
+    r@yetAnother = "and this too";
 
-### Global Functions
+    // Always read globals with @
+    printl(@x);
+    ```
 
-```cssl
-// Global function with 'global' keyword
-global define helper() {
-    printl("I'm global!");
-}
+    ### Global Functions
 
-// Alternative: @ prefix syntax
-define @anotherHelper() {
-    printl("Also global!");
-}
+    ```cssl
+    // Global function with 'global' keyword
+    global define helper() {
+        printl("I'm global!");
+    }
 
-// Global typed function
-global void @utilityFunc(string msg) {
-    printl(msg);
-}
-```
+    // Alternative: @ prefix syntax
+    define @anotherHelper() {
+        printl("Also global!");
+    }
 
-### Global Classes
+    // Global typed function
+    global void @utilityFunc(string msg) {
+        printl(msg);
+    }
+    ```
 
-```cssl
-// Global class with 'global' keyword
-global class SharedClass {
-    string value;
-}
+    ### Global Classes
 
-// Alternative: @ prefix syntax
-class @AnotherShared {
-    int count;
-}
+    ```cssl
+    // Global class with 'global' keyword
+    global class SharedClass {
+        string value;
+    }
 
-// Instantiate global class with @ prefix
-instance = new @SharedClass();
-```
+    // Alternative: @ prefix syntax
+    class @AnotherShared {
+        int count;
+    }
 
-### Prefix Reference
+    // Instantiate global class with @ prefix
+    instance = new @SharedClass();
+    ```
+
+    ### Prefix Reference
+
+    | Prefix | Name | Usage |
+    |--------|------|-------|
+    | `@` | Global/Module | Read global vars, access modules: `@myVar`, `@os.getcwd()` |
+    | `r@` | Global Ref | Assign to global scope: `r@name = value` |
+    | `$` | Shared | Access Python objects: `$counter.value` |
+    | `%` | Captured | Capture value at registration: `%version` |
+    | `s@` | Self-Ref | Access global structs: `s@Backend.config` |
+
+    ### Shared Objects ($)
+
+    Access Python objects shared via `CSSL.share()`:
+
+    ```cssl
+    // Access shared Python object
+    $counter.value = 100;
+    $counter.increment();
+
+    // Delete shared object
+    delete("counter");
+    ```
+
+    ### Captured References (%)
+
+    Capture value at registration time:
+
+    ```cssl
+    string version = "1.0";
+    savedVersion <<== { %version; }
+    version = "2.0";
+    printl(savedVersion);  // Still "1.0"
+    ```
+
+    ### Class Member Access (this->)
+
+    Inside classes, use `this->` to access instance members:
+
+    ```cssl
+    class Person {
+        string name;
+
+        void setName(string n) {
+            this->name = n;  // Instance member
+        }
+    }
+    ```
+
+    ---
+
+    ## Operators
+
+    ### Arithmetic
+
+    | Operator | Description | Example |
+    |----------|-------------|---------|
+    | `+` | Addition / Concatenation | `a + b` |
+    | `-` | Subtraction | `a - b` |
+    | `*` | Multiplication | `a * b` |
+    | `/` | Division | `a / b` |
+    | `%` | Modulo | `a % b` |
+
+    ### Comparison
+
+    | Operator | Description | Example |
+    |----------|-------------|---------|
+    | `==` | Equal | `a == b` |
+    | `!=` | Not equal | `a != b` |
+    | `<` | Less than | `a < b` |
+    | `>` | Greater than | `a > b` |
+    | `<=` | Less or equal | `a <= b` |
+    | `>=` | Greater or equal | `a >= b` |
+
+    ### Logical
+
+    | Operator | Description | Example |
+    |----------|-------------|---------|
+    | `&&` | AND | `a && b` |
+    | `\|\|` | OR | `a \|\| b` |
+    | `!` | NOT | `!a` |
+    | `and` | AND (keyword) | `a and b` |
+    | `or` | OR (keyword) | `a or b` |
+    | `not` | NOT (keyword) | `not a` |
+
+    ### Increment/Decrement (in for-loops)
+
+    | Operator | Description | Example |
+    |----------|-------------|---------|
+    | `++` | Increment | `i++` |
+    | `--` | Decrement | `i--` |
+    | `+=` | Add assign | `i += 1` |
+    | `-=` | Subtract assign | `i -= 1` |
+
+    ---
+
+    ## Control Flow
+
+    ### If / Else If / Else
+
+    ```cssl
+    if (x < 5) {
+        printl("Small");
+    } else if (x < 15) {
+        printl("Medium");
+    } else {
+        printl("Large");
+    }
 
-| Prefix | Name | Usage |
-|--------|------|-------|
-| `@` | Global/Module | Read global vars, access modules: `@myVar`, `@os.getcwd()` |
-| `r@` | Global Ref | Assign to global scope: `r@name = value` |
-| `$` | Shared | Access Python objects: `$counter.value` |
-| `%` | Captured | Capture value at registration: `%version` |
-| `s@` | Self-Ref | Access global structs: `s@Backend.config` |
+    // elif also works
+    if (x < 5) {
+        printl("Small");
+    } elif (x < 15) {
+        printl("Medium");
+    }
+    ```
+
+    ### Switch / Case
+
+    ```cssl
+    switch (day) {
+        case 1:
+            printl("Monday");
+            break;
+        case 2:
+            printl("Tuesday");
+            break;
+        default:
+            printl("Other");
+    }
+    ```
+
+    ### Parameter Switch (Open Params)
+
+    Pattern matching on which named parameters were provided to a function.
+
+    ```cssl
+    define greet(...) {
+        switch (open) {
+            case name & age:
+                printl("Hello " + OpenFind<string, "name"> + ", age " + OpenFind<int, "age">);
+            case name:
+                printl("Hello " + OpenFind<string, "name">);
+            except name:
+                printl("No name provided!");
+            default:
+                printl("Unknown parameters");
+            always:
+                printl("-- greeting complete --");
+            finally:
+                printl("== cleanup ==");
+        }
+    }
 
-### Shared Objects ($)
+    greet(name="Alice");              // case name matches
+    greet(name="Bob", age=25);        // case name & age matches
+    greet(foo="bar");                 // except name matches (no name)
+    ```
+
+    **Syntax:**
+    - `case param:` - executes if parameter exists
+    - `case param1 & param2:` - executes if ALL parameters exist
+    - `case param1 & not param2:` - AND with negation
+    - `except param:` - executes if parameter does NOT exist
+    - `default:` - executes if no case matched
+    - `always:` - executes after any matching case (not after except/default)
+    - `finally:` - always executes (cleanup, like try/finally)
+
+    > **Note:** Cases are checked in order. Place more specific cases first (`case name & age` before `case name`).
+
+    ### While Loop
+
+    ```cssl
+    int i = 0;
+    while (i < 5) {
+        printl(i);
+        i = i + 1;
+    }
+    ```
 
-Access Python objects shared via `CSSL.share()`:
+    ### For Loop (Python-Style)
 
-```cssl
-// Access shared Python object
-$counter.value = 100;
-$counter.increment();
+    ```cssl
+    // Range-based
+    for (i in range(5)) {
+        printl(i);  // 0, 1, 2, 3, 4
+    }
 
-// Delete shared object
-delete("counter");
-```
+    // With start and end
+    for (i in range(10, 15)) {
+        printl(i);  // 10, 11, 12, 13, 14
+    }
 
-### Captured References (%)
+    // With step
+    for (i in range(0, 10, 2)) {
+        printl(i);  // 0, 2, 4, 6, 8
+    }
+    ```
 
-Capture value at registration time:
-
-```cssl
-string version = "1.0";
-savedVersion <<== { %version; }
-version = "2.0";
-printl(savedVersion);  // Still "1.0"
-```
-
-### Class Member Access (this->)
-
-Inside classes, use `this->` to access instance members:
-
-```cssl
-class Person {
-    string name;
-
-    void setName(string n) {
-        this->name = n;  // Instance member
-    }
-}
-```
-
----
-
-## Operators
-
-### Arithmetic
-
-| Operator | Description | Example |
-|----------|-------------|---------|
-| `+` | Addition / Concatenation | `a + b` |
-| `-` | Subtraction | `a - b` |
-| `*` | Multiplication | `a * b` |
-| `/` | Division | `a / b` |
-| `%` | Modulo | `a % b` |
-
-### Comparison
-
-| Operator | Description | Example |
-|----------|-------------|---------|
-| `==` | Equal | `a == b` |
-| `!=` | Not equal | `a != b` |
-| `<` | Less than | `a < b` |
-| `>` | Greater than | `a > b` |
-| `<=` | Less or equal | `a <= b` |
-| `>=` | Greater or equal | `a >= b` |
-
-### Logical
-
-| Operator | Description | Example |
-|----------|-------------|---------|
-| `&&` | AND | `a && b` |
-| `\|\|` | OR | `a \|\| b` |
-| `!` | NOT | `!a` |
-| `and` | AND (keyword) | `a and b` |
-| `or` | OR (keyword) | `a or b` |
-| `not` | NOT (keyword) | `not a` |
-
-### Increment/Decrement (in for-loops)
-
-| Operator | Description | Example |
-|----------|-------------|---------|
-| `++` | Increment | `i++` |
-| `--` | Decrement | `i--` |
-| `+=` | Add assign | `i += 1` |
-| `-=` | Subtract assign | `i -= 1` |
-
----
-
-## Control Flow
-
-### If / Else If / Else
-
-```cssl
-if (x < 5) {
-    printl("Small");
-} else if (x < 15) {
-    printl("Medium");
-} else {
-    printl("Large");
-}
-
-// elif also works
-if (x < 5) {
-    printl("Small");
-} elif (x < 15) {
-    printl("Medium");
-}
-```
-
-### Switch / Case
-
-```cssl
-switch (day) {
-    case 1:
-        printl("Monday");
-        break;
-    case 2:
-        printl("Tuesday");
-        break;
-    default:
-        printl("Other");
-}
-```
-
-### While Loop
-
-```cssl
-int i = 0;
-while (i < 5) {
-    printl(i);
-    i = i + 1;
-}
-```
-
-### For Loop (Python-Style)
-
-```cssl
-// Range-based
-for (i in range(5)) {
-    printl(i);  // 0, 1, 2, 3, 4
-}
-
-// With start and end
-for (i in range(10, 15)) {
-    printl(i);  // 10, 11, 12, 13, 14
-}
-
-// With step
-for (i in range(0, 10, 2)) {
-    printl(i);  // 0, 2, 4, 6, 8
-}
-```
-
-### For Loop (C-Style)
-
-```cssl
-for (int i = 0; i < 10; i++) {
-    printl(i);
-}
-
-for (int i = 10; i > 0; i--) {
-    printl(i);
-}
-```
-
-### Foreach
-
-```cssl
-stack<string> names;
-names.push("Alice");
-names.push("Bob");
-
-// Syntax 1
-foreach (name in names) {
-    printl(name);
-}
-
-// Syntax 2
-foreach names as name {
-    printl(name);
-}
-```
-
-### Break & Continue
-
-```cssl
-for (i in range(10)) {
-    if (i == 5) break;     // Exit loop
-    if (i == 3) continue;  // Skip iteration
-    printl(i);
-}
-```
-
----
-
-## Functions
-
-### Basic Syntax
-
-```cssl
-// Without return
-void sayHello() {
-    printl("Hello!");
-}
-
-// With return
-string getName() {
-    return "CSSL";
-}
-
-// With parameters
-int add(int a, int b) {
-    return a + b;
-}
-```
-
-### Define Functions
-
-```cssl
-// Simple function without type
-define greet() {
-    printl("Hello!");
-}
-
-// With parameters
-define greet(string name) {
-    printl("Hello " + name);
-}
-```
-
-### Function Modifiers
-
-| Modifier | Description |
-|----------|-------------|
-| `undefined` | Silently ignore errors |
-| `closed` | Block external CodeInfusion |
-| `private` | Block all CodeInfusion |
-| `virtual` | Import-cycle safe |
-| `meta` | Source function (any return type allowed) |
-| `super` | Force execution (no exceptions) |
-| `open` | Accept any parameters |
-| `shuffled` | Return multiple values |
-| `const` | Immutable function (like C++) |
-| `static` | Static method/function |
-| `public` | Explicitly public (default) |
-| `global` | Makes function globally accessible |
-
-**Flexible Modifier Order**: Modifiers can appear in any order before the function declaration.
-
-```cssl
-// Ignore errors
-undefined void mayFail() {
-    riskyOperation();
-}
-
-// Protected from injection
-closed void protected() {
-    printl("Protected");
-}
-
-// Multiple returns
-shuffled string getNames() {
-    return "Alice", "Bob", "Charlie";
-}
-
-a, b, c = getNames();
-
-// Any order of modifiers works
-private string *@Myfunc() {
-    println("Hello from global private non-null function!");
-    return "Hey";
-}
-
-// Const function
-const void immutableFunc() {
-    printl("I'm constant");
-}
-
-// Global private const
-global private const void @MyGlobalFunc() {
-    printl("Complex modifiers in any order");
-}
-```
-
-### Typed Functions (Enforced Returns)
-
-Functions with a return type (like `int`, `string`, `vector<T>`) MUST return that type:
-
-```cssl
-// MUST return string
-string getName() {
-    return "Alice";        // OK
-    // return 42;          // Error! Expected string
-}
-
-// MUST return int
-int getAge() {
-    return 30;             // OK
-}
-
-// meta modifier bypasses type checking
-meta datastruct<string> getData() {
-    return "just a string";  // OK despite declared type
-    return 42;               // Also OK - meta allows any type
-}
-```
-
-### Non-Null Functions (*)
-
-Functions that must never return null:
-
-```cssl
-// Non-null function
-define *alwaysReturns() {
-    return "Always a value";
-}
-
-// Non-null assertion on value
-this->name = *$System.os;  // Error if null
-```
-
-### Type Exclusion Filter (*[type])
-
-Functions that must NOT return a specific type:
-
-```cssl
-// Must NOT return string
-shuffled *[string] getNumbers() {
-    return 1, 2, 3;  // OK
-    // return "text";  // Error!
-}
-
-// Must NOT return null
-define *[null] getValue() {
-    return 42;  // OK
-}
-```
+    ### For Loop (C-Style)
 
-### Open Parameters
+    ```cssl
+    for (int i = 0; i < 10; i++) {
+        printl(i);
+    }
 
-```cssl
-open define flexibleFunc(open Params) {
-    string name = OpenFind<string>(0);
-    int num = OpenFind<int>(0);
-    printl(name + " " + num);
-}
+    for (int i = 10; i > 0; i--) {
+        printl(i);
+    }
+    ```
 
-flexibleFunc("Hello", 123, true);
-```
+    ### Foreach
 
----
+    ```cssl
+    stack<string> names;
+    names.push("Alice");
+    names.push("Bob");
 
-## Classes & OOP
+    // Syntax 1
+    foreach (name in names) {
+        printl(name);
+    }
 
-### Class Definition
+    // Syntax 2
+    foreach names as name {
+        printl(name);
+    }
+    ```
 
-```cssl
-class Person {
-    string name;
-    int age;
+    ### Break & Continue
 
-    // Constructor
-    void Person(string n, int a) {
-        this->name = n;
-        this->age = a;
+    ```cssl
+    for (i in range(10)) {
+        if (i == 5) break;     // Exit loop
+        if (i == 3) continue;  // Skip iteration
+        printl(i);
     }
+    ```
+
+    ---
 
-    void greet() {
-        printl("Hello, I'm " + this->name);
+    ## Functions
+
+    ### Basic Syntax
+
+    ```cssl
+    // Without return
+    void sayHello() {
+        printl("Hello!");
     }
 
+    // With return
     string getName() {
-        return this->name;
+        return "CSSL";
+    }
+
+    // With parameters
+    int add(int a, int b) {
+        return a + b;
+    }
+    ```
+
+    ### Define Functions
+
+    ```cssl
+    // Simple function without type
+    define greet() {
+        printl("Hello!");
+    }
+
+    // With parameters
+    define greet(string name) {
+        printl("Hello " + name);
+    }
+    ```
+
+    ### Function Modifiers
+
+    | Modifier | Description |
+    |----------|-------------|
+    | `undefined` | Silently ignore errors |
+    | `closed` | Block external CodeInfusion |
+    | `private` | Block all CodeInfusion |
+    | `virtual` | Import-cycle safe |
+    | `meta` | Source function (any return type allowed) |
+    | `super` | Force execution (no exceptions) |
+    | `open` | Accept any parameters |
+    | `shuffled` | Return multiple values |
+    | `const` | Immutable function (like C++) |
+    | `static` | Static method/function |
+    | `public` | Explicitly public (default) |
+    | `global` | Makes function globally accessible |
+
+    **Flexible Modifier Order**: Modifiers can appear in any order before the function declaration.
+
+    ```cssl
+    // Ignore errors
+    undefined void mayFail() {
+        riskyOperation();
+    }
+
+    // Protected from injection
+    closed void protected() {
+        printl("Protected");
+    }
+
+    // Multiple returns
+    shuffled string getNames() {
+        return "Alice", "Bob", "Charlie";
+    }
+
+    a, b, c = getNames();
+
+    // Any order of modifiers works
+    private string *@Myfunc() {
+        println("Hello from global private non-null function!");
+        return "Hey";
+    }
+
+    // Const function
+    const void immutableFunc() {
+        printl("I'm constant");
     }
-}
-```
 
-### Creating Instances
+    // Global private const
+    global private const void @MyGlobalFunc() {
+        printl("Complex modifiers in any order");
+    }
+    ```
+
+    ### Typed Functions (Enforced Returns)
 
-```cssl
-Person p = new Person("Alice", 30);
-p.greet();
-printl(p.name);
-```
+    Functions with a return type (like `int`, `string`, `vector<T>`) MUST return that type:
 
-### Constructor with `constr` Keyword
+    ```cssl
+    // MUST return string
+    string getName() {
+        return "Alice";        // OK
+        // return 42;          // Error! Expected string
+    }
 
-```cssl
-class Vehicle {
-    string brand;
+    // MUST return int
+    int getAge() {
+        return 30;             // OK
+    }
 
-    constr Initialize(string b) {
-        this->brand = b;
+    // meta modifier bypasses type checking
+    meta datastruct<string> getData() {
+        return "just a string";  // OK despite declared type
+        return 42;               // Also OK - meta allows any type
     }
+    ```
+
+    ### Non-Null Functions (*)
 
-    constr SetupDefaults() {
-        printl("Vehicle ready");
+    Functions that must never return null:
+
+    ```cssl
+    // Non-null function
+    define *alwaysReturns() {
+        return "Always a value";
     }
-}
 
-Vehicle v = new Vehicle("Toyota");
-```
+    // Non-null assertion on value
+    this->name = *$System.os;  // Error if null
+    ```
 
-### Class Inheritance
+    ### Type Exclusion Filter (*[type])
 
-```cssl
-class Animal {
-    string name;
+    Functions that must NOT return a specific type:
 
-    void Animal(string n) {
-        this->name = n;
+    ```cssl
+    // Must NOT return string
+    shuffled *[string] getNumbers() {
+        return 1, 2, 3;  // OK
+        // return "text";  // Error!
     }
 
-    void speak() {
-        printl("Sound");
+    // Must NOT return null
+    define *[null] getValue() {
+        return 42;  // OK
     }
-}
+    ```
+
+    ### Open Parameters
 
-class Dog : extends Animal {
-    void Dog(string n) {
-        this->name = n;
+    ```cssl
+    open define flexibleFunc(open Params) {
+        string name = OpenFind<string>(0);
+        int num = OpenFind<int>(0);
+        printl(name + " " + num);
     }
 
-    void speak() {
-        printl("Woof! I'm " + this->name);
+    flexibleFunc("Hello", 123, true);
+    ```
+
+    ---
+
+    ## Classes & OOP
+
+    ### Class Definition
+
+    ```cssl
+    class Person {
+        string name;
+        int age;
+
+        // Constructor
+        void Person(string n, int a) {
+            this->name = n;
+            this->age = a;
+        }
+
+        void greet() {
+            printl("Hello, I'm " + this->name);
+        }
+
+        string getName() {
+            return this->name;
+        }
     }
-}
+    ```
+
+    ### Creating Instances
 
-Dog d = new Dog("Buddy");
-d.speak();  // "Woof! I'm Buddy"
-```
+    ```cssl
+    Person p = new Person("Alice", 30);
+    p.greet();
+    printl(p.name);
+    ```
 
-### super() and super::method()
+    ### Constructor with `constr` Keyword
 
-```cssl
-class Child : extends Parent {
-    constr ChildInit(string name) {
-        super(name);  // Call parent constructor
+    ```cssl
+    class Vehicle {
+        string brand;
+
+        constr Initialize(string b) {
+            this->brand = b;
+        }
+
+        constr SetupDefaults() {
+            printl("Vehicle ready");
+        }
     }
 
-    void speak() {
-        super::speak();  // Call parent method
-        printl("Child speaking");
+    Vehicle v = new Vehicle("Toyota");
+    ```
+
+    ### Class Inheritance
+
+    ```cssl
+    class Animal {
+        string name;
+
+        void Animal(string n) {
+            this->name = n;
+        }
+
+        void speak() {
+            printl("Sound");
+        }
     }
-}
-```
 
-### Append Mode (++)
+    class Dog : extends Animal {
+        void Dog(string n) {
+            this->name = n;
+        }
 
-Extend constructors/functions while keeping original code:
+        void speak() {
+            printl("Woof! I'm " + this->name);
+        }
+    }
 
-```cssl
-// Original function
-define BaseFunc() {
-    printl("Base functionality");
-}
+    Dog d = new Dog("Buddy");
+    d.speak();  // "Woof! I'm Buddy"
+    ```
 
-// Append to BaseFunc
-define ExtendedFunc() &BaseFunc ++ {
-    printl("Extended functionality");
-}
+    ### super() and super::method()
 
-ExtendedFunc();
-// Output:
-// Base functionality
-// Extended functionality
-```
+    ```cssl
+    class Child : extends Parent {
+        constr ChildInit(string name) {
+            super(name);  // Call parent constructor
+        }
 
-```cssl
-class MyClass {
-    constr MyClassConstructor() {
-        printl("MyClass constructor");
-        this->value = 10;
+        void speak() {
+            super::speak();  // Call parent method
+            printl("Child speaking");
+        }
     }
-}
+    ```
+
+    ### Append Mode (++)
 
-class BetterClass :: extends MyClass {
-    constr BetterConstructor() &MyClass::MyClassConstructor ++ {
-        printl("BetterClass - added code");
-        this->extra = 20;
+    Extend constructors/functions while keeping original code:
+
+    ```cssl
+    // Original function
+    define BaseFunc() {
+        printl("Base functionality");
     }
-}
-```
 
-### Non-Null Class
+    // Append to BaseFunc
+    define ExtendedFunc() &BaseFunc ++ {
+        printl("Extended functionality");
+    }
 
-```cssl
-class *MyClass {
-    // All methods must return non-null
-    string getValue() {
-        return "Value";
-    }
-}
-```
-
----
-
-## Container Types
-
-### stack\<T\> - LIFO Stack
-
-```cssl
-stack<string> names;
-names.push("Alice");
-names.push("Bob");
-
-printl(names.pop());     // "Bob"
-printl(names.peek());    // "Alice" (doesn't remove)
-printl(names.size());    // 1
-printl(names.isEmpty()); // false
-```
-
-**Methods:**
-
-| Method | Description |
-|--------|-------------|
-| `push(value)` | Add to top |
-| `pop()` | Remove and return top |
-| `peek()` | View top without removing |
-| `size()` / `length()` | Element count |
-| `isEmpty()` / `is_empty()` | Check if empty |
-| `contains(value)` | Check if contains |
-| `indexOf(value)` | Find index (-1 if not found) |
-| `toArray()` | Convert to list |
-| `swap()` | Swap top two elements |
-| `dup()` | Duplicate top element |
-
-### vector\<T\> - Dynamic Array
-
-```cssl
-vector<int> nums;
-nums.push(10);
-nums.push(20);
-
-printl(nums.at(0));     // 10
-printl(nums.front());   // 10
-printl(nums.back());    // 20
-```
-
-**Methods:**
-
-| Method | Description |
-|--------|-------------|
-| `push(value)` / `push_back(value)` | Add to end |
-| `push_front(value)` | Add to front |
-| `pop_back()` | Remove from end |
-| `pop_front()` | Remove from front |
-| `at(index)` | Get element |
-| `set(index, value)` | Set element |
-| `front()` | Get first |
-| `back()` | Get last |
-| `size()` / `length()` | Element count |
-| `empty()` / `isEmpty()` | Check if empty |
-| `contains(value)` | Check if contains |
-| `indexOf(value)` | Find first index |
-| `lastIndexOf(value)` | Find last index |
-| `slice(start, end)` | Get sub-vector |
-| `join(separator)` | Join to string |
-| `map(func)` | Apply function |
-| `filter(predicate)` | Filter elements |
-| `forEach(func)` | Execute for each |
-| `every(predicate)` | Check all match |
-| `some(predicate)` | Check any match |
-| `reduce(func, initial)` | Reduce to value |
-| `toArray()` | Convert to list |
-
-### map\<K,V\> - Ordered Key-Value
-
-```cssl
-map<string, int> ages;
-ages.insert("Alice", 30);
-ages.insert("Bob", 25);
-
-printl(ages.find("Alice"));   // 30
-printl(ages.contains("Bob")); // true
-ages.erase("Bob");
-```
-
-**Methods:**
-
-| Method | Description |
-|--------|-------------|
-| `insert(key, value)` | Insert/update pair |
-| `find(key)` | Get value (null if not found) |
-| `at(key)` | Get value (throws if not found) |
-| `erase(key)` | Remove key |
-| `contains(key)` | Check if key exists |
-| `count(key)` | Count (0 or 1) |
-| `size()` | Pair count |
-| `empty()` | Check if empty |
-| `begin()` | First key-value tuple |
-| `end()` | Last key-value tuple |
-| `lower_bound(key)` | First key >= given |
-| `upper_bound(key)` | First key > given |
-
-### datastruct\<T\> - Universal Container
-
-Primary target for BruteInjection operations.
-
-```cssl
-datastruct<string> data;
-data.add("item1");
-data.add("item2");
-
-printl(data.content());  // All elements
-```
-
-**Methods:**
-
-| Method | Description |
-|--------|-------------|
-| `content()` | Get all elements |
-| `add(value)` | Add element |
-| `remove_where(predicate)` | Remove matching |
-| `find_where(predicate)` | Find first matching |
-| `convert(type)` | Convert first element |
-
-### shuffled\<T\> - Multiple Returns
-
-```cssl
-shuffled string getInfo() {
-    return "Alice", "Bob", "Charlie";
-}
-
-a, b, c = getInfo();
-printl(a);  // "Alice"
-```
-
----
-
-## Built-in Functions
-
-### String Operations
-
-```cssl
-string s = "Hello World";
-
-// Case
-upper(s);              // "HELLO WORLD"
-lower(s);              // "hello world"
-capitalize(s);         // "Hello world"
-title(s);              // "Hello World"
-
-// Trim
-trim("  text  ");      // "text"
-ltrim("  text");       // "text"
-rtrim("text  ");       // "text"
-
-// Search
-contains(s, "World");  // true
-startswith(s, "Hello"); // true
-endswith(s, "World");  // true
-indexof(s, "o");       // 4
-lastindexof(s, "o");   // 7
-
-// Manipulation
-replace(s, "World", "CSSL");  // "Hello CSSL"
-substr(s, 0, 5);              // "Hello"
-split(s, " ");                // ["Hello", "World"]
-join("-", ["a", "b"]);        // "a-b"
-repeat("ab", 3);              // "ababab"
-reverse(s);                   // "dlroW olleH"
-
-// Padding
-padleft("42", 5, "0");   // "00042"
-padright("42", 5, ".");  // "42..."
-center("hi", 6, "-");    // "--hi--"
-zfill("42", 5);          // "00042"
-
-// Character
-len(s);                  // 11
-chars("abc");            // ["a", "b", "c"]
-ord("A");                // 65
-chr(65);                 // "A"
-
-// Checks
-isalpha("abc");          // true
-isdigit("123");          // true
-isalnum("abc123");       // true
-isspace("  ");           // true
-```
-
-### Array/List Operations
-
-```cssl
-stack<int> arr = [1, 2, 3, 4, 5];
-
-// Add/Remove
-push(arr, 6);            // Add to end
-pop(arr);                // Remove last
-shift(arr);              // Remove first
-unshift(arr, 0);         // Add to front
-
-// Access
-first(arr);              // First element
-last(arr);               // Last element
-slice(arr, 1, 3);        // [2, 3]
-
-// Transform
-sort(arr);               // Sort ascending
-rsort(arr);              // Sort descending
-reversed(arr);           // Reverse copy
-shuffle(arr);            // Random order
-unique(arr);             // Remove duplicates
-flatten([[1,2],[3,4]]);  // [1, 2, 3, 4]
-
-// Search
-find(arr, x => x > 3);   // First matching
-findindex(arr, x => x > 3);
-every(arr, x => x > 0);  // All match?
-some(arr, x => x > 3);   // Any match?
-count(arr, 2);           // Count of 2
-
-// Functional
-map(arr, x => x * 2);    // [2, 4, 6, 8, 10]
-filter(arr, x => x > 2); // [3, 4, 5]
-reduce(arr, (a,b) => a+b, 0); // 15
-
-// Utilities
-range(5);                // [0, 1, 2, 3, 4]
-range(1, 5);             // [1, 2, 3, 4]
-range(0, 10, 2);         // [0, 2, 4, 6, 8]
-enumerate(arr);          // [(0,1), (1,2), ...]
-zip([1,2], ["a","b"]);   // [(1,"a"), (2,"b")]
-take(arr, 3);            // First 3 elements
-drop(arr, 2);            // Skip first 2
-chunk(arr, 2);           // [[1,2], [3,4], [5]]
-sample(arr, 2);          // 2 random elements
-```
-
-### Dictionary Operations
-
-```cssl
-dict d = {"name": "Alice", "age": 30};
-
-keys(d);                 // ["name", "age"]
-values(d);               // ["Alice", 30]
-items(d);                // [("name","Alice"), ...]
-haskey(d, "name");       // true
-getkey(d, "name");       // "Alice"
-getkey(d, "x", "default"); // "default"
-setkey(d, "city", "NYC"); // Add key
-delkey(d, "age");        // Remove key
-merge(d1, d2);           // Merge dicts
-update(d, {"new": 1});   // Update in place
-fromkeys(["a","b"], 0);  // {"a": 0, "b": 0}
-invert({"a": 1});        // {1: "a"}
-pick(d, "name");         // {"name": "Alice"}
-omit(d, "age");          // {"name": "Alice"}
-```
-
-### Math Functions
-
-```cssl
-abs(-5);                 // 5
-min(3, 1, 2);            // 1
-max(3, 1, 2);            // 3
-sum([1, 2, 3]);          // 6
-avg([1, 2, 3, 4, 5]);    // 3.0
-
-round(3.14159, 2);       // 3.14
-floor(3.9);              // 3
-ceil(3.1);               // 4
-
-pow(2, 3);               // 8
-sqrt(16);                // 4
-mod(7, 3);               // 1
-
-sin(0);                  // 0.0
-cos(0);                  // 1.0
-tan(0);                  // 0.0
-asin(1);                 // 1.5708
-acos(0);                 // 1.5708
-atan(1);                 // 0.7854
-atan2(1, 1);             // 0.7854
-
-log(e());                // 1.0
-log10(100);              // 2.0
-exp(1);                  // 2.71828
-
-pi();                    // 3.14159...
-e();                     // 2.71828...
-radians(180);            // 3.14159
-degrees(3.14159);        // 180
-
-random();                // 0.0 to 1.0
-randint(1, 6);           // 1 to 6
-```
-
-### Date/Time Functions
-
-```cssl
-now();                   // Unix timestamp (float)
-timestamp();             // Unix timestamp (int)
-date();                  // "2025-12-30"
-date("%d/%m/%Y");        // "30/12/2025"
-time();                  // "14:30:45"
-datetime();              // "2025-12-30 14:30:45"
-strftime("%Y-%m-%d", ts);
-
-sleep(1.5);              // Wait 1.5 seconds
-delay(500);              // Wait 500 milliseconds
-```
-
-### File I/O Functions
-
-```cssl
-// Read
-string content = read("file.txt");
-string line5 = readline(5, "file.txt");
-stack<string> lines = readlines("file.txt");
-
-// Write
-write("file.txt", "Hello");
-writeline(3, "New line", "file.txt");
-appendfile("file.txt", "\nMore");
-
-// Path operations
-basename("/path/to/file.txt");  // "file.txt"
-dirname("/path/to/file.txt");   // "/path/to"
-joinpath("/path", "file.txt");  // "/path/file.txt"
-abspath("./file.txt");
-normpath("/path/../other");
-
-// Checks
-pathexists("file.txt");  // true/false
-isfile("file.txt");      // true/false
-isdir("folder");         // true/false
-filesize("file.txt");    // bytes
-
-// Directory
-listdir("./");           // ["file1", "file2"]
-makedirs("new/folder");
-removefile("file.txt");
-removedir("folder");
-copyfile("src", "dst");
-movefile("old", "new");
-```
-
-### JSON Functions (json:: namespace)
-
-```cssl
-// File operations
-json data = json::read("config.json");
-json::write("output.json", data);
-
-// Parse/Stringify
-json obj = json::parse('{"name": "Alice"}');
-string str = json::stringify(obj);
-string pretty = json::pretty(obj);
-
-// Path operations
-json::get(data, "user.name");
-json::get(data, "user.age", 0);  // with default
-json::set(data, "user.name", "Bob");
-json::has(data, "user.email");
-
-// Object operations
-json::keys(obj);         // ["name"]
-json::values(obj);       // ["Alice"]
-json::merge(obj1, obj2); // Deep merge
-```
-
-### Instance Functions (instance:: namespace)
-
-```cssl
-@module = include("lib.cssl-mod");
-
-instance::getMethods(@module);   // Method names
-instance::getClasses(@module);   // Class names
-instance::getVars(@module);      // Variable names
-instance::getAll(@module);       // Categorized dict
-
-instance::call(@module, "methodName", arg1);
-instance::has(@module, "attribute");
-instance::type(@module);         // Type name
-
-isavailable("sharedName");       // Check if exists
-```
-
-### Regex Functions
-
-```cssl
-match("\\d+", "abc123");         // Match at start
-search("\\d+", "abc123");        // Search anywhere
-findall("\\d+", "a1b2c3");       // ["1", "2", "3"]
-sub("\\d", "X", "a1b2");         // "aXbX"
-sub("\\d", "X", "a1b2", 1);      // "aXb2" (count=1)
-```
-
-### Hash Functions
-
-```cssl
-md5("hello");            // 32 hex chars
-sha1("hello");           // 40 hex chars
-sha256("hello");         // 64 hex chars
-```
+    ExtendedFunc();
+    // Output:
+    // Base functionality
+    // Extended functionality
+    ```
+
+    ```cssl
+    class MyClass {
+        constr MyClassConstructor() {
+            printl("MyClass constructor");
+            this->value = 10;
+        }
+    }
 
-### System Functions
+    class BetterClass :: extends MyClass {
+        constr BetterConstructor() &MyClass::MyClassConstructor ++ {
+            printl("BetterClass - added code");
+            this->extra = 20;
+        }
+    }
+    ```
+
+    ### Non-Null Class
+
+    ```cssl
+    class *MyClass {
+        // All methods must return non-null
+        string getValue() {
+            return "Value";
+        }
+    }
+    ```
+
+    ---
+
+    ## Container Types
+
+    ### stack\<T\> - LIFO Stack
+
+    ```cssl
+    stack<string> names;
+    names.push("Alice");
+    names.push("Bob");
+
+    printl(names.pop());     // "Bob"
+    printl(names.peek());    // "Alice" (doesn't remove)
+    printl(names.size());    // 1
+    printl(names.isEmpty()); // false
+    ```
+
+    **Methods:**
+
+    | Method | Description |
+    |--------|-------------|
+    | `push(value)` | Add to top |
+    | `pop()` | Remove and return top |
+    | `peek()` | View top without removing |
+    | `size()` / `length()` | Element count |
+    | `isEmpty()` / `is_empty()` | Check if empty |
+    | `contains(value)` | Check if contains |
+    | `indexOf(value)` | Find index (-1 if not found) |
+    | `toArray()` | Convert to list |
+    | `swap()` | Swap top two elements |
+    | `dup()` | Duplicate top element |
+
+    ### vector\<T\> - Dynamic Array
+
+    ```cssl
+    vector<int> nums;
+    nums.push(10);
+    nums.push(20);
+
+    printl(nums.at(0));     // 10
+    printl(nums.front());   // 10
+    printl(nums.back());    // 20
+    ```
+
+    **Methods:**
+
+    | Method | Description |
+    |--------|-------------|
+    | `push(value)` / `push_back(value)` | Add to end |
+    | `push_front(value)` | Add to front |
+    | `pop_back()` | Remove from end |
+    | `pop_front()` | Remove from front |
+    | `at(index)` | Get element |
+    | `set(index, value)` | Set element |
+    | `front()` | Get first |
+    | `back()` | Get last |
+    | `size()` / `length()` | Element count |
+    | `empty()` / `isEmpty()` | Check if empty |
+    | `contains(value)` | Check if contains |
+    | `indexOf(value)` | Find first index |
+    | `lastIndexOf(value)` | Find last index |
+    | `slice(start, end)` | Get sub-vector |
+    | `join(separator)` | Join to string |
+    | `map(func)` | Apply function |
+    | `filter(predicate)` | Filter elements |
+    | `forEach(func)` | Execute for each |
+    | `every(predicate)` | Check all match |
+    | `some(predicate)` | Check any match |
+    | `reduce(func, initial)` | Reduce to value |
+    | `toArray()` | Convert to list |
+
+    ### map\<K,V\> - Ordered Key-Value
+
+    ```cssl
+    map<string, int> ages;
+    ages.insert("Alice", 30);
+    ages.insert("Bob", 25);
+
+    printl(ages.find("Alice"));   // 30
+    printl(ages.contains("Bob")); // true
+    ages.erase("Bob");
+    ```
+
+    **Methods:**
+
+    | Method | Description |
+    |--------|-------------|
+    | `insert(key, value)` | Insert/update pair |
+    | `find(key)` | Get value (null if not found) |
+    | `at(key)` | Get value (throws if not found) |
+    | `erase(key)` | Remove key |
+    | `contains(key)` | Check if key exists |
+    | `count(key)` | Count (0 or 1) |
+    | `size()` | Pair count |
+    | `empty()` | Check if empty |
+    | `begin()` | First key-value tuple |
+    | `end()` | Last key-value tuple |
+    | `lower_bound(key)` | First key >= given |
+    | `upper_bound(key)` | First key > given |
+
+    ### datastruct\<T\> - Universal Container
+
+    Primary target for BruteInjection operations.
+
+    ```cssl
+    datastruct<string> data;
+    data.add("item1");
+    data.add("item2");
+
+    printl(data.content());  // All elements
+    ```
+
+    **Methods:**
+
+    | Method | Description |
+    |--------|-------------|
+    | `content()` | Get all elements |
+    | `add(value)` | Add element |
+    | `remove_where(predicate)` | Remove matching |
+    | `find_where(predicate)` | Find first matching |
+    | `convert(type)` | Convert first element |
+
+    ### shuffled\<T\> - Multiple Returns
+
+    ```cssl
+    shuffled string getInfo() {
+        return "Alice", "Bob", "Charlie";
+    }
 
-```cssl
-exit(0);                 // Exit with code
-input("Enter name: ");   // Read user input
+    a, b, c = getInfo();
+    printl(a);  // "Alice"
+    ```
+
+    ---
+
+    ## Built-in Functions
+
+    ### String Operations
+
+    ```cssl
+    string s = "Hello World";
+
+    // Case
+    upper(s);              // "HELLO WORLD"
+    lower(s);              // "hello world"
+    capitalize(s);         // "Hello world"
+    title(s);              // "Hello World"
+
+    // Trim
+    trim("  text  ");      // "text"
+    ltrim("  text");       // "text"
+    rtrim("text  ");       // "text"
+
+    // Search
+    contains(s, "World");  // true
+    startswith(s, "Hello"); // true
+    endswith(s, "World");  // true
+    indexof(s, "o");       // 4
+    lastindexof(s, "o");   // 7
+
+    // Manipulation
+    replace(s, "World", "CSSL");  // "Hello CSSL"
+    substr(s, 0, 5);              // "Hello"
+    split(s, " ");                // ["Hello", "World"]
+    join("-", ["a", "b"]);        // "a-b"
+    repeat("ab", 3);              // "ababab"
+    reverse(s);                   // "dlroW olleH"
+
+    // Padding
+    padleft("42", 5, "0");   // "00042"
+    padright("42", 5, ".");  // "42..."
+    center("hi", 6, "-");    // "--hi--"
+    zfill("42", 5);          // "00042"
+
+    // Character
+    len(s);                  // 11
+    chars("abc");            // ["a", "b", "c"]
+    ord("A");                // 65
+    chr(65);                 // "A"
+
+    // Checks
+    isalpha("abc");          // true
+    isdigit("123");          // true
+    isalnum("abc123");       // true
+    isspace("  ");           // true
+    ```
+
+    ### Array/List Operations
+
+    ```cssl
+    stack<int> arr = [1, 2, 3, 4, 5];
+
+    // Add/Remove
+    push(arr, 6);            // Add to end
+    pop(arr);                // Remove last
+    shift(arr);              // Remove first
+    unshift(arr, 0);         // Add to front
+
+    // Access
+    first(arr);              // First element
+    last(arr);               // Last element
+    slice(arr, 1, 3);        // [2, 3]
+
+    // Transform
+    sort(arr);               // Sort ascending
+    rsort(arr);              // Sort descending
+    reversed(arr);           // Reverse copy
+    shuffle(arr);            // Random order
+    unique(arr);             // Remove duplicates
+    flatten([[1,2],[3,4]]);  // [1, 2, 3, 4]
+
+    // Search
+    find(arr, x => x > 3);   // First matching
+    findindex(arr, x => x > 3);
+    every(arr, x => x > 0);  // All match?
+    some(arr, x => x > 3);   // Any match?
+    count(arr, 2);           // Count of 2
+
+    // Functional
+    map(arr, x => x * 2);    // [2, 4, 6, 8, 10]
+    filter(arr, x => x > 2); // [3, 4, 5]
+    reduce(arr, (a,b) => a+b, 0); // 15
+
+    // Utilities
+    range(5);                // [0, 1, 2, 3, 4]
+    range(1, 5);             // [1, 2, 3, 4]
+    range(0, 10, 2);         // [0, 2, 4, 6, 8]
+    enumerate(arr);          // [(0,1), (1,2), ...]
+    zip([1,2], ["a","b"]);   // [(1,"a"), (2,"b")]
+    take(arr, 3);            // First 3 elements
+    drop(arr, 2);            // Skip first 2
+    chunk(arr, 2);           // [[1,2], [3,4], [5]]
+    sample(arr, 2);          // 2 random elements
+    ```
+
+    ### Dictionary Operations
+
+    ```cssl
+    dict d = {"name": "Alice", "age": 30};
+
+    keys(d);                 // ["name", "age"]
+    values(d);               // ["Alice", 30]
+    items(d);                // [("name","Alice"), ...]
+    haskey(d, "name");       // true
+    getkey(d, "name");       // "Alice"
+    getkey(d, "x", "default"); // "default"
+    setkey(d, "city", "NYC"); // Add key
+    delkey(d, "age");        // Remove key
+    merge(d1, d2);           // Merge dicts
+    update(d, {"new": 1});   // Update in place
+    fromkeys(["a","b"], 0);  // {"a": 0, "b": 0}
+    invert({"a": 1});        // {1: "a"}
+    pick(d, "name");         // {"name": "Alice"}
+    omit(d, "age");          // {"name": "Alice"}
+    ```
+
+    ### Math Functions
+
+    ```cssl
+    abs(-5);                 // 5
+    min(3, 1, 2);            // 1
+    max(3, 1, 2);            // 3
+    sum([1, 2, 3]);          // 6
+    avg([1, 2, 3, 4, 5]);    // 3.0
+
+    round(3.14159, 2);       // 3.14
+    floor(3.9);              // 3
+    ceil(3.1);               // 4
+
+    pow(2, 3);               // 8
+    sqrt(16);                // 4
+    mod(7, 3);               // 1
+
+    sin(0);                  // 0.0
+    cos(0);                  // 1.0
+    tan(0);                  // 0.0
+    asin(1);                 // 1.5708
+    acos(0);                 // 1.5708
+    atan(1);                 // 0.7854
+    atan2(1, 1);             // 0.7854
+
+    log(e());                // 1.0
+    log10(100);              // 2.0
+    exp(1);                  // 2.71828
+
+    pi();                    // 3.14159...
+    e();                     // 2.71828...
+    radians(180);            // 3.14159
+    degrees(3.14159);        // 180
+
+    random();                // 0.0 to 1.0
+    randint(1, 6);           // 1 to 6
+    ```
+
+    ### Date/Time Functions
+
+    ```cssl
+    now();                   // Unix timestamp (float)
+    timestamp();             // Unix timestamp (int)
+    date();                  // "2025-12-30"
+    date("%d/%m/%Y");        // "30/12/2025"
+    time();                  // "14:30:45"
+    datetime();              // "2025-12-30 14:30:45"
+    strftime("%Y-%m-%d", ts);
+
+    sleep(1.5);              // Wait 1.5 seconds
+    delay(500);              // Wait 500 milliseconds
+    ```
+
+    ### File I/O Functions
+
+    ```cssl
+    // Read
+    string content = read("file.txt");
+    string line5 = readline(5, "file.txt");
+    stack<string> lines = readlines("file.txt");
+
+    // Write
+    write("file.txt", "Hello");
+    writeline(3, "New line", "file.txt");
+    appendfile("file.txt", "\nMore");
+
+    // Path operations
+    basename("/path/to/file.txt");  // "file.txt"
+    dirname("/path/to/file.txt");   // "/path/to"
+    joinpath("/path", "file.txt");  // "/path/file.txt"
+    abspath("./file.txt");
+    normpath("/path/../other");
+
+    // Checks
+    pathexists("file.txt");  // true/false
+    isfile("file.txt");      // true/false
+    isdir("folder");         // true/false
+    filesize("file.txt");    // bytes
+
+    // Directory
+    listdir("./");           // ["file1", "file2"]
+    makedirs("new/folder");
+    removefile("file.txt");
+    removedir("folder");
+    copyfile("src", "dst");
+    movefile("old", "new");
+    ```
+
+    ### JSON Functions (json:: namespace)
+
+    ```cssl
+    // File operations
+    json data = json::read("config.json");
+    json::write("output.json", data);
+
+    // Parse/Stringify
+    json obj = json::parse('{"name": "Alice"}');
+    string str = json::stringify(obj);
+    string pretty = json::pretty(obj);
+
+    // Path operations
+    json::get(data, "user.name");
+    json::get(data, "user.age", 0);  // with default
+    json::set(data, "user.name", "Bob");
+    json::has(data, "user.email");
+
+    // Object operations
+    json::keys(obj);         // ["name"]
+    json::values(obj);       // ["Alice"]
+    json::merge(obj1, obj2); // Deep merge
+    ```
+
+    ### Instance Functions (instance:: namespace)
+
+    ```cssl
+    @module = include("lib.cssl-mod");
+
+    instance::getMethods(@module);   // Method names
+    instance::getClasses(@module);   // Class names
+    instance::getVars(@module);      // Variable names
+    instance::getAll(@module);       // Categorized dict
+
+    instance::call(@module, "methodName", arg1);
+    instance::has(@module, "attribute");
+    instance::type(@module);         // Type name
+
+    isavailable("sharedName");       // Check if exists
+    ```
+
+    ### Regex Functions
+
+    ```cssl
+    match("\\d+", "abc123");         // Match at start
+    search("\\d+", "abc123");        // Search anywhere
+    findall("\\d+", "a1b2c3");       // ["1", "2", "3"]
+    sub("\\d", "X", "a1b2");         // "aXbX"
+    sub("\\d", "X", "a1b2", 1);      // "aXb2" (count=1)
+    ```
+
+    ### Hash Functions
+
+    ```cssl
+    md5("hello");            // 32 hex chars
+    sha1("hello");           // 40 hex chars
+    sha256("hello");         // 64 hex chars
+    ```
+
+    ### System Functions
 
-env("PATH");             // Get env variable
-setenv("MY_VAR", "val"); // Set env variable
+    ```cssl
+    exit(0);                 // Exit with code
+    input("Enter name: ");   // Read user input
 
-copy(obj);               // Shallow copy
-deepcopy(obj);           // Deep copy
+    env("PATH");             // Get env variable
+    setenv("MY_VAR", "val"); // Set env variable
+
+    copy(obj);               // Shallow copy
+    deepcopy(obj);           // Deep copy
+
+    clear();                 // Clear console
 
-clear();                 // Clear console
+    pyimport("os");          // Import Python module
+    include("lib.cssl-mod"); // Import CSSL module
+    payload("helper.cssl-pl"); // Load payload
 
-pyimport("os");          // Import Python module
-include("lib.cssl-mod"); // Import CSSL module
-payload("helper.cssl-pl"); // Load payload
+    isLinux();               // Platform checks
+    isWindows();
+    isMac();
+    ```
 
-isLinux();               // Platform checks
-isWindows();
-isMac();
-```
+    ### Filter Functions (filter:: namespace)
 
-### Filter Functions (filter:: namespace)
+    ```cssl
+    // Register custom filter
+    filter::register("custom", "handler", callback);
+    filter::unregister("custom", "handler");
+    filter::list();          // All registered filters
+    filter::exists("custom", "handler");
+    ```
 
-```cssl
-// Register custom filter
-filter::register("custom", "handler", callback);
-filter::unregister("custom", "handler");
-filter::list();          // All registered filters
-filter::exists("custom", "handler");
-```
+    ---
 
----
+    ## CodeInfusion
 
-## CodeInfusion
+    Modify functions at runtime.
 
-Modify functions at runtime.
+    ### <<== (Replace)
 
-### <<== (Replace)
+    ```cssl
+    void original() {
+        printl("Original");
+    }
 
-```cssl
-void original() {
-    printl("Original");
-}
+    original() <<== {
+        printl("Replaced");
+    }
 
-original() <<== {
-    printl("Replaced");
-}
+    original();  // "Replaced"
+    ```
 
-original();  // "Replaced"
-```
+    ### +<<== (Add Before)
 
-### +<<== (Add Before)
+    ```cssl
+    void base() {
+        printl("Base");
+    }
 
-```cssl
-void base() {
-    printl("Base");
-}
+    base() +<<== {
+        printl("Added");
+    }
 
-base() +<<== {
-    printl("Added");
-}
+    base();
+    // Output:
+    // Added
+    // Base
+    ```
 
-base();
-// Output:
-// Added
-// Base
-```
+    ### -<<== (Remove)
 
-### -<<== (Remove)
+    ```cssl
+    void withExtra() {
+        printl("Important");
+        printl("Unimportant");
+    }
 
-```cssl
-void withExtra() {
-    printl("Important");
-    printl("Unimportant");
-}
+    withExtra() -<<== {
+        printl("Unimportant");
+    }
 
-withExtra() -<<== {
-    printl("Unimportant");
-}
+    withExtra();  // Only "Important"
+    ```
 
-withExtra();  // Only "Important"
-```
+    ### Exit Injection
 
-### Exit Injection
+    ```cssl
+    exit() <<== {
+        printl("Cleanup...");
+    }
 
-```cssl
-exit() <<== {
-    printl("Cleanup...");
-}
+    exit();  // Executes injection
+    ```
 
-exit();  // Executes injection
-```
+    ---
 
----
+    ## BruteInjection
 
-## BruteInjection
+    Transfer data between containers.
 
-Transfer data between containers.
+    ### +<== (Copy)
 
-### +<== (Copy)
+    ```cssl
+    stack<string> source;
+    source.push("A");
+    source.push("B");
 
-```cssl
-stack<string> source;
-source.push("A");
-source.push("B");
+    datastruct<string> target;
+    target +<== source;  // Copy A, B (source unchanged)
+    ```
 
-datastruct<string> target;
-target +<== source;  // Copy A, B (source unchanged)
-```
+    ### -<== (Move)
 
-### -<== (Move)
+    ```cssl
+    stack<string> src;
+    src.push("Data");
 
-```cssl
-stack<string> src;
-src.push("Data");
+    datastruct<string> dst;
+    dst -<== src;  // src is empty after
+    ```
 
-datastruct<string> dst;
-dst -<== src;  // src is empty after
-```
+    ### ==> (Replace)
 
-### ==> (Replace)
+    ```cssl
+    stack<string> data;
+    data.push("New");
 
-```cssl
-stack<string> data;
-data.push("New");
+    datastruct<string> container;
+    container ==> data;  // Replace container content
+    ```
 
-datastruct<string> container;
-container ==> data;  // Replace container content
-```
+    ### ==>- (Remove Matching)
 
-### ==>- (Remove Matching)
+    ```cssl
+    stack<string> names;
+    names.push("Alice");
+    names.push("Bob");
+    names.push("Alice");
 
-```cssl
-stack<string> names;
-names.push("Alice");
-names.push("Bob");
-names.push("Alice");
+    stack<string> toRemove;
+    toRemove.push("Alice");
 
-stack<string> toRemove;
-toRemove.push("Alice");
+    names ==>- toRemove;
+    printl(names);  // ["Bob"]
+    ```
 
-names ==>- toRemove;
-printl(names);  // ["Bob"]
-```
+    ### Filter Syntax
 
-### Filter Syntax
+    ```cssl
+    target +<== [type::filter=value] source;
 
-```cssl
-target +<== [type::filter=value] source;
+    // String filters
+    result +<== [string::where="Apple"] fruits;
+    result +<== [string::not="Banana"] fruits;
+    result +<== [string::contains="App"] fruits;
+    result +<== [string::length=5] fruits;
+    result +<== [string::cut=3] version;
+    result +<== [string::cutAfter="."] version;
 
-// String filters
-result +<== [string::where="Apple"] fruits;
-result +<== [string::not="Banana"] fruits;
-result +<== [string::contains="App"] fruits;
-result +<== [string::length=5] fruits;
-result +<== [string::cut=3] version;
-result +<== [string::cutAfter="."] version;
+    // Other filters
+    result +<== [integer::where=42] numbers;
+    result +<== [json::key="name"] objects;
+    ```
 
-// Other filters
-result +<== [integer::where=42] numbers;
-result +<== [json::key="name"] objects;
-```
+    ---
 
----
+    ## Value Capture
 
-## Value Capture
+    Capture values at registration time with `%`:
 
-Capture values at registration time with `%`:
+    ```cssl
+    string version = "1.0.0";
+    savedVersion <<== { %version; }
 
-```cssl
-string version = "1.0.0";
-savedVersion <<== { %version; }
+    version = "2.0.0";
+    printl(savedVersion);  // "1.0.0" (captured value)
+    ```
 
-version = "2.0.0";
-printl(savedVersion);  // "1.0.0" (captured value)
-```
+    ### Capturing Functions
 
-### Capturing Functions
+    ```cssl
+    originalExit <<== { %exit(); }
 
-```cssl
-originalExit <<== { %exit(); }
+    exit() <<== {
+        printl("Custom cleanup");
+        originalExit();
+    }
+    ```
 
-exit() <<== {
-    printl("Custom cleanup");
-    originalExit();
-}
-```
+    ---
 
----
+    ## Module System
 
-## Module System
+    ### Import CSSL Module
 
-### Import CSSL Module
+    ```cssl
+    @Math = include("mathlib.cssl-mod");
+    int result = @Math.add(5, 3);
+    ```
 
-```cssl
-@Math = include("mathlib.cssl-mod");
-int result = @Math.add(5, 3);
-```
+    ### Import Python Module
 
-### Import Python Module
+    ```cssl
+    @os = pyimport("os");
+    string cwd = @os.getcwd();
 
-```cssl
-@os = pyimport("os");
-string cwd = @os.getcwd();
+    @datetime = pyimport("datetime");
+    @datetime.datetime.now();
+    ```
 
-@datetime = pyimport("datetime");
-@datetime.datetime.now();
-```
+    ### Load Payload
 
-### Load Payload
+    ```cssl
+    payload("helpers.cssl-pl");
+    ```
 
-```cssl
-payload("helpers.cssl-pl");
-```
+    ### Create Module (CLI)
 
-### Create Module (CLI)
+    ```bash
+    python -m includecpp cssl makemodule mylib.py -o mylib.cssl-mod
+    ```
 
-```bash
-python -m includecpp cssl makemodule mylib.py -o mylib.cssl-mod
-```
+    ---
 
----
+    ## Multi-Language Support
 
-## Multi-Language Support
+    CSSL v4.1.0 introduces multi-language support for interoperability with other programming languages.
 
-CSSL v4.1.0 introduces multi-language support for interoperability with other programming languages.
+    ### libinclude - Load Language Support
 
-### libinclude - Load Language Support
+    Use `libinclude()` to load a language support module:
 
-Use `libinclude()` to load a language support module:
+    ```cssl
+    // Load language support
+    @py = libinclude("python");
+    cpp = libinclude("c++");
+    java = libinclude("java");
+    csharp = libinclude("c#");
+    js = libinclude("javascript");
+    ```
 
-```cssl
-// Load language support
-@py = libinclude("python");
-cpp = libinclude("c++");
-java = libinclude("java");
-csharp = libinclude("c#");
-js = libinclude("javascript");
-```
+    **Supported Languages:**
 
-**Supported Languages:**
+    | Language | Identifiers |
+    |----------|-------------|
+    | Python | `python`, `py` |
+    | C++ | `c++`, `cpp` |
+    | Java | `java` |
+    | C# | `c#`, `csharp` |
+    | JavaScript | `javascript`, `js` |
 
-| Language | Identifiers |
-|----------|-------------|
-| Python | `python`, `py` |
-| C++ | `c++`, `cpp` |
-| Java | `java` |
-| C# | `c#`, `csharp` |
-| JavaScript | `javascript`, `js` |
+    ### supports - Multi-Language Syntax
 
-### supports - Multi-Language Syntax
+    Use the `supports` keyword to write functions or classes using another language's syntax:
 
-Use the `supports` keyword to write functions or classes using another language's syntax:
+    ```cssl
+    // Python-style function
+    define calculate(numbers) : supports python {
+        total = 0
+        for n in numbers:
+            total = total + n
+        return total
+    }
 
-```cssl
-// Python-style function
-define calculate(numbers) : supports python {
-    total = 0
-    for n in numbers:
-        total = total + n
-    return total
-}
+    // C++ style class
+    class Engine : supports cpp {
+        int power;
+        bool running;
 
-// C++ style class
-class Engine : supports cpp {
-    int power;
-    bool running;
+        void start() {
+            this->running = true;
+        }
+    }
 
-    void start() {
-        this->running = true;
+    // JavaScript style function
+    define fetchData(url) : supports javascript {
+        let response = fetch(url);
+        console.log("Fetched: " + url);
+        return response;
     }
-}
+    ```
+
+    ### Cross-Language Instance Access
 
-// JavaScript style function
-define fetchData(url) : supports javascript {
-    let response = fetch(url);
-    console.log("Fetched: " + url);
-    return response;
-}
-```
+    Access instances shared from other languages using `lang$InstanceName` syntax:
 
-### Cross-Language Instance Access
+    ```cssl
+    cpp = libinclude("c++");
 
-Access instances shared from other languages using `lang$InstanceName` syntax:
+    // Access C++ shared instance
+    engine = cpp$MyEngine;
+    printl(engine.power);
 
-```cssl
-cpp = libinclude("c++");
+    // Cross-language inheritance
+    class TurboEngine : extends cpp$Engine {
+        int turboBoost;
 
-// Access C++ shared instance
-engine = cpp$MyEngine;
-printl(engine.power);
+        constr TurboEngine(int boost) {
+            this->turboBoost = boost;
+        }
+    }
+    ```
+
+    ### Instance Sharing API
 
-// Cross-language inheritance
-class TurboEngine : extends cpp$Engine {
-    int turboBoost;
+    Share instances between languages using the `share()` and `get_instance()` methods:
 
-    constr TurboEngine(int boost) {
-        this->turboBoost = boost;
+    ```cssl
+    // Get language support
+    cpp = libinclude("c++");
+
+    // Share a CSSL instance with C++
+    class MyClass {
+        string value;
     }
-}
-```
+    instance = new MyClass();
+    cpp.share("MyClass", instance);
+
+    // Access from C++:
+    // auto* obj = CSSL_GET(MyClass, "MyClass");
+    ```
 
-### Instance Sharing API
+    ### Language SDKs
 
-Share instances between languages using the `share()` and `get_instance()` methods:
+    SDKs are available for sharing instances from other languages into CSSL:
 
-```cssl
-// Get language support
-cpp = libinclude("c++");
+    **C++ SDK:**
+    ```cpp
+    #include "includecpp.h"
 
-// Share a CSSL instance with C++
-class MyClass {
-    string value;
-}
-instance = new MyClass();
-cpp.share("MyClass", instance);
+    class Engine { public: int power = 100; };
 
-// Access from C++:
-// auto* obj = CSSL_GET(MyClass, "MyClass");
-```
+    Engine engine;
+    CSSL_SHARE(Engine, &engine);
+    // Now accessible as cpp$Engine in CSSL
+    ```
 
-### Language SDKs
+    **Java SDK:**
+    ```java
+    import com.includecpp.CSSL;
 
-SDKs are available for sharing instances from other languages into CSSL:
+    MyService svc = new MyService();
+    CSSL.share("MyService", svc);
+    // Now accessible as java$MyService in CSSL
+    ```
 
-**C++ SDK:**
-```cpp
-#include "includecpp.h"
+    **C# SDK:**
+    ```csharp
+    using IncludeCPP;
 
-class Engine { public: int power = 100; };
-
-Engine engine;
-CSSL_SHARE(Engine, &engine);
-// Now accessible as cpp$Engine in CSSL
-```
-
-**Java SDK:**
-```java
-import com.includecpp.CSSL;
-
-MyService svc = new MyService();
-CSSL.share("MyService", svc);
-// Now accessible as java$MyService in CSSL
-```
-
-**C# SDK:**
-```csharp
-using IncludeCPP;
-
-var service = new MyService();
-CSSL.Share("MyService", service);
-// Now accessible as csharp$MyService in CSSL
-```
-
-**JavaScript SDK:**
-```javascript
-import { CSSL } from 'includecpp-cssl';
-
-class DataProcessor { process(data) { } }
-CSSL.share('DataProcessor', new DataProcessor());
-// Now accessible as js$DataProcessor in CSSL
-```
-
-### SDK API Reference
-
-All language SDKs provide these methods:
-
-| Method | Description |
-|--------|-------------|
-| `share(name, instance)` | Share an instance by name |
-| `get(name)` | Get a shared instance |
-| `has(name)` | Check if instance exists |
-| `remove(name)` | Remove a shared instance |
-| `list()` | Get all instance names |
-| `clear()` | Clear all instances |
-
----
-
-## Error Handling
-
-### Try / Catch
-
-```cssl
-try {
-    riskyOperation();
-} catch (error) {
-    printl("Error: " + error);
-}
-
-try {
-    operation();
-} catch (error) {
-    printl("Error");
-} finally {
-    printl("Always runs");
-}
-```
-
-### Undefined Functions
-
-```cssl
-undefined void safeOperation() {
-    dangerousCode();  // Errors ignored
-}
-```
-
-### Assert
-
-```cssl
-assert(x > 0, "x must be positive");
-```
-
----
-
-## Quick Reference
-
-### Keywords
-
-| Keyword | Description |
-|---------|-------------|
-| `void` | No return value |
-| `return` | Return value |
-| `global` | Declare global |
-| `if` / `else` / `elif` | Conditionals |
-| `switch` / `case` / `default` | Switch statement |
-| `for` / `foreach` / `while` | Loops |
-| `break` / `continue` | Loop control |
-| `try` / `catch` / `finally` | Error handling |
-| `class` / `new` / `this` | OOP |
-| `extends` / `overwrites` | Inheritance |
-| `constr` | Constructor |
-| `define` | Function definition |
-| `undefined` | Ignore errors |
-| `closed` / `private` | Injection protection |
-| `virtual` | Import-safe |
-| `meta` / `super` | Special function types |
-| `shuffled` | Multiple returns |
-| `open` | Any parameters |
-| `include` / `get` | Import modules |
-
-### Injection Operators
-
-| Operator | Type | Description |
-|----------|------|-------------|
-| `<<==` | CodeInfusion | Replace function |
-| `+<<==` | CodeInfusion | Add code before |
-| `-<<==` | CodeInfusion | Remove code |
-| `<==` | ValueCapture | Capture/assign |
-| `+<==` | BruteInjection | Copy data |
-| `-<==` | BruteInjection | Move data |
-| `==>` | BruteInjection | Replace data |
-| `==>-` | BruteInjection | Remove matching |
-| `++` | AppendMode | Append to parent |
-
-### Special Syntax
-
-| Syntax | Description |
-|--------|-------------|
-| `@name` | Global variable access |
-| `@name = value` | Global variable assignment |
-| `r@name = value` | Global reference assignment |
-| `$name` | Shared Python object |
-| `%name` | Captured value |
-| `this->` | Class member access |
-| `super::method()` | Parent method call |
-| `json::func()` | Namespace function |
-| `&ClassName::member` | Class member reference |
-| `&FunctionName ++` | Append to function |
-| `*func()` | Non-null function |
-| `*[type]func()` | Type exclusion filter |
-| `global class Name` | Global class declaration |
-| `class @Name` | Global class (alt syntax) |
-| `global define func()` | Global function declaration |
-| `define @func()` | Global function (alt syntax) |
-| `new @ClassName()` | Instantiate global class |
-| `libinclude("lang")` | Load language support module |
-| `supports lang` | Use other language syntax |
-| `lang$InstanceName` | Cross-language instance access |
-
-### Multi-Language Keywords
-
-| Keyword | Description |
-|---------|-------------|
-| `libinclude` | Load language support module |
-| `supports` | Use another language's syntax in function/class |
-
-### Cross-Language Syntax
-
-| Syntax | Description | Example |
-|--------|-------------|---------|
-| `libinclude("lang")` | Load language support | `cpp = libinclude("c++")` |
-| `: supports lang` | Use language syntax | `define func() : supports python { }` |
-| `lang$Name` | Access shared instance | `cpp$Engine`, `java$Service` |
-| `extends lang$Name` | Inherit from shared class | `class Child : extends cpp$Parent { }` |
-
----
-
-*CSSL v4.1.0 - Developed as part of IncludeCPP*
+    var service = new MyService();
+    CSSL.Share("MyService", service);
+    // Now accessible as csharp$MyService in CSSL
+    ```
+
+    **JavaScript SDK:**
+    ```javascript
+    import { CSSL } from 'includecpp-cssl';
+
+    class DataProcessor { process(data) { } }
+    CSSL.share('DataProcessor', new DataProcessor());
+    // Now accessible as js$DataProcessor in CSSL
+    ```
+
+    ### SDK API Reference
+
+    All language SDKs provide these methods:
+
+    | Method | Description |
+    |--------|-------------|
+    | `share(name, instance)` | Share an instance by name |
+    | `get(name)` | Get a shared instance |
+    | `has(name)` | Check if instance exists |
+    | `remove(name)` | Remove a shared instance |
+    | `list()` | Get all instance names |
+    | `clear()` | Clear all instances |
+
+    ---
+
+    ## Error Handling
+
+    ### Try / Catch
+
+    ```cssl
+    try {
+        riskyOperation();
+    } catch (error) {
+        printl("Error: " + error);
+    }
+
+    try {
+        operation();
+    } catch (error) {
+        printl("Error");
+    } finally {
+        printl("Always runs");
+    }
+    ```
+
+    ### Undefined Functions
+
+    ```cssl
+    undefined void safeOperation() {
+        dangerousCode();  // Errors ignored
+    }
+    ```
+
+    ### Assert
+
+    ```cssl
+    assert(x > 0, "x must be positive");
+    ```
+
+    ---
+
+    ## Quick Reference
+
+    ### Keywords
+
+    | Keyword | Description |
+    |---------|-------------|
+    | `void` | No return value |
+    | `return` | Return value |
+    | `global` | Declare global |
+    | `if` / `else` / `elif` | Conditionals |
+    | `switch` / `case` / `default` | Switch statement |
+    | `for` / `foreach` / `while` | Loops |
+    | `break` / `continue` | Loop control |
+    | `try` / `catch` / `finally` | Error handling |
+    | `class` / `new` / `this` | OOP |
+    | `extends` / `overwrites` | Inheritance |
+    | `constr` | Constructor |
+    | `define` | Function definition |
+    | `undefined` | Ignore errors |
+    | `closed` / `private` | Injection protection |
+    | `virtual` | Import-safe |
+    | `meta` / `super` | Special function types |
+    | `shuffled` | Multiple returns |
+    | `open` | Any parameters |
+    | `include` / `get` | Import modules |
+
+    ### Injection Operators
+
+    | Operator | Type | Description |
+    |----------|------|-------------|
+    | `<<==` | CodeInfusion | Replace function |
+    | `+<<==` | CodeInfusion | Add code before |
+    | `-<<==` | CodeInfusion | Remove code |
+    | `<==` | ValueCapture | Capture/assign |
+    | `+<==` | BruteInjection | Copy data |
+    | `-<==` | BruteInjection | Move data |
+    | `==>` | BruteInjection | Replace data |
+    | `==>-` | BruteInjection | Remove matching |
+    | `++` | AppendMode | Append to parent |
+
+    ### Special Syntax
+
+    | Syntax | Description |
+    |--------|-------------|
+    | `@name` | Global variable access |
+    | `@name = value` | Global variable assignment |
+    | `r@name = value` | Global reference assignment |
+    | `$name` | Shared Python object |
+    | `%name` | Captured value |
+    | `this->` | Class member access |
+    | `super::method()` | Parent method call |
+    | `json::func()` | Namespace function |
+    | `&ClassName::member` | Class member reference |
+    | `&FunctionName ++` | Append to function |
+    | `*func()` | Non-null function |
+    | `*[type]func()` | Type exclusion filter |
+    | `global class Name` | Global class declaration |
+    | `class @Name` | Global class (alt syntax) |
+    | `global define func()` | Global function declaration |
+    | `define @func()` | Global function (alt syntax) |
+    | `new @ClassName()` | Instantiate global class |
+    | `libinclude("lang")` | Load language support module |
+    | `supports lang` | Use other language syntax |
+    | `lang$InstanceName` | Cross-language instance access |
+
+    ### Multi-Language Keywords
+
+    | Keyword | Description |
+    |---------|-------------|
+    | `libinclude` | Load language support module |
+    | `supports` | Use another language's syntax in function/class |
+
+    ### Cross-Language Syntax
+
+    | Syntax | Description | Example |
+    |--------|-------------|---------|
+    | `libinclude("lang")` | Load language support | `cpp = libinclude("c++")` |
+    | `: supports lang` | Use language syntax | `define func() : supports python { }` |
+    | `lang$Name` | Access shared instance | `cpp$Engine`, `java$Service` |
+    | `extends lang$Name` | Inherit from shared class | `class Child : extends cpp$Parent { }` |
+
+    ---
+
+    *CSSL v4.1.0 - Developed as part of IncludeCPP*