feat: add instance as symbol value

Author: kamilkrzyskow

src/zenkit/_core.py

@@ -54,6 +54,7 @@
 DLL: Final[CDLL] = CDLL(str(_PATH))
 
 PathOrFileLike = Union[str, PathLike, "Read", bytes, bytearray, "VfsNode"]
+DaedalusSymbolValue = Union[float, int, str, "DaedalusInstance", None]
 
 
 class GameVersion(IntEnum):

src/zenkit/daedalus/__init__.py

@@ -44,3 +44,12 @@
     DaedalusInstanceType.SOUND_EFFECT: SoundEffectInstance,
     DaedalusInstanceType.SOUND_SYSTEM: SoundSystemInstance,
 }
+
+_CLASS_TYPES = {
+    "C_NPC": DaedalusInstanceType.NPC,
+    "C_MISSION": DaedalusInstanceType.MISSION,
+    "C_ITEM": DaedalusInstanceType.ITEM,
+    "C_INFO": DaedalusInstanceType.INFO,
+    "C_ITEMREACT": DaedalusInstanceType.ITEM_REACT,
+    "C_FOCUS": DaedalusInstanceType.FOCUS,
+}

src/zenkit/daedalus_script.py

@@ -20,8 +20,10 @@
 from typing import ClassVar
 
 from zenkit import _native
+from zenkit.daedalus import _CLASS_TYPES
 from zenkit._core import DLL
 from zenkit._core import PathOrFileLike
+from zenkit._core import DaedalusSymbolValue
 from zenkit._native import ZkPointer
 from zenkit._native import ZkString
 from zenkit.daedalus.base import DaedalusInstance
@@ -199,13 +201,17 @@ def return_type(self) -> DaedalusDataType:
         return DaedalusDataType(DLL.ZkDaedalusSymbol_getReturnType(self._handle))
 
     @property
-    def value(self) -> float | int | str | None:
+    def value(self) -> DaedalusSymbolValue:
         if self.type == DaedalusDataType.FLOAT:
             return self.get_float()
         if self.type == DaedalusDataType.INT:
             return self.get_int()
         if self.type == DaedalusDataType.STRING:
             return self.get_string()
+        if self._keepalive.__class__.__name__ == "DaedalusVm" and self.type == DaedalusDataType.INSTANCE:
+            class_sym = self.get_parent_as_symbol(find_root=True)
+            if class_sym:  # Instances always have parent symbols, except for .PAR instances in functions...
+                return self._keepalive.init_instance(self, _CLASS_TYPES[class_sym.name])
         return None
 
     def __repr__(self) -> str: