complete regen of hero classes, spells, races, etc

app/game/models/races.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+from dataclasses import dataclass, field
+from typing import Dict
+
+@dataclass
+class AbilityScores:
+    STR: int = 0
+    DEX: int = 0
+    INT: int = 0
+    WIS: int = 0
+    CON: int = 0
+    LUK: int = 0
+    CHA: int = 0
+
+@dataclass(frozen=True)
+class Race:
+    id: str
+    name: str
+    description: str
+    alignment: int = 0
+    ability_scores: AbilityScores = field(default_factory=AbilityScores)
+    tags: list[str] = field(default_factory=list)   # e.g., {"playable"}, {"hostile","goblinoid"}
+
+    @property
+    def is_playable(self) -> bool:
+        return "playable" in self.tags
+
+    @staticmethod
+    def from_yaml(data: Dict[str, object]) -> "Race":
+        # basic validation with helpful errors
+        required = ["id", "name", "description", "alignment", "ability_mods"]
+        missing = [k for k in required if k not in data]
+        if missing:
+            raise ValueError(f"Spell missing required fields: {missing}")
+        
+        mods = data.get("ability_mods", {}) or {}
+
+        abs = AbilityScores(
+            STR=int(mods.get("STR", 0)),
+            DEX=int(mods.get("DEX", 0)),
+            INT=int(mods.get("INT", 0)),
+            WIS=int(mods.get("WIS", 0)),
+            CON=int(mods.get("CON", 0)),
+            LUK=int(mods.get("LUK", 0)),
+            CHA=int(mods.get("CHA", 0)),
+        )
+
+        tags = list(data.get("tags", []))
+
+        return Race(
+            id=str(data["id"]),
+            name=str(data["name"]),
+            description=str(data["description"]),
+            ability_scores=abs,
+            tags=tags
+        )