SourceInfo provides primary location

#improvement

Author: alandefreitas

include/mrdocs/Metadata/Source.hpp

@@ -142,6 +142,10 @@ MRDOCS_DECL
 void
 merge(SourceInfo& I, SourceInfo&& Other);
 
+MRDOCS_DECL
+OptionalLocation
+getPrimaryLocation(SourceInfo const& I);
+
 void
 tag_invoke(
     dom::ValueFromTag,

src/lib/Metadata/Source.cpp

@@ -80,6 +80,30 @@ merge(SourceInfo& I, SourceInfo&& Other)
     mergeImpl<true>(I, Other);
 }
 
+OptionalLocation
+getPrimaryLocation(SourceInfo const& I)
+{
+    OptionalLocation primaryLoc;
+    if (I.DefLoc)
+    {
+        primaryLoc = *I.DefLoc;
+    }
+    else if (!I.Loc.empty())
+    {
+        auto const documentedIt = std::ranges::find_if(
+            I.Loc, &Location::Documented);
+        if (documentedIt != I.Loc.end())
+        {
+            primaryLoc = *documentedIt;
+        }
+        else
+        {
+            primaryLoc = I.Loc.front();
+        }
+    }
+    return primaryLoc;
+}
+
 template <class IO>
 void
 tag_invoke(