recourse 5.8.0 → 5.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b7756a87eb7ee1ef4267480a0e8370c1b63e50623a7a22cf0efe6a7a7a46644
-  data.tar.gz: 0e7e84177bc55634878165dd8ba0fe19ad2c9d635c586211477d48431354cb47
+  metadata.gz: 2ba8a80061822d678d1c06188fbb414a30f289cb66ad3bcab42a3f49b8547f5d
+  data.tar.gz: 97c05101da058c66b87b5a743bc86f88d045b3af82f597975ba1889bed3f984a
 SHA512:
-  metadata.gz: 468364cedb2192b3a73d7b4642689d0c6b984b156c0a20b7d6930c7a982e406d5c33132bc4fd8158b1c274eb47a925e299728d5f09530dc0421fdd72d303a243
-  data.tar.gz: d34ed9fd8cbe6f355a0bf9889d7cfa4e4ce9ebd02686ac2f1070fefb3230322173855a0662f720a3380f1d8e10224b0e7d5bf125af13287a41a9f81dbf457f01
+  metadata.gz: 655a718dabdb3ef9293fc01fdcb2955564cceed83244ec6c39f93fe29223eed5a616907116843d9482eb7d4141d6f11358403f55bcf924bec78b206295238a8e
+  data.tar.gz: 87c137dbd709ee575981876bf3d3de2a6c6eaae3a09d747ee1b89e67f24c5ba52ffd1f0305953171e38cf8bc6aead8d7e0510cb1f1753ae2046f088137d6cc2d

data/README.md

@@ -68,6 +68,19 @@ offers is the record's to say: nothing to add where there is already one, nothin
 delete where there is none. A write has no index to return to, so it lands on the
 record's own page: a singular resource is the collection of one.
 
+Filters are drawn per enum, per boolean and per foreign key. A model adds one the schema
+says nothing about — the type behind a `has_one`, a word reached through another table —
+by naming the words itself, and naming the menu too, since there is no column to head it:
+
+```ruby
+def self.filter_fields
+  super.merge 'integration_type_in' => { label: 'CRM', values: Integration.selectable }
+end
+```
+
+Naming the words is not leave to query through a table, so `ransackable_associations`
+still says how far Ransack may reach.
+
 Every nested recourse gets namespaced after the parent:
 
 <img width="3824" height="2274" alt="Image" src="https://github.com/user-attachments/assets/9b242335-a25b-4fa8-8023-422538d235b0" />

data/lib/recourse/helpers/choices.rb

@@ -1,7 +1,8 @@
 module Recourse
   module Helpers
     # The filter menus whose options are values rather than records: what a column
-    # itself admits, read off the model rather than out of another table.
+    # itself admits, read off the model rather than out of another table — and the
+    # words a host named where no column admits anything.
     module Choices
     private
 
@@ -38,6 +39,16 @@ module Recourse
         filter_menu predicate, title, values, choices_all(title)
       end
 
+      # A menu of the words a host named, for a predicate no column of this model
+      # describes: the type behind a `has_one`, or anything else Ransack can ask that
+      # a schema says nothing about. Each option is a `[label, value]` pair — the words
+      # read, the value submitted — or a bare word standing as both. There is no column
+      # to take a heading from, so the `label:` is what heads it and what the way back
+      # is named after.
+      def values_filter(predicate, label, values)
+        filter_menu predicate, label, values, choices_all(label)
+      end
+
       # The way back to no filter at all, named after what the menu is of: `All
       # statuses`, `All CRMs`. An acronym keeps its capitals, the way every title
       # the gem lower-cases does.

data/lib/recourse/helpers/filters.rb

@@ -1,7 +1,7 @@
 module Recourse
   module Helpers
     # The menus beside a search box: one per foreign key a table can be narrowed by,
-    # and one per column whose values are a known few.
+    # and one per list of words a host named itself.
     module Filters
     private
 
@@ -24,9 +24,13 @@ module Recourse
         filters.except "#{parent.foreign_key}_in"
       end
 
-      # One filter: the values a column of its own admits, or a menu of the records a
-      # foreign key points at, holding whichever the request already asked for.
-      def filter_field(predicate, label: nil, scope: nil)
+      # One filter: the words a host named, the values a column of its own admits, or
+      # a menu of the records a foreign key points at, holding whichever the request
+      # already asked for. `values:` is the shape for a predicate no column of this
+      # model describes, and it needs the `label:` there is no column to read one off.
+      def filter_field(predicate, label: nil, scope: nil, values: nil)
+        return values_filter predicate, label, values if values
+
         column = predicate.to_s.sub Search::LIST_PREDICATES, ''
 
         choice_filter(predicate, column, label) || reference_filter(predicate, column, label, scope)

data/lib/recourse/version.rb

@@ -1,4 +1,4 @@
 module Recourse
   # Version of the gem, read by the gemspec and by hosts checking compatibility.
-  VERSION = '5.8.0'
+  VERSION = '5.9.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: recourse
 version: !ruby/object:Gem::Version
-  version: 5.8.0
+  version: 5.9.0
 platform: ruby
 authors:
 - claudiob