hibiki_rails 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b661448cbe2b84a20e26f5cd0bffaf2cf7be8c755f0f1b9c692f77e9f5798430
-  data.tar.gz: b09c3b35032a6990ab08c17e424a147e9e667905a4f9e9378062d52583e213d6
+  metadata.gz: 8dc32112018a236bbd193028d2fe6a0c0650afd04cf8e6de5f26d84bed7de97a
+  data.tar.gz: 15fcf11847178df9f355279f7666b064a557ee5ebd0647f24373aeb638fb0131
 SHA512:
-  metadata.gz: dc4013a0867b606341dd9af0135a82ab9e5a8c6b5f5cabd788eea48e0f3b604a708d31aa21c044f8639a5f2951242986b710d893b968246d03703359d562235b
-  data.tar.gz: d407a4c966366e5b11d9db6eaf7e789dcd4e086ca028dad0b2bc9b69bc4ec8f6b110339e338894b51851aa8ace18f08ef2339ce9198cf7a9226dc48d11b8c592
+  metadata.gz: cf0c15e56804599427b2c9ee2e323118ed2dc6decb1862c1765544535313cf49587997375370cfa335db4b2a32cfb8b33dae6f81ffa8870cf73c99af418cc098
+  data.tar.gz: 7dd41bb7197cc96a93a9b878ab41ee02b33a18830ecdb8f8926193529cc2c890ca6336eaca1c9eb71f0963262251d07be77895dda03cfd954ae4483a7968fdf6

data/CHANGELOG.md

@@ -4,6 +4,82 @@ The gem and the npm package are released in lockstep and share these version
 numbers — `app/assets/javascripts/hibiki.js` is a single copy served both ways,
 so importmap and bundler apps always resolve identical client code.
 
+## 0.10.0 — 2026-08-22
+
+### Added
+
+**`hibiki:rails:upload_field` — a `has_one_attached` upload on both edit
+surfaces.** `bin/rails g hibiki:rails:upload_field Album cover` extends a
+hibiki:rails scaffold: the classic form gains a direct-upload file field plus
+a remove checkbox (a virtual `remove_cover` attribute whose purge yields to a
+same-submit upload), and the inline channel form gains a nameless file input
+that direct-uploads on change and hands only the signed blob id to the graph.
+The pending state lives in the channel (a generated concern under
+`app/channels/concerns`, one `include` in the channel), keyed by the form's
+dom, so it survives repaints and the edit row and inline create form stay
+independent; attach/purge happens after a successful commit. Both channel
+queries are preloaded with `with_attached_cover`, `:cover`/`:remove_cover`
+join the permitted params, and one shared
+`app/javascript/controllers/upload_field_controller.js` is emitted per app —
+parameterized by Stimulus values, so a second attachment reuses it. One
+attachment per run; `has_one_attached` only.
+
+**`--accept` — non-image formats.** `--accept=pdf,doc` narrows both file
+inputs (image by default; tokens `image`, `audio`, `video`, `pdf`, `csv`,
+`text`, `doc`, `xls`, `ppt`, plus any raw `type/subtype` or `.ext` passed
+through; an unknown token refuses before anything is written). Every display
+site — the inline form, the classic form, and the row on the index and show
+page — branches per blob at render time on `variable?`: an image gets its
+variant thumbnail, anything else its filename and size, with a
+`rails_blob_path` link on the row. That is one template for every accept
+list, so mixed lists work and a wrong-typed file past the advisory `accept`
+no longer breaks the index at `variant`. The image_processing notice fires
+only when an image type is accepted. The accept list stays advisory — the
+app owns any server-side content-type validation.
+
+**`--many` — `has_many_attached` galleries.** `bin/rails g
+hibiki:rails:upload_field Album photos --many` (implied when the model
+already declares `has_many_attached :photos`; `--many` against an existing
+`has_one_attached` refuses) generates the gallery shape on both surfaces.
+The inline form's input takes several files — the shared
+`upload_field_controller.js` now uploads one file after another, so a
+gallery's pending list keeps the pick order; a single-file input behaves
+as before, and a many-mode run refreshes a copy from before the loop. Each
+attached file carries a graph-owned ✕ (toggle: ✕ marks, Undo unmarks) and
+each pending file its own badge with a ✕ to drop it; the pending state per
+form dom is `{ adds:, removes: }`, applied after a successful commit by
+APPENDING through `attach` and purging the marked ids — the collection is
+never assigned, which since Rails 7.1 replaces it. The classic form gets
+the same append/remove split as two virtual model attributes,
+`add_photos` (a `multiple` direct-upload field, attached in `before_save`)
+and `remove_photo_ids` (a checkbox per attached file, purged in
+`after_save`), riding `params.expect` as a braced group. The row and show
+page render the gallery with the same per-blob thumbnail-or-filename
+branch, so `--many --accept=pdf` is a document list. Two css tokens
+(`gallery_item`, `upload_status_list`).
+
+The packaged client did not change — the emitted Stimulus controller imports
+`@rails/activestorage` from the app's own dependencies.
+
+## 0.9.1 — 2026-08-18
+
+### Added
+
+**`hibiki:rails:nested` creates a missing child model from the field list.**
+`bin/rails g hibiki:rails:nested Song Credit role:string position:integer`
+no longer refuses when `Credit` doesn't exist: the generator invokes
+`active_record:model` with `song:references` prepended (kept where you put it
+if you typed it yourself), then wires the edge off the argument list exactly
+as if the field list had narrowed an existing schema. Run
+`bin/rails db:migrate` before using the fieldset. A created child is never
+ordered silently — put `position` in the field list, or pass
+`--position=COLUMN` and the column joins the create-table migration. With an
+existing child model nothing changes, and a missing model with no field list
+still refuses, now suggesting the inline syntax.
+
+The runtime and the packaged client did not change; the npm 0.9.1 exists only
+to keep the lockstep rule.
+
 ## 0.9.0 — 2026-08-17
 
 ### Added

