crud_components 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f9f34326b3293f67ca0c584810204c8cafaa134c9a198133c5e0250a6022363
-  data.tar.gz: a0e849ee97e6e9f2ce92bf8e3a5fcde8575d82346d1765bc27084ac6ee3a9c1b
+  metadata.gz: 3039812d78a4d8677f871959497a18eb9f2236627a84a0d046b72a520c0ba34c
+  data.tar.gz: 70b36787f0e28e2f51af0cfdf3361dc860fcdfb048d90365ddf4ebf128759372
 SHA512:
-  metadata.gz: ec31fe79476eb57060a317bf48167cae62496ba135e7bc5bf3a2f8da26b5e665e075678fa78bd092c0e2d3ffd630f4e098f378e7f32ecab2b862baffcefb4bbb
-  data.tar.gz: f3f9d619c8246a57a1a42dae88211cc0155b0f0ae155efcb93f2a79e5be9ad338370c52f4d204d9dccb4b08767fdde13186af2ce13403ec645599d889911d31d
+  metadata.gz: 7af65ee9f9aea26c3e6fc132fbe29ad3fbf2a3c8e931e209ee72dd7cb2a57cab670875a3c14fad3907ea316138a58d272729bfd6239d68be9cacf360b4e94fa9
+  data.tar.gz: 7a220eec077f9845b682c3a081e971d2a488a7d09a7bacfb6f514023fff92a3340000420d5bca17b648dfd424522c1f32a31f505eb81c2eb3331c2718fddbf87

data/CHANGELOG.md

@@ -5,6 +5,16 @@ This project follows [semantic versioning](https://semver.org).
 
 ## Unreleased
 
+## v0.2.1 — 2026-08-01
+
+### Changed
+
+- Verified against **Rails 8.1** — the CI matrix now covers it alongside 7.1, 7.2 and 8.0. The gem's runtime API and its declared dependencies are unchanged; the rest is tooling (GitHub Actions bumped, demo image on Ruby 4.0, CI installs libvips so the playground's Active Storage previews load).
+
+### Fixed
+
+- An association column whose target labels itself with a *method* rather than a column (e.g. `label :display_title`) no longer raises `DefinitionError` ("… is neither a column nor an association of …") when its filter or `?q=` search runs. The label-based text match — and the `belongs_to` sort — are skipped whenever there is no column behind the label, as they already were for a block label. A `belongs_to` still filters by value; spell the columns out (`filter publisher: :name`) to match such a target as text.
+
 ## v0.2.0 — 2026-07-14
 
 ### Added

data/README.md

@@ -216,8 +216,8 @@ search_in :title, :subtitle, :publisher   # :publisher matches Publisher's label
 ```
 
 `label` + `identify_by` + `search_in` are a model's **identity** — and they define how
-*other* models render, link and filter it through their associations. Declare Order's
-identity once and every `belongs_to :order` column gets it for free. →
+*other* models render, link and filter it through their associations. Declare Publisher's
+identity once and every `belongs_to :publisher` column gets it for free. →
 [Fields → identity](docs/fields.md#identity-label-identify_by-search_in)
 
 ### Buttons / Actions

data/docs/fields.md

@@ -29,7 +29,7 @@ attribute :token, filter: false                       # opt a derived field out
 `attributes` (plural) applies shared options to several fields at once:
 
 ```ruby
-attributes :participants, :owner, if: :manage
+attributes :purchase_price, :shop_margin, if: :manage
 ```
 
 The field universe is always *all* derived columns/associations plus declared computed
@@ -268,9 +268,9 @@ These are not specific to `DynamicColumn` — a declared `attribute :status, hea
 takes the same options. Everything works in the non-grouped and grouped (`group_by:`) layouts,
 and plays with the column picker (a hidden column simply renders no header). The
 `/column_headers` page in `test/dummy` is a full worked example. This is what lets a
-participants × mails / × resources **matrix** live entirely in `crud_collection` — one
-`DynamicColumn` per mail/resource, its controls in its own header — instead of a hand-built
-controls strip above the table.
+books × properties **matrix** live entirely in `crud_collection` — one `DynamicColumn` per
+property, its controls in its own header — instead of a hand-built controls strip above
+the table.
 
 ## Path columns
 
@@ -332,7 +332,7 @@ icon 'book'               # default: guessed from the model name (config.model_i
   Block form: `label { |book| "#{book.title} (#{book.published_on&.year})" }`. With no
   string column at all it falls back to `"Book #42"` (`model_name.human` + ` #` + id).
   When the label reaches into associations, declare them with `preload:` so they're
