props_template 1.0.0.alpha → 1.0.0.alpha.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d2ef9c553bd49fd4d2a66bd8c2fc427e944b696c9eaa75f6224b5fb3627ca5e
-  data.tar.gz: a717254c4c10d35fb871c50476e72273a25b3ee1ab55ce239b2660633443dbef
+  metadata.gz: 47eaa94bedc38645ef945eb7308cdc257497b063b5a9df481d491ec3bb1ae3ca
+  data.tar.gz: 48da4764807eb7924b224e98175f81c822a67e6ead927904df452d620d39e6e0
 SHA512:
-  metadata.gz: 2a4ab324d50d6f14783b10405073e4cef4b80b70bebda2ce9e586927e79c3ea254cc6fd542ac1b5ea195ebb5d106ffde0fa2801a0215a917d10c32425146ec58
-  data.tar.gz: 2d04b6d02c08da88ac66f5d61c782a8de35e27552f1a49402a39bf14814593b755d8b785f30b42a9dea4197bbe199581f79fcca2b6641293f18d604d48297aa7
+  metadata.gz: 40c1e3bfc2c99a3b37834abec4e9b8463d4585203583f9f2f7ba710d775e714a7950bf1bf60f9d86b67c34de6742a5b5a0d249e0154fb50736288123e9ebb1e4
+  data.tar.gz: 70953db156e838cf72b220f9549c3a4abc6684d5bf0b0ad8a6305b15abf56cd1bd876635248fa2c8f1e43f21241475716d1dca49605fe65279951a8f2e59ed84

data/README.md

@@ -640,6 +640,28 @@ json.flash flash.to_h
 **NOTE** PropsTemplate inverts the usual Rails rendering flow. PropsTemplate
 will render Layout first, then the template when `yield json` is used.
 
+
+### Layouts in API-only Rails apps
+
+If your controllers inherit from `ActionController::API` (typical in API-only Rails apps),
+the layout feature won’t work out of the box, because `ActionController::API`
+does not include layout support.
+
+To enable layout rendering, you can include `ActionView::Layouts` manually,
+then use `layout "your_own_layout"` as usual:
+
+```ruby
+module Api
+  class BaseController < ActionController::API
+    include ActionView::Layouts
+
+    layout "api"
+  end
+end
+```
+
+Without this, Rails will silently skip the layout, which can be tricky to notice.
+
 ## Change key format
 By default, keys are not formatted. This is intentional. By being explicit with your keys,
 it makes your views quicker and more easily diggable when working in JavaScript land.

data/lib/props_template/base.rb

@@ -111,10 +111,6 @@ module Props
       nil
     end
 
-    def partial!(**options)
-      @context.render options
-    end
-
     # json.id item.id
     # json.value item.value
     #

data/lib/props_template/base_with_extensions.rb

@@ -55,15 +55,16 @@ module Props
         options = @em.refine_options(options)
       end
 
-      super(key, options, &block)
+      super
     end
 
     def handle_set_block(key, options)
-      @traveled_path.push(key)
       n = 1
       if (suffix = options[:path_suffix])
         n += suffix.length
         @traveled_path.push(suffix)
+      else
+        @traveled_path.push(key)
       end
 
       super

data/lib/props_template/extensions/fragment.rb

@@ -7,18 +7,28 @@ module Props
       @fragments = fragments
     end
 
-    def handle(options)
+    def self.fragment_name_from_options(options)
       return if !options[:partial]
-      _partial_name, partial_opts = options[:partial]
+
+      _, partial_opts = [*options[:partial]]
+      return unless partial_opts
+
       fragment = partial_opts[:fragment]
 
       if String === fragment || Symbol === fragment
-        key = fragment.to_s
-        path = @base.traveled_path.join(".")
-        @name =key 
+        fragment.to_s
+      end
+    end
+
+    def handle(options)
+      fragment_name = self.class.fragment_name_from_options(options)
+      path = @base.traveled_path
+        .map { |item| item.is_a?(Array) ? item[0] : item }
+        .join(".")
 
+      if fragment_name
         @fragments.push(
-          {id: key, path: path}
+          {id: fragment_name, path: path}
         )
       end
     end

data/lib/props_template/layout_patch.rb

@@ -3,7 +3,7 @@ module Props
     def render_template(view, template, layout_name, locals)
       if !view.respond_to?(:active_template_virtual_path) && template.respond_to?(:virtual_path)
         view.instance_eval <<~RUBY, __FILE__, __LINE__ + 1