data/lib/generators/hibiki/rails/css_variant.rb

@@ -121,7 +121,25 @@ module Hibiki
           fieldset_legend: "fieldset-legend px-2",
           nested_row: "border border-base-300 rounded-box p-3 mb-2 space-y-2",
           btn_ghost_sm: "btn btn-sm btn-ghost",
-          btn_outline_sm: "btn btn-sm btn-outline"
+          btn_outline_sm: "btn btn-sm btn-outline",
+
+          # The upload field (hibiki:rails:upload_field): the attachment row
+          # in both forms, its thumbnail, the non-image filename link on the
+          # row, and the pending badge on its own full-width line under the
+          # controls (the row wraps, so a long filename never pushes Remove
+          # off-screen). upload_row, upload_status and thumb are plain
+          # utilities, so the tailwind variant inherits them.
+          upload_row: "flex flex-wrap items-center gap-3",
+          upload_status: "w-full",
+          # --many: one chip per attached file (thumb + ✕) and the pending
+          # list, which wraps like the row.
+          gallery_item: "inline-flex items-center gap-1",
+          upload_status_list: "w-full flex flex-wrap gap-2",
+          thumb: "rounded",
+          file_link: "link link-hover",
+          file_input: "file-input w-full",
+          file_input_sm: "file-input file-input-sm",
+          badge_info: "badge badge-info"
         }.freeze
 
         # DaisyUI is a plugin over Tailwind, and the merge says so literally:
@@ -179,7 +197,16 @@ module Hibiki
           fieldset_legend: "px-2 text-sm font-medium text-gray-700",
           nested_row: "rounded-md border border-gray-200 p-3 mb-2 space-y-2",
           btn_ghost_sm: SECONDARY_BUTTON.sub("px-3 py-2", "px-2 py-1"),
