plutonium 0.54.0 → 0.55.0

data/lib/plutonium/ui/form/concerns/renders_structured_inputs.rb

@@ -0,0 +1,178 @@
+# frozen_string_literal: true
+
+module Plutonium
+  module UI
+    module Form
+      module Concerns
+        # Renders classless structured inputs (single → hash via nest_one,
+        # repeater → array via nest_many). Field/namespace work is delegated to
+        # the form; this concern owns the structural markup.
+        # @api private
+        module RendersStructuredInputs
+          extend ActiveSupport::Concern
+
+          private
+
+          def render_structured_input(name)
+            entry = resource_definition.defined_structured_inputs[name]
+            options = entry[:options] || {}
+            definition = structured_input_fields_definition(entry)
+            fields = options[:fields] || definition.defined_inputs.keys
+            repeat = options[:repeat]
+
+            if repeat
+              render_structured_repeater(name, definition, fields, repeat_limit(repeat))
+            else
+              render_structured_single(name, definition, fields)
+            end
+          end
+
+          def structured_input_fields_definition(entry)
+            return entry[:options][:using] if entry[:options]&.key?(:using)
+
+            holder = Plutonium::Definition::StructuredInputs::FieldsDefinition.new
+            entry[:block].call(holder)
+            holder
+          end
+
+          def repeat_limit(repeat)
+            repeat.is_a?(Integer) ? repeat : RepeaterFieldStyles::DEFAULT_LIMIT
+          end
+
+          # --- single -------------------------------------------------------
+
+          def render_structured_single(name, definition, fields)
+            raw = structured_input_value(name)
+            value = raw.is_a?(Hash) ? raw.with_indifferent_access : {}
+            div(class: "col-span-full space-y-2 my-4") do
+              h2(class: "text-lg font-semibold text-[var(--pu-text)]") { name.to_s.humanize }
+              nest_one(name, as: name, object: value) do |nested|
+                render_structured_fieldset(nested, definition, fields, removable: false)
+              end
+            end
+          end
+
+          # --- repeater -----------------------------------------------------
+
+          def render_structured_repeater(name, definition, fields, limit)
+            rows = Array(structured_input_value(name)).map { |row| row.is_a?(Hash) ? row.with_indifferent_access : row }
+            existing_collection = rows.presence || {NEW_RECORD: {}}
+            div(
+              class: "col-span-full space-y-2 my-4",
+              data: {
+                controller: "nested-resource-form-fields",
+                nested_resource_form_fields_limit_value: limit
+              }
+            ) do
+              h2(class: "text-lg font-semibold text-[var(--pu-text)]") { name.to_s.humanize }
+              template data_nested_resource_form_fields_target: "template" do
+                nest_many(name, as: name, collection: {NEW_RECORD: {}}, default: {NEW_RECORD: {}}, template: true) do |nested|
+                  render_structured_fieldset(nested, definition, fields, removable: true)
+                end
+              end
+              nest_many(name, as: name, collection: existing_collection) do |nested|
+                if nested.object.blank?
+                  vanish { render_structured_fieldset(nested, definition, fields, removable: true) }
+                else
+                  render_structured_fieldset(nested, definition, fields, removable: true)
+                end
+              end
+              div(data_nested_resource_form_fields_target: :target, hidden: true)
+              render_structured_add_button(name)
+            end
+          end
+
+          # --- helpers ------------------------------------------------------
+
+          def structured_input_value(name)
+            obj = object
+            return nil unless obj.respond_to?(name)
+            obj.public_send(name)
+          end
+
+          # Single source of truth shared with RendersNestedResourceFields.
+          FIELDSET_CLASS = RepeaterFieldStyles::FIELDSET_CLASS
+          FIELD_GRID_CLASS = RepeaterFieldStyles::FIELD_GRID_CLASS
+
+          # @param removable [Boolean] repeater rows are removable; a single
+          #   structured input is the one-and-only object, so it is not.
+          def render_structured_fieldset(nested, definition, fields, removable:)
+            unless removable
+              return fieldset(class: FIELDSET_CLASS) do
+                div(class: FIELD_GRID_CLASS) do
+                  fields.each { |input| render_simple_resource_field(input, definition, nested) }
+                end
+              end
+            end
+
+            # Removable rows soft-delete by DISABLING the inner fieldset: a
+            # disabled <fieldset> is omitted from submission, so the server just
+            # receives the payload without this row and rebuilds the JSON column
+            # from what it gets (no _destroy marker). The row stays in the DOM,
+            # collapsed to a "Removed — Restore" bar, so it can be restored.
+            div(data_controller: "structured-input-row", class: FIELDSET_CLASS) do
+              fieldset(data_structured_input_row_target: "content", class: "space-y-4 border-0 p-0 m-0") do
+                div(class: FIELD_GRID_CLASS) do
+                  fields.each { |input| render_simple_resource_field(input, definition, nested) }
+                end
+                render_structured_remove_button
+              end
+              render_structured_removed_bar
+            end
+          end
+
+          def render_structured_remove_button
+            div(class: "flex items-center justify-end") do
+              button(
+                type: :button,
+                class: "inline-flex items-center gap-1 px-3 py-1.5 text-sm font-medium rounded-lg cursor-pointer " \
+                       "text-danger-700 hover:bg-danger-50 dark:text-danger-400 dark:hover:bg-danger-950/30 " \
+                       "focus:outline-none focus:ring-4 focus:ring-danger-200 dark:focus:ring-danger-900",
+                data_action: "structured-input-row#remove"
+              ) do
+                render Phlex::TablerIcons::Trash.new(class: "w-4 h-4")
+                span { "Remove" }
+              end
+            end
+          end
+
+          # Compact bar shown in place of the row once it's marked for removal.
+          def render_structured_removed_bar
+            div(
+              data_structured_input_row_target: "removed",
+              hidden: true,
+              class: "flex items-center justify-between gap-3 text-sm text-[var(--pu-text-muted)]"
+            ) do
+              span(class: "italic") { "Removed" }
+              button(
+                type: :button,
+                class: "inline-flex items-center gap-1 px-3 py-1.5 text-sm font-medium rounded-lg cursor-pointer " \
+                       "text-secondary-700 hover:bg-secondary-50 dark:text-secondary-300 dark:hover:bg-secondary-900/30 " \
+                       "focus:outline-none focus:ring-4 focus:ring-secondary-200 dark:focus:ring-secondary-900",
+                data_action: "structured-input-row#restore"
+              ) do
+                render Phlex::TablerIcons::ArrowBackUp.new(class: "w-4 h-4")
+                span { "Restore" }
+              end
+            end
+          end
+
+          def render_structured_add_button(name)
+            div do
+              button(
+                type: :button,
+                class: "inline-block",
+                data: {action: "nested-resource-form-fields#add", nested_resource_form_fields_target: "addButton"}
+              ) do
+                span(class: "bg-secondary-700 text-white flex items-center justify-center px-4 py-1.5 text-sm font-medium rounded-lg") do
+                  render Phlex::TablerIcons::Plus.new(class: "w-4 h-4 mr-1")
+                  span { "Add #{name.to_s.singularize.humanize}" }
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/ui/form/concerns/repeater_field_styles.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Plutonium
+  module UI
+    module Form
+      module Concerns
+        # Shared sizing + chrome for repeater-style field groups. Both
+        # RendersNestedResourceFields and RendersStructuredInputs render the
+        # same fieldset/grid markup and share a default row limit, so the
+        # values live here to keep the two concerns from drifting apart.
+        module RepeaterFieldStyles
+          # Default maximum number of rows a repeater renders/clones.
+          DEFAULT_LIMIT = 10
+
+          # Outer fieldset chrome for a single repeater row.
+          FIELDSET_CLASS = "nested-resource-form-fields border border-[var(--pu-border)] rounded-[var(--pu-radius-md)] p-4 space-y-4 relative"
+
+          # Responsive grid the row's fields are laid out in.
+          FIELD_GRID_CLASS = "grid grid-cols-1 md:grid-cols-2 2xl:grid-cols-4 gap-4 grid-flow-row-dense"
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/ui/form/resource.rb

