evc_rails 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fb8d4d59a3526f01f08e3c152ff5abe083e1a2bf1e66ab929db733356b56c822
-  data.tar.gz: 07c8c5688a9ad4ddb78f34ca174f478e9103b656c09223c86aed522746b0b299
+  metadata.gz: '0083734e9b8f16100d769aa08c7393c7e60105a5c9bcbc3774c5955cc3c71def'
+  data.tar.gz: 9099d7be89c3b5c6805fbd0b7b9316409c53a89ff62b1460391265c4a18fa97b
 SHA512:
-  metadata.gz: 6e429ae91cf3b0e3ac7b47001e164e65f6c4c6bd45f6c11f4258bb0a3c7cf77fa04594a4f493b887f434809ff11174996b09099273ac1bfac50897b002489158
-  data.tar.gz: 57c5fb478a987d55dd24e22afda9198f9af0b11056ac3ab2bbf66a52ec420251cae33cfa596caa5074015e241cd5d6754b2f95a04c46ba1951c0190694f92e64
+  metadata.gz: 742227dddbef882cf3a085bfd2c8642e4decc61a76bb83f858b55bb900d1064d09b9507beb3cbfbb62d5472a644793f4457057d23962cce134a6d75aa018bfca
+  data.tar.gz: 13948d925ffc1419337d7d6a104be86bdae102577a133393978cb8c00eab2f7ee63bc627c6e15667c34671534f020588cf5e97297cbc82f6e0d79e800c9b416e

data/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.2] - 2024-12-19
+
+### Added
+
+- **Boolean attribute shorthand**: Support for HTML-style boolean attributes without values
+  - `<Button disabled required />` now converts to `disabled: true, required: true`
+  - Makes templates more concise and readable for boolean parameters
+  - Works with any boolean parameter your component defines
+
+### Changed
+
+- Updated test suite to use new snake_case variable naming convention
+- Improved block variable syntax consistency across all examples
+
+## [0.2.1] - 2024-12-19
+
+### Added
+
+- **Custom block variable naming**: Support for `as` attribute to customize yielded variable names
+  - `<Card as="my_card">` yields `|my_card|` instead of `|card|`
+  - Helps avoid variable name collisions in nested components
+  - Useful for accessing parent component context from nested components
+
+### Changed
+
+- **Block variable naming**: Components now yield snake_case variable names by default
+  - `<Card>` now yields `|card|` instead of `|c|`
+  - More descriptive and consistent with Ruby naming conventions
+  - Only yields variables when slots are present in the component
+
+### Fixed
+
+- Improved slot method naming to match ViewComponent conventions
+  - `<WithHeader>` maps to `with_header` method (not `header`)
+  - `<WithItem>` maps to `with_item` method for both `renders_one` and `renders_many`
+  - Ensures compatibility with ViewComponent's generated method names
+
+## [0.2.0] - 2024-12-19
+
+### Added
+
+- **Slot support**: Full support for ViewComponent slots with `<With...>` syntax
+  - `<WithHeader>` for `renders_one :header`
+  - `<WithItem>` for `renders_many :items` (uses singular method name)
+  - Support for slot attributes and Ruby expressions
+  - Automatic block variable yielding when slots are present
+- **Namespaced component support**: Components in subdirectories
+  - `<UI::Button />` maps to `app/components/ui/button_component.rb`
+  - `<Forms::Fields::TextField />` for deeply nested components
+- **Enhanced error messages**: Line numbers and column positions for better debugging
+- **Production caching**: Automatic template caching using Rails.cache
+- **Cache management**: Methods to clear and inspect template cache
+
+### Changed
+
+- **Template handler architecture**: Improved performance and reliability
+- **Error handling**: More descriptive error messages with context
+
+## [0.1.0] - 2024-12-19
+
+### Added
+
+- **Initial release**: Basic JSX-like syntax for ViewComponent
+- **Self-closing components**: `<Button />` syntax
+- **Block components**: `<Card>content</Card>` syntax
+- **Attribute support**: String, Ruby expressions, and multiple attributes
+- **ERB integration**: Full support for ERB tags and Ruby expressions
+- **Drop-in replacement**: Works as a replacement for `.erb` files
+- **Basic caching**: Template compilation caching for performance
+
+---
+
+## Version History Notes
+
+- **0.1.0**: Initial release with core functionality
+- **0.2.0**: Major feature addition with slots and namespaced components
+- **0.2.1**: Improved variable naming and slot method compatibility
+- **0.2.2**: Added boolean attribute shorthand for cleaner templates

data/README.md

@@ -298,6 +298,34 @@ end
 
 This generates distinct variables, `outer_card` and `inner_card`, allowing you to access the context of each component without collision.
 
+#### Passing a Collection to a Plural Slot (Array Notation)
+
+You can also pass an array directly to a plural slot method using embedded Ruby inside your EVC template. For this advanced use case, block variables are not inferred automatically and it is necessary to define block variables with the `as` attribute.
+
+```erb
+<Navigation as="navigation">
+  <% navigation.with_links([
+    { name: "Home", href: "/" },
+    { name: "Pricing", href: "/pricing" },
+    { name: "Sign Up", href: "/sign-up" }
+  ]) %>
+</Navigation>
+```
+
+This is equivalent to the ERB version:
+
+```erb
+<%= render NavigationComponent.new do |navigation| %>
+  <% navigation.with_links([
+    { name: "Home", href: "/" },
+    { name: "Pricing", href: "/pricing" },
+    { name: "Sign Up", href: "/sign-up" }
+  ]) %>
+<% end %>
+```
+
+You can use this approach for any plural slot method generated by `renders_many`. The block variable (e.g., `navigation`) is always available inside the component block when you use the `as` attribute, even if there are no `<With...>` slot tags present.
+
 ### Mixed Content
 
 You can mix regular HTML, ERB, and component tags:

data/lib/evc_rails/template_handler.rb

@@ -150,8 +150,10 @@ module EvcRails
             else
               component_class = "#{tag_name}Component"
               variable_name = as_variable || component_variable_name(tag_name)
+              # If as_variable is present, force block variable to be yielded
+              force_block_variable = !as_variable.nil?
               stack << [tag_name, component_class, param_str, result.length, :component, nil, false, match.begin(0),
-                        variable_name]
+                        variable_name, force_block_variable]
               result << if param_str.empty?
                           "<%= render #{component_class}.new do %>"
                         else
@@ -188,10 +190,10 @@ module EvcRails
             tag_type = open_tag_data[4]
 
             if tag_type == :component
-              _tag_name, component_class, param_str, start_pos, _type, _slot_name, slot_used, _open_pos, variable_name = open_tag_data
+              _tag_name, component_class, param_str, start_pos, _type, _slot_name, slot_used, _open_pos, variable_name, force_block_variable = open_tag_data
 
-              # Patch in |variable_name| for component if a slot was used
-              if slot_used
+              # Patch in |variable_name| for component if a slot was used or as_variable was present
+              if slot_used || force_block_variable
                 # More robustly find the end of the `do` block to insert the variable.
                 # This avoids faulty regex matching on complex parameters.
                 relevant_part = result[start_pos..-1]

data/lib/evc_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EvcRails
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: evc_rails
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - scttymn
@@ -77,6 +77,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".rubocop.yml"
+- CHANGELOG.md
 - LICENSE.txt
 - README.md
 - Rakefile