-          btn_outline_sm: SECONDARY_BUTTON.sub("px-3 py-2", "px-2 py-1")
+          btn_outline_sm: SECONDARY_BUTTON.sub("px-3 py-2", "px-2 py-1"),
+          file_link: "text-indigo-600 hover:underline",
+          file_input: "block w-full text-sm text-gray-700 file:mr-3 file:rounded-md " \
+                      "file:border-0 file:bg-gray-100 file:px-3 file:py-2 file:text-sm " \
+                      "file:font-medium file:text-gray-700 hover:file:bg-gray-200",
+          file_input_sm: "block text-xs text-gray-700 file:mr-2 file:rounded-md " \
+                         "file:border-0 file:bg-gray-100 file:px-2 file:py-1 file:text-xs " \
+                         "file:font-medium file:text-gray-700 hover:file:bg-gray-200",
+          badge_info: "inline-flex items-center rounded-full bg-sky-100 px-2 py-1 " \
+                      "text-xs font-medium text-sky-800"
         ).freeze
 
         # Every lookup misses, so every class argument is omitted entirely.

data/lib/generators/hibiki/rails/extras_threading.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Hibiki
+  module Rails
+    module Generators
+      # Threading the extras: hash through a pre-0.7.0 scaffold's partial
+      # chain. Scaffolds since 0.7.0 emit it themselves (list -> row ->
+      # row_form, untouched), so on those this is a no-op probe; older
+      # output gets the header/keyword plus the two render calls retrofitted,
+      # anchored on text every scaffold emitted verbatim.
+      #
+      # Shared by every add-on generator that rides extras:
+      # (hibiki:rails:multiselect, hibiki:rails:upload_field). Depends on the
+      # generator for view_path/row_partial/row_form_partial/phlex?.
+      module ExtrasThreading
+        private
+
+        def thread_extras_through_partials
+          return if wired?(extras_probe_path, "extras")
+
+          say_status :compat, "pre-0.7 scaffold — threading extras: through the partials", :yellow
+          phlex? ? thread_extras_phlex : thread_extras_erb
+          return if wired?(extras_probe_path, "extras")
+
+          say_status :warn, "could not thread extras: automatically. Pass an extras: {} local " \
+                            "from the list partial down to #{row_form_partial} yourself.", :yellow
+        end
+
+        def extras_probe_path = phlex? ? view_path("row_form.rb") : view_path("_#{row_form_partial}.html.erb")
+
+        def thread_extras_erb
+          [view_path("_list.html.erb"), view_path("_#{row_partial}.html.erb"),
+           view_path("_#{row_form_partial}.html.erb")].each do |path|
+            # /m: the row form's locals header wraps onto a second line.
+            gsub_file path, /^(<%# locals: \(.*?)\) -%>/m, '\1, extras: {}) -%>', verbose: false
+          end
+          # `form: form` appears exactly once per file, inside the one render
+          # call that must pass extras on.
+          gsub_file view_path("_list.html.erb"), "form: form", "form: form, extras: extras"
+          gsub_file view_path("_#{row_partial}.html.erb"), "form: form", "form: form, extras: extras"
+        end
+
+        def thread_extras_phlex
+          %w[list.rb row.rb row_form.rb].each do |basename|
+            path = view_path(basename)
+            gsub_file path, /(def initialize\([^)]*)\)/, '\1, extras: {})', verbose: false
+            gsub_file path, /^(\s*)@form = form$/, "\\1@form = form\n\\1@extras = extras", verbose: false
+          end
+          gsub_file view_path("list.rb"), "form: @form", "form: @form, extras: @extras"
+          gsub_file view_path("row.rb"), "form: @form", "form: @form, extras: @extras"
+        end
+      end
+    end
+  end
+end

data/lib/generators/hibiki/rails/multiselect/multiselect_generator.rb

@@ -10,6 +10,7 @@ require_relative "../scaffold_phlex_helpers"
 require_relative "../scaffold_model_injection"
 require_relative "../scaffold_schema"
 require_relative "../css_variant"
+require_relative "../extras_threading"
 require_relative "../multiselect_helpers"
 require_relative "../multiselect_injections"
 
@@ -33,6 +34,7 @@ module Hibiki
         include ScaffoldViewHelpers
         include ScaffoldPhlexHelpers
         include ScaffoldModelInjection
+        include ExtrasThreading
         include MultiselectHelpers
         include MultiselectInjections
 

data/lib/generators/hibiki/rails/multiselect_injections.rb