-  eager-loaded wherever this model is shown — `label :full_title, preload: %i[publisher]`
+  eager-loaded wherever this model is shown — `label :display_title, preload: %i[publisher]`
   ([Performance](performance.md#eager-loading-render-dependencies)).
 - **`identify_by`** — the column URL params use to identify a record of this model. With
   `identify_by :slug`, a filter URL reads `?publisher=tor-books` and resolves via
@@ -402,7 +402,7 @@ with `preload: %i[publisher]` — [Performance](performance.md#eager-loading-ren
 | json                      | `<pre>` (rouge if present)                   | —                                                        | —    | not form-editable in v1                                                              |
 | Active Storage attachment | image / preview / icon by content type       | —                                                        | —    | form shows current; keep/add/remove via signed_ids                                   |
 | `belongs_to`              | nil-safe link via target `label`             | select (≤ `select_limit`) / text over target `label`    | v2   | resolves by `identify_by`                                                            |
-| `has_many` / habtm        | "a, b +n more" links                         | text over the children's `label` (block label: facet)    | no   | "+n more" links to nested/filtered index                                             |
+| `has_many` / habtm        | "a, b +n more" links                         | text over the children's `label` (columnless label: facet) | no   | "+n more" links to nested/filtered index                                             |
 | public method             | by value type                                | —                                                        | —    | needs a facet to filter/sort                                                         |
 | `render` block            | block output                                 | —                                                        | —    | facets add filter/sort                                                               |
 

data/docs/filtering.md

@@ -15,9 +15,9 @@ see") see [security.md](security.md).
 Every column is filterable by default through the control its type implies — a string by
 substring, a number/date by range, an enum/boolean by select, an association by its target's
 **label** (the name shown in the cell): a `belongs_to` as a select/text, a `has_many`/habtm as
-text matching any child. A *computed* column, or an association whose label is a block (no
-single column to match), opts in with the `filter` facet (a [search spec](#the-search-spec) or
-a block):
+text matching any child. A *computed* column, or an association whose label has no column
+behind it — a block, or a method name like `label :display_title` — opts in with the `filter`
+facet (a [search spec](#the-search-spec) or a block):
 
 ```ruby
 attribute :author_names do
@@ -95,8 +95,9 @@ filter :title, { authors: :name }              # mixed
 The **label form** — an association name *without* columns — matches the target's
 **label**: the name shown in that association's cell ("search what you see"). It is the
 idiomatic style and never reaches the target's other columns, so a secret column on the
-target can't be probed through an association. When the target's label is a custom block
-(no single column to match), spell the columns out (`filter authors: :name`).
+target can't be probed through an association. When the target's label has no column behind
+it — a custom block, or a method name like `label :display_title` — spell the columns out
+(`filter authors: :name`).
 
 The gem turns a spec into `left_joins` plus parameterized, wildcard-escaped `ILIKE`
 (via `sanitize_sql_like` with an explicit `\` escape char, so `%`, `_` and `\` are all

data/lib/crud_components/builder.rb

@@ -34,7 +34,7 @@ module CrudComponents
     # How a record is titled (links, headings). Give a method name or a block.
     # @param method [Symbol, nil] a method on the record returning its label.
     # @param preload [Array<Symbol>, Symbol, nil] associations the label reaches
-    #   into (`label :full_title, preload: %i[customer training]`). They're
+    #   into (`label :display_title, preload: %i[publisher authors]`). They're
     #   eager-loaded automatically whenever this model is shown as another
     #   model's association column — declare once, no N+1 anywhere.
     # @yield [record] computes the label; receives the record.
@@ -51,7 +51,7 @@ module CrudComponents
     # Associations to eager-load whenever this model is rendered (as a row or as
     # another model's association cell) — for label/render dependencies the gem
     # can't infer. Additive with `label …, preload:`; declare more than once to
-    # accumulate. e.g. `preload :customer, :training`.
+    # accumulate. e.g. `preload :publisher, :authors`.
     # @param names [Array<Symbol>] association names (nested hashes allowed).
     # @return [void]
     def preload(*names)
@@ -154,7 +154,7 @@ module CrudComponents
     private
 
     # Normalize a preload value to an array of includes-specs, leaving a nested
-    # hash (`{ customer: :company }`) intact (Array() would split it).
+    # hash (`{ publisher: :books }`) intact (Array() would split it).
     def preload_list(value)
       case value
       when nil then []

data/lib/crud_components/fields/belongs_to_field.rb

@@ -27,7 +27,7 @@ module CrudComponents
       # Default ?q= reaches the target's label (the name shown in the cell).
       # Skipped for polymorphic (no single target) or a block/columnless label.
       def search_spec_entry
-        name if !reflection.polymorphic? && target_structure.label_field_name
+        name if !reflection.polymorphic? && target_structure.label_column_name
       end
 
       def derived_filterable?
@@ -70,7 +70,7 @@ module CrudComponents
 
       # Load the association, nesting the target's identity_preloads (its label's
       # own association deps) plus any per-column `preload:` so the target's
-      # label never N+1s. e.g. { order: %i[customer training] }.
+      # label never N+1s. e.g. { book: %i[publisher authors] }.
       # A polymorphic belongs_to has no single target class, so we can't nest its
       # label's preloads — just preload the association itself (Rails groups it by
       # type); the cell still renders each record's label and links it at runtime.
@@ -102,14 +102,13 @@ module CrudComponents
       def sort_column
         return nil if reflection.polymorphic?
 
-        col = target_structure.label_field_name
-        col if col && target.column_names.include?(col.to_s)
+        target_structure.label_column_name
       end
 
       # Free text matches the target's label only — the name shown in the cell.
       # A block/computed label has no column to match, so there's no text filter.
       def like_subquery(scope, value)
-        label = target_structure.label_field_name
+        label = target_structure.label_column_name
         return nil unless label
 
         scope.where(name => LikeSpec.apply(target.all, [label], value))

data/lib/crud_components/fields/has_many_field.rb

@@ -49,7 +49,7 @@ module CrudComponents
       # Default ?q= reaches the children's label (the names shown in the list).
       # Skipped when the target's label is a block/columnless.
       def search_spec_entry
-        name if target_structure.label_field_name
+        name if target_structure.label_column_name
       end
 
       # ── filter ─────────────────────────────────────────────────────────────
@@ -58,7 +58,7 @@ module CrudComponents
       # one of its children does. Skipped when the target's label is a
       # block/columnless (no single column to match). Mirrors belongs_to, which
       # filters by its target's label the same way.
-      def derived_filterable? = target_structure.label_field_name.present?
+      def derived_filterable? = target_structure.label_column_name.present?
 
       def apply_derived_filter(scope, value: nil, **)
         return scope unless value

data/lib/crud_components/helpers.rb

@@ -186,7 +186,7 @@ module CrudComponents
     end
 
     # The label for an associated record in an association column: a per-column
-    # `label:` callable (`attribute :order, label: ->(o) { o.full_title(short: true) }`)
+    # `label:` callable (`attribute :publisher, label: ->(p) { p.display_title(short: true) }`)
     # when given, else the target's default {#crud_label}. Used by the
     # association / association_list renderers so a column can re-title the
     # associated record for its context while keeping the nil-safe link.

data/lib/crud_components/like_spec.rb

@@ -90,11 +90,11 @@ module CrudComponents
     # no single column to match, so ask for the columns explicitly.
     def delegate(model, reflection, path)
       target = reflection.klass
-      label = Structure.for(target).label_field_name
+      label = Structure.for(target).label_column_name
       if label.nil?
         raise DefinitionError, "cannot search #{model}##{reflection.name} by label: " \
-                               "#{target}'s label is a custom block, not a column — spell the columns out, " \
-                               "e.g. { #{reflection.name}: %i[...] }"
+                               "#{target}'s label is not a column (custom block or computed method) — " \
+                               "spell the columns out, e.g. { #{reflection.name}: %i[...] }"
       end
 
       [Entry.new(path + [reflection.name], target, label)]

data/lib/crud_components/structure.rb

@@ -172,6 +172,13 @@ module CrudComponents
       label_source.is_a?(Symbol) ? label_source : nil
     end
 
+    # The label as a real database column, else nil (block label, or a Symbol
+    # naming a computed method). Only a column can be sorted or LIKE-matched.
+    def label_column_name
+      name = label_field_name
+      name if name && model.column_names.include?(name.to_s)
+    end
+
     # The icon name (no library prefix) badging this model: the declared `icon`,
     # else the name-based guess in `config.model_icons` (keyed by the singular
     # underscored model name), else `config.model_fallback_icon` (nil = none).

data/lib/crud_components/version.rb

@@ -1,3 +1,3 @@
 module CrudComponents
-  VERSION = '0.2.0'.freeze
+  VERSION = '0.2.1'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: crud_components
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Anatoly Zelenin