plutonium 0.26.6 → 0.26.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13438498e4ed22a7e815bd5f850a48007b17418ae5bf9226c68c360bf41a6a9e
-  data.tar.gz: d23d68ced086dbb49c5777ef8ee4a206a1c29c1b6c12a5efcb068b5c0b8c4cc5
+  metadata.gz: f500aadbdb233a0f38e68d3ce8d0ae90e6a27b68a5d63a5d96265cbaf82de602
+  data.tar.gz: d06ee6233d99cdcb0fa02bf413ec433f9a2820e694df1016c588e420e73860ff
 SHA512:
-  metadata.gz: 95c11cf8731208462dc152b1f31161e578cfdcc276502853d57112cf4694b370c191e8fc3412beef8255deae9211491b3dbe8ef86f30492467936bdfa9213833
-  data.tar.gz: a0263fa147b67cc0435feba73311f0f1d7d54d5fd6d11379f5f3855113ff35e6ec3d67e24b941582925168f5115a1a1a18795690f931fdda5a626f6dd4b225fd
+  metadata.gz: 586131a1db61db7ec366d92d8f4c7bca6ccdfb17de6a022b6bb4157455a34e3f386f7c08eda31817dd6bb40bf12e2730dc45c7751df9229cfe785e40f6877406
+  data.tar.gz: 34b979b70fefb200982490c8f41df44dcd8f0b6804b63c4f691784ec6099a0b4c0b1446c3178512d0a57777ec9c4db8fd7031d0a15861d8f889e5d598343fa1f

data/config/initializers/sqlite_alias.rb

@@ -1,5 +1,7 @@
 # Alias json to jsonb in SQLite migrations
 ActiveSupport.on_load(:active_record) do
+  next unless ActiveRecord::Base.connection.adapter_name.downcase.include?("sqlite")
+
   ActiveRecord::ConnectionAdapters::SQLite3::TableDefinition.class_eval do
     def jsonb(*args, **options)
       json(*args, **options)

data/docs/guide/deep-dive/resources.md

@@ -190,6 +190,9 @@ class BlogDefinition < Plutonium::Resource::Definition
   # Configure sorting
   sort :title
   sort :published_at
+  
+  # Configure default sorting (newest first)
+  default_sort :published_at, :desc
 end
 ```
 

data/docs/modules/query.md

@@ -43,6 +43,9 @@ class PostDefinition < Plutonium::Resource::Definition
   sort :title
   sort :created_at
   sort :view_count
+  
+  # Define default sort (when no sort params are provided)
+  default_sort :created_at, :desc  # or default_sort { |scope| scope.order(featured: :desc, created_at: :desc) }
 end
 ```
 
@@ -273,6 +276,13 @@ end
 - Consider performance impact of JOINs in search queries
 - Use `.distinct` when searching across associations
 
+### Default Sorting
+- Define a default sort to show newest items first by default: `default_sort :id, :desc`
+- Use field and direction: `default_sort :created_at, :desc`
+- Or use a block for complex sorting: `default_sort { |scope| scope.order(featured: :desc, created_at: :desc) }`
+- The default sort is only applied when no sort parameters are provided by the user
+- Child definitions inherit the default sort from parent definitions
+
 ### URL Structure
 - The `q` parameter namespace keeps query params organized
 - All filter inputs are nested under their filter name

data/docs/modules/table.md

@@ -31,6 +31,9 @@ class PostDefinition < Plutonium::Resource::Definition
   # Define sorting
   sort :title
   sort :published_at
+  
+  # Define default sort (newest first)
+  default_sort :created_at, :desc
 
   # Enable search
   search do |scope, query|
@@ -200,6 +203,11 @@ class PostDefinition < Plutonium::Resource::Definition
   sort :author_name, using: "users.name" do |scope, direction:|
     scope.joins(:author).order("users.name #{direction}")
   end