@@ -201,45 +201,8 @@ module Hibiki
           RUBY
         end
 
-        # ---- pre-extras scaffolds (before 0.7.0) -----------------------------------
-
-        # Older scaffold output has no extras: hash to ride on, so it is
-        # threaded through here — the header/keyword plus the two render
-        # calls, anchored on text every scaffold emitted verbatim.
-        def thread_extras_through_partials
-          return if wired?(extras_probe_path, "extras")
-
-          say_status :compat, "pre-0.7 scaffold — threading extras: through the partials", :yellow
-          phlex? ? thread_extras_phlex : thread_extras_erb
-          return if wired?(extras_probe_path, "extras")
-
-          say_status :warn, "could not thread extras: automatically. Pass an extras: {} local " \
-                            "from the list partial down to #{row_form_partial} yourself.", :yellow
-        end
-
-        def extras_probe_path = phlex? ? view_path("row_form.rb") : view_path("_#{row_form_partial}.html.erb")
-
-        def thread_extras_erb
-          [view_path("_list.html.erb"), view_path("_#{row_partial}.html.erb"),
-           view_path("_#{row_form_partial}.html.erb")].each do |path|
-            # /m: the row form's locals header wraps onto a second line.
-            gsub_file path, /^(<%# locals: \(.*?)\) -%>/m, '\1, extras: {}) -%>', verbose: false
-          end
-          # `form: form` appears exactly once per file, inside the one render
-          # call that must pass extras on.
-          gsub_file view_path("_list.html.erb"), "form: form", "form: form, extras: extras"
-          gsub_file view_path("_#{row_partial}.html.erb"), "form: form", "form: form, extras: extras"
-        end
-
-        def thread_extras_phlex
-          %w[list.rb row.rb row_form.rb].each do |basename|
-            path = view_path(basename)
-            gsub_file path, /(def initialize\([^)]*)\)/, '\1, extras: {})', verbose: false
-            gsub_file path, /^(\s*)@form = form$/, "\\1@form = form\n\\1@extras = extras", verbose: false
-          end
-          gsub_file view_path("list.rb"), "form: @form", "form: @form, extras: @extras"
-          gsub_file view_path("row.rb"), "form: @form", "form: @form, extras: @extras"
-        end
+        # The pre-0.7.0 extras threading moved to ExtrasThreading (shared with
+        # hibiki:rails:upload_field).
       end
     end
   end

data/lib/generators/hibiki/rails/nested/USAGE

@@ -8,9 +8,11 @@ Description:
     fallback in the full-page form, and the controller's params.expect
     double-array group.
 
-    Parent and Child models must exist and be migrated, and Child must
-    declare belongs_to :<parent>. An optional field list narrows or orders
-    the child's form fields; the facts stay the schema's.
+    When the Child model exists (migrated, with belongs_to :<parent>), an
+    optional field list narrows or orders its form fields; the facts stay
+    the schema's. When it doesn't, the field list creates it — model and
+    migration via active_record:model, <parent>:references prepended for
+    you. Run bin/rails db:migrate before using the fieldset.
 
     Depth is composition: run once per edge. A run whose Parent is itself a
     nested child (its _<parent>_fields partial exists) nests into that
@@ -20,7 +22,8 @@ Description:
     the fieldset ordered — the has_many gains an order scope, the parent
     form stamps positions from array order, and rows get ↑/↓ buttons. The
     named column is added by migration when missing; --skip-position opts
-    out entirely.
+    out entirely. A created child is never ordered silently: put position
+    in the field list, or pass --position.
 
 Examples:
     bin/rails g hibiki:rails:nested Song Credit
@@ -28,3 +31,5 @@ Examples:
     bin/rails g hibiki:rails:nested Credit Contribution
 
     bin/rails g hibiki:rails:nested Song Credit artist:references role:string --position=rank
+
+    bin/rails g hibiki:rails:nested Song Credit role:string position:integer

data/lib/generators/hibiki/rails/nested/nested_generator.rb

