inline_forms_installer 8.1.5 → 8.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ebb695af4c902a20604e51deb4fc8a2eefaf32e625cf86805633ffd65e048d4
-  data.tar.gz: 1b630b3fc3f578fbde245ec2957c9cedc60c0dc27cf28d506b56a41361fb9d5c
+  metadata.gz: 1db2a592daf12e0ddf1b93c67469f400540e58a81b8ca96ee516dccb7a03dc20
+  data.tar.gz: 4e5abd3355753c8f09d79e16431007a0b268066e1106330c4251649262f92fe2
 SHA512:
-  metadata.gz: 50c22db56f53d41b37f9aaffb44298478a707fbd8f36d962a280e8d952f1c77a25306f6c9e2ecd10f59b825807ced7f172c6dfa547d613efa3569cee6c3e88ec
-  data.tar.gz: 1c4b64a00674ca2096c1b40c2f48f7bed3c2bd696f0fdf0cd295c6f7df093b244047040e2b07059c42364dd26e842040218973ea002324aafc6780a388ed7d62
+  metadata.gz: 92c4c50ca28769e76767bcc11fc74c742520386cddf55c4559133b95251161dd71d28e2a9e8d3fbddde62b95d9adf6e72f5666b7893ae9f94374132d66af37b6
+  data.tar.gz: d71c002620d3959812057383f6714eb01f9863370351d4436cf419e4b7a2ece6f78a2848ca057209fe6b68956fe42e04bdcd1f75731d6880c06d06b960f358b2

data/lib/inline_forms_installer/installer_core.rb

@@ -105,6 +105,13 @@ gem 'jquery-ui-rails', '4.0.3'
 # Foundation Icons SCSS + fonts are vendored in the inline_forms engine (Dart Sass;
 # foundation-icons-sass-rails depended on sass-rails).
 gem 'mini_magick'
+# money-rails powers the `money_field` Tier 1 helper:
+#   * adds the `humanized_money_with_symbol` view helper used by
+#     money_field_show
+#   * exposes `monetize :foo_cents` so an integer `_cents` column is
+#     read/written as a Money instance through `obj.foo`
+# Used by FormElementShowcase#amount in the --example app.
+gem 'money-rails', '~> 3.0'
 gem 'mysql2'
 gem 'paper_trail', '~> 17.0'
 gem 'rails-i18n', '~> 8.1'
@@ -1039,6 +1046,239 @@ 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 amount:money_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 scale_int:scale_with_integers scale_val:scale_with_values 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"
+
+  # money-rails wiring for the `amount:money_field` showcase column.
+  #
+  #   * The inline_forms generator emits a plain `t.integer :amount`
+  #     (FormElementRegistry maps `:money_field` to `:integer`), but
+  #     money-rails' `monetize` reader/writer convention is `_cents`-
+  #     suffixed: declare `monetize :amount_cents`, store cents in
+  #     `amount_cents`, and money-rails defines `obj.amount`/`obj.amount=`
+  #     returning/parsing Money objects. That keeps the inline_forms
+  #     attribute list entry `[:amount, :money_field]` semantically
+  #     correct (`obj.amount` => Money) without a custom helper.
+  #   * Rename the column in the generated create-table migration from
+  #     `:amount` to `:amount_cents` *before* `rake db:migrate` runs.
+  #   * Add a small initializer pinning the default currency so the
+  #     showcase renders predictably under any host locale.
+  showcase_migration = Dir.glob("db/migrate/*_inline_forms_create_form_element_showcases.rb").first
+  if showcase_migration
+    gsub_file showcase_migration, /t\.integer :amount\b/, "t.integer :amount_cents, default: 0, null: false"
+  end
+
+  create_file "config/initializers/money.rb", <<-MONEY_INIT.strip_heredoc
+    # Generated by inline_forms (money-rails defaults for the
+    # FormElementShowcase `amount:money_field` demo column).
+    MoneyRails.configure do |config|
+      config.default_currency = :usd
+    end
+  MONEY_INIT
+
+  # 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  monetize :amount_cents\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' } ]",
+    "[ :scale_int, :scale_with_integers ]"             => "[ :scale_int, :scale_with_integers, { 1 => 'one', 2 => 'two', 3 => 'three', 4 => 'four', 5 => 'five' } ]",
+    "[ :scale_val, :scale_with_values ]"               => "[ :scale_val, :scale_with_values, { 1 => 'red', 2 => 'green', 3 => 'blue' } ]",
+  }
+  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
+          amount: Amount
+          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
+          scale_int: Scale (integers)
+          scale_val: Scale (values)
+          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.amount          = Money.from_amount(99.95, "USD") if s.respond_to?(:amount=)
+          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.scale_int       = 3
+          s.scale_val       = 2
+          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
+          s.scale_int  = 1
+          s.scale_val  = 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.8"
 
   # 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,152 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Choice/scale 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_int)
