inline_forms_installer 8.1.5 → 8.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ebb695af4c902a20604e51deb4fc8a2eefaf32e625cf86805633ffd65e048d4
-  data.tar.gz: 1b630b3fc3f578fbde245ec2957c9cedc60c0dc27cf28d506b56a41361fb9d5c
+  metadata.gz: 8780337213fbfb45e061f0f5309c9cb73826461aacca4dd4cc1662214b8654f4
+  data.tar.gz: c355bf659cc460fa83ca210a712c91b466dc4d7e30c0c8477906b2d867770674
 SHA512:
-  metadata.gz: 50c22db56f53d41b37f9aaffb44298478a707fbd8f36d962a280e8d952f1c77a25306f6c9e2ecd10f59b825807ced7f172c6dfa547d613efa3569cee6c3e88ec
-  data.tar.gz: 1c4b64a00674ca2096c1b40c2f48f7bed3c2bd696f0fdf0cd295c6f7df093b244047040e2b07059c42364dd26e842040218973ea002324aafc6780a388ed7d62
+  metadata.gz: 1e663a9f2bfdf0ad9e8bab1a93cb397a12374d7918a7f08d069c10b84ca3e635c95cd702c87e1164fb78173f6992cd99191930c1814ffdddc7d996273303c5c5
+  data.tar.gz: 210aef3002d3c58c01f226c5f29e6f0a7e548c8b273cb3eca3f08e524beb407f16b75d4cd3ec46abcac4e4a65b21d05c3d2132e79d347cac5a528b54119ac5a4

data/lib/inline_forms_installer/installer_core.rb

@@ -1039,6 +1039,202 @@ if ENV['install_example'] == 'true'
   say "- Running migrations for owner + seed (owners + apartments.owner_id + 3 apts/3 owners)..."
   run "bundle exec rake db:migrate"
 
