feat: Introduce core VM, compiler, and runtime components with initial instruction set.

Author: ProgrammerKR

include/advanced.h

@@ -12,7 +12,7 @@
 #ifndef PROX_ADVANCED_H
 #define PROX_ADVANCED_H
 
-#include "chunk.h"
+#include "bytecode.h"
 #include "common.h"
 
 

include/bytecode.h

@@ -1,145 +1,70 @@
-// --------------------------------------------------
-//   Project: ProX Programming Language (ProXPL)
-//   Author:  ProgrammerKR
-//   Created: 2025-12-16
-//   Copyright © 2025. ProXentix India Pvt. Ltd.  All rights reserved.
-
 #ifndef PROXPL_BYTECODE_H
 #define PROXPL_BYTECODE_H
-#include <stdint.h>
-#include <stddef.h>
-
-/* Value representation (simple) */
-typedef enum {
-    VAL_NULL = 0,
-    VAL_NUMBER,
-    VAL_BOOL,
-    VAL_STRING,
-    VAL_FUNCTION_PROTO
-} ValueType;
 
-typedef struct {
-    ValueType type;
-    union {
-        double number;
-        int boolean;
-        struct {
-            char *chars;
-            uint32_t length;
-        } string;
-        void *proto; /* placeholder for function proto during runtime */
-    } as;
-} Value;
+#include "common.h"
+#include "value.h"
 
-/* Constant table */
-typedef struct {
-    Value *items;
-    size_t count;
-    size_t capacity;
-} ConstTable;
-
-/* Chunk (bytecode + constants) */
+// ProX-Bytecode Opcodes
+typedef enum {
+  OP_CONSTANT,
+  OP_NIL,
+  OP_TRUE,
+  OP_FALSE,
+  OP_POP,
+  OP_GET_LOCAL,
+  OP_SET_LOCAL,
+  OP_GET_GLOBAL,
+  OP_DEFINE_GLOBAL,
+  OP_SET_GLOBAL,
+  OP_GET_UPVALUE,
+  OP_SET_UPVALUE,
+  OP_GET_PROPERTY,
+  OP_SET_PROPERTY,
+  OP_GET_SUPER,
+  OP_EQUAL,
+  OP_GREATER,
+  OP_LESS,
+  OP_ADD,
+  OP_SUBTRACT,
+  OP_MULTIPLY,
+  OP_DIVIDE,
+  OP_NOT,
+  OP_NEGATE,
+  OP_PRINT,
+  OP_JUMP,
+  OP_JUMP_IF_FALSE,
+  OP_LOOP,
+  OP_CALL,
+  OP_INVOKE,
+  OP_SUPER_INVOKE,
+  OP_CLOSURE,
+  OP_CLOSE_UPVALUE,
+  OP_RETURN,
+  OP_CLASS,
+  OP_INHERIT,
+  OP_METHOD,
+  
+  // Future enhancements
+  OP_MATCH,
+  OP_AWAIT,
+  OP_YIELD,
+  
+  OP_HALT = 0xFF
+} OpCode;
+
+// Chunk: Sequence of bytecode and metadata
 typedef struct {
-    uint8_t *code;
-    size_t code_len;
-    size_t code_cap;
-    ConstTable constants;
+  int count;
+  int capacity;
+  uint8_t *code;
+  int *lines;           // Line numbers for debugging/errors
+  ValueArray constants; // Constant pool
 } Chunk;
 