@@ -5,6 +5,7 @@ module Plutonium
     module Form
       class Resource < Base
         include Plutonium::UI::Form::Concerns::RendersNestedResourceFields
+        include Plutonium::UI::Form::Concerns::RendersStructuredInputs
 
         attr_reader :resource_fields, :resource_definition, :singular_resource
 
@@ -171,7 +172,9 @@ module Plutonium
 
         def render_resource_field(name)
           when_permitted(name) do
-            if resource_definition.respond_to?(:defined_nested_inputs) && resource_definition.defined_nested_inputs[name]
+            if resource_definition.respond_to?(:defined_structured_inputs) && resource_definition.defined_structured_inputs[name]
+              render_structured_input(name)
+            elsif resource_definition.respond_to?(:defined_nested_inputs) && resource_definition.defined_nested_inputs[name]
               render_nested_resource_field(name)
             else
               render_simple_resource_field(name, resource_definition, self)

data/lib/plutonium/ui/modal/slideover.rb

@@ -25,11 +25,17 @@ module Plutonium
         # controller on the frame after showModal(). Mirrors the filter
         # slideover's pattern — see Centered for the same rationale.
         def base_dialog_classes
+          # The backdrop dim+blur is static (no [data-open] gating, no
+          # transition): a ::backdrop that fades its bg-color while carrying
+          # backdrop-filter re-rasterises the blur every frame and stutters
+          # the panel slide. Keeping it static lets only the panel animate
+          # (transform), composited smoothly. The backdrop snaps in at
+          # showModal() and is dropped when the dialog leaves the top layer
+          # on close(), so it still covers the panel's slide-out. Mirrors
+          # the .pu-dialog::backdrop rule in components.css.
           "fixed top-0 right-0 bottom-0 left-auto m-0 h-screen max-w-full max-h-screen " \
             "bg-[var(--pu-surface)] border-l border-[var(--pu-border)] " \
