philiprehberger-html_builder 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3456c0aafd35720f59ea6e59561f262f43b5365ea60a669064df2b51c6a3e12
-  data.tar.gz: 9bccfcfc9471afa14a8e5760799ddf9fce538747e7a5adaa0ac971f5a8c6de84
+  metadata.gz: c951cd5a9e74ab6642a9181b01235a4a5a63b39015fd05cf5c41ab0157bc6106
+  data.tar.gz: ab129d21a86612912a83f460cd49424b4005ac95fe6f7c8c6471f3f5309a6640
 SHA512:
-  metadata.gz: eaf644594e2209e715c251d4d6d0c4d6540b620f00ac1adde085f31fdf66658fb52f7e9b819d34c93fad91c76b7765eb58888d3c387752815636e628b3559e35
-  data.tar.gz: 9998a84aed894d70f92f08752278748df2a54097c4a7b4b866d43f50865ee07f0db48aaa7c6a4cc20a4adb52b67e10ba9862a7b0a258ebe1d93fb620e40276c2
+  metadata.gz: c6ceba75c99ca6620ba8434521b02703cb42d0113f662fe0789928dec1b1e38f4e3057c4fd44495eefd30bd53d08127d6b95daa470e4d67bf15ed56f61e085a9
+  data.tar.gz: c70fd51be8e402a223a7a1114a0f0950dd66267f2cf20506a1437a32905ba3185634a980fa314fd9785c985600a947890e05768b35dccdaabdbb40a395cb0191

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-04-15
+
+### Added
+- `list(items, ordered: false, **attrs, &block)` helper for building `<ul>` or `<ol>` lists from an array of items with optional custom rendering via block
+
+## [0.4.0] - 2026-04-15
+
+### Added
+- `HtmlBuilder.escape(value)` module method for escaping arbitrary strings using the DSL's escaper
+
 ## [0.3.0] - 2026-04-14
 
 ### Added

data/README.md

@@ -142,6 +142,27 @@ Philiprehberger::HtmlBuilder.build do
 end
 ```
 
+### Lists
+
+Build `<ul>` or `<ol>` lists from an array of items. Items are text-escaped by default. Pass `ordered: true` for an ordered list. Use a block for custom rendering of each item:
+
+```ruby
+Philiprehberger::HtmlBuilder.build do
+  list(%w[Apple Banana Cherry])
+end
+# => '<ul><li>Apple</li><li>Banana</li><li>Cherry</li></ul>'
+
+Philiprehberger::HtmlBuilder.build do
+  list(%w[First Second], ordered: true, class: 'steps')
+end
+# => '<ol class="steps"><li>First</li><li>Second</li></ol>'
+
+Philiprehberger::HtmlBuilder.build do
+  list(%w[Alice Bob]) { |name| strong name }
+end
+# => '<ul><li><strong>Alice</strong></li><li><strong>Bob</strong></li></ul>'
+```
+
 ### CSS Class Helpers
 
 Build conditional CSS class strings from mixed arguments. Strings are included as-is, hash keys are included when their value is truthy:
@@ -229,6 +250,15 @@ Philiprehberger::HtmlBuilder.build_pretty(indent_size: 4) do
 end
 ```
 
+### Escape Helper
+
+Escape arbitrary strings outside the DSL using the same entity encoding:
+
+```ruby
+Philiprehberger::HtmlBuilder.escape('<script>alert("xss")</script>')
+# => "&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;"
+```
+
 ### Fragment Merging
 
 Combine multiple builder outputs into a single HTML string:
@@ -250,6 +280,7 @@ Philiprehberger::HtmlBuilder.merge(header, body, footer)
 | `HtmlBuilder.build_pretty { ... }` | Build pretty-printed HTML with indentation |
 | `HtmlBuilder.build_minified { ... }` | Alias for `build`, explicitly produces minified output |
 | `HtmlBuilder.merge(*fragments)` | Merge multiple HTML fragment strings into one |
+| `HtmlBuilder.escape(value)` | Escape HTML special characters in a string using the DSL's escaper |
 | `Builder#to_html` | Render builder contents to a minified HTML string |
 | `Builder#to_pretty_html` | Render builder contents to a pretty-printed HTML string |
 | `Builder#text(content)` | Add escaped text content to the current element |
@@ -264,6 +295,7 @@ Philiprehberger::HtmlBuilder.merge(header, body, footer)
 | `Builder#textarea_field(name, content, label_text:, **attrs)` | Build a label + textarea |
 | `Builder#hidden_field(name, value)` | Generate a hidden input element |
 | `Builder#submit(text, **attrs)` | Generate a submit button (default text "Submit") |
+| `Builder#list(items, ordered:, **attrs, &block)` | Build a `<ul>` or `<ol>` from an array of items |
 | `Builder#class_names(*args)` | Build a conditional CSS class string from strings and hashes |
 | `Builder#cache(key) { ... }` | Cache rendered block output by key; return cached HTML on repeat calls |
 | `Escape.html(value)` | Escape HTML special characters in a string |

data/lib/philiprehberger/html_builder/builder.rb

@@ -216,6 +216,26 @@ module Philiprehberger
         button(text, type: 'submit', **attrs)
       end
 
+      # Build a list (ul or ol) from an array of items
+      #
+      # @param items [Array] the list items
+      # @param ordered [Boolean] use ol instead of ul (default false)
+      # @param attrs [Hash] additional attributes for the list element
+      # @yield [item] optional block for custom rendering of each item
+      # @return [Node]
+      def list(items, ordered: false, **attrs, &block)
+        tag_name = ordered ? :ol : :ul
+        send(tag_name, **attrs) do
+          items.each do |item|
+            if block
+              li { block.call(item) }
+            else
+              li item.to_s
+            end
+          end
+        end
+      end
+
       # Build a space-joined CSS class string from mixed arguments
       #
       # Strings are included as-is. Hash keys are included when their value is truthy.

data/lib/philiprehberger/html_builder/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module HtmlBuilder
-    VERSION = '0.3.0'
+    VERSION = '0.5.0'
   end
 end

data/lib/philiprehberger/html_builder.rb

@@ -52,5 +52,13 @@ module Philiprehberger
     def self.merge(*fragments)
       fragments.join
     end
+
+    # Escape HTML special characters in a string using the same escaper as the DSL.
+    #
+    # @param value [Object] the value to escape (converted to string)
+    # @return [String] the escaped string
+    def self.escape(value)
+      Escape.html(value)
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-html_builder
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-15 00:00:00.000000000 Z
+date: 2026-04-16 00:00:00.000000000 Z
 dependencies: []
 description: Build HTML programmatically using a clean tag DSL with nested blocks,
   automatic content escaping, void element support, and attribute hashes.