@@ -22,6 +22,8 @@ module Hibiki
       # generic Hibiki::Rails::NestedActions), reactive_nested on the parent
       # form, the model wiring, the classic fields_for fallback in the
       # full-page form, and the controller's params.expect double-array group.
+      # A missing child model is created from the field list (model +
+      # migration via active_record:model, the parent reference prepended).
       #
       # Depth is composition — run once per edge. A run whose parent is
       # itself a nested child injects into the parent's own fields partial
@@ -62,6 +64,14 @@ module Hibiki
           warn_without_phlex_rails
         end
 
+        def create_child_model
+          return unless create_child?
+
+          # to_argv, never GeneratedAttribute#to_s: `title:string!` round-trips
+          # through to_s as "title:string{null}", which .parse then rejects.
+          invoke "active_record:model", child_model_argv
+        end
+
         def create_child_form
           template "child_form.rb.tt", child_form_path
         end
@@ -111,10 +121,7 @@ module Hibiki
         end
 
         def post_install
-          if @position_migration
-            say_status :migrate, "#{child_table_name}.#{position_column} was added — " \
-                                 "run bin/rails db:migrate before using the fieldset.", :yellow
-          end
+          migrate_notice
           schema.belongs_tos.each do |column|
             say_status :assoc, "using #{column.association_class_name}##{column.label_column} as " \
                                "the #{column.human_name.downcase} option label — edit " \
@@ -124,6 +131,18 @@ module Hibiki
 
         private
 
+        # Never both: a created child's ordering column rides its
+        # create-table migration.
+        def migrate_notice
+          if create_child?
+            say_status :migrate, "#{child_class_name} was generated — " \
+                                 "run bin/rails db:migrate before using the fieldset.", :yellow
+          elsif @position_migration
+            say_status :migrate, "#{child_table_name}.#{position_column} was added — " \
+                                 "run bin/rails db:migrate before using the fieldset.", :yellow
+          end
+        end
+
         # The scaffold's own view layer, read from what it left on disk; an
         # explicit --phlex wins. Deep mode reads it off the parent's fields
         # partial instead of the row form.

data/lib/generators/hibiki/rails/nested_helpers.rb

@@ -36,8 +36,19 @@ module Hibiki
 
         def child_form_class_name = "#{child_class_name}Form"
         def child_form_path = File.join("app/forms", "#{child_class_name.underscore}_form.rb")
+        def child_model_path = File.join("app/models", "#{child_class_name.underscore}.rb")
         def child_table_name = child_class_name.tableize.tr("/", "_")
 
+        # Create mode: no constant, no model file, and a field list to build
+        # from. Memoized before the invoke writes the file — later calls must
+        # keep the preflight answer.
+        def create_child?
+          return @create_child if defined?(@create_child)
+
+          @create_child = attributes.any? && child_class_name.safe_constantize.nil? &&
+                          !exists?(child_model_path)
+        end
+
         def child_class
           @child_class ||= begin
             klass = child_class_name.safe_constantize
@@ -53,9 +64,13 @@ module Hibiki
         end
 
         def missing_child_message
-          "No model #{child_class_name}. hibiki:rails:nested needs the child model " \
-            "to exist:\n    bin/rails g model #{child_class_name} #{singular_name}:references " \
-            "role:string\nMigrate, then re-run."
+          if exists?(child_model_path)
+            "#{child_class_name} has no table yet. Run bin/rails db:migrate first."
+          else
+            "No model #{child_class_name}. Pass its fields and the generator creates it " \
+              "(#{singular_name}:references is added for you):\n    " \
+              "bin/rails g hibiki:rails:nested #{name} #{child} role:string"
+          end
         end
 
         # The child's belongs_to back to the parent. Required: the has_many's
@@ -92,9 +107,14 @@ module Hibiki
 
         # Everything that can refuse, before anything is written.
         def check_wireable!
-          child_class
-          parent_reflection
-          check_parent_wireable!
+          if create_child?
+            check_parent_wireable!
+            check_creatable!
+          else
+            child_class
+            parent_reflection
+            check_parent_wireable!
+          end
           check_editable_columns!
         end
 