+  # ---------------------------------------------------------------------
+  # FormElementShowcase: a fourth example resource that exercises every
+  # kept Tier 1 form_element helper on a single object. The kept set
+  # (and the rationale for what was dropped) is documented in
+  # stuff/form-element-showcase-plan.md. The runtime helpers handle
+  # every element generically; this block wires up the model, value
+  # rows, uploaders, join table, and seed data.
+  # ---------------------------------------------------------------------
+  say "- Generating FormElementShowcase (one resource per kept Tier 1 form_element)..."
+  sleep 1
+  run %q{bundle exec rails g inline_forms FormElementShowcase title:string body_plain_area:plain_text_area count:integer_field price:decimal_field meeting_date:date_select meeting_time:time_select birth_month:month_select start_month:month_year_picker is_active:check_box gender:radio_button rating_int:dropdown_with_integers priority:dropdown_with_values priority2:dropdown_with_values stars:dropdown_with_values_with_stars attachment:file_field jingle:audio_field cover:image_field description:rich_text roles:has_and_belongs_to_many _enabled:yes _list_order:title _list_search:title _presentation:'#{title}'}
+
+  say "- Generating Attachment + Jingle uploaders (Cover reuses ImageUploader)..."
+  run "bundle exec rails generate uploader Attachment"
+  run "bundle exec rails generate uploader Jingle"
+
+  # Cover reuses ImageUploader (already generated for Photo). CarrierWave
+  # is happy to mount one uploader class on multiple models; the global
+  # `remove_previously_stored_files_after_update = false` keeps PaperTrail
+  # revertable for both.
+  gsub_file "app/models/form_element_showcase.rb",
+            "mount_uploader :cover, CoverUploader",
+            "mount_uploader :cover, ImageUploader"
+
+  # First field-level validation in the example app. `allow_blank: true`
+  # keeps PaperTrail revert paths (and the seeded second row, which leaves
+  # count nil) valid. The integration test covers the explicit error
+  # path by POSTing `count: "abc"` to /form_element_showcases.
+  inject_into_file "app/models/form_element_showcase.rb",
+                   "\n  validates :count, numericality: { only_integer: true }, allow_blank: true\n  mount_uploader :attachment, AttachmentUploader\n",
+                   after: "class FormElementShowcase < ApplicationRecord\n"
+
+  # Value-bearing rows for every form_element that needs a values hash
+  # (or hash + options_disabled). 8.1.5 row shape: [:attr, :form_element]
+  # for bare rows, [:attr, :form_element, values, options_disabled] for
+  # choice rows.
+  showcase_value_rows = {
+    "[ :is_active, :check_box ]"                       => "[ :is_active, :check_box, { 0 => 'no', 1 => 'yes' } ]",
+    "[ :gender, :radio_button ]"                       => "[ :gender, :radio_button, { 1 => 'male', 2 => 'female' } ]",
+    "[ :rating_int, :dropdown_with_integers ]"         => "[ :rating_int, :dropdown_with_integers, { 1 => 'one', 2 => 'two', 3 => 'three' } ]",
+    "[ :priority, :dropdown_with_values ]"             => "[ :priority, :dropdown_with_values, { 1 => 'low', 2 => 'mid', 3 => 'high' } ]",
+    "[ :priority2, :dropdown_with_values ]"            => "[ :priority2, :dropdown_with_values, { 1 => 'low', 2 => 'mid', 3 => 'high' }, [ 2 ] ]",
+    "[ :stars, :dropdown_with_values_with_stars ]"     => "[ :stars, :dropdown_with_values_with_stars, { 1 => '1stars', 2 => '2stars', 3 => '3stars', 4 => '4stars', 5 => '5stars' } ]",
+  }
+  showcase_value_rows.each do |from, to|
+    gsub_file "app/models/form_element_showcase.rb", from, to
+  end
+
+  # Section headers + the trailing info/info_list block. `roles` is a
+  # has_and_belongs_to_many relation so the generator skips its
+  # attribute_list row; we hand-insert it as `:info_list` (read-only
+  # checklist of role _presentation strings).
+  showcase_header_inserts = {
+    "[ :title, :text_field ],"                  => "[ :header_basics, :header ], \n     [ :title, :text_field ],",
+    "[ :count, :integer_field ],"               => "[ :header_numbers, :header ], \n     [ :count, :integer_field ],",
+    "[ :meeting_date, :date_select ],"          => "[ :header_dates, :header ], \n     [ :meeting_date, :date_select ],",
+    "[ :is_active, :check_box, { 0 => 'no'"     => "[ :header_choices, :header ], \n     [ :is_active, :check_box, { 0 => 'no'",
+    "[ :attachment, :file_field ],"             => "[ :header_files, :header ], \n     [ :attachment, :file_field ],",
+    "[ :description, :rich_text ],"             => "[ :header_rich, :header ], \n     [ :description, :rich_text ],",
+  }
+  showcase_header_inserts.each do |from, to|
+    gsub_file "app/models/form_element_showcase.rb", from, to
+  end
+
+  # Insert :roles (info_list), :header_meta, and the timestamps after
+  # the rich_text row. The generator does not emit a row for
+  # `roles:has_and_belongs_to_many` (relation? is true), so we add it
+  # manually here.
+  gsub_file "app/models/form_element_showcase.rb",
+            "[ :description, :rich_text ], \n",
+            "[ :description, :rich_text ], \n     [ :roles, :info_list ], \n     [ :header_meta, :header ], \n     [ :created_at, :info ], \n     [ :updated_at, :info ], \n"
+
+  # Locale keys for the showcase attributes. Headers + the timestamps
+  # need explicit labels so `human_attribute_name` does not fall back to
+  # "Header basics" / "Created at". The leading two-space indent puts
+  # the `activerecord:` key under the existing `en:` root.
+  showcase_locale = <<~END_SHOWCASE_LOCALE
+    activerecord:
+      attributes:
+        form_element_showcase:
+          header_basics: Basics
+          header_numbers: Numbers
+          header_dates: Dates and times
+          header_choices: Choices and scales
+          header_files: Files
+          header_rich: Rich text
+          header_meta: Metadata
+          title: Title
+          body_plain_area: Plain text area
+          count: Count
+          price: Price
+          meeting_date: Meeting date
+          meeting_time: Meeting time
+          birth_month: Birth month
+          start_month: Start month
+          is_active: Is active
+          gender: Gender
+          rating_int: Rating
+          priority: Priority
+          priority2: Priority (with disabled option)
+          stars: Stars
+          attachment: Attachment
+          jingle: Jingle
+          cover: Cover
+          description: Description
+          roles: Roles
+          created_at: Created at
+          updated_at: Updated at
+  END_SHOWCASE_LOCALE
+  append_to_file "config/locales/inline_forms_local.en.yml", showcase_locale.lines.map { |l| "  #{l}" }.join
+
+  # Star images for dropdown_with_values_with_stars. The runtime helper
+  # calls `image_tag("\#{n}stars.png")`, so we ship 5 tiny PNGs in
+  # lib/installer_templates/example_app_assets and copy them into
+  # app/assets/images at install time.
+  showcase_assets_root = File.join(INSTALLER_ROOT, "lib/installer_templates/example_app_assets")
+  (1..5).each do |n|
+    src = File.join(showcase_assets_root, "#{n}stars.png")
+    copy_file src, File.join("app/assets/images", "#{n}stars.png") if File.exist?(src)
+  end
+
+  # Join table for has_and_belongs_to_many :roles. Mirrors the
+  # roles_users join migration created for the user model above.
+  say "- Creating form_element_showcases_roles join migration..."
+  sleep 1
+  habtm_ts = Time.now.utc.strftime("%Y%m%d%H%M%S")
+  create_file "db/migrate/#{habtm_ts}_create_join_table_form_element_showcases_roles.rb", <<-HABTM_MIGRATION.strip_heredoc
+    class CreateJoinTableFormElementShowcasesRoles < ActiveRecord::Migration[8.1]
+      def self.up
+        create_table :form_element_showcases_roles, id: false, force: true do |t|
+          t.integer :form_element_showcase_id
+          t.integer :role_id
+        end
+      end
+
+      def self.down
+        drop_table :form_element_showcases_roles
+      end
+    end
+  HABTM_MIGRATION
+
+  # Seed two showcase rows: one fully populated (so every show branch
+  # has data), and one with no roles + no uploads (so info_list's empty
+  # branch and the uploader empty branches render). Idempotent.
+  say "- Creating FormElementShowcase seed migration..."
+  sleep 1
+  showcase_seed_ts = Time.now.utc.strftime("%Y%m%d%H%M%S")
+  create_file "db/migrate/#{showcase_seed_ts}_seed_form_element_showcases.rb", <<-SHOWCASE_SEED.strip_heredoc
+    class SeedFormElementShowcases < ActiveRecord::Migration[8.1]
+      def up
+        return unless defined?(FormElementShowcase)
+
+        full = FormElementShowcase.find_or_create_by!(title: "Full demo") do |s|
+          s.body_plain_area = "A short plain-text paragraph."
+          s.count           = 7
+          s.price           = "12.34"
+          s.meeting_date    = Date.new(2026, 6, 1)
+          s.meeting_time    = Time.utc(2000, 1, 1, 14, 30)
+          s.birth_month     = 7
+          s.start_month     = Date.new(2026, 9, 1)
+          s.is_active       = true
+          s.gender          = 1
+          s.rating_int      = 2
+          s.priority        = 2
+          s.priority2       = 3
+          s.stars           = 4
+          s.description     = "<p>A rich-text paragraph for the showcase.</p>"
+        end
+        if defined?(Role) && Role.exists?(1) && full.roles.empty?
+          full.roles << Role.find(1)
+        end
+
+        # "Empty" refers to the role and uploader fields (their empty
+        # branches need to render). The other fields keep valid values
+        # because several show helpers (e.g. dropdown_with_integers) raise
+        # on nil/out-of-range integers.
+        FormElementShowcase.find_or_create_by!(title: "Empty demo") do |s|
+          s.is_active  = false
+          s.gender     = 1
+          s.rating_int = 1
+          s.priority   = 1
+          s.priority2  = 1
+          s.stars      = 1
+        end
+      end
+
+      def down
+        return unless defined?(FormElementShowcase)
+        FormElementShowcase.where(title: ["Full demo", "Empty demo"]).destroy_all
+      end
+    end
+  SHOWCASE_SEED
+
+  say "- Running showcase migrations (create table + join + seed)..."
+  run "bundle exec rake db:migrate"
+
   example_views_root = File.join(INSTALLER_ROOT, "lib/installer_templates/example_app_views")
   Dir.glob(File.join(example_views_root, "**", "*")).sort.each do |abs|
     next unless File.file?(abs)

