inline_forms 7.2.11 → 7.9.1

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

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Stock _show partial: scalar fields are wrapped in <turbo-frame> and use HTML
+# edit/update/cancel (no UJS on field links/forms). Same contract as name_list.
+class ExampleAppApartmentFieldTurboTest < ExampleAppIntegrationTestCase
+  setup do
+    @apartment = Apartment.find_or_create_by!(name: "Turbo Field Apt") do |a|
+      a.title = "Turbo Field Title"
+    end
+    @frame_id = "apartment_#{@apartment.id}_name"
+    @turbo_headers = { "Turbo-Frame" => @frame_id }
+  end
+
+  test "show panel opens as HTML inside row turbo-frame" do
+    row_frame = "apartment_#{@apartment.id}"
+    get apartment_path(@apartment, update: row_frame),
+        headers: { "Turbo-Frame" => row_frame, "Accept" => "text/html" }
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{row_frame}">)
+    assert_includes @response.body, "turbo-frame",
+      "row show should embed _show with per-field turbo-frame wrappers"
+    assert_includes @response.body, @frame_id
+  end
+
+  test "stock scalar field edit update and cancel via turbo-frame" do
+    get edit_apartment_path(
+      @apartment,
+      attribute: "name",
+      form_element: "text_field",
+      update: @frame_id
+    ), headers: @turbo_headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{@frame_id}">)
+    refute_includes @response.body, 'data-remote="true"'
+
+    put apartment_path(
+      @apartment,
+      attribute: "name",
+      form_element: "text_field",
+      update: @frame_id
+    ), params: { name: "Stock Turbo Name" }, headers: @turbo_headers
+    assert_response :success
+    assert_includes @response.body, "Stock Turbo Name"
+    assert_equal "Stock Turbo Name", @apartment.reload.name
+
+    get apartment_path(
+      @apartment,
+      attribute: "name",
+      form_element: "text_field",
+      update: @frame_id
+    ), headers: @turbo_headers
+    assert_response :success
+    assert_includes @response.body, "Stock Turbo Name"
+    refute_includes @response.body, 'name="name"',
+      "cancel returns read-only field, not edit form"
+  end
+
+  test "field show cancel responds to html even without Turbo-Frame header" do
+    get apartment_path(
+      @apartment,
+      attribute: "name",
+      form_element: "text_field",
+      update: @frame_id
+    ), headers: { "Accept" => "text/html, application/xhtml+xml" }
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{@frame_id}">)
+    assert_includes @response.body, @apartment.name
+  end
+end

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

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Custom page demo: same turbo-field contract as stock _show, without opening the panel.
+class ExampleAppApartmentNameListTest < ExampleAppIntegrationTestCase
+  setup do
+    @apartments = 10.times.map do |i|
+      Apartment.find_or_create_by!(name: "NameList Apt #{i}") do |a|
+        a.title = "Title #{i}"
+      end
+    end
+  end
+
+  test "name list page is reachable and renders turbo-frame inline-edit targets for first 10 apartments" do
+    get apartment_name_list_path
+    assert_response :success
+
+    Apartment.order(:id).limit(10).each do |apartment|
+      assert_includes @response.body, %(<turbo-frame id="apartment_#{apartment.id}_name">),
+        "expected turbo-frame wrapper for apartment #{apartment.id}"
+      assert_includes @response.body, apartment.name,
+        "expected apartment name on page"
+    end
+  end
+
+  test "more menu links to apartment name list" do
+    get apartments_path
+    assert_response :success
+    assert_includes @response.body, apartment_name_list_path,
+      "expected More menu link to name list"
+    assert_includes @response.body, "Apartment names (first 10)"
+  end
+
+  test "name list field links use turbo-frame navigation not UJS remote" do
+    apartment = @apartments.first
+    get apartment_name_list_path
+    assert_response :success
+
+    frame_html = @response.body[%r{<turbo-frame id="apartment_#{apartment.id}_name">.*?</turbo-frame>}m]
+    assert frame_html, "expected turbo-frame for apartment #{apartment.id}"
+    assert_match(
+      %r/href="[^"]*\/apartments\/#{apartment.id}\/edit[^"]*update=apartment_#{apartment.id}_name[^"]*"/,
+      frame_html,
+      "expected edit link with update= matching turbo-frame id"
+    )
+    refute_includes frame_html, 'data-remote="true"',
+      "field edits use Turbo frames, not UJS"
+  end
+
+  test "name list reuses stock turbo field edit update cycle" do
+    apartment = @apartments.first
+    frame_id = "apartment_#{apartment.id}_name"
+    turbo_headers = { "Turbo-Frame" => frame_id }
+
+    get edit_apartment_path(
+      apartment,
+      attribute: "name",
+      form_element: "text_field",
+      update: frame_id
+    ), headers: turbo_headers
+    assert_response :success
+
+    put apartment_path(
+      apartment,
+      attribute: "name",
+      form_element: "text_field",
+      update: frame_id
+    ), params: { name: "Name List Turbo" }, headers: turbo_headers
+    assert_response :success
+    assert_equal "Name List Turbo", apartment.reload.name
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+class ExampleAppApartmentNameRequiredTest < ExampleAppIntegrationTestCase
+  setup do
+    @frame = "apartments_list"
+    @frame_headers = { "Turbo-Frame" => @frame, "Accept" => "text/html" }
+  end
+
+  test "top-level create without name does not persist" do
+    assert_no_difference("Apartment.count") do
+      post apartments_path(update: @frame),
+        params: { title: "Missing name" },
+        headers: @frame_headers
+    end
+    assert_response :success
+    assert_includes @response.body, 'name="name"'
+    assert_includes @response.body, 'class="edit_form"'
+  end
+end

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

