🧠 W++ Developer Guide

🌀 Interpreter Architecture

The W++ interpreter is a recursive AST-walker with dynamic scoping and async evaluation support.

📁 File: Interpreter.cs

• Evaluate(Node) — Core dispatch function for interpreting AST nodes
• EvaluateBinary() — Handles binary math, logic, and comparisons
• InjectBuiltins() — Registers built-in functions like http.get and json.parse
• GetAllMethods() — Recursively resolves entity method inheritance
• ConvertJsonElement() — Converts raw JsonElement into usable W++ types

Runtime Features:

• 🧠 Dynamic scope: every Interpreter instance can be nested
• 💾 Built-in runtime linker via IRuntimeLinker
• ⚙️ Entity + method resolution with support for alters and disown
• 🔗 Function and async function delegates (FunctionObject, AsyncFunctionObject)
• 🔥 Exception-based flow for return, break, continue

🧬 JIT Compiler Overview

The W++ JIT compiler emits .NET IL from AST nodes using System.Reflection.Emit. It's fully async-compatible and produces runtime DynamicMethods that return Task<object>.

📁 File: JitCompiler.cs

• Compile(Node) — Kicks off IL generation for a full AST
• EmitNode(Node, ILGenerator...) — Central recursive emitter for every supported node
• FunctionObject — Wrapper for compiled lambdas with async Invoke()
• AwaitTask() — Safely awaits Task<object> results

Supported Nodes:

• BlockNode, PrintNode, AssignmentNode, IdentifierNode
• BinaryExpressionNode, UnaryExpressionNode
• WhileNode, ForNode, IfElseNode, SwitchNode
• ReturnNode, ThrowNode, TryCatchNode
• LambdaNode, CallNode, BooleanNode, StringNode, NumberNode

Special Behaviors:

• 🧠 Variables declared with DeclareLocal and stored in a scoped map
• 🎯 Jump labels for control flow (break, continue, return)
• 🔥 Full async pipeline with AwaitTask instead of blocking .Result
• 🧪 Each function/lambda gets a DynamicMethod and is stored in a shared _constants pool