data/lib/inline_forms_installer/version.rb

@@ -1,6 +1,6 @@
 # -*- encoding : utf-8 -*-
 module InlineFormsInstaller
-  VERSION = "8.1.5"
+  VERSION = "8.1.6"
 
   # Written into generated apps' `.ruby-version` (must match gemspec `required_ruby_version`).
   TARGET_RUBY_VERSION = "ruby-4.0.4"

data/lib/installer_templates/example_app_tests/test/integration/example_app_showcase_choice_scale_fields_test.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Choice helpers on FormElementShowcase:
+#   check_box                       (is_active, 0|1)
+#   radio_button                    (gender, hash)
+#   dropdown_with_integers          (rating_int)
+#   dropdown_with_values            (priority normal + priority2 options_disabled)
+#   dropdown_with_values_with_stars (stars)
+# (scale_with_integers / scale_with_values are dropped from the showcase
+# until their runtime show helpers are repaired; see CHANGELOG 8.1.6.)
+class ExampleAppShowcaseChoiceScaleFieldsTest < ExampleAppIntegrationTestCase
+  setup do
+    @showcase = FormElementShowcase.find_or_create_by!(title: "Choice/scale demo")
+  end
+
+  def field_frame(attr)
+    "form_element_showcase_#{@showcase.id}_#{attr}"
+  end
+
+  def field_headers(attr)
+    { "Turbo-Frame" => field_frame(attr), "Accept" => "text/html" }
+  end
+
+  def underscored_param_root
+    "_form_element_showcase"
+  end
+
+  test "check_box toggles is_active from 0 to 1" do
+    @showcase.update!(is_active: false)
+    frame = field_frame(:is_active)
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "is_active",
+      form_element: "check_box",
+      update: frame
+    ), params: { is_active: 1 }, headers: field_headers(:is_active)
+
+    assert_response :success
+    assert_equal 1, @showcase.reload.is_active ? 1 : 0
+  end
+
+  test "check_box toggles is_active back to 0 when param missing" do
+    @showcase.update!(is_active: true)
+    frame = field_frame(:is_active)
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "is_active",
+      form_element: "check_box",
+      update: frame
+    ), params: {}, headers: field_headers(:is_active)
+
+    assert_response :success
+    assert_equal false, !!@showcase.reload.is_active
+  end
+
+  test "radio_button sets gender via attribute param" do
+    frame = field_frame(:gender)
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "gender",
+      form_element: "radio_button",
+      update: frame
+    ), params: { gender: 2 }, headers: field_headers(:gender)
+
+    assert_response :success
+    assert_equal 2, @showcase.reload.gender
+  end
+
+  test "dropdown_with_integers sets rating_int" do
+    frame = field_frame(:rating_int)
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "rating_int",
+      form_element: "dropdown_with_integers",
+      update: frame
+    ), params: { underscored_param_root => { rating_int: 2 } }, headers: field_headers(:rating_int)
+
+    assert_response :success
+    assert_equal 2, @showcase.reload.rating_int
+  end
+
+  test "dropdown_with_values priority round-trips" do
+    frame = field_frame(:priority)
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "priority",
+      form_element: "dropdown_with_values",
+      update: frame
+    ), params: { underscored_param_root => { priority: 3 } }, headers: field_headers(:priority)
+
+    assert_response :success
+    assert_equal 3, @showcase.reload.priority
+  end
+
+  test "dropdown_with_values priority2 disables the third option in the edit form" do
+    @showcase.update!(priority2: 1)
+    frame = field_frame(:priority2)
+    get edit_form_element_showcase_path(
+      @showcase,
+      attribute: "priority2",
+      form_element: "dropdown_with_values",
+      update: frame
+    ), headers: field_headers(:priority2)
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    # options_disabled is [2] for priority2; that option should render with `disabled`.
+    assert_match(%r{<option [^>]*disabled[^>]*value="2"|<option [^>]*value="2"[^>]*disabled}, @response.body)
+  end
+
+  test "dropdown_with_values_with_stars sets stars" do
+    frame = field_frame(:stars)
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "stars",
+      form_element: "dropdown_with_values_with_stars",
+      update: frame
+    ), params: { underscored_param_root => { stars: 5 } }, headers: field_headers(:stars)
+
+    assert_response :success
+    assert_equal 5, @showcase.reload.stars
+  end
+
+end