@@ -197,7 +197,7 @@ class ExampleAppApartmentPhotosPaginationTest < ExampleAppIntegrationTestCase
     )
   end
 
-  test "row container opts out of Turbo so swapped-in UJS forms (replace photo etc.) keep working" do
+  test "nested photo rows are turbo-framed with Turbo presentation links (no data-turbo false on row)" do
     get photos_path(
       parent_class: "Apartment",
       parent_id: @apartment.id,
@@ -206,23 +206,235 @@ class ExampleAppApartmentPhotosPaginationTest < ExampleAppIntegrationTestCase
     )
     assert_response :success
 
-    # The container-level opt-out is what protects the inline-edit /
-    # replace-photo flow: when a user replaces a photo, show.js.erb /
-    # edit.js.erb does $('#<row_id>').html(<form>), so the multipart
-    # form that submits the upload is a descendant of this row. With
-    # data-turbo="false" on the row, Turbo doesn't intercept that
-    # submission -- jquery-ujs + remotipart do, the request goes out
-    # with Accept: text/javascript, and the controller's format.js
-    # branch handles it. Without this, Turbo Frames would send
-    # Accept: text/html and the update action (no format.html for
-    # not_accessible_through_html? models like Photo) raises
-    # UnknownFormat AFTER the DB write -- a 406 with a corrupted UI.
     sample_row_id = "apartment_#{@apartment.id}_photo_#{@apartment.photos.first.id}"
     assert_match(
-      %r{<div[^>]+id="#{Regexp.escape(sample_row_id)}"[^>]*data-turbo="false"|<div[^>]+data-turbo="false"[^>]*id="#{Regexp.escape(sample_row_id)}"},
+      %r{<turbo-frame[^>]*\bid="#{Regexp.escape(sample_row_id)}"},
       @response.body,
-      "expected the per-row container (id=\"#{sample_row_id}\") to carry data-turbo=\"false\" " \
-      "so swapped-in UJS forms inherit the Turbo opt-out"
+      "expected each nested photo row to be a <turbo-frame id=\"#{sample_row_id}\">"
     )
