Add support for custom HTML hero sections (#120)

Signed-off-by: Juan Cruz Viotti <[email protected]>

schemas/configuration.json

@@ -45,6 +45,9 @@
         }
       }
     },
+    "hero": {
+      "type": "string"
+    },
     "pages": {
       "type": "object",
       "minProperties": 1,

src/enterprise/enterprise_index.h

@@ -222,6 +222,16 @@ auto generate_toc(
         output_html, configuration,
         configuration.at("title").to_string() + " Schemas",
         configuration.at("description").to_string(), "");
+
+    if (configuration.defines("hero")) {
+      output_html.open("div", {{"class", "container-fluid px-4"}})
+          .open("div",
+                {{"class",
+                  "bg-light border border-light-subtle mt-4 px-3 py-3"}});
+      output_html.unsafe(configuration.at("hero").to_string());
+      output_html.close("div").close("div");
+    }
+
     sourcemeta::registry::enterprise::html_file_manager(html, meta);
     sourcemeta::registry::enterprise::html_end(output_html);
     html << "\n";

src/html/include/sourcemeta/registry/html_safe.h

@@ -38,6 +38,11 @@ template <typename T> class SafeOutput {
     return *this;
   }
 
+  auto unsafe(const std::string_view content) -> SafeOutput & {
+    this->stream << content;
+    return *this;
+  }
+
 private:
   T &stream;
 };

test/sandbox/configuration.json

@@ -1,6 +1,7 @@
 {
   "url": "http://localhost:8000",
   "port": 8000,
+  "hero": "<p class=\"mb-0\">A sample schema registry sandbox for testing purposes</p>",
   "action": {
     "title": "Star on GitHub",
     "url": "https://github.com/sourcemeta/registry",

test/schemas/configuration/fail.test.json

@@ -720,6 +720,21 @@
           }
         }
       }
+    },
+    {
+      "description": "non-string hero",
+      "valid": false,
+      "data": {
+        "url": "https://www.example.com",
+        "port": 8000,
+        "hero": 1,
+        "schemas": {
+          "example": {
+            "base": "https://schemas.example.com",
+            "path": "./schemas"
+          }
+        }
+      }
     }
   ]
 }

test/schemas/configuration/pass.test.json

@@ -178,6 +178,21 @@
           }
         }
       }
+    },
+    {
+      "description": "basic HTML hero",
+      "valid": true,
+      "data": {
+        "url": "https://www.example.com",
+        "port": 8000,
+        "hero": "<p>Hello</p>",
+        "schemas": {
+          "example": {
+            "base": "https://schemas.example.com",
+            "path": "./schemas"
+          }
+        }
+      }
     }
   ]
 }