@@ -119,10 +139,21 @@ module Hibiki
 
           raise ::Rails::Generators::Error,
                 "#{child_class_name} has no editable columns beyond " \
-                "#{parent_reflection.foreign_key}#{" and #{position_column}" if ordered?} — " \
+                "#{child_foreign_key}#{" and #{position_column}" if ordered?} — " \
                 "nothing to build a fieldset from."
         end
 
+        # A bare <parent>_id column generates no belongs_to, and the has_many's
+        # inverse_of and accepts_nested_attributes_for both stand on it.
+        def check_creatable!
+          fk = "#{singular_name}_id"
+          return if attributes.none? { !it.reference? && it.name == fk }
+
+          raise ::Rails::Generators::Error,
+                "Spell the parent column #{singular_name}:references — a bare #{fk} " \
+                "generates no belongs_to, and the nested wiring needs one."
+        end
+
         # ---- the owning resource ---------------------------------------------
         #
         # Root mode: the parent itself. Deep mode: derived from where the
@@ -182,15 +213,36 @@ module Hibiki
 
         # ---- the child schema ------------------------------------------------
         #
-        # Always the introspection path — the child model is required — with
-        # the scaffold's 3.6 merge when a field list narrows or orders it. The
-        # parent's foreign key and the ordering column never become form
-        # fields: the association assigns one, the parent form stamps the
-        # other.
+        # Introspection when the child model exists (the scaffold's 3.6 merge
+        # when a field list narrows or orders it); the argument-only path when
+        # this run is creating the model — the fresh constant is not loadable
+        # in-process, so nothing may read it. The parent's foreign key and the
+        # ordering column never become form fields: the association assigns
+        # one, the parent form stamps the other.
+
+        def introspectable_child = create_child? ? nil : child_class
+
+        # Argument-derived in create mode: there is no reflection to ask yet.
+        def child_foreign_key
+          @child_foreign_key ||= create_child? ? "#{singular_name}_id" : parent_reflection.foreign_key.to_s
+        end
+
+        # What create_child_model hands to active_record:model: the parent
+        # reference prepended unless the field list already spells it, the
+        # --position column appended when ordering asked for one the list
+        # doesn't carry.
+        def child_model_argv
+          parent_ref = ("#{singular_name}:references" unless parent_ref_argument?)
+          position_arg = ("#{position_column}:integer" if ordered? && options[:position].present? &&
+                                                          attributes.none? { it.name == position_column })
+          [child_class_name, *parent_ref, *attributes.map { to_argv(it) }, *position_arg]
+        end
+
+        def parent_ref_argument? = attributes.any? { it.reference? && it.name == singular_name }
 
         def full_schema
           @full_schema ||= if attributes.any?
-                             ScaffoldSchema.from_attributes(attributes, model: child_class)
+                             ScaffoldSchema.from_attributes(attributes, model: introspectable_child)
                            else
                              ScaffoldSchema.from_model(child_class)
                            end
@@ -206,7 +258,7 @@ module Hibiki
 
         def form_excluded?(column)
           return true if column.belongs_to? && column.association_name == singular_name.to_sym
-          return true if column.name.to_s == parent_reflection.foreign_key.to_s
+          return true if column.name.to_s == child_foreign_key
 
           ordered? && column.name.to_s == position_column
         end
@@ -218,6 +270,7 @@ module Hibiki
 
           @ordered = if options[:skip_position] then false
                      elsif options[:position].present? then true
+                     elsif create_child? then attributes.any? { it.name == "position" }
                      else child_class.column_names.include?("position")
                      end
         end
@@ -225,7 +278,7 @@ module Hibiki
         def position_column = @position_column ||= options[:position].presence || "position"
 
         def position_migration_needed?
-          ordered? && !child_class.column_names.include?(position_column)
+          ordered? && !create_child? && !child_class.column_names.include?(position_column)
         end
 
         # ---- template refs ---------------------------------------------------

data/lib/generators/hibiki/rails/upload_field/USAGE