+  
+  # Default sort when no user sorting is applied
+  default_sort :created_at, :desc  # Simple form
+  # or with a block for complex sorting:
+  # default_sort { |scope| scope.order(featured: :desc, created_at: :desc) }
 end
 ```
 

data/lib/plutonium/core/controller.rb

@@ -77,15 +77,14 @@ module Plutonium
             model_class = element.class
             if model_class.respond_to?(:base_class) && model_class != model_class.base_class
               # Check if the STI model is registered, if not use base class
-              route_configs = current_engine.routes.resource_route_config_for(model_class.to_s.pluralize.underscore)
-              model_class = model_class.base_class if route_configs.nil? || route_configs.empty?
+              route_configs = current_engine.routes.resource_route_config_for(model_class.model_name.plural)
+              model_class = model_class.base_class if route_configs.empty?
             end
 
             controller_chain << model_class.to_s.pluralize
             if index == args.length - 1
-              resource_route_configs = current_engine.routes.resource_route_config_for(model_class.to_s.pluralize.underscore)
-              resource_route_config = resource_route_configs&.first
-              url_args[:id] = element.to_param unless resource_route_config && resource_route_config[:route_type] == :resource
+              resource_route_config = current_engine.routes.resource_route_config_for(model_class.model_name.plural)[0]
+              url_args[:id] = element.to_param unless resource_route_config[:route_type] == :resource
               url_args[:action] ||= :show
             else
               url_args[model_class.to_s.underscore.singularize.to_sym] = element.to_param

data/lib/plutonium/definition/actions.rb

@@ -47,7 +47,7 @@ module Plutonium
         action(:destroy, route_options: {method: :delete},
           record_action: true, collection_record_action: true, category: :danger,
           icon: Phlex::TablerIcons::Trash, position: 100,
-          confirmation: "Are you sure?", turbo_frame: "_top", return_to: "")
+          confirmation: "Are you sure?", turbo_frame: "_top")
 
         # Example of dynamic route options using custom url_resolver:
         #

data/lib/plutonium/definition/sorting.rb

@@ -6,9 +6,27 @@ module Plutonium
       included do
         defineable_props :sort
 
+        class_attribute :_default_sort, instance_writer: false, instance_predicate: false
+
         def self.sorts(*names)
           names.each { |name| sort name }
         end
+
+        def self.default_sort(field = nil, direction = :asc, &block)
+          self._default_sort = if block_given?
+            block
+          elsif field
+            [field, direction]
+          end
+          _default_sort
+        end
+
+        # Set a sensible default: newest items first
+        default_sort :id, :desc
+      end
+
+      def default_sort
+        self.class._default_sort
       end
     end
   end

data/lib/plutonium/resource/controllers/queryable.rb

@@ -25,6 +25,10 @@ module Plutonium
                 query_object.define_sorter key, value[:block], **value[:options]
               end
 
+              if current_definition.respond_to?(:default_sort) && current_definition.default_sort
+                query_object.default_sort_config = current_definition.default_sort
+              end
+
               current_definition.defined_filters.each do |key, value|
                 with = value[:options][:with]
                 if with.is_a?(Class) && with < Plutonium::Query::Filter

data/lib/plutonium/resource/query_object.rb

@@ -2,6 +2,7 @@ module Plutonium
   module Resource
     class QueryObject
       attr_reader :search_filter, :search_query
+      attr_accessor :default_sort_config
 
       # Initializes a QueryObject with the given resource_class and parameters.
       #
@@ -221,12 +222,20 @@ module Plutonium
       # @return [Object] The modified scope.
       def apply_sorts(scope, params)
         selected_sort_directions = extract_sort_directions(params)
-        selected_sort_fields.each do |name|
-          next unless (sorter = sort_definitions[name])
 
-          direction = selected_sort_directions[name] || "ASC"
-          scope = sorter.apply(scope, direction:)
+        if selected_sort_fields.any?
+          # Apply user-selected sorts
+          selected_sort_fields.each do |name|
+            next unless (sorter = sort_definitions[name])
+
+            direction = selected_sort_directions[name] || "ASC"
+            scope = sorter.apply(scope, direction:)
+          end
+        elsif default_sort_config
+          # Apply default sort when no sorts are selected
+          scope = apply_default_sort(scope)
         end
+
         scope
       end
 
@@ -250,6 +259,24 @@ module Plutonium
           end
         end.compact
       end
+
+      # Applies the default sort to the given scope
+      #
+      # @param scope [Object] The initial scope
+      # @return [Object] The sorted scope
+      def apply_default_sort(scope)
+        case default_sort_config
+        when Proc
+          # Block form: default_sort { |scope| scope.order(...) }
+          default_sort_config.call(scope)
+        when Array
+          # Field/direction form: default_sort :created_at, :desc
+          field, direction = default_sort_config
+          scope.order(field => direction)
+        else
+          scope
+        end
+      end
     end
   end
 end

data/lib/plutonium/version.rb

@@ -1,5 +1,5 @@
 module Plutonium
-  VERSION = "0.26.6"
+  VERSION = "0.26.8"
   NEXT_MAJOR_VERSION = VERSION.split(".").tap { |v|
     v[1] = v[1].to_i + 1
     v[2] = 0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plutonium
 version: !ruby/object:Gem::Version
-  version: 0.26.6
+  version: 0.26.8
 platform: ruby
 authors:
 - Stefan Froelich
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-03 00:00:00.000000000 Z
+date: 2025-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk