formatic 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d41f61aacdbc9679d1e63ff82441ac6008ae35f53a8b5425986e3bac53baeb0d
-  data.tar.gz: 2974cac3f7d742dc001b45a2c5cdfe81f71e4e2cfd24d6052b4d563a790423c7
+  metadata.gz: 0dfc8f4ebc2732072e4bce05a6bb1e8ca892fa98c3cc7ad51871e3f16468fbbb
+  data.tar.gz: 7511ea6cfd3d519a2f03438162b25efc369422e981a4edf51193361928a32f0a
 SHA512:
-  metadata.gz: 4da00730403d13520acf91dd762fe73e9a007ba6ba4146aa96cfb40d9e18ee71e4d45eb54569fab08a87df55838ee6c6302b1881c6b4a8eaa3376b10cf91462f
-  data.tar.gz: 7d37f9de2bb33f902fb85390aa8bcdc0f1500131196cf55107eeaaa5df94cd78e22bb34bc88cadaae41ac20457eb3d74d34053989da08d457d7e2a04f99cfd51
+  metadata.gz: 50383fb5853a0b588c723776b019e58acd4f7f557316df8c0be2bcf426251bec32d5049f57290e3b125be2ca05b9ad80664e0ab0be437b25f34d6498eeddddc7
+  data.tar.gz: cbb323dbde2a7bbf9abfb6d694f133f93d6f81fb7366877a05a98d847a21f7779bcdc9e0f38df1d1d91b74c04335b0107ed2709f0c60530c7baa26e429de7f56

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [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
+
 ## [0.6.0] 2026-10-26
 
 - Include `Formatic::Testing::Capybara::Search` in a Capybara RackTest class to call `search 'Acme Corp', from: 'Customer'`

data/README.md

@@ -22,6 +22,11 @@ when its query still matches the input. An optional `with_clear` slot clears
 the current selection.
 An optional `with_add_record` slot stays hidden while searching and appears
 after a successful response, even when there are no matches.
+The query input uses a field-specific `placeholder:` or `helpers.placeholder`
+translation when present. Otherwise it combines the translated label with the
+localized search prompt. English and German prompts are included; other locales
+fall back to the label. Search fields prevent implicit form submission on Enter
+by default; pass `prevent_submit_on_enter: false` to disable that behavior.
 
 ```ruby
 = render Formatic::Search.new(f:, attribute_name: :commander_id,
@@ -33,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,9 +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)
@@ -24,7 +25,11 @@ module Formatic
     end
 
     def search_placeholder
-      manual_placeholder.presence || wrapper.placeholder
+      return manual_placeholder if manual_placeholder.present?
+      return wrapper.placeholder if wrapper.placeholder.present?
+
+      translated_label = helpers.strip_tags(f.label(attribute_name))
+      ::I18n.t('formatic.search.placeholder', label: translated_label, default: translated_label)
     end
   end
 end

data/config/locales/formatic.de.yml

@@ -3,3 +3,6 @@ de:
 
     date:
       blank: Leer
+
+    search:
+      placeholder: '%{label} suchen...'

data/config/locales/formatic.en.yml

@@ -3,3 +3,6 @@ en:
 
     date:
       blank: Blank
+
+    search:
+      placeholder: Search %{label}...

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.0'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: formatic
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - halo
@@ -249,7 +249,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.20
 specification_version: 4
 summary: A set of ViewComponents for form elements
 test_files: []