+#   scale_with_values               (scale_val)
+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
+
+  test "scale_with_integers scale_int round-trips" do
+    frame = field_frame(:scale_int)
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "scale_int",
+      form_element: "scale_with_integers",
+      update: frame
+    ), params: { underscored_param_root => { scale_int: 4 } }, headers: field_headers(:scale_int)
+
+    assert_response :success
+    assert_equal 4, @showcase.reload.scale_int
+  end
+
+  test "scale_with_values scale_val round-trips" do
+    frame = field_frame(:scale_val)
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "scale_val",
+      form_element: "scale_with_values",
+      update: frame
+    ), params: { underscored_param_root => { scale_val: 3 } }, headers: field_headers(:scale_val)
+
+    assert_response :success
+    assert_equal 3, @showcase.reload.scale_val
+  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,99 @@
+# 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     (amount, money-rails `monetize :amount_cents`)
+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 "money_field amount round-trips through monetize :amount_cents" do
+    skip "money-rails monetize not configured" unless FormElementShowcase.respond_to?(:monetized_attributes) &&
+      FormElementShowcase.monetized_attributes.key?("amount")
+
+    frame = "form_element_showcase_#{@showcase.id}_amount"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    put form_element_showcase_path(
+      @showcase,
+      attribute: "amount",
+      form_element: "money_field",
+      update: frame
+    ), params: { amount: "12.34" }, headers: headers
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    reloaded = @showcase.reload
+    assert_equal 1234, reloaded.amount_cents,
+      "expected monetize to parse '12.34' into 1234 cents, got #{reloaded.amount_cents.inspect}"
+  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 used to crash on nil
+    # params (month_year_picker_update, scale_*_update, dropdown_*_update)
+    # so we supply just enough to let the create walk reach validation.
+    assert_no_difference "FormElementShowcase.count" do
+      post form_element_showcases_path(update: @list_frame),
+           params: {
+             title: "Bad Count",
+             count: "abc",
+             amount: "0.00",
+             start_month: "September 2026",
+             _form_element_showcase: {
+               rating_int: 1,
+               priority: 1,
+               priority2: 1,
+               stars: 1,
+               scale_int: 1,
+               scale_val: 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,124 @@
+# 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
+    amount
+    meeting_date
+    meeting_time
+    birth_month
+    start_month
+    is_active
+    gender
+    rating_int
+    priority
+    priority2
+    stars
+    scale_int
+    scale_val
+    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.scale_int       = 3
+      s.scale_val       = 2
+      s.amount          = Money.from_amount(99.95, "USD") if s.respond_to?(:amount=) && defined?(Money)
+      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
+      s.scale_int  = 1
+      s.scale_val  = 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,84 @@
+# 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
+    amount
+    header_dates
+    meeting_date
+    meeting_time
+    birth_month
+    start_month
+    header_choices
+    is_active
+    gender
+    rating_int
+    priority
+    priority2
+    stars
+    scale_int
+    scale_val
+    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.8
 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