fixes (#14 and more) & compile-time literal casting & improved error reporting, robustness & test coverage

.github/workflows/ci.yml

@@ -14,9 +14,9 @@ jobs:
     runs-on: ${{ matrix.os }}
     steps:
       - name: Install V
-        uses: vlang/setup-v@v1
+        uses: vlang/setup-v@v1.4
         with:
-          version: weekly.2025.09
+          version: weekly.2025.48
 
       - name: Checkout ${{ github.event.repository.name }}
         uses: actions/checkout@v2

.github/workflows/manual-release.yml

@@ -44,9 +44,9 @@ jobs:
         uses: actions/checkout@v2
 
       - name: Install V
-        uses: vlang/setup-v@v1
+        uses: vlang/setup-v@v1.4
         with:
-          version: weekly.2025.09
+          version: weekly.2025.48
 
       - name: Build Project
         run: v -prod -gc none -o "bin/papyrus" compiler.v

CHANGELOG.md

@@ -1,4 +1,30 @@
-## Next release
+## Next Release
+
+### Improvements
+
+- **Improved Error Handling**
+  - All panics replaced with more informative alternatives for better debugging.
+
+- **Developer Experience Enhancements**
+  - Added bug report issue template to streamline problem reporting.
+  - Added `version` command to display current compiler version.
+  - Updated supported V compiler version.
+  - TODO: Update help command documentation.
+  - добавлен compile-time каст значений-литералов (int "123" -> 123) для параметров по умолчанию и значений в объявлении свойства
+      ```
+      int Property MyPropAutoCast = \"123\" Auto`
+      ```
+      ```
+      Int Function MyFunc(int n1, int n2 = \"12\")
+        return n1
+      EndFunction"
+      ```
+  - исправлены none значения у property и параметров по умолчанию в функцях
+  - добавлены проверки отсутствующих скриптов в некоторых местах
+  - добавлены проверки родителей у скриптов
+  - исправлена проверка аргумента функции в состоянии с параметром по умолчанию
+  - добавлена проверка параметра по умолчанию
+
 ...
 
 ## V 0.0.3

README.RU.md

@@ -2,6 +2,8 @@
 
 Компилятор скриптового языка Papyrus с открытым исходным кодом. На данный момент компилятор поддерживает только Skyrim (тестировался на Skyrim SE/AE). 
 
+[![Discord Chat](https://img.shields.io/discord/1377359857220321416?label=Discord&logo=Discord)](https://discord.gg/JqQZXAXvPT)
+
 Компилятор был создан для следующих целей:
 1. **Понимание языков программирования:** Проект разработан для того, чтобы глубже понять, как работают языки программирования.
 2. **Эксперименты с языком V:** Использует язык программирования V для реализации.
@@ -29,6 +31,7 @@ papyrus <command> [arguments]
 ```
 
 ### Команды:
+- `version`: Выводит версию компилятора и некоторую дополнительную информацию о билде.
 - `compile`: Компилирует файлы с расширением `.psc` в бинарный формат `.pex`.
 - `read`: Читает и дизассемблирует файл с расширением `.pex`, выводя его содержимое в человекочитаемом формате в консоль.
 - `disassembly`: Читает и дизассемблирует файл с расширением `.pex`, сохраняя содержимое в человекочитаемом формате в текстовый файл.
@@ -45,7 +48,7 @@ papyrus <command> [arguments]
 - `-silent`: Отключает вывод сообщений об ошибках в консоль.
 - `-original`: Использует оригинальный компилятор Papyrus для компиляции.
 - `-stats`: Сохраняет статистику по скомпилированным файлам в .md файлы (количество вызовов функций, наследований, файлов).
-- `-check`: Проверяет синтаксис .psc файлов без генерации .pex файлов.
+- `-check`: Проверяет синтаксис .psc файлов, но не создает .pex файлы.
 - `-verbose`: ...
 
 ### Примеры использования
@@ -125,7 +128,7 @@ Function EquipItem(Form akItem, bool abPreventRemoval = false, bool abSilent = f
 ## Сборка
 
 ### Требования:
-- [V compiler f3d2eb1 (weekly.2025.09)](https://github.com/vlang/v/releases/tag/weekly.2025.09)
+- [V compiler d0dc13e (weekly.2025.48)](https://github.com/vlang/v/releases/tag/weekly.2025.48)
 
 ```bash
 v -o "bin\papyrus.exe" -prod -gc none compiler.v

README.md

@@ -2,6 +2,8 @@
 
 An open-source compiler for the Papyrus scripting language. Currently, the compiler only supports Skyrim (tested on Skyrim SE/AE).
 
+[![Discord Chat](https://img.shields.io/discord/1377359857220321416?label=Discord&logo=Discord)](https://discord.gg/JqQZXAXvPT)
+
 The compiler was created for the following purposes:
 1. **Understanding Programming Languages:** The project is designed to gain a deeper understanding of how programming languages work.
 2. **Experimenting with the V Language:** It uses the V programming language for implementation.
@@ -125,7 +127,7 @@ Scripts from the directory specified by the `-h "..."` argument will NOT be comp
 ## Building
 
 ### Requirements:
-- [V compiler f3d2eb1 (weekly.2025.09)](https://github.com/vlang/v/releases/tag/weekly.2025.09)
+- [V compiler d0dc13e (weekly.2025.48)](https://github.com/vlang/v/releases/tag/weekly.2025.48)
 
 ```bash
 v -o "bin\papyrus.exe" -prod -gc none compiler.v

bin/Original Compiler/README.md

@@ -0,0 +1,3 @@
+# Original Compiler Files
+
+This directory contains the original Papyrus compiler files from the Creation Kit.

compiler.v

@@ -6,16 +6,26 @@ import json
 import builder
 import pref
 import pex
+import papyrus.util
 
 //#flag -lucrtd
 
 fn main() {
 	prefs := pref.parse_args()
-
+	
 	mut sw := time.new_stopwatch()
 	sw.start()
 
 	match prefs.mode {
+		.version {
+			info := util.collect_info()
+			println("Version: ${info.version}")
+			println("Commit:  ${info.git_commit}")
+			println("Build date:  ${info.build_date}")
+			println("Build type:  ${info.build_type}")
+			println("Repository: https://github.com/russo-2025/papyrus-compiler")
+			exit(0)
+		}
 		.compile {
 			builder.compile(prefs)
 		}
@@ -27,12 +37,18 @@ fn main() {
 		.disassembly {
 			println("disassembly file: `${prefs.paths[0]}` ")
 			pex_file := pex.read_from_file(prefs.paths[0])
-			os.write_file(prefs.paths[0] + ".txt", pex_file.str()) or { panic(err) }
+			output_file_name := prefs.paths[0] + ".txt"
+			os.write_file(output_file_name, pex_file.str()) or {
+				util.fatal_error("failed to write file ${output_file_name}; ${err}")
+			}
 		}
 		.create_dump {
 			dump_objects := pex.create_dump_from_pex_dir(prefs.paths[0])
 			json_data := json.encode_pretty(dump_objects)
-			os.write_file(os.real_path("dump.json"), json_data) or { panic(err) }
+			output_file_name := os.real_path("dump.json")
+			os.write_file(output_file_name, json_data) or {
+				util.fatal_error("failed to write file ${output_file_name}; ${err}")
+			}
 		}
 		.help {
 			pref.print_help_info()

modules/builder/builder.v

@@ -7,6 +7,7 @@ import pref
 import papyrus.ast
 import papyrus.checker
 import gen.gen_pex
+import papyrus.util
 
 const cache_path = os.real_path('./.papyrus')
 const compiler_exe_path = os.real_path('./Original Compiler/PapyrusCompiler.exe')
@@ -64,7 +65,7 @@ pub fn (mut b Builder) run() bool {
 
 	b.pref.header_dirs = b.pref.header_dirs.reverse()
 
-	println("used header dirs ${b.pref.header_dirs}")
+	b.print("used header dirs ${b.pref.header_dirs}")
 
 	b.files, b.files_names = find_all_src_files(b.pref.paths)
 
@@ -141,11 +142,11 @@ fn (mut b Builder) start_timer(name string) {
 fn (mut b Builder) print_timer(name string) {
 	if sw := b.timers[name] {
 		time_ms := f32(sw.elapsed().microseconds()) / 1000
-		b.print('$name: $time_ms ms')
+		b.print('${name}: ${time_ms} ms')
 		b.timers.delete(name)
 	}
 	else {
-		panic('invalid timer')
+		util.compiler_error(msg: "failed to find timer", phase: "builder", prefs: b.pref, file: @FILE, func: @FN, line: @LINE)
 	}
 }
 
@@ -167,8 +168,7 @@ fn (b Builder) print(msg string) {
 
 @[noreturn]
 fn error(msg string) {
-	eprintln(msg)
-	exit(1)
+	util.fatal_error(msg)
 }
 
 /*
@@ -188,7 +188,9 @@ fn (mut b Builder) register_info_from_dump(dump_obj &pex.DumpObject) {
 		methods: []ast.Fn{}
 	)
 
-	mut sym := b.table.find_type(dump_obj.name) or { panic("failed to find type") }
+	mut sym := b.table.find_type(dump_obj.name) or {
+		util.compiler_error(msg: "failed to find type", phase: "builder", prefs: b.pref, file: @FILE, func: @FN, line: @LINE)
+	}
 
 	for dump_method in dump_obj.methods {
 		if !sym.has_method(dump_method.name) {

modules/builder/cache.v

@@ -4,23 +4,35 @@ import os
 
 import pref
 import papyrus.ast
+import papyrus.util
 
 struct CacheFile {
 pub mut:
 	last_mod_time	i64
 }
 
 fn read_cache(path string) &CacheFile {
-	mut file := os.open(path) or { panic(err) }
+	mut file := os.open(path) or {
+		util.fatal_error("failed to open file: ${err}")
+	}
+
 	mut cache := CacheFile{}
-	file.read_struct(mut cache) or { panic(err) }
+	file.read_struct(mut cache) or {
+		util.fatal_error("failed to read file: ${err}")
+	}
 	file.close()
 	return &cache
 }
 
 fn write_cache(path string, cache &CacheFile) {
-	mut file := os.create(path) or { panic(err) }
-	file.write_struct(cache) or { panic(err) }
+	mut file := os.create(path) or {
+		util.fatal_error("failed to create file: ${err}")
+	}
+
+	file.write_struct(cache) or {
+		util.fatal_error("failed to write file: ${err}")
+	}
+
 	file.close()
 }
 

modules/builder/original.v

@@ -16,15 +16,18 @@ fn (mut b Builder) compile_original() {
 
 	for file in b.files {
 		cmd := '"${compiler_exe_path}" "${file}" -quiet -i="${header_dirs}" -o="${b.pref.output_dir}" -f="${compiler_flags_path}"'
+
+		b.print("executing: `${cmd}`")
+
 		res := unsafe { os.raw_execute(cmd) }
 
 		if res.exit_code == 0 {
-			println('successfully - ${file}')
+			b.print('successfully - ${file}')
 		}
 		else {
-			println('failed - ${file}')
-			println('console output:')
-			println(res.output)
+			b.print('failed - ${file}')
+			b.print('console output:')
+			b.print(res.output)
 		}
 	}
 }

modules/builder/pex.v

@@ -6,6 +6,7 @@ import pex
 import papyrus.ast
 import papyrus.parser
 import papyrus.checker
+import papyrus.util
 
 @[inline]
 fn (mut b Builder) compile_pex() {
@@ -20,26 +21,26 @@ fn (mut b Builder) compile_pex() {
 	b.start_timer('parse headers files')
 	b.parse_deps()
 	b.print_timer('parse headers files')
-
-	//fns_dump.load("FunctionsDump.json", mut b.table) or { panic(err) }
 
 	b.start_timer('check files')
 	mut c := checker.new_checker(b.table, b.pref)
 	c.check_files(mut b.parsed_files)
 	b.print_timer('check files')
 
 	if !os.exists(cache_path) {
-		os.mkdir(cache_path) or { panic(err) }
+		os.mkdir(cache_path) or {
+			util.fatal_error("failed to make dir: ${err}")
+		}
 	}
 
 	if c.errors.len != 0 {
-		println("failed to compile files, ${c.errors.len} errors")
-
 		$if test {
+			println(c.errors)
+			print_backtrace()
 			assert false, "checker.errors.len != 0"
 		}
 
-		exit(1)
+		util.fatal_error("failed to compile files, ${c.errors.len} errors")
 	}
 
 	if b.pref.backend == .check {
@@ -106,8 +107,12 @@ fn (mut b Builder) gen_to_pex_file(mut parsed_file ast.File, mut buff_bytes pex.
 
 		assert !buff_bytes.is_empty()
 
-		mut file := os.create(output_file_path) or { panic(err) }
-		file.write(buff_bytes.bytes) or { panic(err) }
+		mut file := os.create(output_file_path) or {
+			util.fatal_error("failed to create file: ${err}")
+		}
+		file.write(buff_bytes.bytes) or {
+			util.fatal_error("failed to write file: ${err}")
+		}
 		file.close()
 	}
 }

modules/builder/stats.v

@@ -3,6 +3,7 @@ module builder
 import os
 import strings
 import papyrus.ast
+import papyrus.util
 
 struct FnInfo {
 pub mut:
@@ -172,7 +173,9 @@ fn (s Stats) save() {
 	b.writeln("| native global fns | ${s.count_native_static_fns} |")
 	b.writeln("| all methods | ${s.count_all_methods} |")
 	b.writeln("| native methods | ${s.count_native_methods}")
-	os.write_file("stats.md", b.str()) or { panic(err) }
+	os.write_file("stats.md", b.str()) or {
+		util.fatal_error("failed to write file: ${err}")
+	}
 
 	mut obj_info_arr := s.obj_info.values()
 	obj_info_arr.sort(a.count > b.count)
@@ -186,7 +189,9 @@ fn (s Stats) save() {
 		b.writeln("| ${obj_info.name} | ${obj_info.count} | ")
 	}
 
-	os.write_file("obj_extends_count.md", b.str()) or { panic(err) }
+	os.write_file("obj_extends_count.md", b.str()) or {
+		util.fatal_error("failed to write file: ${err}")
+	}
 
 	mut call_info_arr := s.call_info.values()
 	call_info_arr.sort(a.count > b.count)
@@ -200,7 +205,9 @@ fn (s Stats) save() {
 		b.writeln("| ${call_info.obj_name}.${call_info.name} | ${call_info.count} | ")
 	}
 
-	os.write_file("all_fns_count.md", b.str()) or { panic(err) }
+	os.write_file("all_fns_count.md", b.str()) or {
+		util.fatal_error("failed to write file: ${err}")
+	}
 
 	// only native
 	b = strings.new_builder(100)
@@ -213,5 +220,7 @@ fn (s Stats) save() {
 		}
 	}
 
-	os.write_file("native_fns_count.md", b.str()) or { panic(err) }
+	os.write_file("native_fns_count.md", b.str()) or {
+		util.fatal_error("failed to write file: ${err}")
+	}
 }