props_template 1.0.0.alpha → 1.0.0.alpha.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d2ef9c553bd49fd4d2a66bd8c2fc427e944b696c9eaa75f6224b5fb3627ca5e
-  data.tar.gz: a717254c4c10d35fb871c50476e72273a25b3ee1ab55ce239b2660633443dbef
+  metadata.gz: e576ca76e76fabbf53a61bd1a4151ec9438e0be6024315ff36045e214ff45f3c
+  data.tar.gz: af5136ad10bb352e8bbf0c268f61b619431a13f1fdb6707a3a1178dd86aef0e0
 SHA512:
-  metadata.gz: 2a4ab324d50d6f14783b10405073e4cef4b80b70bebda2ce9e586927e79c3ea254cc6fd542ac1b5ea195ebb5d106ffde0fa2801a0215a917d10c32425146ec58
-  data.tar.gz: 2d04b6d02c08da88ac66f5d61c782a8de35e27552f1a49402a39bf14814593b755d8b785f30b42a9dea4197bbe199581f79fcca2b6641293f18d604d48297aa7
+  metadata.gz: 3bef324bee977c40a521e92c19d3d36ba7586d75802a06393185a22122b6b6f471c0f4461ccab0b3deff9797cf1d3db513772c7caf38cbcd90dc31b4a3097a8b
+  data.tar.gz: c6baaca2c8608dea574adf14a9327910a3cdaca5d48180e05591edc214719e5e62460342609d08cae69257d4c118fc04886a61f30746ca3408f528370dcb0918

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/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,19 @@ 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
+        @traveled_path = []
+      end
+
+      fragment_context = @fragment_name
+      [@found_block, @traveled_path, pass_opts, fragment_context]
     end
 
     def set_block_content!(*args)
@@ -50,6 +58,12 @@ module Props
 
         @depth += 1
         if options[:partial]
+          fragment_name = Fragment.fragment_name_from_options(options)
+          if fragment_name
+            @fragment_name = fragment_name
+            @traveled_path = []
+          end
+
           @partialer.handle(options)
         else
           yield
@@ -94,6 +108,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
+              @traveled_path = []
+            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 +124,7 @@ module Props
       end
     end
 
-    def child!(options={}, &block)
+    def child!(options = {}, &block)
       return if @found_block
 
       child_index = @child_index || -1
@@ -128,7 +147,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.2".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,7 +51,9 @@ module Props
         options.delete(:dig)
 
         @builder.set!(key, options, &block)
-        found_block, found_options = @builder.found!
+        found_block, found_path, found_options, fragment_context = @builder.found!
+        @found_path = found_path || []
+        @fragment_context = fragment_context
         @builder = prev_builder
 
         if found_block
@@ -59,6 +64,18 @@ module Props
       end
     end
 
+    def partial!(**options)
+      @context.render options
+    end
+
+    def found_path!
+      @found_path.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.2
 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: []