From 8f5905c801f10ed940ae15351e521c25cfed88e2 Mon Sep 17 00:00:00 2001
From: Andrej730 <azhilenkov@gmail.com>
Date: Tue, 22 Jul 2025 14:11:17 +0500
Subject: [PATCH] ifcopenshell_wrapper.pyi - document Element attributes

---
 .../ifcopenshell/ifcopenshell_wrapper.pyi     | 50 ++++++++++++++++---
 1 file changed, 42 insertions(+), 8 deletions(-)

diff --git a/src/ifcopenshell-python/ifcopenshell/ifcopenshell_wrapper.pyi b/src/ifcopenshell-python/ifcopenshell/ifcopenshell_wrapper.pyi
index 1bce3a7734..17c2d14a36 100644
--- a/src/ifcopenshell-python/ifcopenshell/ifcopenshell_wrapper.pyi
+++ b/src/ifcopenshell-python/ifcopenshell/ifcopenshell_wrapper.pyi
@@ -213,28 +213,62 @@ class DoubleArray3:
     def swap(self, v): ...
 
 class Element:
+    # TODO: Remove from the wrapper?
     def SetParents(self, newparents): ...
+    # TODO: could it be None?
     @property
-    def context(self): ...
+    def context(self) -> str:
+        """Element's geometry context.
+
+        E.g 'Body':
+        """
+        ...
+
     @property
-    def guid(self): ...
+    def guid(self) -> str:
+        """Mirroring IfcRoot.GlobalId."""
+        ...
+
     @property
-    def id(self) -> int: ...
+    def id(self) -> int:
+        """Element's STEP ID."""
+        ...
+    # TODO: could it be None?
     @property
-    def name(self): ...
+    def name(self) -> str:
+        """Mirroring IfcRoot.Name."""
+        ...
+
     @property
-    def parent_id(self): ...
+    def parent_id(self) -> int:
+        """Parent object STEP id.
+
+        E.g. IfcBuildingStorey that element's in.
+        """
+        ...
+    # TODO: Returns SwigPyObject. Should we just remove it from the wrapper?
     def parents(self): ...
     @property
-    def product(self): ...
+    def product(self) -> entity_instance: ...
     @property
     def transformation(self) -> Transformation: ...
     @property
     def transformation_buffer(self) -> bytes: ...
     @property
-    def type(self): ...
+    def type(self) -> str:
+        """Element's IFC Class.
+
+        E.g. 'IfcWall'.
+        """
+        ...
+
     @property
-    def unique_id(self): ...
+    def unique_id(self) -> str:
+        """Interal unique id for the element.
+
+        E.g. 'product-186f8dc2-070c-46e1-a65b-a435a043ba3e-body'.
+        """
+        ...
 
 class FileSchema(HeaderEntity):
     schema_identifiers: Any