data/lib/installer_templates/example_app_tests/test/integration/example_app_showcase_date_time_fields_test.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Date/time-shaped Tier 1 helpers on FormElementShowcase:
+#   date_select       (meeting_date)
+#   time_select       (meeting_time)
+#   month_select      (birth_month, 1..12 integer)
+#   month_year_picker (start_month, date)
+class ExampleAppShowcaseDateTimeFieldsTest < ExampleAppIntegrationTestCase
+  setup do
+    @showcase = FormElementShowcase.find_or_create_by!(title: "Date/time demo")
+  end
+
+  test "date_select meeting_date renders datepicker on edit" do
+    frame = "form_element_showcase_#{@showcase.id}_meeting_date"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    get edit_form_element_showcase_path(
+      @showcase,
+      attribute: "meeting_date",
+      form_element: "date_select",
+      update: frame
+    ), headers: headers
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    assert_includes @response.body, %(class="datepicker")
+    assert_includes @response.body, %(name="meeting_date")
+  end
+
+  test "time_select meeting_time renders timepicker on edit" do
+    @showcase.update!(meeting_time: Time.utc(2000, 1, 1, 9, 15))
+    frame = "form_element_showcase_#{@showcase.id}_meeting_time"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    get edit_form_element_showcase_path(
+      @showcase,
+      attribute: "meeting_time",
+      form_element: "time_select",
+      update: frame
+    ), headers: headers
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    assert_includes @response.body, %(class="timepicker")
+    assert_includes @response.body, %(name="meeting_time")
+  end
+
+  test "month_select birth_month renders 12 options on edit" do
+    @showcase.update!(birth_month: 6)
+    frame = "form_element_showcase_#{@showcase.id}_birth_month"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    get edit_form_element_showcase_path(
+      @showcase,
+      attribute: "birth_month",
+      form_element: "month_select",
+      update: frame
+    ), headers: headers
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    assert_match(/<select[^>]+name="date\[birth_month\]"/, @response.body)
+  end
+
+  test "month_year_picker start_month renders datepicker class hook" do
+    @showcase.update!(start_month: Date.new(2026, 5, 1))
+    frame = "form_element_showcase_#{@showcase.id}_start_month"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    get edit_form_element_showcase_path(
+      @showcase,
+      attribute: "start_month",
+      form_element: "month_year_picker",
+      update: frame
+    ), headers: headers
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    assert_includes @response.body, %(datepicker-month-year)
+    assert_includes @response.body, %(name="start_month")
+  end
+end