-/* Function prototype (serialized form) */
-typedef struct {
-    uint32_t arity;
-    uint16_t max_regs;
-    Chunk chunk;
-    uint16_t upvalue_count;
-} FunctionProto;
-
-/* Opcodes */
-typedef enum {
-    OP_NOP = 0x00,
-    OP_ADD = 0x01,
-    OP_SUB = 0x02,
-    OP_MUL = 0x03,
-    OP_DIV = 0x04,
-    OP_MOD = 0x05,
-    OP_NEG = 0x06,
-
-    OP_EQ  = 0x10,
-    OP_NEQ = 0x11,
-    OP_LT  = 0x12,
-    OP_LTE = 0x13,
-    OP_GT  = 0x14,
-    OP_GTE = 0x15,
-
-    OP_NOT = 0x20,
-    OP_AND = 0x21,
-    OP_OR  = 0x22,
-
-    OP_PUSH_CONST = 0x30,
-    OP_LOAD_REG   = 0x31,
-    OP_STORE_REG  = 0x32,
-    OP_POP        = 0x33,
-    OP_DUP        = 0x34,
-
-    OP_JMP         = 0x40,
-    OP_JMP_IF_TRUE = 0x41,
-    OP_JMP_IF_FALSE= 0x42,
-
-    OP_CALL       = 0x50,
-    OP_RETURN     = 0x51,
-    OP_TAIL_CALL  = 0x52,
-
-    OP_MAKE_FUNCTION = 0x60,
-    OP_CLOSURE       = 0x61,
-    OP_CLOSE_UPVALUE = 0x62,
-    OP_LOAD_UPVALUE  = 0x63,
-    OP_STORE_UPVALUE = 0x64,
-
-    OP_NEW_ARRAY = 0x70,
-    OP_INDEX_GET = 0x71,
-    OP_INDEX_SET = 0x72,
-    OP_GET_FIELD = 0x73,
-    OP_SET_FIELD = 0x74,
-
-    OP_DBG_LINE = 0x90,
-    OP_DBG_LOC  = 0x91,
-
-    OP_HALT = 0xFF
-} Opcode;
-
-/* Addressing modes for CALL / similar */
-typedef enum {
-    AM_CONST = 0x01,
-    AM_REG   = 0x02,
-    AM_STACK = 0x03
-} AddrMode;
-
-/* Chunk API */
-void chunk_init(Chunk *chunk);
-void chunk_free(Chunk *chunk);
-void chunk_write_byte(Chunk *chunk, uint8_t byte);
-void chunk_write_bytes(Chunk *chunk, const uint8_t *bytes, size_t len);
-
-/* emission helpers */
-void emit_opcode(Chunk *chunk, Opcode op);
-void emit_u8(Chunk *chunk, uint8_t x);
-void emit_u16_le(Chunk *chunk, uint16_t x);
-void emit_u32_le(Chunk *chunk, uint32_t x);
-void emit_uleb128(Chunk *chunk, uint64_t value);
-void emit_sleb128(Chunk *chunk, int64_t value);
-
-/* constant table */
-void consttable_init(ConstTable *tbl);
-void consttable_free(ConstTable *tbl);
-size_t consttable_add(ConstTable *tbl, Value v);
-Value consttable_get(const ConstTable *tbl, size_t idx);
-
-/* serialization */
-int write_chunk_to_file(const char *path, const Chunk *chunk);
-int read_chunk_from_file(const char *path, Chunk *out);
-
-/* utility */
-uint64_t read_uleb128_from(const uint8_t *buf, size_t buf_len, size_t *out_read);
-int64_t read_sleb128_from(const uint8_t *buf, size_t buf_len, size_t *out_read);
+// Chunk API
+void initChunk(Chunk *chunk);
+void freeChunk(Chunk *chunk);
+void writeChunk(Chunk *chunk, uint8_t byte, int line);
+int addConstant(Chunk *chunk, Value value);
 
-#endif /* PROXPL_BYTECODE_H */
+#endif // PROXPL_BYTECODE_H

include/chunk.h

@@ -23,6 +23,9 @@ typedef int16_t  i16;
 typedef int32_t  i32;
 typedef int64_t  i64;
 
+#define UINT8_MAX 255
+#define UINT8_COUNT (UINT8_MAX + 1)
+
 // Debugging
 #define DEBUG_TRACE_EXECUTION
 #define DEBUG_PRINT_CODE

include/common.h

@@ -7,7 +7,7 @@
 #ifndef PROX_COMPILER_H
 #define PROX_COMPILER_H
 
-#include "scanner.h"
+#include "bytecode.h"
 #include "vm.h"
 
 
@@ -35,7 +35,7 @@ typedef struct {
   Precedence precedence;
 } ParseRule;
 
-bool compile(const char *source, Chunk *chunk);
+ObjFunction* compile(const char *source);
 
 #include "ast.h"
 void generateBytecode(StmtList* statements, Chunk* chunk);

include/compiler.h

@@ -7,7 +7,7 @@
 #ifndef PROX_DEBUG_H
 #define PROX_DEBUG_H
 
-#include "chunk.h"
+#include "bytecode.h"
 
 void disassembleChunk(Chunk *chunk, const char *name);
 int disassembleInstruction(Chunk *chunk, int offset);

include/debug.h

@@ -0,0 +1,13 @@
+#ifndef PROXPL_ERROR_REPORT_H
+#define PROXPL_ERROR_REPORT_H
+
+#include "common.h"
+#include "scanner.h"
+
+// Report a compile-time error with code context
+void reportCompileError(const char* source, Token token, const char* message);
+
+// Report a runtime error with code context
+void reportRuntimeError(const char* source, int line, const char* message);
+
+#endif // PROXPL_ERROR_REPORT_H

include/error_report.h

@@ -9,7 +9,7 @@
 
 #include "common.h"
 #include "value.h"
-#include "chunk.h" // Required because ObjFunction contains a 'Chunk' struct
+#include "bytecode.h" // Required because ObjFunction contains a 'Chunk' struct
 
 #define OBJ_TYPE(value) (AS_OBJ(value)->type)
 

include/object.h

@@ -8,7 +8,7 @@
 #define PROXPL_API_H
 
 #include "vm.h"
-#include "chunk.h"
+#include "bytecode.h"
 
 /* Public API: Initialize and shutdown the VM */
 void proxpl_vm_init(VM *vm);