terrazzo 0.7.2 → 0.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fa314f0163e8980b8d9008128b2b1e2d365aae6c3dfdbf318f225f76ddb75dd
-  data.tar.gz: c4537807333d2d028706e5ccd8bc0bdc74141c3432cd32b651170cce479a10b0
+  metadata.gz: 69d154e835cecd712223cce10063d1e51a185dbe26c705acab6b9f040d4dd0b8
+  data.tar.gz: ef0f793e70ca95e739eefc40b64b3188ae1774fb3338489316136fc19b08f746
 SHA512:
-  metadata.gz: 466b4ed0ea5ef20ccbad8d9813780656486858c6848925c5dc576a67f400924b4eb3675d6d70ffcd4ac4747fbaf789c099e8a7ad3ddd7150dbd70d9800191266
-  data.tar.gz: c6ca0e192e3d578a9dc32e2b33fba3c7f4c33e0db9a42e80ae1d8ef7fd68c90c61a4e73572d9c61358cb59eb998442a98d39c1f0e7c407f7119af538c8852274
+  metadata.gz: 11217eadfa4391055dec08ea2958cabdc10954ac653b027a14130e632ff0c7e5643657ca486c0096909014ec9276ea80909036e3aa267408d71604839f0bc9cd
+  data.tar.gz: ad45007e3d20d3d32e26939e46cf58ad62245c240e49ab9f2e0d9293252f18dcdde30e6873237cbc5b31ce90a0c85fb0442cfcbb8fc73c151a86699975e50c28

data/README.md

