From 83a78360813917cc922810e8c92042f320e83912 Mon Sep 17 00:00:00 2001
From: Andrej730 <azhilenkov@gmail.com>
Date: Mon, 3 Aug 2026 20:03:26 +0500
Subject: [PATCH] stub: document `use_attribute_value_derived`

---
 .../ifcopenshell/ifcopenshell_wrapper.pyi      | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/src/ifcopenshell-python/ifcopenshell/ifcopenshell_wrapper.pyi b/src/ifcopenshell-python/ifcopenshell/ifcopenshell_wrapper.pyi
index 4e1a4dd2df..ec9a591768 100644
--- a/src/ifcopenshell-python/ifcopenshell/ifcopenshell_wrapper.pyi
+++ b/src/ifcopenshell-python/ifcopenshell/ifcopenshell_wrapper.pyi
@@ -525,8 +525,6 @@ class attribute:
     def optional(self) -> bool: ...
     def type_of_attribute(self) -> parameter_type: ...
 
-class attribute_value_derived: ...
-
 class boolean_result:
     INTERSECTION: Any
     SUBTRACTION: Any
@@ -1642,12 +1640,25 @@ def construct_iterator_with_include_exclude_id(
     geometry_library, settings, file, elems, include, num_threads, logger=None
 ): ...
 def convert_loop_to_function_item(loop): ...
+
+class attribute_value_derived: ...
+
+def get_feature(x: Literal["use_attribute_value_derived"]) -> bool:
+    """Get the current value of a named feature flag."""
+
+def set_feature(x: Literal["use_attribute_value_derived"], v: bool) -> None:
+    """Set a named feature flag.
+
+    ``use_attribute_value_derived``: when enabled, attribute values supplied
+    as derived (``*``) are returned as instances of ``attribute_value_derived``
+    instead of being indistinguishable from NIL (``$``) values.
+    """
+
 def create_box(*args): ...
 def create_epeck(*args): ...
 def create_geometry_serializer(*args) -> GeometrySerializer: ...
 def create_shape(*args): ...
 def flatten(deep): ...
-def get_feature(x): ...
 def get_info_cpp(v: entity_instance, recursive: bool, include_identifier: bool) -> dict[str, Any]: ...
 def get_log(): ...
 def helmert_curve_point(A0, A1, A2, s): ...
@@ -1664,7 +1675,6 @@ def read(data: str) -> file: ...
 def register_schema(schema: schema_definition) -> None: ...
 def schema_by_name(schema_name: str) -> schema_definition: ...
 def schema_names() -> tuple[str, ...]: ...
-def set_feature(x, v): ...
 def set_log_format_json(): ...
 def set_log_format_text(): ...
 def stream_from_string(data): ...