YesNt-Interpreter/SYNTAX_V2.md

YesNt v2 Syntax

This document describes the current, word-based YesNt syntax.

Goals

• Keep current semantics and execution model.
• Replace terse mnemonics and symbols with readable words.
• Preserve line-based scripting.
• Keep the language line-based and lightweight.

v2 Core Rules

• Statements are line-based.
• # ... remains a comment.
• Variable interpolation inside text uses ${name}.
• String literals use double quotes ("...") with escapes like \n, \t, \", \\. Interpolation is not evaluated inside string literals.
• Function and label declarations are block markers with a trailing :.
• Conditions retain current evaluator expressions (for example: a == b, x > 5, 10 + 2 == 12).

Quick Example

var name = world
func greet:
print_line "Hello world"
print_line Hello ${name}
end_func
call greet

Block Conditionals

if 10 > 5:
print_line yes
else:
print_line no
end_if

While Loops

var i = 3
while ${i} > 0:
print_line ${i}
var i = ${i} - 1 calc
end_while

Lists

list items new
list items add apple
list items add banana
list items get 1
var value = %out
print_line ${value}

Full v1 -> v2 Mapping

Area	v1 Syntax	v2 Syntax	Notes
Variables	<x = value	var x = value	Local variable define/update.
Variables	!<x = value	global x = value	Global variable define/update.
Variables	del x	delete x	Deletes local first, then global.
Variables	>x	${x}	Variable read/interpolation token.
Console	cwl	print_line	Empty line print.
Console	cwl text	print_line text	Print with newline.
Console	cw text	print text	Print without newline.
Console	%crl	%read_line	Inline token, inserts user line input.
Console	%cr	%read_key	Inline token, inserts user key input.
Console	cls	clear	Clear console.
Code flow	lbl name	label name:	Label declaration/target.
Code flow	jmp name	goto name	Unconditional jump.
Code flow	jif name | cond	if cond goto name	Conditional jump.
Functions	fnc name	func name:	Function declaration (optional , separated named parameters).
Functions	cal name	call name	Function call without args.
Functions	cal name | a,b,c	call name with a, b, c	Function call with args.
Functions	in value	push_in value	Push in-arg onto input stack.
Functions	%get	%in	Inline token, pop current call input arg.
Functions	%isi	%has_in	Inline token, bool if input arg exists.
Functions	put value	push_out value	Push out-arg in function.
Functions	%out	%out	Keep token name for familiarity.
Functions	%iso	%has_out	Inline token, bool if out arg exists.
Functions	ret	end_func	Return from function.
Functions	return value	return value	Return from function, optionally pushing a value to the out stack.
Functions	ccs	clear_call_stack	Clear call stack.
Condition-call	cif name | cond	if cond call name	Conditional function call.
Termination	end	exit	Planned termination.
Termination	trm	abort_all	Planned termination + cancel tasks.
Errors	trw message	throw message	Error termination.
Errors	err message	error message	Non-fatal/runtime message end state.
Processing	expr !calc	expr calc	Evaluate arithmetic fragments.
Processing	text !eval	text eval	Decode safe string literals.
Processing	line !task	line task	Run line in background task runtime.
Processing	slp ms	sleep ms	Sleep with runtime-aware cancellation.
Processing	len text	length text	Push text length to out stack.
Processing	imp file	import file	Inline include of another .ynt file.
System	exc prog	exec prog	Execute process with in-stack args.
System	exc prog | a,b,c	exec prog with a, b, c	Execute process with explicit args.
Predefined	%time	%time	Unix timestamp token.
Predefined	%os	%os	OS platform token.
Predefined	%cpu	%cpu	Processor architecture token.
Predefined	%is64	%is64	64-bit OS bool token.
Predefined	%pi	%pi	PI token.
Predefined	%rnd	%rand	Random number token.

Notes

• %out is intentionally kept as %out.
• Postfix operations are calc, eval, and task.
• return exits the function early (optionally with a value via return <value>); end_func is the explicit end-of-function marker. Both terminate the current function call.
• Functions may declare named parameters after the name (e.g. func add: a, b); each parameter is bound to a local variable from the call arguments, equivalent to var a = %in / var b = %in.