Initial project import

tools/v/vlib/builtin/js/builtin.v

@@ -0,0 +1,157 @@
+// Copyright (c) 2019-2024 Alexander Medvednikov. All rights reserved.
+// Use of this source code is governed by an MIT license
+// that can be found in the LICENSE file.
+
+module builtin
+
+fn (a any) toString()
+
+// panic prints an error message, then exits the process with exit code of 1.
+@[noreturn]
+pub fn panic(s string) {
+	eprintln('V panic: ' + s)
+	eprintln(js_stacktrace())
+	exit(1)
+}
+
+// panic_n prints an error message, followed by the given number, then exits the process with exit code of 1.
+@[noreturn]
+pub fn panic_n(s string, n i64) {
+	eprintln('V panic: ' + s)
+	eprintln(js_stacktrace())
+	exit(1)
+}
+
+// IError holds information about an error instance.
+pub interface IError {
+	msg() string
+	code() int
+}
+
+// str returns the message of IError.
+pub fn (err IError) str() string {
+	return match err {
+		None__ {
+			'none'
+		}
+		Error {
+			err.msg()
+		}
+		MessageError {
+			err.str()
+		}
+		else {
+			'${err.type_name()}: ${err.msg()}'
+		}
+	}
+}
+
+// Error is the empty default implementation of `IError`.
+pub struct Error {}
+
+// msg returns the message of Error.
+pub fn (err Error) msg() string {
+	return ''
+}
+
+// code returns the code of Error.
+pub fn (err Error) code() int {
+	return 0
+}
+
+// MessageError is the default implementation of the `IError` interface that is returned by the `error()` function.
+struct MessageError {
+pub:
+	msg  string
+	code int
+}
+
+// str returns the message and code of the MessageError.
+pub fn (err MessageError) str() string {
+	return err.msg
+}
+
+// msg returns the message of the MessageError.
+pub fn (err MessageError) msg() string {
+	return err.msg
+}
+
+// code returns the code of MessageError.
+pub fn (err MessageError) code() int {
+	return err.code
+}
+
+pub const none__ = IError(&None__{})
+
+struct None__ {
+	Error
+}
+
+fn (_ None__) str() string {
+	return 'none'
+}
+
+pub struct Option {
+	state u8
+	err   IError = none__
+}
+
+// str returns the Option type: ok, none, or error.
+pub fn (o Option) str() string {
+	if o.state == 0 {
+		return 'Option{ ok }'
+	}
+	if o.state == 1 {
+		return 'Option{ none }'
+	}
+	return 'Option{ error: "${o.err}" }'
+}
+
+pub struct _option {
+	state u8
+	err   IError = none__
+}
+
+// str returns the Option type: ok, none, or error.
+pub fn (o _option) str() string {
+	if o.state == 0 {
+		return 'Option{ ok }'
+	}
+	if o.state == 1 {
+		return 'Option{ none }'
+	}
+	return 'Option{ error: "${o.err}" }'
+}
+
+// trace_error prints to stderr a string and a backtrace of the error.
+fn trace_error(x string) {
+	eprintln('> ${@FN} | ${x}')
+}
+
+// error returns a default error instance containing the error given in `message`.
+// Example: if ouch { return error('an error occurred') }
+@[inline]
+pub fn error(message string) IError {
+	// trace_error(message)
+	return &MessageError{
+		msg: message
+	}
+}
+
+// error_with_code returns a default error instance containing the given `message` and error `code`.
+// Example: if ouch { return error_with_code('an error occurred', 1) }
+@[inline]
+pub fn error_with_code(message string, code int) IError {
+	// trace_error('${message} | code: ${code}')
+	return &MessageError{
+		msg:  message
+		code: code
+	}
+}
+
+// free allows for manually freeing memory allocated at the address `ptr`.
+// However, this is a no-op on JS backend
+@[unsafe]
+pub fn free(ptr voidptr) {
+	_ := ptr
+}