@@ -2,6 +2,9 @@
 
 A drop-in admin panel for Rails apps. Uses the [Administrate](https://github.com/thoughtbot/administrate) dashboard DSL with a React SPA frontend powered by [Superglue](https://github.com/thoughtbot/superglue).
 
+[![CI](https://github.com/gohypelab/terrazzo/actions/workflows/ci.yml/badge.svg)](https://github.com/gohypelab/terrazzo/actions/workflows/ci.yml)
+[![Release](https://github.com/gohypelab/terrazzo/actions/workflows/release.yml/badge.svg)](https://github.com/gohypelab/terrazzo/actions/workflows/release.yml)
+
 - **Familiar DSL** — same `ATTRIBUTE_TYPES`, `COLLECTION_ATTRIBUTES`, `FORM_ATTRIBUTES` you already know
 - **React SPA** — search, sort, and paginate without full page reloads, no separate API needed
 - **shadcn/ui + Tailwind** — polished defaults with supported ejection when you want app-owned source
@@ -23,11 +26,13 @@ bundle exec vite install
 
 # Add the npm package and frontend dependencies
 npm install terrazzo
-npm install @radix-ui/react-avatar @radix-ui/react-dialog @radix-ui/react-dropdown-menu \
-  @radix-ui/react-label @radix-ui/react-popover @radix-ui/react-select \
-  @radix-ui/react-separator @radix-ui/react-slot @radix-ui/react-tooltip \
-  class-variance-authority lucide-react tailwindcss@latest
-npm install --save-dev @tailwindcss/cli@latest # if your app does not already compile Tailwind
+npm install @radix-ui/react-avatar@1.1.11 @radix-ui/react-dialog@1.1.15 \
+  @radix-ui/react-dropdown-menu@2.1.16 @radix-ui/react-label@2.1.8 \
+  @radix-ui/react-popover@1.1.15 @radix-ui/react-select@2.2.6 \
+  @radix-ui/react-separator@1.1.8 @radix-ui/react-slot@1.2.4 \
+  @radix-ui/react-tooltip@1.2.8 class-variance-authority@0.7.1 \
+  lucide-react@0.344.0 tailwindcss@4.2.1
+npm install --save-dev @tailwindcss/cli@4.2.1 # if your app does not already compile Tailwind
 
 # Install Terrazzo — generates admin namespace, app barrels,
 # shadcn metadata/path aliases, and dashboards.
@@ -58,6 +63,39 @@ Full docs at **[gohypelab.github.io/terrazzo](https://gohypelab.github.io/terraz
 - Node.js 18+
 - A JS bundler (Vite recommended, esbuild also supported)
 
+Terrazzo selects JSON 2.x because current Rails releases do not support the
+JSON 3 argument format. See [the Rails compatibility fix](https://github.com/rails/rails/pull/58601).
+
+## Development and releases
+
+Pull requests and pushes to `main` run the Ruby unit specs, npm package checks,
+documentation build, and example app system specs through GitHub Actions.
+
+Repository npm projects pin direct dependencies and use a seven-day minimum
+release age when resolving updates. The published package and documentation
+projects also commit their lockfiles. Use npm 11.10 or newer when changing
+dependencies; project `.npmrc` files save new dependencies with exact versions
+automatically.
+
+Terrazzo releases the Ruby gem and npm package from the same version tag. After
+updating `lib/terrazzo/version.rb` and `npm/package.json` to matching versions,
+push an annotated `v*` tag. The release workflow validates both packages,
+publishes missing versions to RubyGems and npm through OIDC trusted publishing,
+and creates a GitHub Release with generated notes. Existing registry versions
+are skipped, so a partially completed or manually published release can be
+retried safely.
+
+See [RELEASING.md](RELEASING.md) for trusted publisher setup, release commands,
+and retry instructions.
+
+## Customizing search
+
+Enable search with `searchable: true` in a dashboard field's options. Search supports
+numeric columns, JSON store accessors, and associated records. Override the
+controller's `search_resources` method to add custom search syntax.
+See [search fields](docs/customizing-dashboards.md#search-fields) and
+[custom search](docs/customizing-controller-actions.md#customizing-search).
+
 ## Customizing Per-Row Actions
 
 Terrazzo generates Show, Edit, and Destroy action buttons for each row on index pages and has_many tables on show pages.

data/app/controllers/terrazzo/application_controller.rb

@@ -158,9 +158,12 @@ module Terrazzo
       resource_class.all
     end
 
+    def search_resources
+      Terrazzo::Search.new(scoped_resource, dashboard, params[:search]).run
+    end
+
     def index_resources_and_order
-      search = Terrazzo::Search.new(scoped_resource, dashboard, params[:search])
-      resources = search.run
+      resources = search_resources
 
       filter = Terrazzo::Filter.new(resources, dashboard, params[:filter], params[:filter_value])
       resources = filter.run

data/lib/terrazzo/search.rb

@@ -9,11 +9,7 @@ module Terrazzo
     end
 
     def run
-      if term.blank?
-        scoped_resource
-      else
-        search_results
-      end
+      term.blank? ? scoped_resource : search_results
     end
 
     private
@@ -21,52 +17,72 @@ module Terrazzo
     LIKE_ESCAPE = "\\"
 
     def search_results
-      @association_search_joined = false
       searchable_attributes = dashboard.search_attributes
       return scoped_resource if searchable_attributes.empty?
 
-      conditions = searchable_attributes.map do |attr|
-        type = dashboard.attribute_type_for(attr)
+      conditions =
+        searchable_attributes
+          .map do |attr|
+            type = dashboard.attribute_type_for(attr)
 
-        if type.respond_to?(:associative?) && type.associative?
-          build_association_search(attr, type)
-        else
-          table = scoped_resource.model.arel_table
-          table[attr].matches(search_pattern, LIKE_ESCAPE)
-        end
-      end.compact
+            if type.respond_to?(:associative?) && type.associative?
+              build_association_search(attr, type)
+            else
+              text_attribute(scoped_resource.model, attr).matches(search_pattern, LIKE_ESCAPE)
+            end
+          end
+          .compact
 
       return scoped_resource if conditions.empty?
 
       combined = conditions.reduce(:or)
-      results = scoped_resource.where(combined)
-      @association_search_joined ? results.distinct : results
+      scoped_resource.where(combined)
     end
 
     def build_association_search(attr, type)
       reflection = scoped_resource.model.reflect_on_association(attr)
       return nil unless reflection
 
-      assoc_table = reflection.klass.arel_table
       columns = association_search_columns(type, reflection.klass)
       return nil if columns.empty?
 
-      @scoped_resource = scoped_resource.left_joins(attr)
-      @association_search_joined = true
-      columns
-        .map { |column| assoc_table[column].matches(search_pattern, LIKE_ESCAPE) }
-        .reduce(:or)
+      condition =
+        columns
+          .map { |column| text_attribute(reflection.klass, column).matches(search_pattern, LIKE_ESCAPE) }
+          .reduce(:or)
+
+      # Match IDs so association joins do not duplicate rows or compare JSON columns.
+      model = scoped_resource.model
+      primary_key = model.arel_table[model.primary_key]
+      ids = model.unscoped.joins(attr).where(condition).reselect(primary_key)
+      primary_key.in(ids.arel)
     end
 
     def association_search_columns(type, associated_class)
       configured = type.respond_to?(:options) ? Array(type.options[:searchable_fields]) : []
-      candidates = configured.presence || [:name, :title, :email]
-      column_names = associated_class.column_names
+      candidates = configured.presence || %i[name title email]
+      column_names = associated_class.column_names + associated_class.stored_attributes.values.flatten.map(&:to_s)
 
-      candidates
-        .map(&:to_s)
-        .select { |column| column_names.include?(column) }
-        .map(&:to_sym)
+      candidates.map(&:to_s).select { |column| column_names.include?(column) }.map(&:to_sym)
+    end
+
+    def text_attribute(model, attribute)
+      mysql = %w[Mysql2 Trilogy].include?(model.connection.adapter_name)
+      store = model.stored_attributes.find { |_column, fields| fields.include?(attribute.to_sym) }
+      expression =
+        if store
+          column = model.arel_table[store.first]
+          if mysql
+            path = Arel::Nodes.build_quoted("$.#{attribute.to_s.to_json}")
+            value = Arel::Nodes::NamedFunction.new("JSON_EXTRACT", [column, path])
+            Arel::Nodes::NamedFunction.new("JSON_UNQUOTE", [value])
+          else
+            Arel::Nodes::InfixOperation.new("->>", column, Arel::Nodes.build_quoted(attribute.to_s))
+          end
+        else
+          model.arel_table[attribute]
+        end
+      model.arel_table.cast(expression, mysql ? "CHAR" : "text")
     end
 
     def search_pattern

data/lib/terrazzo/version.rb

@@ -1,3 +1,3 @@
 module Terrazzo
-  VERSION = "0.7.2"
+  VERSION = "0.7.4"
 end

data/terrazzo.gemspec

@@ -31,6 +31,9 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "rails", ">= 7.1"
+  # Current Rails releases require the JSON 2 argument format.
+  # Remove this limit after released Rails versions include rails/rails#58601.
+  spec.add_dependency "json", "~> 2.0"
   spec.add_dependency "kaminari", "~> 1.2"
   spec.add_dependency "superglue", "~> 1.1"
   spec.add_dependency "form_props", ">= 0.0.6"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: terrazzo
 version: !ruby/object:Gem::Version
-  version: 0.7.2
+  version: 0.7.4
 platform: ruby
 authors:
 - Terrazzo Contributors
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: kaminari
   requirement: !ruby/object:Gem::Requirement
@@ -339,7 +353,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A Rails admin framework powered by Superglue and React
 test_files: []