formatic 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c770f8b2518ead02b5d2a7797068c3192ed9d264e22d59af830569eb07a6c0ef
-  data.tar.gz: ffc6912dea00ef5faf99fa815d7d3173d446fb07f312c160a80e6d29f9ec175c
+  metadata.gz: 0dfc8f4ebc2732072e4bce05a6bb1e8ca892fa98c3cc7ad51871e3f16468fbbb
+  data.tar.gz: 7511ea6cfd3d519a2f03438162b25efc369422e981a4edf51193361928a32f0a
 SHA512:
-  metadata.gz: eaf5adeb08637ff84743f4a0c26c694533af908ee64d716340f96478fed4cc2a93004bf73a5bb3c50d8be4b647e703ab7f5d9bafb93cad4e483473c60501760c
-  data.tar.gz: af465ca562212a64012756431fd96340d2e44c5d68a11ee4ede6a912f2e8d5627b853140b0f759d57d84f90f1d6722aab752496e47a386bd5c56132f7d5d9e0f
+  metadata.gz: 50383fb5853a0b588c723776b019e58acd4f7f557316df8c0be2bcf426251bec32d5049f57290e3b125be2ca05b9ad80664e0ab0be437b25f34d6498eeddddc7
+  data.tar.gz: cbb323dbde2a7bbf9abfb6d694f133f93d6f81fb7366877a05a98d847a21f7779bcdc9e0f38df1d1d91b74c04335b0107ed2709f0c60530c7baa26e429de7f56

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.7.0] - 2026-10-27
+
+- Add an instance-based `Formatic::Search::Frontend` with `as_json` and `to_json`.
+- Pass the frontend object to `Formatic::Search` to render selected records.
+- Remove the class-level `.json` helper and the `with_selected_record` slot.
+
 ## [0.6.1] 2026-10-26
 
 - Proper i18n for Formatic::Search placeholders

data/README.md

@@ -38,6 +38,20 @@ For Rack tests, call `Formatic::Testing::Search.call(page:, query: 'Bob', from:
 It reads the field's URL and parameter names, requests matching JSON directly, and
 fills the hidden input with a result returned by that endpoint.
 
+Use `Formatic::Search::Frontend` to represent a result for both the JSON response
+and a selected search field. Its `as_json` and `to_json` methods return the wrapped
+`id`, `choice`, and `selected` record. Pass the object to
+`Formatic::Search` to render its selected markup, including the usual clear control:
+the app supplies the rendered record fragments, and Formatic adds the search wrappers.
+
+```ruby
+frontend = Formatic::Search::Frontend.new(id: commander.id,
+                                          choice_html:,
+                                          selected_html:)
+render Formatic::Search.new(f:, attribute_name: :commander_id,
+                            url: admin_commanders_path(format: :json), frontend:)
+```
+
 Capybara RackTest test classes can include the `search` helper instead:
 
 ```ruby

data/app/components/formatic/search/frontend.rb

@@ -2,20 +2,37 @@
 
 module Formatic
   class Search
-    # Builds one search JSON record from the app partials.
+    # Represents one search result for JSON responses and selected search fields.
     class Frontend
-      def self.json(id:, choice:, selected:)
+      attr_reader :id, :choice_html, :selected_html
+
+      def initialize(id:, choice_html:, selected_html:)
+        @id = id
+        @choice_html = choice_html
+        @selected_html = selected_html
+      end
+
+      def as_json(_options = nil)
         {
-          id: id,
-          choice: render_html(::Formatic::Search::Choice.new(record_id: id).with_content(choice)),
-          selected: render_html(::Formatic::Search::Selected.new.with_content(selected))
+          id:,
+          choice: render_html(choice_component),
+          selected: render_html(::Formatic::Search::Selected.new.with_content(selected_html))
         }
       end
 
-      def self.render_html(component)
+      def to_json(options = nil)
+        as_json.to_json(options)
+      end
+
+      private
+
+      def choice_component
+        ::Formatic::Search::Choice.new(record_id: id).with_content(choice_html)
+      end
+
+      def render_html(component)
         ApplicationController.render(component)
       end
-      private_class_method :render_html
     end
   end
 end

data/app/components/formatic/search/selected.rb

@@ -4,12 +4,12 @@ module Formatic
   class Search
     # The record that is currently chosen.
     class Selected < ::Formatic::ApplicationComponent
-      option :readonly, default: -> { false }
+      option :clearable, default: -> { true }
 
       erb_template <<~ERB
         <div class="c-formatic-search__selection">
           <div class="c-formatic-search__selected-record"><%= content %></div>
-          <% unless readonly %>
+          <% if clearable %>
             <div class="c-formatic-search__actions"><%= render ::Formatic::Search::Clear.new %></div>
           <% end %>
         </div>

data/app/components/formatic/search.rb

@@ -8,10 +8,10 @@ module Formatic
     option :url
     option :record_name, as: :manual_record_name, optional: true
     option :exclude_ids, default: -> { [] }
+    option :frontend, optional: true
     option :placeholder, as: :manual_placeholder, optional: true
     option :prevent_submit_on_enter, default: -> { true }
 
-    renders_one :selected_record
     renders_one :add_record
 
     erb_template(::Formatic::Templates::Search.call)

data/lib/formatic/templates/search.rb

@@ -19,8 +19,9 @@ module Formatic
                                  class: 'js-formatic-search__value' %>
 
               <div class="c-formatic-search__selected js-formatic-search__selected">
-                <% if selected_record? %>
-                  <%= render ::Formatic::Search::Selected.new(readonly: readonly).with_content(selected_record) %>
+                <% if frontend %>
+                  <%= render ::Formatic::Search::Selected.new(clearable: !readonly)
+                                                        .with_content(frontend.selected_html) %>
                 <% end %>
               </div>
 

data/lib/formatic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Formatic
-  VERSION = '0.6.1'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: formatic
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - halo