🧹

.gitattributes

@@ -1,2 +1,2 @@
 src/nakai/html.gleam  linguist-generated
-src/nakai/html/attrs.gleam  linguist-generated
+src/nakai/attr.gleam  linguist-generated

Makefile

@@ -8,12 +8,15 @@ all: build
 # `gleam run -m ...` does a full build, but we need to run it again after our codegen
 # step, or we might end up with the build artifacts being stale, if the new generated
 # is different.
-build:
-	@$(GLEAM) run -m nakai_codegen
+build: codegen
 	@$(GLEAM) build
 .PHONY: build
 
-docs: build
+codegen:
+	@$(GLEAM) run -m nakai_codegen
+.PHONY: codegen
+
+docs: codegen
 	@$(GLEAM) docs build
 .PHONY: docs
 
@@ -22,11 +25,11 @@ format:
 	@$(GLEAM) run -m nakai_codegen
 .PHONY: format
 
-test: build
+test: codegen
 	@$(GLEAM) test
 .PHONY: test
 
-bench: build
+bench: codegen
 	@$(GLEAM) run -m nakai_benchmark
 .PHONY: bench
 

codegen/html_prelude.gleam

@@ -12,7 +12,7 @@ pub type Node {
   /// will be rendered in-place, equivalent to using `html.Fragment(children)`.
   /// ## Example
   /// ```gleam
-  /// html.Html([attrs.lang("en-US")], [
+  /// html.Html([attr.lang("en-US")], [
   ///   ...
   /// ])
   /// ```
@@ -35,7 +35,7 @@ pub type Node {
   /// will be rendered in-place, equivalent to using `html.Fragment(children)`.
   /// ## Example
   /// ```gleam
-  /// html.Body([attrs.class("dark-mode")], [
+  /// html.Body([attr.class("dark-mode")], [
   ///   ...
   /// ])
   /// ```
@@ -74,7 +74,7 @@ pub type Node {
   /// ## Example
   /// ```gleam
   /// // bad example, pls use `html.link`
-  /// html.LeafElement("link", [attrs.rel("stylesheet"), attrs.href(...)])
+  /// html.LeafElement("link", [attr.rel("stylesheet"), attr.href(...)])
   /// ```
   LeafElement(tag: String, attrs: List(Attr))
   /// An HTML comment, which will be included in the document.
@@ -122,7 +122,10 @@ pub type Node {
   /// any other script, so **do not use any untrusted input**.
   /// ## Example
   /// ```gleam
-  /// html.Script("alert('hello, lucy!')")
+  /// html.Script([], "alert('hello, lucy!')")
+  /// ```
+  /// ```gleam
+  /// html.Script([attr.type_("module"), attr.src(...)], "")
   /// ```
   Script(attrs: List(Attr), content: String)
   /// Renders absolutely nothing. For when you may or may not have something to render,