finalise interface & documentation

Signed-off-by: Folling <mail@folling.io>

include/ikarus/folders/property_tree_item.h

@@ -0,0 +1,31 @@
+#pragma once
+
+/// \file property_tree_item.h
+/// \author Folling <folling@ikarus.world>
+
+#include <ikarus/macros.h>
+
+/// \addtogroup properties Properties
+/// @{
+
+IKARUS_BEGIN_HEADER
+
+struct IkarusPropertyTreeItem;
+
+/// \brief Visits a property tree item, calling the appropriate visitor function.
+/// \param item The item to visit.
+/// \pre \li Must not be null.
+/// \pre \li Must exist.
+/// \param property_visitor The visitor function called if the item is a property. Skipped if null.
+/// \param property_folder_visitor The visitor function called if the item is a property folder. Skipped if null.
+/// \param data The data passed to the visitor functions.
+IKA_API void ikarus_property_tree_item_visit(
+    struct IkarusPropertyTreeItem * item,
+    void (*property_visitor)(struct IkarusProperty * property, void * data),
+    void (*property_folder_visitor)(struct IkarusPropertyFolder * folder, void * data),
+    void * data
+);
+
+IKARUS_END_HEADER
+
+/// @}