base_editing_bootstrap 1.12.0 → 1.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 220d6cba364a9462e61d4db63e648b902899d92330afe32fa7f9844f898e5793
-  data.tar.gz: d74f68c4b7d6682b85dcde6089c41ec23a00596e848c6d7c98bcac89e14c5f67
+  metadata.gz: 74db6610e2c8ab5c7f25de60eb6fb1c7ba1fa83570cd552a3356674356f02518
+  data.tar.gz: 8aea6970cecd4fa8623711b21d9ec77e2b2657757dfa94c91e94028b687a074e
 SHA512:
-  metadata.gz: 3b64e2d71bbed18776836d07c93dc771e33bf43d3cc465cd3b88839936ea6694f8763f928178764e5b30625416a2f83cabba59a40e879249299d52ba397f862f
-  data.tar.gz: cc362577fa363200349af2ee2b2cb076573047d865f5b9866434c213518e1a3471b0b6dcae851d59650f5b9bb973a0bab7093dce729e45d4783147bbc68305fc
+  metadata.gz: 5713323d93896548db8ee7fd75b187e5b7b6b61efb76c3855a92c79139eaa993af1a480a6cc1fe85c84a95e9b8af1f2c0dabe615ce14815728450bbd4390b10e
+  data.tar.gz: 1a6068cc2a7b296c4f8d0a3a20097efd9dddb1752bb6e5e4844053ec8f6997eac49183af26d6873949c44d4bce05235ebfb655f171d7c0d2e203a48bef8988ae

data/CHANGELOG.md

