feat: add foreign class support with allocation, construct opcodes, and CLI callback wiring

Implement the initial infrastructure for foreign classes in the Wren VM, including new opcodes (FOREIGN_CONSTRUCT, FOREIGN_CLASS), a WrenBindForeignClassFn callback type in the public API, and updated CLI vm.c to store and forward foreign binding callbacks via setForeignCallbacks(). The compiler now tracks whether a class is foreign via a new isForeign flag in ClassCompiler, emits CODE_FOREIGN_CONSTRUCT instead of CODE_CONSTRUCT for foreign class constructors, and errors on field definitions inside foreign classes. The debug dump and opcode header gain entries for the new opcodes, and wrenBindSuperclass handles the -1 numFields sentinel for foreign classes to prevent field inheritance from superclasses.

test/api/main.c

@@ -5,16 +5,23 @@
 #include "vm.h"
 #include "wren.h"
 
-#include "value.h"
+#include "foreign_class.h"
 #include "returns.h"
+#include "value.h"
 
-#define REGISTER_TEST(name, camelCase) \
-  if (strcmp(testName, #name) == 0) return camelCase##BindForeign(fullName)
+#define REGISTER_METHOD(name, camelCase) \
+  if (strcmp(testName, #name) == 0) return camelCase##BindMethod(fullName)
+
+#define REGISTER_CLASS(name, camelCase) \
+    if (strcmp(testName, #name) == 0) \
+    { \
+      camelCase##BindClass(className, &methods); \
+    }
 
 // The name of the currently executing API test.
 const char* testName;
 
-static WrenForeignMethodFn bindForeign(
+static WrenForeignMethodFn bindForeignMethod(
     WrenVM* vm, const char* module, const char* className,
     bool isStatic, const char* signature)
 {
@@ -29,8 +36,9 @@ static WrenForeignMethodFn bindForeign(
   strcat(fullName, ".");
   strcat(fullName, signature);
 
-  REGISTER_TEST(returns, returns);
-  REGISTER_TEST(value, value);
+  REGISTER_METHOD(foreign_class, foreignClass);
+  REGISTER_METHOD(returns, returns);
+  REGISTER_METHOD(value, value);
 
   fprintf(stderr,
       "Unknown foreign method '%s' for test '%s'\n", fullName, testName);
@@ -38,6 +46,18 @@ static WrenForeignMethodFn bindForeign(
   return NULL;
 }
 
+static WrenForeignClassMethods bindForeignClass(
+    WrenVM* vm, const char* module, const char* className)
+{
+  WrenForeignClassMethods methods = { NULL, NULL };
+  if (strcmp(module, "main") != 0) return methods;
+
+  REGISTER_CLASS(foreign_class, foreignClass);
+
+  return methods;
+}
+
+
 int main(int argc, const char* argv[])
 {
   if (argc != 2)
@@ -54,6 +74,7 @@ int main(int argc, const char* argv[])
   strcat(testPath, testName);
   strcat(testPath, ".wren");
 
-  runFile(bindForeign, testPath);
+  setForeignCallbacks(bindForeignMethod, bindForeignClass);
+  runFile(testPath);
   return 0;
 }