bullet_train 1.6.3 → 1.6.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c76cb66088988d0ed0e9e1b2f444f4377bd8ba8531d2ec6f9d00b7374e8d5f0f
-  data.tar.gz: 29dfa7afdad1612cb2ac44b264d408877dea791e34f670f34b2b2cc0c73b5384
+  metadata.gz: 6cf9564d4d63992dbe9df4f6de5f4ab36779ca94917f109266bfd6073c6dc22d
+  data.tar.gz: 81076fc1023dfc4ea68780b458bcd963cd8206745a8864a254df363e5b87cbe5
 SHA512:
-  metadata.gz: 5b2e8240126515b5b6abf0015efa63ac4c320173c4c97508843627487434aaa87a04fe5cf2a691c8e7059cd6458334ab201911b7384ddb86e3abee01df680755
-  data.tar.gz: 23e1a5035a6b5c0d8d52af7ab529ecd9b7fbae774e34fb6655c3f72056f17d16492b1bfa2ede9e270280fa516bb8b7e11fd20931a29ef8ff081f3f103fa6eabb
+  metadata.gz: 3aa704f739f7d20d8da157aaafa6dea19e5c0900109b958c17de77198b135ba381fb85df30413fb63dd0c655da5cd092ced876c00470bf6ac6c5c7fc9f2046aa
+  data.tar.gz: 6ade1feff8b5990362076b9dc871ef760571acb4852467ef945792f2f87fa27d75168a8df25ec6d9bb858af2a9c2f85d1a09ad956c260f886dc1d7bed347a250

data/docs/field-partials/super-select.md

@@ -71,6 +71,32 @@ Here is an example allowing a new option to be entered by the user:
 </code></pre>
 
 Note: this will set the option `value` (which will be submitted to the server) to the entered text.
+
+To handle the new entry's text on the server, use `ensure_backing_models_on`.
+
+`ensure_backing_models_on` validates an `id:` or multiple `ids:` against a passed Active Record relation, and yields for each missing id so you can create backing models. Like this:
+
+```rb
+if strong_params[:category_id]
+  strong_params[:category_id] = ensure_backing_models_on(current_team.categories, id: strong_params[:category_id]) do |scope, id|
+    scope.find_or_create_by(name: id)
+  end
+end
+```
+
+In case our form had `multiple: true`, we could have used `ids:` instead:
+
+```rb
+if strong_params[:category_ids]
+  strong_params[:category_ids] = ensure_backing_models_on(current_team.categories, ids: strong_params[:category_ids]) do |scope, id|
+    scope.find_or_create_by(name: id)
+  end
+end
+```
+
+Note, if you need to constrain the collection further you could pass any extra scope, e.g. `current_team.categories.not_archived`.
+
+
 ## Events
 
 All events dispatched from the `super_select` partial are [Select2's jQuery events][select2_events] re-dispatched as native DOM events with the following caveats:
@@ -115,11 +141,11 @@ import { Controller } from "stimulus"
 
 export default class extends Controller {
   static targets = [ "dependentField" ]
-  
+
   updateDependentFields(event) {
     const originalSelect2Event = event.detail.event
     console.log(`catching event ${event.type}`, originalSelect2Event)
-    
+
     this.dependentFieldTargets.forEach((dependentField) => {
       // update dependentField based on value found in originalSelect2Event.target.value
     })
@@ -152,4 +178,4 @@ If you'd like to:
 * modify other fields based on the value of your `super_select`, or
 * modify your `super_select` based on the value of other fields
 
-See [Dynamic Forms and Dependent Fields](/docs/field-partials/dynamic-forms-dependent-fields.md).
+See [Dynamic Forms and Dependent Fields](/docs/field-partials/dynamic-forms-dependent-fields.md).

data/lib/bullet_train/version.rb

@@ -1,3 +1,3 @@
 module BulletTrain
-  VERSION = "1.6.3"
+  VERSION = "1.6.5"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bullet_train
 version: !ruby/object:Gem::Version
-  version: 1.6.3
+  version: 1.6.5
 platform: ruby
 authors:
 - Andrew Culver
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-13 00:00:00.000000000 Z
+date: 2023-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: standard