philiprehberger-html_builder 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2422583ee49313a76a8eb70b50d6d8de0040b3f8ea9a9e22722013b0ab7537f5
-  data.tar.gz: b61ca71f0b42e279fdd9fa4375b7d67c7c9c8db7a85cc4c6575d5e9ba455b87e
+  metadata.gz: 9a1ed5d63b82c40002240f74e0f808a5e62926efd8b55a0c52b482d804a23bab
+  data.tar.gz: 814fd3cf20cf2cf358f25e38d14dcf9f02e84e32827a584c0c94a947d4404f48
 SHA512:
-  metadata.gz: 16b555765bd466535c05261da722bdacd670ee72bae7fc635e09de789a02eed4ad6f9020e17404fcb140e34060e1c1be2c5bfff05674e8c5d3867e4f9c8917ed
-  data.tar.gz: 75d90b85a6a865213dda114f6e3880d1f059a96ebbfbe348ad872b702fd644c5eece3e86bb56bb1237eae573b74c721dcbf004d3377a05503fce95319e200b69
+  metadata.gz: 0e0214af812ff0754349ee79c494f544f34b6b5a16852387d3c51c30b1580c7e88f75d0392f4761dacf754c91722cc83015f95131f065c60eaa073df64453217
+  data.tar.gz: eb761b219b3a40319752ba84628ed2a7a88f0ea423581619a641a98932a3c39f8deabb83edb077be8c0319436d60f7ccac2f53f5acaa6e63cb5d469e4d04b271

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-04-26
+
+### Added
+- `merge_attrs(*hashes)` helper for merging attribute hashes; concatenates `:class` (space-separated) and `:style` (semicolon-separated) values rather than overwriting
+- `aria(**pairs)` helper for building ARIA attribute hashes from snake_case keyword pairs (converted to `aria-kebab-case` string keys; nil values omitted)
+
 ## [0.6.0] - 2026-04-16
 
 ### Added

data/README.md

@@ -163,6 +163,28 @@ end
 # => '<ul><li><strong>Alice</strong></li><li><strong>Bob</strong></li></ul>'
 ```
 
+### Attribute Helpers
+
+Merge multiple attribute hashes — concatenating `:class` (single space) and `:style` (`'; '`) values rather than overwriting — and build ARIA attribute hashes from snake_case keyword pairs:
+
+```ruby
+Philiprehberger::HtmlBuilder.build do
+  base = { class: 'btn', style: 'color: red' }
+  variant = { class: 'btn-primary', style: 'font-weight: bold' }
+  attrs = merge_attrs(base, variant)
+
+  button('Save', **attrs)
+end
+# => '<button class="btn btn-primary" style="color: red; font-weight: bold">Save</button>'
+
+Philiprehberger::HtmlBuilder.build do
+  aria(label: 'Save', expanded: false, describedby: nil)
+end
+# => { 'aria-label' => 'Save', 'aria-expanded' => 'false' }
+```
+
+`merge_attrs` joins `:class` values with a single space and `:style` values with `'; '`. Other keys follow last-write-wins, and input hashes are not mutated. `aria` converts snake_case keys to `aria-kebab-case` string keys, stringifies values, and omits keys whose value is `nil`.
+
 ### 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:
@@ -324,6 +346,8 @@ Philiprehberger::HtmlBuilder.merge(header, body, footer)
 | `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#merge_attrs(*hashes)` | Merge attribute hashes, concatenating `:class` (space) and `:style` (`'; '`) values |
+| `Builder#aria(**pairs)` | Build an ARIA attribute hash from snake_case keys (rendered as `aria-kebab-case`); omits nil values |
 | `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

@@ -265,6 +265,49 @@ module Philiprehberger
         result.join(' ')
       end
 
+      # Merge multiple attribute hashes into one
+      #
+      # `:class` values are concatenated with a single space, and `:style` values
+      # are concatenated with a semicolon and space. All other keys follow last-write-wins
+      # semantics. Input hashes are not mutated.
+      #
+      # @param hashes [Array<Hash>] one or more attribute hashes to merge
+      # @return [Hash] the merged attribute hash
+      def merge_attrs(*hashes)
+        result = {}
+        hashes.each do |h|
+          next if h.nil?
+
+          h.each do |key, value|
+            if key == :class && result.key?(:class)
+              result[:class] = "#{result[:class]} #{value}"
+            elsif key == :style && result.key?(:style)
+              result[:style] = "#{result[:style]}; #{value}"
+            else
+              result[key] = value
+            end
+          end
+        end
+        result
+      end
+
+      # Build an ARIA attribute hash from keyword pairs
+      #
+      # snake_case keys are converted to `aria-kebab-case` string keys. Values are
+      # converted to strings. Keys whose value is `nil` are omitted from the result.
+      #
+      # @param pairs [Hash] keyword pairs to convert into ARIA attributes
+      # @return [Hash<String, String>] hash with `"aria-*"` string keys and string values
+      def aria(**pairs)
+        result = {}
+        pairs.each do |key, value|
+          next if value.nil?
+
+          result["aria-#{key.to_s.tr('_', '-')}"] = value.to_s
+        end
+        result
+      end
+
       # Cache a rendered block result by key
       #
       # On the first call with a given key, the block is executed, its rendered

data/lib/philiprehberger/html_builder/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module HtmlBuilder
-    VERSION = '0.6.0'
+    VERSION = '0.7.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-html_builder
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-16 00:00:00.000000000 Z
+date: 2026-04-27 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.