feat(doc): implement a HTML documentation generator

A new generator that doesn't create implementations for a language, but
instead creates HTML documentation for a schema.

This is the first building block to provide a new CLI command that can
generate the documentation for any schema, similar to how rustdoc can
generate local documentation for Rust files or projects.

.editorconfig

@@ -6,7 +6,7 @@ indent_size = 4
 insert_final_newline = true
 trim_trailing_whitespace = true
 
-[*.{json,yaml,yml}]
+[*.{html,js,json,yaml,yml}]
 indent_size = 2
 
 [Justfile]

.vscode/settings.json

@@ -1,2 +1,13 @@
 {
+  "editor.quickSuggestions": {
+    "other": "on",
+    "strings": "on"
+  },
+  "files.associations": {
+    "**/templates/**/*.html": "jinja-html",
+    "*.css": "tailwindcss"
+  },
+  "tailwindCSS.includeLanguages": {
+    "jinja-html": "html"
+  }
 }

Cargo.toml

@@ -20,6 +20,7 @@ missing_docs = "warn"
 [workspace.lints.clippy]
 all = "deny"
 pedantic = "warn"
+clone_on_ref_ptr = "warn"
 
 [workspace.dependencies]
 clap = { version = "4.4.11", features = ["derive", "wrap_help"] }

book/highlight/package.json

@@ -12,6 +12,6 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^1.4.1",
-    "esbuild": "^0.19.9"
+    "esbuild": "^0.19.10"
   }
 }

crates/stef-build/src/definition.rs

@@ -186,7 +186,11 @@ fn compile_const(
     }
 }
 
-fn compile_import(Import { segments, element }: &Import<'_>) -> TokenStream {
+fn compile_import(
+    Import {
+        segments, element, ..
+    }: &Import<'_>,
+) -> TokenStream {
     let segments = segments.iter().enumerate().map(|(i, segment)| {
         let segment = Ident::new(segment.get(), Span::call_site());
         if i > 0 {