+    refute_match(
+      %r{<turbo-frame[^>]*id="#{Regexp.escape(sample_row_id)}"[^>]*data-turbo="false"},
+      @response.body,
+      "nested turbo-frame rows must not opt out of Turbo (field cancel / pagination live inside frames)"
+    )
+    assert_select %(turbo-frame##{sample_row_id} a[data-turbo='true'][data-turbo-frame='#{sample_row_id}']), minimum: 1
+  end
+
+  test "nested Photo versions restore targets nested row turbo-frame not bare photo id" do
+    photo = @apartment.photos.first!
+    original_name = photo.name
+    photo.update!(name: "#{original_name}-changed")
+    row_id = "apartment_#{@apartment.id}_photo_#{photo.id}"
+    versions_frame = "photo_#{photo.id}_versions"
+    version = photo.versions.where(event: "update").order(:id).last
+    assert version, "expected an update version to revert"
+
+    get list_versions_photo_path(photo, update: versions_frame),
+        headers: { "Turbo-Frame" => versions_frame, "Accept" => "text/html" }
+    assert_response :success
+    assert_includes @response.body, "data-turbo-frame=\"#{row_id}\"",
+      "restore must target the nested row frame (#{row_id}), not photo_#{photo.id}"
+
+    # 7.9.0: revert always responds with turbo-stream (the legacy
+    # `format.html` fallback was dropped).
+    post revert_photo_path(version.id, update: row_id),
+         headers: {
+           "Turbo-Frame" => versions_frame,
+           "Accept" => "text/vnd.turbo-stream.html"
+         }
+    assert_response :success
+    assert_includes @response.body, %(action="replace")
+    assert_includes @response.body, %(target="#{row_id}")
+    assert_equal original_name, photo.reload.name
+  end
+
+  test "nested Photo row opens and closes via Turbo HTML (not_accessible_through_html model)" do
+    photo = @apartment.photos.first!
+    row_id = "apartment_#{@apartment.id}_photo_#{photo.id}"
+    row_headers = { "Turbo-Frame" => row_id, "Accept" => "text/html" }
+
+    get photo_path(photo, update: row_id), headers: row_headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{row_id}">)
+    assert_includes @response.body, "object_presentation"
+
+    get photo_path(photo, update: row_id, close: true), headers: row_headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{row_id}">)
+    refute_includes @response.body, "object_presentation"
+  end
+
+  test "nested Photo name field cancel returns field show HTML (Turbo)" do
+    photo = @apartment.photos.first!
+    frame_id = "apartment_#{@apartment.id}_photo_#{photo.id}_name"
+    turbo_headers = { "Turbo-Frame" => frame_id, "Accept" => "text/html" }
+
+    get edit_photo_path(
+      photo,
+      attribute: "name",
+      form_element: "text_field",
+      update: frame_id
+    ), headers: turbo_headers
+    assert_response :success
+
+    get photo_path(
+      photo,
+      attribute: "name",
+      form_element: "text_field",
+      update: frame_id
+    ), headers: turbo_headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame_id}">)
+    refute_includes @response.body, 'name="name"',
+      "cancel must return read-only field, not the edit form"
+  end
+
+  # Step 3 (ujs-to-turbo.md): nested `not_accessible_through_html?` Photo + CarrierWave
+  # `image` must accept Turbo-driven multipart PUT inside the field `<turbo-frame>`
+  # (no `UnknownFormat` / 406 after DB write — regression class from 7.2.0).
+  test "nested Photo image field updates via Turbo multipart PUT inside field frame" do
+    photo = @apartment.photos.first!
+    frame_id = "apartment_#{@apartment.id}_photo_#{photo.id}_image"
+    turbo_headers = { "Turbo-Frame" => frame_id, "Accept" => "text/html" }
+
+    get edit_photo_path(
+      photo,
+      attribute: "image",
+      form_element: "image_field",
+      update: frame_id
+    ), headers: turbo_headers
+    assert_response :success
+    assert_includes @response.body, %(enctype="multipart/form-data"),
+      "image edit form must stay multipart when Turbo omits remote: true"
+    assert_includes @response.body, %(<turbo-frame id="#{frame_id}">)
+
+    seed_dir = Rails.root.join("db", "seed_images")
+    jpgs = Dir.glob(seed_dir.join("*.{jpg,jpeg}"), File::FNM_CASEFOLD).sort
+    assert_operator jpgs.size, :>=, 2,
+      "need at least two seed jpgs so replacement can differ from current mount"
+
+    replacement = jpgs.find { |abs| File.basename(abs) != photo.name } || jpgs.last
+    uploaded = Rack::Test::UploadedFile.new(replacement, "image/jpeg")
+
+    put photo_path(
+      photo,
+      attribute: "image",
+      form_element: "image_field",
+      update: frame_id
+    ),
+        params: { image: uploaded },
+        headers: turbo_headers
+
+    assert_response :success,
+      "multipart image update must respond with HTML (not 406 UnknownFormat)"
+    assert_includes @response.body, %(<turbo-frame id="#{frame_id}">)
+    refute_match(/UnknownFormat|406/, @response.body)
+
+    photo.reload
+    assert photo.image.present?, "expected CarrierWave mount after Turbo multipart PUT"
+  end
+
+  # 7.5.2 regression: after cancel / update on a field, the swapped
+  # `<turbo-frame id="…">` must contain a Turbo link
+  # (`data-turbo="true" data-turbo-frame="_self"`) so the user can re-open
+  # the editor. 7.5.1 emitted `data-remote="true"`, which jquery_ujs
+  # intercepts as a JS request the controller does not register, so the
+  # second click silently fails (no swap, no edit form).
+  test "nested Photo image field show after update has Turbo (not data-remote) link" do
+    photo = @apartment.photos.first!
+    frame_id = "apartment_#{@apartment.id}_photo_#{photo.id}_image"
+    turbo_headers = { "Turbo-Frame" => frame_id, "Accept" => "text/html" }
+
+    seed_dir = Rails.root.join("db", "seed_images")
+    jpgs = Dir.glob(seed_dir.join("*.{jpg,jpeg}"), File::FNM_CASEFOLD).sort
+    replacement = jpgs.find { |abs| File.basename(abs) != photo.name } || jpgs.last
+    uploaded = Rack::Test::UploadedFile.new(replacement, "image/jpeg")
+
+    put photo_path(
+      photo,
+      attribute: "image",
+      form_element: "image_field",
+      update: frame_id
+    ),
+        params: { image: uploaded },
+        headers: turbo_headers
+    assert_response :success
+    refute_match(
+      /data-remote="true"/,
+      @response.body,
+      "field_show after Turbo update must use Turbo data attributes; " \
+      "data-remote=\"true\" hits jquery_ujs (no JS responder) and the " \
+      "second click silently fails."
+    )
+    assert_match(
+      /data-turbo="true"/,
+      @response.body,
+      "expected Turbo data attribute on the inline-edit link inside the swapped field frame"
+    )
+  end
+
+  # Same regression on the cancel path (no DB write): clicking the field
+  # cancel returns the read-only field; the link inside must be a Turbo link
+  # so the user can re-open the editor.
+  test "nested Photo image field show after cancel has Turbo (not data-remote) link" do
+    photo = @apartment.photos.first!
+    frame_id = "apartment_#{@apartment.id}_photo_#{photo.id}_image"
+    turbo_headers = { "Turbo-Frame" => frame_id, "Accept" => "text/html" }
+
+    get photo_path(
+      photo,
+      attribute: "image",
+      form_element: "image_field",
+      update: frame_id
+    ), headers: turbo_headers
+    assert_response :success
+    refute_match(/data-remote="true"/, @response.body,
+      "cancel-side field_show must not regress to UJS data-remote=\"true\"")
+    assert_match(/data-turbo="true"/, @response.body)
+  end
+
+  test "nested Photo new cancel and create via Turbo inside associated list frame" do
+    frame = "apartment_#{@apartment.id}_photos"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    get new_photo_path(update: frame, parent_class: "Apartment", parent_id: @apartment.id),
+        headers: headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    assert_includes @response.body, "stylesheet", "new form must use inline_forms layout (styled)"
+    assert_includes @response.body, %(enctype="multipart/form-data")
+    assert_includes @response.body, 'class="edit_form"'
+    assert_includes @response.body, 'name="name"'
+
+    get photos_path(
+      parent_class: "Apartment",
+      parent_id: @apartment.id,
+      update: frame,
+      ul_needed: true
+    ), headers: headers
+    assert_response :success
+    assert_match %r{<turbo-frame id="#{frame}"}, @response.body
+    assert_match %r{<turbo-frame id="#{@update_span}"}, @response.body
+
+    seed = Rails.root.join("db/seed_images/dsc00099.jpg")
+    uploaded = Rack::Test::UploadedFile.new(seed, "image/jpeg")
+
+    assert_difference("Photo.count", 1) do
+      post photos_path(
+        update: frame,
+        parent_class: "Apartment",
+        parent_id: @apartment.id
+      ),
+           params: {
+             name: "curl_new_photo.jpg",
+             caption: "from turbo test",
+             image: uploaded
+           },
+           headers: headers
+    end
+    assert_response :success
+    assert_match %r{<turbo-frame id="#{frame}"}, @response.body
+    assert_match %r{<turbo-frame id="#{@update_span}"}, @response.body
+    assert_includes @response.body, "curl_new_photo.jpg"
   end
 end

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

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Stock `/apartments` index: each row is `<turbo-frame id="apartment_<id>">`;
+# opening/closing the inline panel uses Turbo GET `show` + `close` (HTML), not UJS.
+class ExampleAppApartmentRowTurboTest < ExampleAppIntegrationTestCase
+  setup do
+    @apartment = Apartment.first || Apartment.create!(name: "Row Turbo Apt", title: "T")
+    @row_frame = "apartment_#{@apartment.id}"
+    @row_headers = { "Turbo-Frame" => @row_frame, "Accept" => "text/html" }
+  end
+
+  test "apartments index wraps each row in a turbo-frame" do
+    get apartments_path
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{@row_frame}">),
+      "expected top-level list row inside turbo-frame"
+  end
+
+  test "row presentation link uses turbo navigation not UJS remote" do
+    get apartments_path
+    assert_response :success
+    assert_select "turbo-frame##{@row_frame} div.small-11.column > a", count: 1 do |elements|
+      el = elements.first
+      assert_equal "true", el["data-turbo"]
+      assert_equal @row_frame, el["data-turbo-frame"]
+      assert_nil el["data-remote"]
+    end
+  end
+
+  test "row open show returns full panel inside matching turbo-frame" do
+    get apartment_path(@apartment, update: @row_frame), headers: @row_headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{@row_frame}">)
+    assert_includes @response.body, "object_presentation",
+      "expected expanded _show panel"
+  end
+
+  test "row close returns collapsed row inside matching turbo-frame" do
+    get apartment_path(@apartment, update: @row_frame, close: true), headers: @row_headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{@row_frame}">)
+    refute_includes @response.body, "object_presentation",
+      "expected _close row, not full panel"
+  end
+
+  test "row close responds to html without Turbo-Frame header" do
+    get apartment_path(
+      @apartment,
+      update: @row_frame,
+      close: true
+    ), headers: { "Accept" => "text/html, application/xhtml+xml" }
+
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{@row_frame}">)
+  end
+
+  test "row toolbar trash and destroy links use Turbo not UJS remote" do
+    get apartments_path
+    assert_response :success
+    assert_select "turbo-frame##{@row_frame} a[data-turbo='true'][data-turbo-frame='#{@row_frame}']", minimum: 1
+    refute_select "turbo-frame##{@row_frame} a[data-remote='true']"
+  end
+
+  test "destroy via Turbo DELETE returns undo inside matching turbo-frame" do
+    doomed = Apartment.create!(name: "Turbo Destroy Me", title: "X")
+    frame = "apartment_#{doomed.id}"
+    headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    delete apartment_path(doomed, update: frame), headers: headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{frame}">)
+    assert_includes @response.body, "undo"
+    assert_not Apartment.exists?(doomed.id)
+  end
+
+  test "revert via Turbo POST restores row as collapsed turbo-frame" do
+    doomed = Apartment.create!(name: "Turbo Revert Me", title: "Y")
+    apt_id = doomed.id
+    frame = "apartment_#{apt_id}"
+    delete_headers = { "Turbo-Frame" => frame, "Accept" => "text/html" }
+
+    delete apartment_path(doomed, update: frame), headers: delete_headers
+    assert_response :success
+
+    # 7.9.0 dropped the `format.html` fallback in `revert`; restore links
+    # always request a turbo-stream now (the response replaces both the
+    # row and the versions panel in one stream).
+    versions_frame = "#{frame}_versions"
+    destroy_version = PaperTrail::Version.where(item_type: "Apartment", item_id: apt_id).order(:id).last
+    post revert_apartment_path(destroy_version.id, update: frame),
+         headers: {
+           "Turbo-Frame" => versions_frame,
+           "Accept" => "text/vnd.turbo-stream.html"
+         }
+    assert_response :success
+    assert Apartment.where(name: "Turbo Revert Me").exists?
+    assert_includes @response.body, %(action="replace")
+    assert_includes @response.body, %(target="#{frame}")
+    assert_includes @response.body, %(target="#{versions_frame}")
+  end
+end

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

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Step 4: top-level `/apartments` list, +new, cancel, and create use Turbo Frames
+# (`<turbo-frame id="apartments_list">`) instead of UJS + new.js.erb / list.js.erb.
+class ExampleAppApartmentTopLevelNewTest < ExampleAppIntegrationTestCase
+  setup do
+    @frame = "apartments_list"
+    @frame_headers = { "Turbo-Frame" => @frame, "Accept" => "text/html" }
+    @apartment = Apartment.find_or_create_by!(name: "Top Level List Apt") do |a|
+      a.title = "Top level list seed"
+    end
+  end
+
+  test "top-level apartments index wraps list in turbo-frame" do
+    get apartments_path
+    assert_response :success
+    assert_match(
+      %r{<turbo-frame[^>]+id="#{Regexp.escape(@frame)}"[^>]*class="list_container"},
+      @response.body
+    )
+    refute_match(
+      %r{<div[^>]+id="#{Regexp.escape(@frame)}"[^>]*class="list_container"},
+      @response.body,
+      "list root must be turbo-frame, not legacy div"
+    )
+  end
+
+  test "top-level + new link uses Turbo not UJS remote" do
+    get apartments_path
+    assert_response :success
+    assert_match(
+      %r{<a [^>]*class="button new_button"[^>]*data-turbo="true"[^>]*data-turbo-frame="#{Regexp.escape(@frame)}"[^>]*href="/apartments/new\?update=apartments_list"},
+      @response.body
+    )
+    refute_match(
+      %r{<a [^>]*class="button new_button"[^>]*data-remote="true"},
+      @response.body
+    )
+  end
+
+  test "top-level new returns new form inside matching turbo-frame" do
+    get new_apartment_path(update: @frame), headers: @frame_headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{@frame}">)
+    assert_includes @response.body, 'name="name"'
+    assert_includes @response.body, 'class="edit_form"'
+    refute_includes @response.content_type.to_s, "javascript"
+  end
+
+  test "top-level cancel returns list inside matching turbo-frame" do
+    get apartments_path(update: @frame, ul_needed: true), headers: @frame_headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{@frame}")
+    assert_includes @response.body, "<turbo-frame id=\"apartment_"
+  end
+
+  test "top-level create via Turbo persists and returns the list frame" do
+    name = "TopLevelNewApt-#{SecureRandom.hex(4)}"
+    assert_difference("Apartment.count", 1) do
+      post apartments_path(update: @frame),
+        params: { name: name, title: "Top level new test" },
+        headers: @frame_headers
+    end
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{@frame}">)
+    assert_includes @response.body, name
+  end
+end

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

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative "../example_app/example_integration_test_case"
+
+# Step 4: top-level index pagination swaps `<turbo-frame id="apartments_list">`.
+class ExampleAppApartmentTopLevelPaginationTest < ExampleAppIntegrationTestCase
+  setup do
+    @frame = "apartments_list"
+    @frame_headers = { "Turbo-Frame" => @frame, "Accept" => "text/html" }
+    @original_per_page = Apartment.per_page
+    Apartment.per_page = 3
+    6.times do |i|
+      Apartment.find_or_create_by!(name: "Paginate Apt #{i}") do |a|
+        a.title = "Pagination seed #{i}"
+      end
+    end
+  end
+
+  teardown do
+    Apartment.per_page = @original_per_page
+  end
+
+  test "top-level pagination links target apartments_list frame id" do
+    get apartments_path
+    assert_response :success
+    assert_match %r{class="pagination"}, @response.body
+    assert_match(
+      /update=apartments_list/,
+      @response.body,
+      "pagination must pass update=apartments_list for Turbo frame swap"
+    )
+  end
+
+  test "top-level page 2 returns matching turbo-frame with Turbo-Frame header" do
+    get apartments_path(page: 2, update: @frame, ul_needed: true), headers: @frame_headers
+    assert_response :success
+    assert_includes @response.body, %(<turbo-frame id="#{@frame}")
+    refute_match(/id="outer_container"/, @response.body)
+  end
+end