data/lib/installer_templates/example_app_tests/test/integration/example_app_showcase_numeric_fields_test.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Numeric Tier 1 helpers on FormElementShowcase:
+#   integer_field   (count)        + numericality validation regression
+#   decimal_field   (price)
+# (money_field is dropped from the showcase; the runtime helper depends on
+# money-rails' `humanized_money_with_symbol`, which is not in the installer
+# Gemfile. See CHANGELOG 8.1.6 "Dropped" section.)
+class ExampleAppShowcaseNumericFieldsTest < ExampleAppIntegrationTestCase
+  setup do
+    @showcase = FormElementShowcase.find_or_create_by!(title: "Numeric demo")
+    @list_frame = "form_element_showcases_list"
+    @list_headers = { "Turbo-Frame" => @list_frame, "Accept" => "text/html" }
+  end
+
+  test "integer_field count round-trips" do
+    frame = "form_element_showcase_#{@showcase.id}_count"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "count",
+      form_element: "integer_field",
+      update: frame
+    ), params: { count: "42" }, headers: headers
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    assert_includes @response.body, "42"
+    assert_equal 42, @showcase.reload.count
+  end
+
+  test "decimal_field price round-trips" do
+    frame = "form_element_showcase_#{@showcase.id}_price"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "price",
+      form_element: "decimal_field",
+      update: frame
+    ), params: { price: "99.95" }, headers: headers
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    assert_includes @response.body, "99.95"
+    assert_equal "99.95", @showcase.reload.price
+  end
+
+  test "integer_field count rejects non-integer via top-level create" do
+    # The controller's create iterates every attribute and calls each
+    # form_element's update method. Several helpers crash on nil params:
+    #   - month_year_picker_update -> Date.parse("") raises
+    #   - dropdown_with_integers_update / dropdown_with_values{_with_stars}_update
+    #     -> params[:_form_element_showcase][:attr] dereferences nil
+    # We supply just enough to let the create walk reach the validation step.
+    assert_no_difference "FormElementShowcase.count" do
+      post form_element_showcases_path(update: @list_frame),
+           params: {
+             title: "Bad Count",
+             count: "abc",
+             start_month: "September 2026",
+             _form_element_showcase: {
+               rating_int: 1,
+               priority: 1,
+               priority2: 1,
+               stars: 1,
+             },
+           },
+           headers: @list_headers
+    end
+    assert_response :success
+    body = @response.body
+    assert_match(/is not a number|count[^<]*is not a number/i, body,
+      "expected numericality error to render after invalid count")
+  end
+end