-            "backdrop:bg-transparent data-[open]:backdrop:bg-black/60 " \
-            "data-[open]:backdrop:backdrop-blur-sm " \
-            "backdrop:transition-[background-color] backdrop:duration-300 backdrop:ease-out " \
+            "backdrop:bg-black/60 backdrop:backdrop-blur-sm " \
             "rounded-none p-0 " \
             "open:flex flex-col " \
             "translate-x-full data-[open]:translate-x-0 " \

data/lib/plutonium/version.rb

@@ -1,5 +1,5 @@
 module Plutonium
-  VERSION = "0.54.0"
+  VERSION = "0.55.0"
   NEXT_MAJOR_VERSION = VERSION.split(".").tap { |v|
     v[1] = v[1].to_i + 1
     v[2] = 0

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radioactive-labs/plutonium",
-  "version": "0.54.0",
+  "version": "0.55.0",
   "description": "Build production-ready Rails apps in minutes, not days. Convention-driven, fully customizable, AI-ready.",
   "type": "module",
   "main": "src/js/core.js",

data/src/css/components.css

@@ -513,12 +513,17 @@
   border-radius: var(--pu-radius-lg);
 }
 
+/* Dim + frosted blur for the whole time the dialog is in the top layer.
+   Deliberately NOT transitioned and NOT gated on [data-open]: a ::backdrop
+   that repaints every frame (a bg-color fade) while carrying a
+   backdrop-filter forces the browser to re-rasterise the blur per frame,
+   which stutters the panel's open/close animation — and doubly so when a
+   nested confirm animates over a parent modal whose blur is still live.
+   Keeping it static lets the GPU rasterise the blur once; only the panel
+   animates (opacity/scale/translate, cheaply composited). The backdrop
+   snaps in at showModal() and is removed when the dialog leaves the top
+   layer on close(), so the dim still covers the panel's exit. */
 .pu-dialog::backdrop {
-  background-color: transparent;
-  transition: background-color 200ms ease-out;
-}
-
-.pu-dialog[data-open]::backdrop {
   background-color: rgb(0 0 0 / 0.6);
   backdrop-filter: blur(4px);
 }

data/src/js/controllers/register_controllers.js

@@ -1,6 +1,7 @@
 // Import controllers here
 import ResourceHeaderController from "./resource_header_controller.js"
 import NestedResourceFormFieldsController from "./nested_resource_form_fields_controller.js"
+import StructuredInputRowController from "./structured_input_row_controller.js"
 import FormController from "./form_controller.js"
 import ResourceDropDownController from "./resource_drop_down_controller.js"
 import ResourceCollapseController from "./resource_collapse_controller.js"