@@ -0,0 +1,46 @@
+Description:
+    Adds a has_one_attached upload onto a resource that
+    hibiki:rails:scaffold_controller already generated, on both edit
+    surfaces. One attachment per run.
+
+    The classic form gains a direct-upload file field plus a remove
+    checkbox (a virtual remove_<attachment> attribute on the model, whose
+    purge yields to a same-submit upload). The inline channel form gains a
+    nameless file input that direct-uploads on change and hands only the
+    signed blob id to the graph — the pending state lives there, keyed by
+    the form's dom, so it survives repaints and the edit row and inline
+    create form stay independent.
+
+    The channel gains one `include`; everything else lives in a generated
+    concern under app/channels/concerns that wraps the lifecycle with
+    super. Both channel queries are preloaded with with_attached_<name>,
+    and one shared upload_field_controller.js is emitted per app.
+
+    --accept=pdf,doc narrows the file inputs (image by default; tokens
+    image, audio, video, pdf, csv, text, doc, xls, ppt, or a raw
+    type/subtype or .ext). Images render as thumbnails, anything else as
+    its filename and size — decided per blob at render time, so mixed
+    lists work and a wrong-typed file never breaks the page.
+
+    --many generates a has_many_attached gallery instead (implied when the
+    model already declares one): the inline input takes several files, each
+    attached file gets a graph-owned ✕ mark (toggle; purged on save) and
+    each pending file its own badge. The classic form appends through a
+    `multiple` field and purges checked remove_<singular>_ids — both
+    virtual attributes on the model, so the collection is never assigned
+    (which would replace it). --many against an existing has_one_attached
+    refuses.
+
+    Prerequisites (warned about, never installed): the Active Storage
+    tables, the image_processing gem for thumbnails (when images are
+    accepted), and ActiveStorage.start() in the JS entrypoint for the
+    classic form.
+
+Examples:
+    bin/rails g hibiki:rails:upload_field Album cover
+
+    bin/rails g hibiki:rails:upload_field Report document --accept=pdf,doc
+
+    bin/rails g hibiki:rails:upload_field Album photos --many
+
+    bin/rails g hibiki:rails:upload_field Album cover --css=tailwind --phlex

data/lib/generators/hibiki/rails/upload_field/templates/_upload.html.erb.tt

@@ -0,0 +1,38 @@
+<%#- ESCAPING: <%% emits runtime ERB into the generated view; a bare <% is
+     consumed here at generation time. #{...} inside an escaped tag is runtime
+     Ruby and passes through untouched. -%>
+<%%# locals: (form:, dom:, extras: {}) -%>
+<%%# The <%= attachment_name %> upload. The file input carries NO name on purpose: the save
+    submit serializes the form with FormData and a File can't ride the
+    channel — the input direct-uploads on change and hands the signed id to
+    <%= set_action %>; the badges are the graph echoing that state back. %>
+<%% pending = extras.fetch(:<%= extras_key %>, {})[dom] %>
+<%% attachment = form.record&.<%= attachment_reader %> %>
+<%%= label_tag "#{dom}_<%= attachment_name %>", "<%= attachment_human %>"<%= arg_css(:label) %> %>
+<div<%= css_attr(:upload_row) %>>
+  <%%# variable? — an image gets a thumbnail, anything else its filename. %>
+  <%% if attachment && !pending&.dig(:remove) %>
+    <%% if attachment.blob.variable? %>
+      <%%= image_tag attachment.blob.variant(resize_to_limit: [ 48, 48 ])<%= arg_css(:thumb) %> %>
+    <%% else %>
+      <span<%= css_attr(:muted_inline) %>><%%= attachment.blob.filename %> (<%%= number_to_human_size(attachment.blob.byte_size) %>)</span>
+    <%% end %>
+  <%% end %>
+  <%%= tag.input type: "file", accept: "<%= accept_attr %>", id: "#{dom}_<%= attachment_name %>"<%= arg_css(:file_input_sm) %>,
+                data: { controller: "upload-field",
+                        upload_field_url_value: rails_direct_uploads_path,
+                        upload_field_action_value: "<%= set_action %>",
+                        upload_field_dom_value: dom,
+                        action: "change->upload-field#upload" } %>
+  <%% if !pending&.dig(:remove) && (attachment || pending) %>
+    <%%= tag.button("Remove", type: "button"<%= arg_css(:btn_ghost_sm) %>,
+                   **on(:<%= remove_action %>, with: { dom: dom })) %>
+  <%% end %>
+  <div<%= css_attr(:upload_status) %>>
+    <%% if pending&.dig(:remove) %>
+      <span<%= css_attr(:badge_warning) %>><%= attachment_name %> removed on save</span>
+    <%% elsif pending %>
+      <span<%= css_attr(:badge_info) %>><%%= pending[:filename].truncate(12) %> — attaches on save</span>
+    <%% end %>
+  </div>
+</div>