-          def active_template_virtual_path; "#{template.virtual_path}";end
+          def active_template_virtual_path; @_active_template_virtual_path || "#{template.virtual_path}";end
         RUBY
       end
 

data/lib/props_template/searcher.rb

@@ -11,6 +11,7 @@ module Props
       @builder = builder
       @traveled_path = []
       @partialer = Partialer.new(self, context, builder)
+      @fragment_name = nil
     end
 
     def deferred!
@@ -24,12 +25,20 @@ module Props
     def found!
       pass_opts = @found_options.clone || {}
       pass_opts.delete(:defer)
-      traveled_path = @traveled_path[1..] || []
+      traveled_path = @traveled_path || []
       if !traveled_path.empty?
         pass_opts[:path_suffix] = traveled_path
       end
 
-      [@found_block, pass_opts]
+      fragment_name = Fragment.fragment_name_from_options(pass_opts)
+      if fragment_name
+        @fragment_name = fragment_name
+        @fragment_path = @traveled_path.clone
+      end
+
+      fragment_context = @fragment_name
+
+      [@found_block, @traveled_path, pass_opts, @fragment_path, fragment_context]
     end
 
     def set_block_content!(*args)
@@ -50,6 +59,12 @@ module Props
 
         @depth += 1
         if options[:partial]
+          fragment_name = Fragment.fragment_name_from_options(options)
+          if fragment_name
+            @fragment_name = fragment_name
+            @fragment_path = @traveled_path.clone
+          end
+
           @partialer.handle(options)
         else
           yield
@@ -82,6 +97,17 @@ module Props
 
         if item
           pass_opts = @partialer.refine_options(options, item)
+
+          if (key = pass_opts[:key])
+            val = if item.respond_to? key
+              item.send(key)
+            elsif item.is_a? Hash
+              item[key] || item[key.to_sym]
+            end
+
+            pass_opts[:key] = [pass_opts[:key], val]
+          end
+
           @traveled_path.push(key_index)
 
           if @depth == @search_path.size - 1
@@ -94,6 +120,11 @@ module Props
 
           @depth += 1
           if pass_opts[:partial]
+            fragment_name = Fragment.fragment_name_from_options(pass_opts)
+            if fragment_name
+              @fragment_name = fragment_name
+              @fragment_path = @traveled_path.clone
+            end
             # todo: what happens when cached: true is passed?
             # would there be any problems with not using the collection_rende?
             @partialer.handle(pass_opts)
@@ -105,7 +136,7 @@ module Props
       end
     end
 
-    def child!(options={}, &block)
+    def child!(options = {}, &block)
       return if @found_block
 
       child_index = @child_index || -1
@@ -128,7 +159,7 @@ module Props
         @depth -= 1
       end
 
-      @child_index = child_index    
+      @child_index = child_index
     end
   end
 end

data/lib/props_template/version.rb

@@ -1,3 +1,3 @@
 module Props
-  VERSION = "1.0.0.alpha".freeze
+  VERSION = "1.0.0.alpha.3".freeze
 end

data/lib/props_template.rb

@@ -30,11 +30,14 @@ module Props
       :disable_deferments!,
       :set_block_content!,
       :traveled_path!,
+      :fragment_context!,
       to: :builder!
 
     def initialize(context = nil, options = {})
       @builder = BaseWithExtensions.new(self, context, options)
       @context = context
+      @fragment_context = nil
+      @found_path = []
     end
 
     def set!(key, options = {}, &block)
@@ -48,8 +51,11 @@ module Props
         options.delete(:dig)
 
         @builder.set!(key, options, &block)
-        found_block, found_options = @builder.found!
+        found_block, found_path, found_options, fragment_path, fragment_context = @builder.found!
+        @found_path = found_path || []
+        @fragment_context = fragment_context
         @builder = prev_builder
+        @fragment_path = fragment_path
 
         if found_block
           set!(key, found_options, &found_block)
@@ -59,6 +65,18 @@ module Props
       end
     end
 
+    def partial!(**options)
+      @context.render options
+    end
+
+    def found_path!
+      @found_path[@fragment_path.size..].join(".")
+    end
+
+    def fragment_context!
+      @fragment_context
+    end
+
     def builder!
       @builder
     end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: props_template
 version: !ruby/object:Gem::Version
-  version: 1.0.0.alpha
+  version: 1.0.0.alpha.3
 platform: ruby
 authors:
 - Johny Ho
 bindir: bin
 cert_chain: []
-date: 2025-07-13 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -106,7 +106,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A fast JSON builder
 test_files: []