philiprehberger-html_builder 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae55b58a30868dfa5bc7afd1f3300723c88c8f05e97470571a02619e07dd3dfd
-  data.tar.gz: 39f947b3d37ac2a914da3fa42f99dd9a3fddd9d43b09498d548b03eae269b694
+  metadata.gz: 56b6f4a4c8e09045d724f5f67b3f8cec1e87fc2daddd397e04604cf13bcd33d8
+  data.tar.gz: 1b820c958ea1cafe11fa4aa415fb76b17aebef39aa611b6f100dedcdf01f2411
 SHA512:
-  metadata.gz: e4147ae709bc12f9c0d422169e2a8183bc90a92d3ae9b19cda6c62ad7fa927923b436d0a68f1c496eee6de843d9585a26a60786fee3611c3bcf8c765cf0365bd
-  data.tar.gz: 37cbec88f3da3293458bdbd8c42270c44d7f6f1b6f1e4b7052154968df53de570f9921dd27f9dde0a4221c56cf1ade5902168c2b98bd7af1f32327134b0b08f2
+  metadata.gz: '0398ad1acd04f45d1e28dc890a8436e01d42b9ed4e9bab2f0ee6d8e278d505016f74bee609c8743a0f8e3d69c111b3e03c83e9e2779bcb7437a51f7167183e1a'
+  data.tar.gz: 693dbcc9294f41267f54e66ef5c9a082f24c1a222d4db7d3c648623a392cf8ca6e6a80ac7fea0c944eb080c87ef598fba5b1292829ac4cc6825495bbbe54f1c3

data/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-05-30
+
+### Added
+- `HtmlBuilder.data(**attrs)` helper to build `data-*` attribute hashes, mirroring the existing `aria` helper
+
+### Fixed
+- Bug report issue template now includes a required `gem-version` field and marks `ruby-version` as required, matching the standard template
+
 ## [0.8.0] - 2026-05-20
 
 ### Added

data/README.md

@@ -183,9 +183,14 @@ Philiprehberger::HtmlBuilder.build do
   aria(label: 'Save', expanded: false, describedby: nil)
 end
 # => { 'aria-label' => 'Save', 'aria-expanded' => 'false' }
+
+Philiprehberger::HtmlBuilder.build do
+  data(controller: 'menu', modal_target: 'dialog', open: true)
+end
+# => { 'data-controller' => 'menu', 'data-modal-target' => 'dialog', 'data-open' => 'true' }
 ```
 
-`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`.
+`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`. `data` mirrors `aria` for the `data-*` attribute namespace.
 
 ### CSS Class Helpers
 
@@ -369,6 +374,7 @@ Philiprehberger::HtmlBuilder.merge(header, body, footer)
 | `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#data(**attrs)` | Build a `data-*` attribute hash from snake_case keys (rendered as `data-kebab-case`); omits nil values |
 | `Builder#cache(key) { ... }` | Cache rendered block output by key; return cached HTML on repeat calls |
 | `Builder#capture { ... }` | Render the block in an isolated scope and return its HTML string (no append) |
 | `Escape.html(value)` | Escape HTML special characters in a string |

data/lib/philiprehberger/html_builder/builder.rb

@@ -308,6 +308,25 @@ module Philiprehberger
         result
       end
 
+      # Build a `data-*` attribute hash from keyword pairs
+      #
+      # snake_case keys are converted to `data-kebab-case` string keys. Values are
+      # converted to strings. Keys whose value is `nil` are omitted from the result.
+      # String keys are passed through with a `data-` prefix and underscores
+      # converted to dashes (e.g. `"modal-target"` becomes `"data-modal-target"`).
+      #
+      # @param attrs [Hash] keyword pairs to convert into `data-*` attributes
+      # @return [Hash<String, String>] hash with `"data-*"` string keys and string values
+      def data(**attrs)
+        result = {}
+        attrs.each do |key, value|
+          next if value.nil?
+
+          result["data-#{key.to_s.tr('_', '-')}"] = value.to_s
+        end
+        result
+      end
+
       # Render a block in an isolated builder scope and return the HTML string
       # without appending anything to the current document.
       #

data/lib/philiprehberger/html_builder/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module HtmlBuilder
-    VERSION = '0.8.0'
+    VERSION = '0.9.0'
   end
 end

metadata

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