data/lib/generators/hibiki/rails/upload_field/templates/_upload_many.html.erb.tt

@@ -0,0 +1,47 @@
+<%#- ESCAPING: <%% emits runtime ERB into the generated view; a bare <% is
+     consumed here at generation time. #{...} inside an escaped tag is runtime
+     Ruby and passes through untouched. -%>
+<%%# locals: (form:, dom:, extras: {}) -%>
+<%%# The <%= attachment_name %> gallery. The file input carries NO name on purpose: the save
+    submit serializes the form with FormData and a File can't ride the
+    channel — the input direct-uploads each pick on change and hands the
+    signed ids to <%= add_action %>; the badges and ✕ marks are the graph
+    echoing that state back. %>
+<%% pending = extras.fetch(:<%= extras_key %>, {})[dom] || { adds: [], removes: [] } %>
+<%% attachments = form.record&.<%= attachment_reader %> || [] %>
+<%%= label_tag "#{dom}_<%= attachment_name %>", "<%= attachment_human %>"<%= arg_css(:label) %> %>
+<div<%= css_attr(:upload_row) %>>
+  <%% attachments.each do |attachment| %>
+    <span<%= css_attr(:gallery_item) %>>
+      <%%# variable? — an image gets a thumbnail, anything else its filename. %>
+      <%% if attachment.blob.variable? %>
+        <%%= image_tag attachment.blob.variant(resize_to_limit: [ 48, 48 ])<%= arg_css(:thumb) %> %>
+      <%% else %>
+        <span<%= css_attr(:muted_inline) %>><%%= attachment.blob.filename %> (<%%= number_to_human_size(attachment.blob.byte_size) %>)</span>
+      <%% end %>
+      <%% if pending[:removes].include?(attachment.id) %>
+        <span<%= css_attr(:badge_warning) %>>removed on save</span>
+        <%%= tag.button("Undo", type: "button"<%= arg_css(:btn_ghost_sm) %>,
+                       **on(:<%= remove_action %>, with: { dom: dom, attachment_id: attachment.id })) %>
+      <%% else %>
+        <%%= tag.button("✕", type: "button", aria: { label: "Remove" }<%= arg_css(:btn_ghost_sm) %>,
+                       **on(:<%= remove_action %>, with: { dom: dom, attachment_id: attachment.id })) %>
+      <%% end %>
+    </span>
+  <%% end %>
+  <%%= tag.input type: "file", multiple: true, accept: "<%= accept_attr %>", id: "#{dom}_<%= attachment_name %>"<%= arg_css(:file_input_sm) %>,
+                data: { controller: "upload-field",
+                        upload_field_url_value: rails_direct_uploads_path,
+                        upload_field_action_value: "<%= add_action %>",
+                        upload_field_dom_value: dom,
+                        action: "change->upload-field#upload" } %>
+  <div<%= css_attr(:upload_status_list) %>>
+    <%% pending[:adds].each do |add| %>
+      <span<%= css_attr(:gallery_item) %>>
+        <span<%= css_attr(:badge_info) %>><%%= add[:filename].truncate(12) %> — attaches on save</span>
+        <%%= tag.button("✕", type: "button", aria: { label: "Drop" }<%= arg_css(:btn_ghost_sm) %>,
+                       **on(:<%= remove_action %>, with: { dom: dom, signed_id: add[:signed_id] })) %>
+      </span>
+    <%% end %>
+  </div>
+</div>