feat(lib): all base classes implement node kind inc pattern

This pattern defines a single source of truth for all derived types in a family of classes. Thus, conversions with the `as_` and `is_` functions are limited to valid derived classes.

Author: alandefreitas

include/mrdocs/Metadata/Expression.hpp

@@ -25,6 +25,16 @@ struct ExprInfo
     /** The expression, as written */
     std::string Written;
 
+    ExprInfo& asExpr() noexcept
+    {
+        return *this;
+    }
+
+    ExprInfo const& asExpr() const noexcept
+    {
+        return *this;
+    }
+
     auto operator<=>(ExprInfo const&) const = default;
 };
 
@@ -49,18 +59,15 @@ struct ConstantExprInfo
 
     auto operator<=>(ConstantExprInfo const&) const = default;
 
-    static_assert(std::integral<type>,
-        "expression type must be integral");
+    static_assert(std::integral<type>, "expression type must be integral");
 };
 
 template <class T>
 static void merge(
     ConstantExprInfo<T>& I,
     ConstantExprInfo<T>&& Other)
 {
-    merge(
-        dynamic_cast<ExprInfo&>(I),
-        dynamic_cast<ExprInfo&&>(Other));
+    merge(I.asExpr(), std::move(Other.asExpr()));
     if (!I.Value)
     {
         I.Value = std::move(Other.Value);

include/mrdocs/Metadata/Info/Concept.hpp

@@ -64,7 +64,7 @@ tag_invoke(
     ConceptInfo const& I,
     DomCorpus const* domCorpus)
 {
-    tag_invoke(t, io, dynamic_cast<Info const&>(I), domCorpus);
+    tag_invoke(t, io, I.asInfo(), domCorpus);
     io.map("template", I.Template);
     if (!I.Constraint.Written.empty())
     {

include/mrdocs/Metadata/Info/Enum.hpp

@@ -87,7 +87,7 @@ tag_invoke(
     EnumInfo const& I,
     DomCorpus const* domCorpus)
 {
-    tag_invoke(t, io, dynamic_cast<Info const&>(I), domCorpus);
+    tag_invoke(t, io, I.asInfo(), domCorpus);
     io.map("type", I.UnderlyingType);
     io.map("isScoped", I.Scoped);
     io.map("constants", dom::LazyArray(I.Constants, domCorpus));

include/mrdocs/Metadata/Info/EnumConstant.hpp

@@ -53,7 +53,7 @@ tag_invoke(
     EnumConstantInfo const& I,
     DomCorpus const* domCorpus)
 {
-    tag_invoke(t, io, dynamic_cast<Info const&>(I), domCorpus);
+    tag_invoke(t, io, I.asInfo(), domCorpus);
     if (!I.Initializer.Written.empty())
     {
         io.map("initializer", I.Initializer.Written);

include/mrdocs/Metadata/Info/Function.hpp

@@ -107,7 +107,7 @@ tag_invoke(
     FunctionInfo const& I,
     DomCorpus const* domCorpus)
 {
-    tag_invoke(t, io, dynamic_cast<Info const&>(I), domCorpus);
+    tag_invoke(t, io, I.asInfo(), domCorpus);
     io.map("isVariadic", I.IsVariadic);
     io.map("isVirtual", I.IsVirtual);
     io.map("isVirtualAsWritten", I.IsVirtualAsWritten);

include/mrdocs/Metadata/Info/Guide.hpp

@@ -75,7 +75,7 @@ tag_invoke(
     GuideInfo const& I,
     DomCorpus const* domCorpus)
 {
-    tag_invoke(t, io, dynamic_cast<Info const&>(I), domCorpus);
+    tag_invoke(t, io, I.asInfo(), domCorpus);
     io.map("params", dom::LazyArray(I.Params, domCorpus));
     io.map("deduced", I.Deduced);
     io.map("template", I.Template);

include/mrdocs/Metadata/Info/Namespace.hpp

@@ -155,7 +155,7 @@ tag_invoke(
     NamespaceInfo const& I,
     DomCorpus const* domCorpus)
 {
-    tag_invoke(t, io, dynamic_cast<Info const&>(I), domCorpus);
+    tag_invoke(t, io, I.asInfo(), domCorpus);
     io.map("isInline", I.IsInline);
     io.map("isAnonymous", I.IsAnonymous);
     io.map("members", I.Members);

include/mrdocs/Metadata/Info/NamespaceAlias.hpp

@@ -57,7 +57,7 @@ tag_invoke(
     NamespaceAliasInfo const& I,
     DomCorpus const* domCorpus)
 {
-    tag_invoke(t, io, dynamic_cast<Info const&>(I), domCorpus);
+    tag_invoke(t, io, I.asInfo(), domCorpus);
     io.map("aliasedSymbol", I.AliasedSymbol);
 }
 

include/mrdocs/Metadata/Info/Overloads.hpp

@@ -79,7 +79,7 @@ tag_invoke(
     OverloadsInfo const& I,
     DomCorpus const* domCorpus)
 {
-    tag_invoke(t, io, dynamic_cast<Info const&>(I), domCorpus);
+    tag_invoke(t, io, I.asInfo(), domCorpus);
     io.map("class", I.Class);
     io.map("overloadedOperator", I.OverloadedOperator);
     io.map("members", dom::LazyArray(I.Members, domCorpus));

include/mrdocs/Metadata/Info/Record.hpp

@@ -114,7 +114,7 @@ tag_invoke(
     RecordInfo const& I,
     DomCorpus const* domCorpus)
 {
-    tag_invoke(t, io, dynamic_cast<Info const&>(I), domCorpus);
+    tag_invoke(t, io, I.asInfo(), domCorpus);
     io.map("tag", I.KeyKind);
     io.map("defaultAccess", getDefaultAccessString(I.KeyKind));
     io.map("isFinal", I.IsFinal);