Everything You Need to Build with .wn

Overview

Wevoamon is a custom programming language that uses the .wn extension. The current engine is implemented in C++ and includes a complete Lexer-Parser-Compiler-VM pipeline with expanding runtime capabilities.

The language is under active development and should be considered experimental.

Quick Start

Build the runtime and execute your first .wn program:

cmake -S . -B build -G "MinGW Makefiles" -DCMAKE_CXX_COMPILER="C:/msys64/ucrt64/bin/g++.exe"
cmake --build build -j 4
.\build\wevoamon.exe .\examples\hello.wn

Run any entry file:

.\build\wevoamon.exe .\path\to\program.wn

Syntax

Statements end with ;, assignments use <-, and blocks use { ... }.

forge score <- 72;

check (score >= 50) {
  print::console("Pass");
} other {
  print::console("Fail");
}

ritual add(a, b) {
  give a + b;
}

Modules

Use call to load modules and share to expose selected symbols.

// main.wn
call auth;

check (login("admin", "1234")) {
  print::console("Auth success");
}

// auth.wn
ritual login(user, pass) {
  give user == "admin" && pass == "1234";
}

share login;

Runtime APIs

Built-ins currently available:

• print::console(...)
• clock()
• gc::collect()
• gc::stats()
• jit::status()

print::console(gc::stats());
print::console(jit::status());

CLI Usage

Current runtime executable:

wevoamon.exe <entry-file.wn>

Typical usage:

• Create and edit .wn files
• Use call moduleName; for module imports
• Build the runtime with CMake
• Execute the entry program and iterate on diagnostics

Engine Architecture

Developer Workflow

1. Define token, AST, compiler, and VM changes for new syntax or opcodes.
2. Update language documentation and examples in the same PR.
3. Build locally and run examples/hello.wn as a smoke test.
4. Open a PR with concise technical rationale and migration notes.

Latest Updates

Contribute

We welcome contributions in parser/compiler correctness, runtime features, diagnostics, tooling, and documentation.