data/lib/installer_templates/example_app_tests/test/integration/example_app_showcase_page_render_test.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Smoke test for the full FormElementShowcase show page. Covers the
+# display-only helpers (`header`, `info`, `info_list`) and the show
+# branches of every uploader helper + rich_text.
+class ExampleAppShowcasePageRenderTest < ExampleAppIntegrationTestCase
+  # All non-header attributes on FormElementShowcase that should each
+  # be wrapped in a `<turbo-frame id="form_element_showcase_<id>_<attr>">`.
+  SHOWCASE_FIELD_ATTRIBUTES = %i[
+    title
+    body_plain_area
+    count
+    price
+    meeting_date
+    meeting_time
+    birth_month
+    start_month
+    is_active
+    gender
+    rating_int
+    priority
+    priority2
+    stars
+    attachment
+    jingle
+    cover
+    description
+    roles
+    created_at
+    updated_at
+  ].freeze
+
+  SHOWCASE_HEADER_ATTRIBUTES = %i[
+    header_basics
+    header_numbers
+    header_dates
+    header_choices
+    header_files
+    header_rich
+    header_meta
+  ].freeze
+
+  setup do
+    locale = Locale.find_or_create_by!(name: "en") { |l| l.title = "English" }
+    @role = Role.find_or_create_by!(name: "superadmin") { |r| r.description = "Super Admin" }
+
+    @full = FormElementShowcase.find_or_create_by!(title: "Full demo") do |s|
+      s.body_plain_area = "Plain text body"
+      s.count           = 7
+      s.price           = "12.34"
+      s.meeting_date    = Date.new(2026, 6, 1)
+      s.meeting_time    = Time.utc(2000, 1, 1, 14, 30)
+      s.birth_month     = 7
+      s.start_month     = Date.new(2026, 9, 1)
+      s.is_active       = true
+      s.gender          = 1
+      s.rating_int      = 2
+      s.priority        = 2
+      s.priority2       = 3
+      s.stars           = 4
+      s.description     = "<p>A rich-text body.</p>"
+    end
+    @full.roles << @role unless @full.roles.where(id: @role.id).exists?
+
+    @empty = FormElementShowcase.find_or_create_by!(title: "Empty demo") do |s|
+      # Keep dropdown/scale integers at valid indices so the show helpers
+      # do not crash on nil. The point of "empty demo" is that roles and
+      # uploads are blank, not every integer attribute.
+      s.gender     = 1
+      s.rating_int = 1
+      s.priority   = 1
+      s.priority2  = 1
+      s.stars      = 1
+    end
+  end
+
+  test "full showcase show page renders every per-attribute turbo-frame" do
+    row_frame = "form_element_showcase_#{@full.id}"
+    get form_element_showcase_path(@full, update: row_frame),
+        headers: { "Turbo-Frame" => row_frame, "Accept" => "text/html" }
+
+    assert_response :success
+
+    SHOWCASE_FIELD_ATTRIBUTES.each do |attr|
+      frame = "form_element_showcase_#{@full.id}_#{attr}"
+      assert_includes @response.body, %(<turbo-frame id="#{frame}">),
+        "expected per-attribute frame for #{attr}"
+    end
+
+    SHOWCASE_HEADER_ATTRIBUTES.each do |attr|
+      label = FormElementShowcase.human_attribute_name(attr)
+      assert_includes @response.body, label,
+        "expected header label for #{attr} (#{label.inspect})"
+    end
+
+    assert_includes @response.body, @role.name,
+      "expected info_list to render the role's _presentation"
+  end
+
+  test "empty showcase info_list renders the no-roles placeholder" do
+    row_frame = "form_element_showcase_#{@empty.id}"
+    get form_element_showcase_path(@empty, update: row_frame),
+        headers: { "Turbo-Frame" => row_frame, "Accept" => "text/html" }
+
+    assert_response :success
+    frame = "form_element_showcase_#{@empty.id}_roles"
+    body = @response.body
+    assert_includes body, %(<turbo-frame id="#{frame}">)
+    frame_block = body[body.index(%(<turbo-frame id="#{frame}">"))..-1] rescue nil
+    # info_list_show emits a `--` placeholder for empty associations.
+    assert_match(/<turbo-frame id="#{frame}">[^<]*<div class='row [^']+'>--<\/div>/m, body,
+      "expected info_list empty placeholder `--` inside roles frame")
+  end
+end

data/lib/installer_templates/example_app_tests/test/integration/example_app_showcase_text_fields_test.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Round-trip the text-shaped Tier 1 helpers on FormElementShowcase:
+#   text_field           (title)
+#   plain_text_area      (body_plain_area)
+class ExampleAppShowcaseTextFieldsTest < ExampleAppIntegrationTestCase
+  setup do
+    @showcase = FormElementShowcase.find_or_create_by!(title: "TextFields demo")
+  end
+
+  test "text_field title round-trips through the field turbo-frame" do
+    frame = "form_element_showcase_#{@showcase.id}_title"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "title",
+      form_element: "text_field",
+      update: frame
+    ), params: { title: "TextFields updated" }, headers: headers
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    assert_includes @response.body, "TextFields updated"
+    assert_equal "TextFields updated", @showcase.reload.title
+  end
+
+  test "plain_text_area body round-trips through the field turbo-frame" do
+    frame = "form_element_showcase_#{@showcase.id}_body_plain_area"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    body = "Hello plain text\nMulti-line content"
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "body_plain_area",
+      form_element: "plain_text_area",
+      update: frame
+    ), params: { body_plain_area: body }, headers: headers
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    assert_includes @response.body, "Hello plain text"
+    assert_equal body, @showcase.reload.body_plain_area
+  end
+end

