view_component_css_dsl 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fcd1b87aa8e32ecd595601ffbce3015c1cd7d1119a97967fda706f859499654
-  data.tar.gz: 3b473073f9fca60d277fa0dd9700cd66b2da76a2f72222830f3a3d76bc294ce7
+  metadata.gz: 49d5390931f1620f410e179868a1ab08cfcf4a0fa05164c8b4e7e7ba860fa1b2
+  data.tar.gz: 1f51a210129bd2ee1cfd414697e923c60e5be7c0c8870788e193482aacfda6ee
 SHA512:
-  metadata.gz: f4c117c6970000983d5acbdbb2d75254ac9875b5f0faeb64e80e78e88dd8644ee5dc3a01c24dfbac1257405cac55aa92c5975c1ac639cf28b8f2632e42002eec
-  data.tar.gz: a57068184216a9c7f3d0554efa9658805749d35aa57f8d1592a1a7c3f26bb5a2b3bc0333d68e073cb4281e619cff6067c84db55118196ee227b32bdbddfbcc98
+  metadata.gz: '0086317b10dbb3b32225d9b7eb9b1695d176c40ea6adad370ca6259366edbb1952038170fa4499ecaa2ad5edfff2af7c2459214140bc2be8dd61b6441fac7e05'
+  data.tar.gz: f2286966bae1f1c1b12b2f10e09f58d983281cbfdf0d96c863d98f28b3b7feefae85229d17a440f19d156a51ff7d0dbd2d525660186cb310d6273f15bce4d112

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Changelog
 
-## [Unreleased]
 
-## [0.1.0]
+
+## [0.1.1] - 2026-05-15
+
+### Changed
+
+- `view_component` dependency pinned to `~> 4.0` (was `>= 4.0`) — RubyGems-recommended SemVer-aware constraint
+- Minimum Ruby version raised to 3.2 (was 3.1), matching the floor for `view_component >= 4.0`
+
+## [0.1.0] - 2026-05-15
+
+### Added
+
 - Initial release. Extracted from SOFware/forge.

data/README.md

@@ -327,6 +327,8 @@ bundle exec rspec
 bundle exec standardrb
 ```
 
+Releases are managed by [reissue](https://github.com/SOFware/reissue). When committing, add Keep-a-Changelog trailers (`Added:`, `Changed:`, `Fixed:`, etc.) and reissue will collate them into `CHANGELOG.md` at release time. To publish a new version, run the "Release gem to RubyGems.org" workflow from GitHub Actions.
+
 ## License
 
 MIT. See [LICENSE.txt](LICENSE.txt).

data/lib/view_component_css_dsl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ViewComponentCssDsl
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/view_component_css_dsl.rb

@@ -12,11 +12,6 @@ require_relative "view_component_css_dsl/version"
 module ViewComponentCssDsl
   extend ActiveSupport::Concern
 
-  # HTML attributes auto-extracted from kwargs at construction time. Anything in
-  # this set is captured into @html_attrs instead of being passed to initialize,
-  # so callers can pass `class:`, `data:`, `aria:`, etc. without the component
-  # declaring them. To opt out, accept a kwarg with the same name in initialize
-  # (e.g. `def initialize(class:)`) or use a keyrest name other than html_attrs.
   HTML_ATTR_KEYS = Set[
     :alt, :aria, :autofocus,
     :class, :colspan, :contenteditable,
@@ -206,20 +201,60 @@ module ViewComponentCssDsl
     # Override `new` to auto-extract HTML attributes from kwargs into @html_attrs,
     # so components don't need to declare **html_attrs in their initialize signature.
     # Anything in HTML_ATTR_KEYS that wasn't declared as a kwarg is captured.
+    #
+    # These can then be referenced in the component's template as `html_attrs`.
+    #
+    # Why?
+    # - DX: All components can accept arbitrary html attrs for free. Dev can pass
+    #   arbitrary html attrs in at any caller and have it output at the component's
+    #   top-level element.
+    # - Removes boilerplate of putting `**html_attrs` as the last argument in every
+    #   single component's initialize signature, and then having to set the same as an
+    #   ivar within the initialize body.
+    # - Requires following a pattern of declaring `**html_attrs` in the top level
+    #   element of every single component's template.
+    # - Example template definition:
+    #
+    #     # html_attrs contains :class, :data, etc defined either in the component
+    #     # or passed in by the caller.
+    #     <%= tag.my_component **html_attrs do %>
+    #       <%= content %>
+    #     <% end %>
+    #
+    # Example caller:
+    #
+    #   render MyComponent.new(text: "Hello", class: "custom", data: {foo: "bar"})
+    #
+    # - :text goes to component's #initialize method, as normal
+    # - :class, :data, etc are captured and merged into @html_attrs automatically
+    # - The component's initialize method will look like:
+    #
+    #     def initialize(text)
+    #       @text = text
+    #     end
+    #
+    # To opt out of this behavior, inherit from ViewComponent::Base directly instead of
+    # ApplicationComponent.
+    #
     def new(*args, **kwargs, &block)
       info = initialize_params_info
       html_attrs = {}
+
+      # Only extract HTML attrs if the component uses **html_attrs pattern.
+      # Components with other keyrest names (like **options) should receive all kwargs.
       if info[:uses_html_attrs_keyrest]
+        # Extract HTML attrs, but NOT if they're declared component params
         extractable = HTML_ATTR_KEYS.intersection(kwargs.keys) - info[:declared_kwargs]
         html_attrs = kwargs.extract!(*extractable)
       end
 
       instance = allocate
+      # Set @html_attrs BEFORE initialize so components can access it there
       instance.instance_variable_set(:@html_attrs, html_attrs)
       instance.send(:initialize, *args, **kwargs, &block)
 
-      # Merge with any @html_attrs the component set inside initialize (older
-      # components that still declare **html_attrs). Caller-provided values win.
+      # Merge with any @html_attrs set by initialize (old pattern components).
+      # Caller-provided values (html_attrs) take precedence over component defaults.
       existing = instance.instance_variable_get(:@html_attrs) || {}
       instance.instance_variable_set(:@html_attrs, existing.merge(html_attrs))
       instance
@@ -234,12 +269,17 @@ module ViewComponentCssDsl
         keyrest_name = nil
         instance_method(:initialize).parameters.each do |type, name|
           case type
-          when :key, :keyreq then declared_kwargs << name
-          when :keyrest then keyrest_name = name
+          when :key, :keyreq
+            declared_kwargs << name
+          when :keyrest
+            keyrest_name = name
           end
         end
-        uses_html_attrs_keyrest = keyrest_name.nil? || keyrest_name == :html_attrs
-        {declared_kwargs:, uses_html_attrs_keyrest:}
+
+        {
+          declared_kwargs:,
+          uses_html_attrs_keyrest: keyrest_name == :html_attrs || keyrest_name.nil?
+        }
       end
     end
 

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: view_component_css_dsl
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Jeff Lange
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-05-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -44,6 +43,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: reissue
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -95,7 +108,6 @@ metadata:
   source_code_uri: https://github.com/SOFware/view_component_css_dsl
   changelog_uri: https://github.com/SOFware/view_component_css_dsl/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -110,8 +122,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Declarative CSS class DSL for ViewComponent + Tailwind
 test_files: []