YesNt-Interpreter/README.md

• Documentation
• Language Reference
• Releases

What is it?

YesNt is a line-based, interpreted scripting language. The core idea is simple: each line maps to one primary statement. Lines are processed top-to-bottom, and inline tokens (like ${variable} or %read_line) are substituted before the statement executes. Postfix modifiers like calc and task can also appear at the end of a line to evaluate arithmetic or fork execution into a background thread.

Key characteristics:

• Line-based execution: Lines are processed top-to-bottom. Each line is a self-contained statement
• Explicit control flow: Labels, goto, and conditional jumps alongside structured if/while blocks
• Explicit scoping: var for function-local variables, global for cross-scope shared state
• Functions with stacks: Arguments and return values are passed via explicit push/pop stacks (push_in, %in, push_out, %out)
• Background tasks: Any line can be forked into a background execution flow with task
• Embeddable: The interpreter ships as a C# library. Custom statements can be registered, and built-in ones can be removed or disabled for sandboxing

YesNt is intentionally minimal and transparent. It is well suited for scripting, education, and embedding in applications that need a lightweight, controllable scripting engine.

Usage

1. Download & install the latest release
   • GitHub (Windows/Linux/macOS): releases
2. Run a script with the interpreter CLI
   • YesNt.Interpreter.App script.ynt runs a script
3. Or use the terminal code editor
   • YesNt.CodeEditor opens the editor (optional path to load a file)
   • run / debug to execute the open script
   • format to auto-format indentation

Example

func greet:
    var name = %in
    print_line Hello, ${name}!
return

func add:
    var result = %in + %in calc
    push_out ${result}
return

call greet with Alice
call greet with Bob

call add with 3, 7
var sum = %out
print_line 3 + 7 = ${sum}