Documentation

Implements the PUSH instruction (Opcode 0x01).

@details This is the entry point for the PUSH operation. It performs the following steps: 1. Reads the **TypeID** byte from the bytecode stream. 2. Delegates the reading of the value and the stack push to stackPushValue.

This separation allows for a cleaner implementation and easier extension of supported types in the future.

Implements the POP instruction (Opcode 0x02).

@details Removes the top element of the stack and discards it. Commonly used to clean up the stack after an expression evaluation where the result is not needed (e.g., `func();` where return is ignored).

@throws Error "Stack Underflow" if the stack is empty.

Implements the DUP instruction (Opcode 0x03).

@details Duplicates the top element of the stack. Useful for operations that consume a value but need to preserve it for a subsequent operation. State change: `[..., A] -> [..., A, A]`

@throws Error "Stack Underflow" if the stack is empty.

Implements the SWAP instruction (Opcode 0x04).

@details Swaps the top two elements of the stack. Stack: [..., A, B] -> [..., B, A]

Implements CAST (Opcode 0x80).

@details Reads a TypeID and tries to convert the top of stack to that type.

Implements TYPEOF (Opcode 0x81).

@details Pops a value from the stack, determines its runtime type, and pushes a string representation (e.g., "int", "list").

Stack: [value] -> ["type_name"]

Implements SIZEOF (Opcode 0x82).

@details Pops a value and pushes its length. - List: Number of elements. - Struct: Number of fields. - Others: 0 (or error, depending on strictness choice).

@throws Error if the value is not a container (List/Struct).