data/lib/installer_templates/example_app_tests/test/models/example_app_form_element_showcase_test.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+# Pins the FormElementShowcase model wiring:
+#   - plain_text columns are present (no rich_text drift)
+#   - every kept Tier 1 attribute is in the attribute list
+#   - priority2 keeps its options_disabled tuple slot (8.1.5 row shape)
+#   - integer numericality is enforced on :count
+class ExampleAppFormElementShowcaseTest < ActiveSupport::TestCase
+  EXPECTED_ATTRIBUTES = %i[
+    header_basics
+    title
+    body_plain_area
+    header_numbers
+    count
+    price
+    header_dates
+    meeting_date
+    meeting_time
+    birth_month
+    start_month
+    header_choices
+    is_active
+    gender
+    rating_int
+    priority
+    priority2
+    stars
+    header_files
+    attachment
+    jingle
+    cover
+    header_rich
+    description
+    roles
+    header_meta
+    created_at
+    updated_at
+  ].freeze
+
+  test "plain_text helper configuration validates without drift" do
+    assert_nothing_raised do
+      InlineForms.validate_plain_text_configuration_for!(FormElementShowcase)
+    end
+  end
+
+  test "inline_forms_attribute_list contains every expected attribute" do
+    keys = FormElementShowcase.new.inline_forms_attribute_list.map { |row| row.first }
+    EXPECTED_ATTRIBUTES.each do |attr|
+      assert_includes keys, attr, "expected #{attr} in inline_forms_attribute_list"
+    end
+  end
+
+  test "priority2 keeps options_disabled at tuple slot 3 (8.1.5 row shape)" do
+    row = FormElementShowcase.new.inline_forms_attribute_list.assoc(:priority2)
+    assert_not_nil row, "expected a :priority2 row"
+    assert_equal :dropdown_with_values, row[1]
+    assert_kind_of Hash, row[2]
+    assert_equal [2], row[3],
+      "expected options_disabled at index 3 (was the 8.1.5 row-shape shift)"
+  end
+
+  test "count rejects non-integer input with a numericality error" do
+    showcase = FormElementShowcase.new(title: "X", count: "abc")
+    assert_not showcase.valid?
+    assert_includes showcase.errors.attribute_names, :count
+    assert showcase.errors[:count].any? { |m| m.match?(/not a number/i) },
+      "expected `not a number` error on :count, got #{showcase.errors[:count].inspect}"
+  end
+
+  test "count accepts a valid integer" do
+    showcase = FormElementShowcase.new(title: "X", count: 5)
+    assert showcase.valid?, "expected showcase to be valid with count=5, got #{showcase.errors.full_messages.inspect}"
+  end
+
+  test "count allows blank" do
+    showcase = FormElementShowcase.new(title: "X", count: nil)
+    assert showcase.valid?, "expected showcase to be valid with count=nil (allow_blank), got #{showcase.errors.full_messages.inspect}"
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inline_forms_installer
 version: !ruby/object:Gem::Version
