Added initial support for MermaidJS sequence diagram

src/class_diagram/generators/mermaid/class_diagram_generator.cc

@@ -25,6 +25,7 @@
 namespace clanguml::class_diagram::generators::mermaid {
 
 using clanguml::common::generators::mermaid::indent;
+using clanguml::common::generators::mermaid::render_name;
 
 generator::generator(diagram_config &config, diagram_model &model)
     : common_generator<diagram_config, diagram_model>{config, model}
@@ -32,19 +33,6 @@ generator::generator(diagram_config &config, diagram_model &model)
 {
 }
 
-std::string generator::render_name(std::string name) const
-{
-    util::replace_all(name, "<", "&lt;");
-    util::replace_all(name, ">", "&gt;");
-    util::replace_all(name, "(", "&lpar;");
-    util::replace_all(name, ")", "&rpar;");
-    util::replace_all(name, "##", "::");
-    util::replace_all(name, "{", "&lbrace;");
-    util::replace_all(name, "}", "&rbrace;");
-
-    return name;
-}
-
 void generator::generate_alias(
     const common::model::element &c, std::ostream &ostr) const
 {

src/class_diagram/generators/mermaid/class_diagram_generator.h

@@ -246,8 +246,6 @@ private:
     const std::vector<std::string> method_groups_{
         "constructors", "assignment", "operators", "other"};
 
-    std::string render_name(std::string name) const;
-
     template <typename T>
     void sort_class_elements(std::vector<T> &elements) const
     {

src/common/generators/generators.h

@@ -31,6 +31,7 @@
 #include "package_diagram/generators/json/package_diagram_generator.h"
 #include "package_diagram/generators/plantuml/package_diagram_generator.h"
 #include "sequence_diagram/generators/json/sequence_diagram_generator.h"
+#include "sequence_diagram/generators/mermaid/sequence_diagram_generator.h"
 #include "sequence_diagram/generators/plantuml/sequence_diagram_generator.h"
 #include "util/util.h"
 #include "version.h"
@@ -168,11 +169,11 @@ struct diagram_generator_t<clanguml::config::class_diagram,
     mermaid_generator_tag> {
     using type = clanguml::class_diagram::generators::mermaid::generator;
 };
-// template <>
-// struct diagram_generator_t<clanguml::config::sequence_diagram,
-//     mermaid_generator_tag> {
-//     using type = clanguml::sequence_diagram::generators::mermaid::generator;
-// };
+template <>
+struct diagram_generator_t<clanguml::config::sequence_diagram,
+    mermaid_generator_tag> {
+    using type = clanguml::sequence_diagram::generators::mermaid::generator;
+};
 // template <>
 // struct diagram_generator_t<clanguml::config::package_diagram,
 //     mermaid_generator_tag> {

src/common/generators/mermaid/generator.cc

@@ -64,9 +64,9 @@ std::string to_mermaid(message_t r)
 {
     switch (r) {
     case message_t::kCall:
-        return "->";
+        return "->>";
     case message_t::kReturn:
-        return "-->";
+        return "-->>";
     default:
         return "";
     }
@@ -78,4 +78,16 @@ std::string indent(const unsigned level)
     return std::string(level * kIndentWidth, ' ');
 }
 
+std::string render_name(std::string name)
+{
+    util::replace_all(name, "<", "&lt;");
+    util::replace_all(name, ">", "&gt;");
+    util::replace_all(name, "(", "&lpar;");
+    util::replace_all(name, ")", "&rpar;");
+    util::replace_all(name, "##", "::");
+    util::replace_all(name, "{", "&lbrace;");
+    util::replace_all(name, "}", "&rbrace;");
+
+    return name;
+}
 } // namespace clanguml::common::generators::mermaid

src/common/generators/mermaid/generator.h

@@ -44,6 +44,8 @@ std::string to_mermaid(message_t r);
 
 std::string indent(const unsigned level);
 
+std::string render_name(std::string name);
+
 /**
  * @brief Base class for diagram generators
  *

src/sequence_diagram/generators/mermaid/sequence_diagram_generator.h

@@ -0,0 +1,141 @@
+/**
+ * @file src/sequence_diagram/generators/mermaid/sequence_diagram_generator.h
+ *
+ * Copyright (c) 2021-2023 Bartek Kryza <bkryza@gmail.com>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#pragma once
+
+#include "common/generators/mermaid/generator.h"
+#include "config/config.h"
+#include "sequence_diagram/model/diagram.h"
+#include "sequence_diagram/visitor/translation_unit_visitor.h"
+#include "util/util.h"
+
+#include <glob/glob.hpp>
+
+#include <filesystem>
+#include <fstream>
+#include <iostream>
+#include <sstream>
+
+namespace clanguml {
+namespace sequence_diagram {
+namespace generators {
+namespace mermaid {
+
+using diagram_config = clanguml::config::sequence_diagram;
+using diagram_model = clanguml::sequence_diagram::model::diagram;
+
+template <typename C, typename D>
+using common_generator = clanguml::common::generators::mermaid::generator<C, D>;
+
+/**
+ * @brief Sequence diagram MermaidJS generator
+ */
+class generator : public common_generator<diagram_config, diagram_model> {
+public:
+    generator(diagram_config &config, diagram_model &model);
+
+    using common_generator<diagram_config, diagram_model>::generate;
+
+    /**
+     * @brief Main generator method.
+     *
+     * This method is called first and coordinates the entire diagram
+     * generation.
+     *
+     * @param ostr Output stream.
+     */
+    void generate_diagram(std::ostream &ostr) const override;
+
+    /**
+     * @brief Generate sequence diagram message.
+     *
+     * @param m Message model
+     * @param ostr Output stream
+     */
+    void generate_call(const clanguml::sequence_diagram::model::message &m,
+        std::ostream &ostr) const;
+
+    /**
+     * @brief Generate sequence diagram return message
+     *
+     * @param m Message model
+     * @param ostr Output stream
+     */
+    void generate_return(const clanguml::sequence_diagram::model::message &m,
+        std::ostream &ostr) const;
+
+    /**
+     * @brief Generate sequence diagram participant
+     *
+     * @param ostr Output stream
+     * @param id Participant id
+     * @param force If true, generate the participant even if its not in
+     *              the set of active participants
+     * @return Id of the generated participant
+     */
+    void generate_participant(
+        std::ostream &ostr, common::id_t id, bool force = false) const;
+
+    /**
+     * @brief Generate sequence diagram participant by name
+     *
+     * This is convenience wrapper over `generate_participant()` by id.
+     *
+     * @param ostr Output stream
+     * @param name Full participant name
+     */
+    void generate_participant(
+        std::ostream &ostr, const std::string &name) const;
+
+    /**
+     * @brief Generate sequence diagram activity.
+     *
+     * @param a Activity model
+     * @param ostr Output stream
+     * @param visited List of already visited participants, this is necessary
+     *                for breaking infinite recursion on recursive calls
+     */
+    void generate_activity(const clanguml::sequence_diagram::model::activity &a,
+        std::ostream &ostr,
+        std::vector<common::model::diagram_element::id_t> &visited) const;
+
+private:
+    /**
+     * @brief Check if specified participant has already been generated.
+     *
+     * @param id Participant id.
+     * @return True, if participant has already been generated.
+     */
+    bool is_participant_generated(common::id_t id) const;
+
+    /**
+     * @brief Generate MermaidJS alias for participant
+     *
+     * @param participant Sequence diagram participant model
+     * @return Particpant alias
+     */
+    std::string generate_alias(const model::participant &participant) const;
+
+    mutable std::set<common::id_t> generated_participants_;
+    model::function::message_render_mode
+    select_method_arguments_render_mode() const;
+};
+
+} // namespace mermaid
+} // namespace generators
+} // namespace sequence_diagram
+} // namespace clanguml