rblade 3.0.0 → 3.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5760d0a2af4a86bf0ffcc9451abb3a46357029b9f5fea33afdf8305282c3d5e3
-  data.tar.gz: aaf764e044528fac1287219268ed117d332fd13204eb52971de9a88402665780
+  metadata.gz: c122be45a5a4cf085c9303105e2ba077e98f985ec1d460b661a34c90011f5bc6
+  data.tar.gz: 2025546b49a6058123cc089ade23c51c8a63be70f311336938d79898ee5c08e7
 SHA512:
-  metadata.gz: d38f0abf519963a665c5780a2e2328f4bc357455c2cbec99d49362eb76f4529ece7edd65b08ec4c9669700a2c0fca5feeade897fff938aa5c8ed64790f96c152
-  data.tar.gz: 4ef6e7d9bffb6b9a4360af6ffe7030d9cac15ce6b3c67da546af9739659cb68ea801f06e4ddeaa67f66ce48e4885d4b2931a090518d39b05b994592bd7db0447
+  metadata.gz: 7254ddefde7ec012469079917d69c6009bc16853ed230270803b751cf60cf724d642da949247e183a0dd8eff33fff540ce66698b52471ae5c0dd145969040aec
+  data.tar.gz: 7f66601910831102f56aaf3c637be8fe1284f043b80927c0b9d41adba7e35bee224f7fa00b6b5f6615b0883e5330879feb560c2de2ac1126700e2368ae1fe226

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 3.0.1 [2025-03-18]
+- Fix dynamic components not working when `RBlade.component_helper_method_name` is set
+
 ## 3.0.0 [2025-03-18]
 - Add ability to add raw directive handlers that add ruby code to the template
 - Add `RBlade.direct_component_rendering` option to allow RBlade components to be rendered directly

data/README.md

@@ -976,7 +976,28 @@ If you would like to prepend content onto the beginning of a stack, you should u
 <a name="rblade-integration"></a>
 ## Integrating RBlade With Other Templates
 
-You might want to use RBlade components within other templates, e.g. if you are using a component library that uses them. By default, RBlade components cannot be rendered directly, but this can be enabled using the `direct_component_rendering` option. 
+You might want to use RBlade components within other templates, e.g. if you are using a component library that uses them. The `component` helper method lets you easily include RBlade components in your ERB (or other) templates:
+
+```erb
+<%= component "button", class: "mt-4", colour: "green" do %>
+  <b>My button</b>
+<% end %>
+```
+
+If preferred, the `component` method can be renamed using the `RBlade.component_helper_method_name` option:
+
+```ruby
+# config/initializers/rblade.rb
+
+# Change the name of the component helper method
+RBlade.component_helper_method_name = :rblade_component
+
+
+# app/views/home/show.erb
+<%= rblade_component "my_component" %>
+```
+
+By default, RBlade layouts are not compatible with other templates, and components cannot be rendered directly, but this can be enabled using the `direct_component_rendering` option. 
 
 ```ruby
 # config/initializers/rblade.rb
@@ -985,13 +1006,14 @@ You might want to use RBlade components within other templates, e.g. if you are
 RBlade.direct_component_rendering = true
 ```
 
-Once enabled, RBlade components can be rendered using `render partial: ...`. Block contents are passed to the component in the `slot` variable, `attributes` is initialized using `local_assigns`, and the `@props` directive will look for content set using `content_for`.
+Once enabled, RBlade components can be used as layouts for ERB templates, or rendered directly using `render`. Block contents are passed to the component in the `slot` variable, `attributes` is initialized using `local_assigns`, and the `@props` directive will look for content set using `content_for`.
 
 ```erb
 <%= render template: "components/button", locals: {class: "mt-4", slot: capture do %>
-  
+  <% content_for: :title, "My title" %>
+  <b>My content</b>
 <% end } %>
 ```
 
 > [!NOTE]  
-> RBlade's `{{ }}` print directives are automatically sent through Rails' `h` function to prevent XSS attacks.
+> Using the `component` helper instead of RBlade's component syntax does not take advantage of RBlade's component caching

data/lib/rblade/compiler/compiles_components.rb

@@ -67,7 +67,7 @@ module RBlade
 
       attributes = compile_attributes token.value[:attributes]
 
-      "@output_buffer.raw_buffer<<component(#{component_value}, '#{RBlade.escape_quotes(@component_store.current_view_name)}', #{attributes.join ","}) do;"
+      "@output_buffer.raw_buffer<<#{RBlade.component_helper_method_name}(#{component_value}, '#{RBlade.escape_quotes(@component_store.current_view_name)}', #{attributes.join ","}) do;"
     end
 
     def compile_token_end(token)

data/rblade.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name = "rblade"
-  s.version = "3.0.0"
+  s.version = "3.0.1"
   s.summary = "A component-first templating engine for Rails"
   s.description = "RBlade is a simple, yet powerful templating engine for Ruby on Rails, inspired by Laravel Blade."
   s.authors = ["Simon J"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rblade
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.0.1
 platform: ruby
 authors:
 - Simon J