-  version: 8.1.5
+  version: 8.1.6
 platform: ruby
 authors:
 - Ace Suares
@@ -89,6 +89,11 @@ files:
 - lib/installer_templates/dartsass/devise_main.scss
 - lib/installer_templates/dartsass/inline_forms_dartsass_builds.rb
 - lib/installer_templates/dartsass/inline_forms_main.scss
+- lib/installer_templates/example_app_assets/1stars.png
+- lib/installer_templates/example_app_assets/2stars.png
+- lib/installer_templates/example_app_assets/3stars.png
+- lib/installer_templates/example_app_assets/4stars.png
+- lib/installer_templates/example_app_assets/5stars.png
 - lib/installer_templates/example_app_tests/test/example_app/example_integration_test_case.rb
 - lib/installer_templates/example_app_tests/test/integration/example_app_apartment_field_turbo_test.rb
 - lib/installer_templates/example_app_tests/test/integration/example_app_apartment_name_list_test.rb
@@ -104,10 +109,16 @@ files:
 - lib/installer_templates/example_app_tests/test/integration/example_app_photo_revert_test.rb
 - lib/installer_templates/example_app_tests/test/integration/example_app_photos_test.rb
 - lib/installer_templates/example_app_tests/test/integration/example_app_routing_test.rb
+- lib/installer_templates/example_app_tests/test/integration/example_app_showcase_choice_scale_fields_test.rb
+- lib/installer_templates/example_app_tests/test/integration/example_app_showcase_date_time_fields_test.rb
+- lib/installer_templates/example_app_tests/test/integration/example_app_showcase_numeric_fields_test.rb
+- lib/installer_templates/example_app_tests/test/integration/example_app_showcase_page_render_test.rb
+- lib/installer_templates/example_app_tests/test/integration/example_app_showcase_text_fields_test.rb
 - lib/installer_templates/example_app_tests/test/integration/example_app_turbo_layout_test.rb
 - lib/installer_templates/example_app_tests/test/integration/example_app_validation_hints_test.rb
 - lib/installer_templates/example_app_tests/test/models/example_app_apartment_name_validation_test.rb
 - lib/installer_templates/example_app_tests/test/models/example_app_apartment_photo_test.rb
+- lib/installer_templates/example_app_tests/test/models/example_app_form_element_showcase_test.rb
 - lib/installer_templates/example_app_tests/test/models/example_app_paper_trail_changeset_test.rb
 - lib/installer_templates/example_app_tests/test/models/example_app_plain_text_rich_text_edge_cases_test.rb
 - lib/installer_templates/example_app_views/apartments/name_list.html.erb