@@ -2,6 +2,30 @@
 All notable changes to this project will be documented in this file. See [conventional commits](https://www.conventionalcommits.org/) for commit guidelines.
 
 - - -
+## 1.14.0 - 2026-03-19
+#### Features
+- Nested elements with limit from rails config (#24) - (f003ce4) - Marino Bonetti
+#### Bug Fixes
+- Correct nested_form when elements are marked for destruction - (9fd6544) - Marino Bonetti
+
+- - -
+
+## 1.13.0 - 2026-02-03
+#### Features
+- Form submit button inheritance value - (00b04b1) - Marino Bonetti
+- Add customizability on model for form partial (#21) - (b7cead4) - Marino Bonetti
+- Add BaseEditingBootstrap::Logging for form selection - (ecded89) - Marino Bonetti
+#### Bug Fixes
+- Warning escape - (1512271) - Marino Bonetti
+- Correct submit text in case of not ActiveRecord - (6b658d4) - Marino Bonetti
+#### Refactoring
+- Replace `config_accessor` with `mattr_accessor` in BaseEditingBootstrap - (a4c3fb0) - Marino Bonetti
+- BsLogging default tagging - (fbd4f2f) - Marino Bonetti
+#### Miscellaneous Chores
+- Add Ruby 4.0 as a valid version in matrix - (f32795e) - Marino Bonetti
+
+- - -
+
 ## 1.12.0 - 2025-12-05
 #### Features
 - Add Capacity of custom disable action column - (4910fc3) - Marino Bonetti

data/README.md

@@ -35,16 +35,34 @@ $ bundle exec rails g base_editing_bootstrap:install
 
 **Si presume quindi che ActiveStorage sia correttamente installato, completo del javascript per il direct upload**
 
+### Upgrade Notes
+- From <= 1.13:
+  In `app/javascript/controllers/application.js` replace:
+  ```js
+  import RailsNestedForm from '@stimulus-components/rails-nested-form'
+  application.register('nested-form', RailsNestedForm)
+  ```
+  with:
+  ```js
+  import NestedForm from 'nested_form_controller';
+  application.register('nested-form', NestedForm);
+  ```
+  in `config/importmap.rb` remove: 
+  ```ruby
+  pin "@stimulus-components/rails-nested-form"
+  ```
+  and finaly remove in vendor/javascript the `@stimulus-components/rails-nested-form` downloaded dependencies
+
 ### Note for NestedAttributes
 
-Seguire le istruzioni per installare anche NestedAttributeForm Controller per stimulus:
+Il controller nested attributes viene importato da importmaps dell'engine.
+E' necessagio registrare il nuovo controller in app/javascript/application.js
 
-```shell
-bin/importmap pin @stimulus-components/rails-nested-form
+```js
+import NestedForm from 'nested_form_controller'; // Mappato con import maps locale
+application.register('nested-form', NestedForm); // Utilizzato nell'interfaccia della form.
 ```
 
-e seguire installazione https://www.stimulus-components.com/docs/stimulus-rails-nested-form
-
 ### Generators
 
 Then Install dependency (if you run base_editing_bootstrap:install you are good to go):
@@ -197,6 +215,19 @@ Utilizzo per modello base, in questo esempio prendiamo come modello Post come es
   - default => base.html.erb
 
   **Form Field**
+  - CUSTOM => Nel modello, richiamare il metodo di classe per impostare il partial per lo specifico campo, 
+              dal punto di vista del helper per ricercare il partial corretto avverrà poi il normale iter di ricerca 
+              fra namespace di classe e namespace di controller per trovare il corretto partial:
+      ```ruby
+      class MyCustomModel < ApplicationRecord
+        include BaseEditingBootstrap::BaseModel
+        set_field_to_form_partial :title, :textarea
+      end
+      ```
+      E' anche disponibile un helper per testare la corretta configurazione:
+      ```ruby
+        it_behaves_like "a model with custom field_to_form_partial", :importo, :currency
+      ```
   - Integer => _integer.html.erb
   - Float => _decimal.html.erb
   - Decimal => _decimal.html.erb
@@ -230,8 +261,8 @@ Utilizzo per modello base, in questo esempio prendiamo come modello Post come es
       nested attraverso quanto elencato nella policy dell'oggetto padre.  
   - Default/String => _base.html.erb
 
-  In futuro si prevede di aggiungere automatismi per renderizzare senza
-  l'intervento dell'utente dei campi.
+    In futuro si prevede di aggiungere automatismi per renderizzare senza
+    l'intervento dell'utente dei campi.
 - [OPTIONAL] Search Form:  
   Per poter aggiungere una form di ricerca basta aggiungere alla policy
   del modello in questione i campi di ricerca che verranno poi utilizzati da ransack
@@ -263,10 +294,22 @@ Fai riferimento all'implementazione di esempio del dummy `Company->addresses`
 
 ### Translations
 
-Traduzioni disponibili:  
+#### Index buttons:  
 Per i bottoni della index, è possibile eseguire l'override del testo presente nel bottone.
 Leggere la documentazione nel file `app/helpers/base_editing_helper.rb#translate_with_controller_scoped`
 
+#### Per i bottoni delle form(Submit):  
+E' possibile tradurre il contenuto del bottone andando ad impostare la traduzione direttamente in yml.
+ES:  
+Con la class inheritance così composta: Remote < Base < ApplicationRecord < ActiveRecord::Base  
+per il bottone dell'oggetto Remote avremo questa ricerca:
+1. en.helpers.submit.remote.create
+2. en.helpers.submit.base.create
+3. en.helpers.submit.create
+
+In caso di oggetto persistente verrà ricercata la chiave finale `update`
+
+
 ## Testing helpers
 
 ### Requirements(installed with generators)

data/app/assets/config/base_editing_bootstrap_manifest.js

@@ -0,0 +1 @@
+//= link nested_form_controller.js

data/app/assets/javascripts/nested_form_controller.js

@@ -0,0 +1,48 @@
+import NestedForm from "@stimulus-components/rails-nested-form"
+
+// Connects to data-controller="nested-form"
+export default class extends NestedForm {
+
+  static values = {
+    limit: Number,
+  }
+
+  add(e) {
+    super.add(e);
+    this.check_for_enabling_add_button(e);
+  }
+
+  remove(e) {
+    super.remove(e);
+    this.check_for_enabling_add_button(e);
+  }
+
+  // Elenco elementi presenti visibili (e quindi non settati per essere cancellati)
+  total_active_elements() {
+    let count = 0;
+
+    this.targetTarget.parentElement.querySelectorAll(this.wrapperSelectorValue).forEach((ele) => {
+      if (ele.checkVisibility()) {
+        count += 1;
+      }
+    })
+    return count;
+  }
+
+  check_for_enabling_add_button(e) {
+    if (this.hasLimitValue) {
+      if (this.total_active_elements() >= this.limitValue) {
+        // Aggiungiamo classe disable sull'elemento che ha lanciato questo evento
+        this.add_button().disabled = "disabled";
+      } else {
+        this.add_button().removeAttribute("disabled");
+      }
+    }
+  }
+
+  add_button() {
+    return this.element.querySelector('[data-action="nested-form#add"]')
+  }
+
+
+}

data/app/helpers/utilities/form_helper.rb

@@ -4,6 +4,7 @@ module Utilities
     include EnumHelper
     include IconHelper
     include Pundit::Authorization
+    include BaseEditingBootstrap::Logging
     ##
     # Metodo su cui eseguire override per i campi specifici rispetto all'oggetto gestito dal controller
     # @deprecated Utilizza form_print_field(form, field) senza sovrascriverlo
@@ -20,7 +21,9 @@ module Utilities
     # @param [Symbol] field
     def form_print_field(form, field)
       locals = {form:, field:}
-      if form.object.class.respond_to?(:defined_enums) && form.object.class.defined_enums.key?(field.to_s)
+      if form.object.class.respond_to?(:field_to_form_partial) and (generic_field = form.object.class.field_to_form_partial(field))
+        type= :custom
+      elsif form.object.class.respond_to?(:defined_enums) && form.object.class.defined_enums.key?(field.to_s)
         type = :enum
         generic_field = "enum"
       elsif form.object.class.respond_to?(:reflect_on_association) &&
@@ -88,13 +91,12 @@ module Utilities
         "form_field",
         generic_field
       )
-      Rails.logger.debug do
+      bs_logger.debug do
         <<~TEXT
-          [BASE EDITING BOOTSTRAP]
-           TYPE: #{type}
-           GENERIC_FIELD: #{generic_field}
-           TEMPLATE: #{template.short_identifier}
-           LOCALS:#{locals}
+          TYPE: #{type}
+          GENERIC_FIELD: #{generic_field}
+          TEMPLATE: #{template.short_identifier}
+          LOCALS:#{locals}
         TEXT
       end
       template.render(self, locals)

data/app/helpers/utilities/template_helper.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Utilities::TemplateHelper
-
+  include BaseEditingBootstrap::Logging
   ##
   # Ricerca template con fallbacks.
   # In ordine, cerca di trovare il partial per l'oggetto(tramite il metodo to_partial_path) e il campo specifico.
@@ -30,21 +30,23 @@ module Utilities::TemplateHelper
       start_class = start_class.superclass
     end
 
-    [
-      # Precedenza modello e campo specifico
-      ["Campo SPECIFICO + inheritance tra modelli", field, obj_base_paths],
-      # cerco tramite nome modello semplice, con namespace della risorsa (cell_field,header_field,form_field) e nome del campo specifico
-      ["Campo specifico con nome modello + inheritance controllers", "#{obj.model_name.element}/#{base_path}/#{field}", lookup_context.prefixes],
-      # cerco struttura senza il livello del nome del modello
-      ["Campo specifico senza nome modello + inheritance controllers", "#{base_path}/#{field}", lookup_context.prefixes],
-      # Ricerca tramite campo generico e prefissi di contesto che contiene anche controller e namespace di controller
-      ["Campo GENERICO + inheritance controllers", "#{base_path}/#{generic_field}", lookup_context.prefixes],
-      ["Campo GENERICO + inheritance tra modelli", generic_field, obj_base_paths],
-      ["Default BaseEditingController", "base_editing/#{base_path}/#{generic_field}", []],
-    ].each do |desc,partial, prefixes|
-      Rails.logger.debug { "[BASE EDITING BOOTSTRAP] #{desc} - partial:`#{partial}` in #{prefixes.inspect}" }
-      if lookup_context.exists?(partial, prefixes, true)
-        return lookup_context.find(partial, prefixes, true)
+    bs_logger.tagged(field) do
+      [
+        # Precedenza modello e campo specifico
+        ["Campo SPECIFICO + inheritance tra modelli", field, obj_base_paths],
+        # cerco tramite nome modello semplice, con namespace della risorsa (cell_field,header_field,form_field) e nome del campo specifico
+        ["Campo specifico con nome modello + inheritance controllers", "#{obj.model_name.element}/#{base_path}/#{field}", lookup_context.prefixes],
+        # cerco struttura senza il livello del nome del modello
+        ["Campo specifico senza nome modello + inheritance controllers", "#{base_path}/#{field}", lookup_context.prefixes],
+        # Ricerca tramite campo generico e prefissi di contesto che contiene anche controller e namespace di controller
+        ["Campo GENERICO + inheritance controllers", "#{base_path}/#{generic_field}", lookup_context.prefixes],
+        ["Campo GENERICO + inheritance tra modelli", generic_field, obj_base_paths],
+        ["Default BaseEditingController", "base_editing/#{base_path}/#{generic_field}", []],
+      ].each do |desc, partial, prefixes|
+        bs_logger.debug { "#{desc} - partial:`#{partial}` in #{prefixes.inspect}" }
+        if lookup_context.exists?(partial, prefixes, true)
+          return lookup_context.find(partial, prefixes, true)
+        end
       end
     end
     # fallback finale

data/app/views/base_editing/_nested_row_form.html.erb

@@ -1,4 +1,4 @@
-<tr class="nested-form-wrapper" data-new-record="<%= form.object.new_record? %>" id="<%= dom_id(form.object) %>">
+<tr class="nested-form-wrapper <%= (form.object.marked_for_destruction? ? "d-none" : "") %>" data-new-record="<%= form.object.new_record? %>" id="<%= dom_id(form.object) %>">
 
   <% policy(form.object).editable_attributes.each do |field| %>
     <td>

data/app/views/base_editing/form_field/_accept_has_many_nested_field.html.erb

@@ -1,5 +1,25 @@
 <%# locals: (form:, field:,new_object:) -%>
-<%= content_tag :table, class: "table", data: {controller: 'nested-form'} do %>
+<%
+
+  ##
+  # Costruisco le opzioni per limitare tramite interfaccia (ricevuta da configurazione di Rails nested_attributes_for)
+  # il numero di nested elements
+  controller_data = {controller: 'nested-form'}
+  if (limit = form.object.class.nested_attributes_options[field].dig(:limit))
+    controller_data["nested-form-limit-value"] = \
+      case limit
+      when Symbol #TODO add tests
+        form.object.class.send(limit)
+      when Proc #TODO add tests
+        limit.call
+      else
+        limit
+      end
+  end
+
+%>
+
+<%= content_tag :table, class: "table", data: controller_data do %>
 
   <thead>
   <tr>

data/config/importmap.rb

@@ -0,0 +1,2 @@
+pin "@stimulus-components/rails-nested-form", to: "https://ga.jspm.io/npm:@stimulus-components/rails-nested-form@5.0.0/dist/stimulus-rails-nested-form.mjs" # @5.0.0
+pin_all_from File.expand_path("../app/assets/javascripts", __dir__)

data/lib/base_editing_bootstrap/VERSION

@@ -1 +1 @@
-1.12.0
+1.14.0

data/lib/base_editing_bootstrap/base_model.rb

@@ -11,6 +11,7 @@ module BaseEditingBootstrap
                :ransackable_associations,
                :ransackable_scopes, to: :@class
 
+      class_attribute :_field_to_form_partial
 
       ##
       # Label da utilizzare nelle option per quando si genera le select dei belongs to
@@ -44,6 +45,25 @@ module BaseEditingBootstrap
           Pundit.policy(BaseEditingBootstrap.authentication_model.new, self.new).permitted_scopes_for_ransack.map(&:to_s)
         end
       end
+
+      ##
+      # Questo metodo registra sulla classe la tuppla campo e partial per impostare il
+      # partial da utilizzare nel rendering
+      #
+      # E' presente anche un helper per i test:
+      #
+      #   it_behaves_like "a model with custom field_to_form_partial", :importo, :currency
+      #
+      def set_field_to_form_partial(field, partial)
+        self._field_to_form_partial ||= {}
+        self._field_to_form_partial = self._field_to_form_partial.merge(field => partial)
+      end
+
+      def field_to_form_partial(field)
+        return nil unless self._field_to_form_partial
+        self._field_to_form_partial.fetch(field, nil)
+      end
+
     end
   end
 end

data/lib/base_editing_bootstrap/engine.rb

@@ -5,5 +5,13 @@ module BaseEditingBootstrap
       app.deprecators[:base_editing_bootstrap] = BaseEditingBootstrap.deprecator
     end
 
+    initializer "base_editing_bootstrap.importmap", before: "importmap" do |app|
+      app.config.importmap.paths << Engine.root.join("config/importmap.rb")
+    end
+
+    initializer "base_editing_bootstrap.assets.precompile" do |app|
+      app.config.assets.precompile << "nested_form_controller.js"
+    end
+
   end
 end

data/lib/base_editing_bootstrap/forms/base.rb

@@ -106,6 +106,22 @@ module BaseEditingBootstrap::Forms
     #             di seguire realmente il link con il browser.
     def submit(value = nil, options = {})
       @template.content_tag(:div, class: "btn-group mr-1") do
+
+        if value.nil? && object.respond_to?(:model_name)
+          key = object.respond_to?(:persisted?) ? (object.persisted? ? :update : :create) : :submit
+          defaults = []
+          tmp = object.class
+          while tmp != ::ActiveRecord::Base && tmp.respond_to?(:model_name)
+            defaults << :"helpers.submit.#{tmp.model_name.i18n_key}.#{key}"
+            tmp = tmp.superclass
+          end
+          defaults << :"helpers.submit.#{key}"
+          defaults << "_NOT_FOUND_TRANSLATION_"
+
+          value = I18n.translate(defaults.shift, model: object.model_name.human, default: defaults)
+          value = nil if value == "_NOT_FOUND_TRANSLATION_"
+        end
+
         super(value, options.reverse_merge(class: "btn btn-primary")) +
           @template.link_to(object.class.human_attribute_name(:_submit_undo, default: :undo),
                             @template.index_custom_polymorphic_path(object.class),

data/lib/base_editing_bootstrap/logging.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module BaseEditingBootstrap
+  module Logging
+    def bs_logger
+      @logger ||= begin
+                    config_logger = BaseEditingBootstrap.logger
+                    config_logger = config_logger || (defined?(Rails) ? Rails.logger : Logger.new($stdout))
+                    ActiveSupport::TaggedLogging.new(config_logger).tagged("BASE EDITING BOOTSTRAP")
+                  end
+    end
+
+  end
+end

data/lib/base_editing_bootstrap.rb

@@ -16,29 +16,31 @@ loader.ignore("#{__dir__}/generators")
 loader.setup
 
 module BaseEditingBootstrap
-  include ActiveSupport::Configurable
+    def self.configure
+      yield self
+    end
 
   ##
   # Controller da cui derivare poi il BaseEditingController da cui derivano
   # tutti i controller sottostanti
   # @default "ApplicationController"
-  config_accessor :inherited_controller, default: "ApplicationController"
+  mattr_accessor :inherited_controller, default: "ApplicationController"
   
   ##
   # Configurazione per alterare lo standard di azione post aggiornamento record
   # il default è andare nella pagina di editing del record
   # possibili valori :edit , :index
-  config_accessor :after_success_update_redirect, default: :edit
+  mattr_accessor :after_success_update_redirect, default: :edit
 
   ##
   # Configurazione per alterare lo standard di azione post creazione record
   # il default è andare nella pagina di editing del record
   # possibili valori :edit , :index  
-  config_accessor :after_success_create_redirect, default: :edit
+  mattr_accessor :after_success_create_redirect, default: :edit
 
   ##
   # Classe che rappresenta l'utente, solitamente User
-  config_accessor :authentication_model_class, default: "User"
+  mattr_accessor :authentication_model_class, default: "User"
 
   def self.authentication_model
     self.authentication_model_class.constantize
@@ -46,12 +48,16 @@ module BaseEditingBootstrap
 
   ##
   # Factory per la creazione del modello che rappresenta l'auteticazione
-  config_accessor :authentication_model_factory, default: :user
+  mattr_accessor :authentication_model_factory, default: :user
 
   def self.deprecator
     @deprecator ||= ActiveSupport::Deprecation.new("2.0", "BaseEditingBootstrap")
   end
 
+  ##
+  # Logger, default to Rails.logger
+  mattr_accessor :logger, default: nil
+
 end
 
 loader.eager_load

data/lib/generators/base_editing_bootstrap/install/install_generator.rb

@@ -35,9 +35,9 @@ module BaseEditingBootstrap
         # attualmente penso sia più sensato semplicemente scrivere a video i passaggi necessari, dato che
         # potrebbe essere già presente importmap, nested_attribute_controller e le varie configurazioni
 
-        say "Install dependencies for nested attributes:"
-        say "   bin/importmap pin @stimulus-components/rails-nested-form"
-        say "Attiva quindi come spiegato qua: https://www.stimulus-components.com/docs/stimulus-rails-nested-form il controller"
+        say "Install nested attributes controller, add to application.js:"
+        say " import NestedForm from 'nested_form_controller' \n
+              application.register('nested-form', NestedForm)"
 
       end
     end

data/lib/generators/base_editing_bootstrap/install/templates/initializer.rb

@@ -27,4 +27,10 @@ BaseEditingBootstrap.configure do |config|
   # Factory per la creazione del modello che rappresenta l'auteticazione
   # config.authentication_model_factory= :user
 
+  ##
+  # Logger, default to Rails.logger
+  # @default to Rails.logger or STDOUT if no Rails.logger
+  # config.logger = ActiveSupport::TaggedLogging.logger($stdout)
+  # config.logger = Rails.logger
+
 end

data/spec/support/external_shared/base_model.rb

@@ -84,3 +84,15 @@ RSpec.shared_examples "a validated? object" do
     it { is_expected.to be_validated }
   end
 end
+
+RSpec.shared_examples "a model with custom field_to_form_partial" do |field, partial|
+
+  it "when #{field}" do
+    expect(described_class.field_to_form_partial(field)).to eq partial
+  end
+
+  it "anything else" do
+    expect(described_class.field_to_form_partial(anything)).to be_nil
+  end
+
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: base_editing_bootstrap
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.14.0
 platform: ruby
 authors:
 - Marino Bonetti
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-05 00:00:00.000000000 Z
+date: 2026-03-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -320,6 +320,7 @@ files:
 - README.md
 - Rakefile
 - app/assets/config/base_editing_bootstrap_manifest.js
+- app/assets/javascripts/nested_form_controller.js
 - app/controllers/.keep
 - app/controllers/base_editing_controller.rb
 - app/controllers/restricted_area_controller.rb
@@ -389,6 +390,7 @@ files:
 - app/views/kaminari/_paginator.html.erb
 - app/views/kaminari/_prev_page.html.erb
 - base_editing_bootstrap.gemspec
+- config/importmap.rb
 - config/initializers/base_field_error_proc.rb
 - config/locales/it.yml
 - config/routes.rb
@@ -400,6 +402,7 @@ files:
 - lib/base_editing_bootstrap/forms/base.rb
 - lib/base_editing_bootstrap/generators_helpers.rb
 - lib/base_editing_bootstrap/is_validated.rb
+- lib/base_editing_bootstrap/logging.rb
 - lib/base_editing_bootstrap/resource_finder.rb
 - lib/base_editing_bootstrap/searches/base.rb
 - lib/base_editing_bootstrap/searches/field.rb