@@ -40,6 +41,7 @@ export default function (application) {
   application.register("sidebar", SidebarController)
   application.register("resource-header", ResourceHeaderController)
   application.register("nested-resource-form-fields", NestedResourceFormFieldsController)
+  application.register("structured-input-row", StructuredInputRowController)
   application.register("form", FormController)
   application.register("resource-drop-down", ResourceDropDownController)
   application.register("resource-collapse", ResourceCollapseController)

data/src/js/controllers/structured_input_row_controller.js

@@ -0,0 +1,26 @@
+import { Controller } from "@hotwired/stimulus"
+
+// Connects to data-controller="structured-input-row"
+//
+// Soft-removes a classless structured-input row by DISABLING its fields — a
+// disabled <fieldset> is omitted from form submission, so the server simply
+// receives the payload without that row and rebuilds the JSON column from what
+// it gets (no _destroy marker needed). The row stays in the DOM, collapsed to a
+// "Removed — Restore" bar, so it can be restored (re-enabled) before saving.
+export default class extends Controller {
+  static targets = ["content", "removed"]
+
+  remove(e) {
+    e.preventDefault()
+    this.contentTarget.disabled = true
+    this.contentTarget.hidden = true
+    this.removedTarget.hidden = false
+  }
+
+  restore(e) {
+    e.preventDefault()
+    this.contentTarget.disabled = false
+    this.contentTarget.hidden = false
+    this.removedTarget.hidden = true
+  }
+}

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: plutonium
 version: !ruby/object:Gem::Version
-  version: 0.54.0
+  version: 0.55.0
 platform: ruby
 authors:
 - Stefan Froelich
 bindir: exe
 cert_chain: []
-date: 2026-06-01 00:00:00.000000000 Z
+date: 2026-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -593,6 +593,8 @@ files:
 - docs/public/images/home-index.png
 - docs/public/images/home-new.png
 - docs/public/images/home-show.png
+- docs/public/images/reference/structured-inputs-removed.png
+- docs/public/images/reference/structured-inputs.png
 - docs/public/images/tutorial/02-empty-index.png
 - docs/public/images/tutorial/02-index-with-posts.png
 - docs/public/images/tutorial/02-new-form-modal.png
@@ -663,6 +665,8 @@ files:
 - docs/superpowers/plans/2026-05-07-ui-layout-overhaul.md.tasks.json
 - docs/superpowers/plans/2026-05-15-public-pages-overhaul.md
 - docs/superpowers/plans/2026-05-15-public-pages-overhaul.md.tasks.json
+- docs/superpowers/plans/2026-06-02-structured-inputs.md
+- docs/superpowers/plans/2026-06-02-structured-inputs.md.tasks.json
 - docs/superpowers/specs/2026-04-08-plutonium-skills-overhaul-design.md
 - docs/superpowers/specs/2026-04-14-plutonium-testing-design.md
 - docs/superpowers/specs/2026-05-07-ui-layout-overhaul-design.md
@@ -671,7 +675,7 @@ files:
 - docs/superpowers/specs/2026-05-13-docs-restructure-design.md
 - docs/superpowers/specs/2026-05-15-public-pages-overhaul-design.md
 - docs/superpowers/specs/2026-05-29-avatar-component-design.md
-- docs/superpowers/specs/2026-06-01-interaction-repeater-inputs-design.md
+- docs/superpowers/specs/2026-06-01-structured-inputs-design.md
 - esbuild.config.js
 - exe/pug
 - gemfiles/rails_7.gemfile
@@ -974,6 +978,7 @@ files:
 - lib/plutonium/definition/scoping.rb
 - lib/plutonium/definition/search.rb
 - lib/plutonium/definition/sorting.rb
+- lib/plutonium/definition/structured_inputs.rb
 - lib/plutonium/engine.rb
 - lib/plutonium/engine/validator.rb
 - lib/plutonium/helpers.rb
@@ -987,7 +992,6 @@ files:
 - lib/plutonium/interaction/base.rb
 - lib/plutonium/interaction/concerns/scoping.rb
 - lib/plutonium/interaction/concerns/workflow_dsl.rb
-- lib/plutonium/interaction/nested_attributes.rb
 - lib/plutonium/interaction/outcome.rb
 - lib/plutonium/interaction/response/base.rb
 - lib/plutonium/interaction/response/failure.rb
@@ -1051,6 +1055,8 @@ files:
 - lib/plutonium/routing/mapper_extensions.rb
 - lib/plutonium/routing/resource_registration.rb
 - lib/plutonium/routing/route_set_extensions.rb
+- lib/plutonium/structured_inputs/param_cleaner.rb
+- lib/plutonium/structured_inputs/params_concern.rb
 - lib/plutonium/support/parameters.rb
 - lib/plutonium/testing.rb
 - lib/plutonium/testing/auth_helpers.rb
@@ -1101,6 +1107,8 @@ files:
 - lib/plutonium/ui/form/components/sticky_footer.rb
 - lib/plutonium/ui/form/components/uppy.rb
 - lib/plutonium/ui/form/concerns/renders_nested_resource_fields.rb
+- lib/plutonium/ui/form/concerns/renders_structured_inputs.rb
+- lib/plutonium/ui/form/concerns/repeater_field_styles.rb
 - lib/plutonium/ui/form/concerns/typeahead_attributes.rb
 - lib/plutonium/ui/form/interaction.rb
 - lib/plutonium/ui/form/options/inferred_types.rb
@@ -1206,6 +1214,7 @@ files:
 - src/js/controllers/select_navigator.js
 - src/js/controllers/sidebar_controller.js
 - src/js/controllers/slim_select_controller.js
+- src/js/controllers/structured_input_row_controller.js
 - src/js/controllers/table_column_menu_controller.js
 - src/js/controllers/table_header_controller.js
 - src/js/controllers/textarea_autogrow_controller.js
@@ -1230,7 +1239,7 @@ metadata:
   homepage_uri: https://radioactive-labs.github.io/plutonium-core/
   source_code_uri: https://github.com/radioactive-labs/plutonium-core
 post_install_message: |
-  ⚠️  Plutonium 0.54.0 — breaking change
+  ⚠️  Plutonium 0.55.0 — breaking change
 
   Entity-scoped URL helpers and path params have been renamed from
   `<entity>_scope_*` to `<entity>_scoped_*`.

data/docs/superpowers/specs/2026-06-01-interaction-repeater-inputs-design.md

@@ -1,178 +0,0 @@
-# Interaction Repeater Inputs
-
-**Date:** 2026-06-01
-**Status:** Design — pending review
-
-## Problem
-
-Interactions (`Plutonium::Resource::Interaction`) collect scalar inputs via
-`attribute`, but have no first-class way to collect a **repeating group of
-fields** — e.g. a variable-length list of `{label, phone_number}` contacts —
-as structured input the interaction can validate and use in `execute`.
-
-The repeater UX already exists for resource forms (the
-`nested-resource-form-fields` Stimulus controller: add/remove rows, `<template>`
-cloning). But it is **model-backed**: the renderer
-(`Plutonium::UI::Form::Concerns::RendersNestedResourceFields` →
-`NestedFieldContext`) sources its row metadata (`:class`, `:macro`, `:limit`,
-multiplicity) from `resource_class.all_nested_attributes_options`, which only
-reflects ActiveRecord associations on the acted-on resource.
-
-For an interaction collecting a classless list, there is no association and no
-class. The current behaviour (characterized in
-`test/plutonium/ui/form/interaction_nested_input_test.rb`):
-
-- `nested_input` is registered on interactions and param coercion works, **but**
-- `nested_attribute_options` resolves to `{}`, so `blank_object` is `nil` →
-  `nest_one`/`nest_many` have no template object → the nested UI renders nothing.
-- The one case that *does* work is when the interaction's nested attribute
-  happens to mirror a real association on the acted-on resource (the README's
-  `CreateUserInteraction` building a `User` with `has_many :contacts`).
-
-So interactions have the *param* half of nested inputs but no working *rendering*
-half for the classless case, and the failure is silent.
-
-## Goal
-
-Let an interaction declare a **classless repeating field group** that:
-
-- renders with the existing repeater UX (add/remove rows, template cloning,
-  delete checkbox),
-- collects into the interaction as an **array of plain hashes**
-  (`contacts => [{label:, phone_number:}, …]`),
-- needs **no backing class** — just a fields definition.
-
-Non-goals (explicitly out of scope):
-
-- A single (non-repeater) variant. Repeater only; value is always an array.
-- Type coercion of row values. Rows are plain hashes; the interaction validates
-  them itself.
-- Reusing/extending model-backed `nested_input` semantics for the classless case.
-
-## Feasibility anchor
-
-Phlexi already supports hash-backed rendering. `Phlexi::Field::Support::Value.from`:
-
-```ruby
-return object[key] if object.is_a?(Hash)
-object.public_send(key) if object.respond_to?(key)
-```
-
-So a row can be a plain `Hash`, and the blank/template row can be `{}` (every
-field reads `nil` → empty). No synthesized classes are required.
-
-## Design
-
-### 1. DSL — `repeater`
-
-A new, self-contained DSL on the interaction base. One call declares everything:
-
-```ruby
-class CreateUserInteraction < Plutonium::Resource::Interaction
-  attribute :first_name, :string
-
-  repeater :contacts do |f|
-    f.input :label
-    f.input :phone_number
-  end
-
-  # or, reusing an existing fields definition:
-  # repeater :addresses, using: AddressFields, fields: %i[label map_url]
-
-  # options: limit: (default 10)
-end
-```
-
-`repeater :name` will:
-
-1. declare `attribute :name` defaulting to `[]`,
-2. register a **classless** `name_attributes=` collector (see §2),
-3. register render config (the fields definition, `multiple: true`, `limit`).
-
-A distinct name (not `nested_input`) is intentional: it signals different
-semantics (classless, collects hashes) and keeps a clean, conditional-free
-implementation path separate from model-backed `nested_input`.
-
-### 2. Param handling
-
-`name_attributes=` accepts what the form submits — either an `Array` of row
-hashes or a `Hash` keyed by index (`{"0" => {...}, "1" => {...}}`, Rails' nested
-form shape). For each row:
-
-- skip if `_destroy` is truthy (`1`/`"1"`/`true`/`"true"`),
-- skip if every value is blank (the empty trailing/blank rows),
-- otherwise keep the row as a symbolized hash with `_destroy` removed.
-
-Store the result as `name` = `Array<Hash>`. The `name` reader returns that array
-(used both by `execute` and by the renderer to repopulate on re-render).
-
-### 3. Rendering
-
-Reuse the existing repeater chrome. Add a **classless render path** that does not
-touch `all_nested_attributes_options`:
-
-- config (fields, `multiple: true`, `limit`) comes from the `repeater`
-  declaration,
-- the template/blank row object is `{}`,
-- existing rows come from the array of hashes already on the attribute (so a
-  validation-failed re-render repopulates),
-- field naming via `nest_many(:contacts, as: :contacts_attributes, …)` →
-  `interaction[contacts_attributes][N][label]`.
-
-The resource (model-backed) render path is left untouched and stays covered by
-the existing characterization tests
-(`test/integration/admin_portal/nested_form_rendering_test.rb`).
-
-> Implementation detail deferred to the plan: whether the classless path is a
-> sibling context to `NestedFieldContext` or a generalization of it, and how the
-> `repeater` fields block maps onto the existing `NestedInputsDefinition`. The
-> design constraint is only that the resource path does not change behaviour.
-
-### 4. `nested_input` raises when no class is resolvable
-
-Convert the silent classless failure into a guiding error. When the nested-field
-renderer cannot resolve a class to build rows (no `object_class`, and no `:class`
-from association metadata), raise:
-
-```
-`nested_input :contacts` could not resolve a class to build its rows.
-If this is an interaction collecting plain inputs, use `repeater :contacts` instead.
-```
-
-This keeps the legitimate model-backed `nested_input` working (class present →
-renders) and fails loudly only where it is actually broken. It also guards
-genuinely misconfigured resource nested inputs.
-
-### 5. `accepts_nested_attributes_for` is unchanged
-
-It stays available on interactions for the deliberate case of building real
-model instances in `execute`. `repeater` does not use or replace it.
-
-### 6. Documentation
-
-Update the interaction README: document `repeater` for classless repeating
-input; note that `nested_input` is model-backed and now errors without a
-resolvable class.
-
-## Testing
-
-- **Param round-trip** (unit): `contacts_attributes=` with an `Array` and with a
-  Rails index-keyed `Hash` → `contacts` is an array of symbolized hashes;
-  `_destroy` and all-blank rows dropped.
-- **Render** (integration): a dummy interaction with a `repeater`, wired to an
-  interactive action, GET its form → assert the repeater HTML — controller
-  container + limit, `<template>`, fieldset, `interaction[contacts_attributes]
-  [NEW_RECORD][label]` naming, add button, delete checkbox. Fixture built via
-  the `pu:*` generators per project convention.
-- **Guard** (unit/integration): a classless `nested_input` on an interaction
-  raises the guiding error. Update the existing characterization test
-  (`interaction_nested_input_test.rb`) from "blank_object is nil" to "raises".
-- **Regression**: resource nested fields unchanged — existing characterization
-  tests stay green.
-
-## Risk / breaking change
-
-Making `nested_input` raise without a resolvable class is a (small) breaking
-change for any interaction relying on the silently-broken classless path — but
-that path renders nothing today, so there is no working behaviour to break. The
-model-backed path is preserved.