plutonium 0.34.1 → 0.35.0

data/docs/reference/definition/actions.md

@@ -277,6 +277,10 @@ end
 
 ### Bulk Action
 
+Bulk actions operate on multiple selected records. When registered, the resource table automatically shows:
+- **Selection checkboxes** in each row
+- **Bulk actions toolbar** that appears when records are selected
+
 ```ruby
 class BulkArchiveInteraction < Plutonium::Resource::Interaction
   presents label: "Archive Selected", icon: Phlex::TablerIcons::Archive
@@ -296,6 +300,33 @@ class BulkArchiveInteraction < Plutonium::Resource::Interaction
 end
 ```
 
+Register in definition:
+
+```ruby
+class PostDefinition < ResourceDefinition
+  action :bulk_archive, interaction: BulkArchiveInteraction
+  # bulk_action: true is automatically inferred from `resources` attribute
+end
+```
+
+Add the policy method (checked per-record):
+
+```ruby
+class PostPolicy < ResourcePolicy
+  def bulk_archive?
+    # Can use record attributes - checked for each selected record
+    user.admin? || record.author == user
+  end
+end
+```
+
+::: tip Bulk Action Authorization
+Bulk actions use **per-record authorization**:
+- Policy method (e.g., `bulk_archive?`) is checked for **each selected record** - you can use `record` attributes
+- Backend rejects the entire request if any record fails authorization
+- UI only shows actions that **all** selected records support
+:::
+
 ### Resource Action (No Record)
 
 ```ruby
@@ -322,12 +353,12 @@ end
 
 ```ruby
 def execute
-  # Success with message
+  # Success with message (redirects to resource automatically)
   succeed(resource).with_message("Done!")
 
-  # Success with redirect
+  # Success with custom redirect (only if different from default)
   succeed(resource)
-    .with_redirect_response(resource_url_for(resource))
+    .with_redirect_response(custom_dashboard_path)
     .with_message("Redirecting...")
 
   # Failure with field errors
@@ -338,6 +369,10 @@ def execute
 end
 ```
 
+::: tip Automatic Redirect
+Redirect is automatic on success. You can use `with_redirect_response` for a different destination.
+:::
+
 ## Inherited Actions
 
 Actions defined in `ResourceDefinition` are inherited by all definitions:

data/docs/reference/definition/fields.md

@@ -16,7 +16,7 @@ Complete reference for field configuration in definitions.
 ```ruby
 class PostDefinition < Plutonium::Resource::Definition
   # field - changes type everywhere
-  field :content, as: :rich_text
+  field :content, as: :markdown
 
   # input - form-specific
   input :title,
@@ -43,7 +43,7 @@ end
 | Category | Types |
 |----------|-------|
 | **Text** | `:string`, `:text`, `:email`, `:url`, `:tel`, `:password` |
-| **Rich Text** | `:rich_text`, `:markdown` |
+| **Rich Text** | `:markdown` (uses EasyMDE editor) |
 | **Numeric** | `:number`, `:integer`, `:decimal`, `:range` |
 | **Boolean** | `:boolean` |
 | **Date/Time** | `:date`, `:time`, `:datetime` |
@@ -302,7 +302,7 @@ input :documents, as: :uppy,
 ### Rich Text Content
 
 ```ruby
-field :content, as: :rich_text    # Form: rich editor
+field :content, as: :markdown     # Form: EasyMDE editor
 display :content, as: :markdown   # Show: rendered markdown
 ```
 

data/docs/reference/definition/index.md

@@ -10,7 +10,7 @@ Definitions control how resources render - which fields appear in forms, how tab
 class PostDefinition < Plutonium::Resource::Definition
   # Field configuration
   field :title
-  field :body, as: :rich_text
+  field :body, as: :markdown
 
   # Form-specific
   input :title, placeholder: "Enter title"
@@ -81,7 +81,7 @@ Override selectively:
 ```ruby
 class PostDefinition < Plutonium::Resource::Definition
   # Override just body field
-  field :body, as: :rich_text
+  field :body, as: :markdown
 
   # Other fields still auto-detected
 end

data/docs/reference/generators/index.md

@@ -182,7 +182,6 @@ packages/admin_portal/
 │   ├── controllers/admin_portal/
 │   │   ├── concerns/controller.rb
 │   │   ├── plutonium_controller.rb
-│   │   ├── resource_controller.rb
 │   │   └── dashboard_controller.rb
 │   ├── definitions/admin_portal/
 │   ├── policies/admin_portal/

data/docs/reference/interaction/index.md

@@ -156,6 +156,10 @@ rescue ActiveRecord::RecordInvalid => e
 end
 ```
 
+::: warning Handle RecordInvalid
+`ActiveRecord::RecordInvalid` is **not** rescued automatically. Always rescue it when using bang methods (`create!`, `update!`, `save!`).
+:::
+
 ## Constructor
 
 Interactions require `view_context:` and accept attributes as keyword arguments:
@@ -193,10 +197,14 @@ outcome = interaction.call
 
 ## Success Outcomes
 
+::: tip Automatic Redirect
+On success, the controller automatically redirects to the resource.
+:::
+
 ### Basic Success
 
 ```ruby
-succeed(resource)
+succeed(resource)  # Redirects to resource automatically
 ```
 
 ### With Message
@@ -206,11 +214,12 @@ succeed(resource).with_message("Post published!")
 succeed(resource).with_message("Warning: limited visibility", :alert)
 ```
 
-### With Redirect
+### With Custom Redirect
+
+Useful when redirecting somewhere other than the default:
 
 ```ruby
-succeed(resource).with_redirect_response(posts_path)
-succeed(resource).with_redirect_response(resource, status: :see_other)
+succeed(resource).with_redirect_response(custom_dashboard_path)
 ```
 
 ### With File Download
@@ -327,9 +336,7 @@ class Company::InviteUserInteraction < Plutonium::Resource::Interaction
     )
     UserInviteMailer.invitation(invite).deliver_later
 
-    succeed(resource)
-      .with_message("Invitation sent to #{email}")
-      .with_redirect_response(resource)
+    succeed(resource).with_message("Invitation sent to #{email}")
   rescue ActiveRecord::RecordInvalid => e
     failed(e.record.errors)
   end
@@ -434,9 +441,6 @@ end
 1. **Keep interactions focused** - One action per interaction
 2. **Use validations** - Validate all inputs before execution
 3. **Handle errors gracefully** - Rescue exceptions and return `failed()`
-4. **Return meaningful messages** - Help users understand what happened
-5. **Use `and_then` for chains** - Compose complex workflows from simple interactions
-6. **Declare attributes explicitly** - Always declare `resource` or `resources` attributes
 
 ## Related
 

data/docs/reference/model/index.md

@@ -215,5 +215,4 @@ scope :filtered, -> { where(status: 'active') }
 ## Related
 
 - [Model Features](./features)
-- [Resources Concept](/concepts/resources)
 - [Definition Reference](/reference/definition/)

data/docs/reference/portal/index.md

@@ -174,40 +174,27 @@ end
 
 ## Controllers
 
-### Base Controller
-
-```ruby
-# packages/admin_portal/app/controllers/admin_portal/resource_controller.rb
-module AdminPortal
-  class ResourceController < Plutonium::Portal::ResourceController
-    layout "admin_portal/application"
-
-    private
-
-    def after_sign_in_path
-      admin_root_path
-    end
-  end
-end
-```
-
 ### Resource Controllers
 
+Portal-specific controllers inherit from the feature package's controller and include the portal's controller concern:
+
 ```ruby
 # packages/admin_portal/app/controllers/admin_portal/posts_controller.rb
-module AdminPortal
-  class PostsController < ResourceController
-    private
+class AdminPortal::PostsController < ::PostsController
+  include AdminPortal::Concerns::Controller
 
-    def build_resource
-      super.tap do |post|
-        post.user = current_user
-      end
+  private
+
+  def build_resource
+    super.tap do |post|
+      post.user = current_user
     end
   end
 end
 ```
 
+Controllers are auto-created if not defined. When accessing `AdminPortal::PostsController`, Plutonium will dynamically create it by inheriting from `::PostsController` and including `AdminPortal::Concerns::Controller`.
+
 ## Portal-Specific Overrides
 
 ### Definitions
@@ -298,7 +285,7 @@ end
 To allow unauthenticated access to specific actions:
 
 ```ruby
-class AdminPortal::PagesController < AdminPortal::ResourceController
+class AdminPortal::PagesController < AdminPortal::PlutoniumController
   skip_before_action :authenticate, only: [:health]
 
   def health
@@ -314,7 +301,7 @@ end
 ```ruby
 # packages/admin_portal/app/controllers/admin_portal/dashboard_controller.rb
 module AdminPortal
-  class DashboardController < ResourceController
+  class DashboardController < PlutoniumController
     def index
       @stats = {
         posts: Post.count,
@@ -377,6 +364,5 @@ end
 
 ## Related
 
-- [Packages and Portals Concept](/concepts/packages-portals)
 - [Authentication Guide](/guides/authentication)
 - [Multi-tenancy Guide](/guides/multi-tenancy)

data/gemfiles/rails_7.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.33.1)
+    plutonium (0.34.1)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 9.0)

data/gemfiles/rails_8.0.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.33.1)
+    plutonium (0.34.1)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 9.0)

data/gemfiles/rails_8.1.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.33.1)
+    plutonium (0.34.1)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 9.0)

data/lib/generators/pu/pkg/portal/portal_generator.rb

@@ -28,8 +28,6 @@ module Pu
           "packages/#{package_namespace}/app/controllers/#{package_namespace}/concerns/controller.rb"
         template "app/controllers/plutonium_controller.rb",
           "packages/#{package_namespace}/app/controllers/#{package_namespace}/plutonium_controller.rb"
-        template "app/controllers/resource_controller.rb",
-          "packages/#{package_namespace}/app/controllers/#{package_namespace}/resource_controller.rb"
 
         template "app/controllers/dashboard_controller.rb",
           "packages/#{package_namespace}/app/controllers/#{package_namespace}/dashboard_controller.rb"

data/lib/generators/pu/pkg/portal/templates/app/views/package/dashboard/index.html.erb

@@ -1,81 +1,37 @@
-<div class="bg-gray-50 dark:bg-gray-900 p-8 rounded-xl">
-  <h2 class="text-2xl font-bold text-gray-800 dark:text-white mb-6">
-    Resources Management Dashboard
-  </h2>
+<div class="space-y-6">
+  <div>
+    <h1 class="text-2xl font-bold text-[var(--pu-text)]">Dashboard</h1>
+    <p class="text-[var(--pu-text-muted)]">Manage your resources</p>
+  </div>
+
   <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
     <% registered_resources.each do |resource| %>
       <% next unless allowed_to? :index?, resource %>
-      <div
-        class="
-          bg-white dark:bg-gray-800 rounded-lg overflow-hidden shadow-md border-l-4
-          border-primary-600 dark:border-primary-500 transition-all duration-300
-          hover:translate-y-[-2px] hover:shadow-lg
-        "
-      >
-        <div class="flex p-6">
-          <div
-            class="
-              flex-shrink-0 flex items-center justify-center h-12 w-12 rounded-md
-              bg-primary-50 dark:bg-primary-900/30
-            "
-          >
-            <svg
-              class="h-6 w-6 text-primary-600 dark:text-primary-400"
-              xmlns="http://www.w3.org/2000/svg"
-              fill="none"
-              viewBox="0 0 24 24"
-              stroke="currentColor"
-            >
-              <path
-                stroke-linecap="round"
-                stroke-linejoin="round"
-                stroke-width="2"
-                d="M20 7l-8-4-8 4m16 0l-8 4m8-4v10l-8 4m0-10L4 7m8 4v10M4 7v10l8 4"
-              />
-            </svg>
-          </div>
-          <div class="ml-4 flex-1">
-            <h3
-              class="
-                text-lg font-semibold text-gray-900 dark:text-white flex items-center
-              "
-            >
-              <%= resource.model_name.human.titleize.pluralize %>
-              <span
-                class="
-                  ml-2 px-2 py-0.5 text-xs rounded-full bg-primary-100 text-primary-800
-                  dark:bg-primary-900 dark:text-primary-200
-                "
-              ><%= authorized_resource_scope(resource).count %></span>
-            </h3>
+      <div class="pu-card group hover:shadow-[var(--pu-shadow-lg)] transition-shadow">
+        <div class="pu-card-body space-y-4">
+          <div class="flex items-start justify-between">
+            <div class="flex items-center gap-3">
+              <div class="flex items-center justify-center h-10 w-10 rounded-[var(--pu-radius-md)] bg-primary-100 dark:bg-primary-900/30">
+                <svg class="h-5 w-5 text-primary-600 dark:text-primary-400" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2">
+                  <path stroke-linecap="round" stroke-linejoin="round" d="M20 7l-8-4-8 4m16 0l-8 4m8-4v10l-8 4m0-10L4 7m8 4v10M4 7v10l8 4" />
+                </svg>
+              </div>
+              <div>
+                <h3 class="font-semibold text-[var(--pu-text)]"><%= resource.model_name.human.titleize.pluralize %></h3>
+                <p class="text-sm text-[var(--pu-text-muted)]"><%= authorized_resource_scope(resource).count %> records</p>
+              </div>
+            </div>
           </div>
-        </div>
-        <div class="bg-gray-50 dark:bg-gray-700/50 px-6 py-3">
-          <div
-            class="
-              text-xs font-medium text-gray-500 dark:text-gray-400 uppercase tracking-wider
-            "
-          >Quick Actions</div>
-          <div class="mt-2 flex space-x-2">
-            <%# Check for resource creation permission %>
+
+          <div class="flex items-center gap-2 pt-2 border-t border-[var(--pu-border-muted)]">
+            <a href="<%= resource_url_for(resource, parent: nil) %>" class="pu-btn pu-btn-sm pu-btn-primary">
+              View All
+            </a>
             <% if allowed_to? :new?, resource %>
-              <a
-                href="<%= resource_url_for(resource, parent: nil, action: :new) %>"
-                class="
-                  px-2 py-1 text-xs font-medium rounded bg-white dark:bg-gray-700 text-gray-700
-                  dark:text-gray-300 border border-gray-200 dark:border-gray-600 hover:bg-gray-50
-                  dark:hover:bg-gray-600 transition-colors
-                "
-              >Add New</a>
+              <a href="<%= resource_url_for(resource, parent: nil, action: :new) %>" class="pu-btn pu-btn-sm pu-btn-outline">
+                Add New
+              </a>
             <% end %>
-            <a
-              href="<%= resource_url_for(resource, parent: nil) %>"
-              class="
-                px-2 py-1 text-xs font-medium rounded bg-white dark:bg-gray-700 text-gray-700
-                dark:text-gray-300 border border-gray-200 dark:border-gray-600 hover:bg-gray-50
-                dark:hover:bg-gray-600 transition-colors
-              "
-            >View All</a>
           </div>
         </div>
       </div>

data/lib/plutonium/action/interactive.rb

@@ -79,7 +79,7 @@ module Plutonium
           if attribute_names.include?(:resource)
             :interactive_record_action
           elsif attribute_names.include?(:resources)
-            :interactive_collection_action
+            :interactive_bulk_action
           else
             :interactive_resource_action
           end
@@ -99,7 +99,7 @@ module Plutonium
         # @return [Hash] The action options
         def self.determine_action_options(action_type)
           {
-            bulk_action: action_type == :interactive_collection_action,
+            bulk_action: action_type == :interactive_bulk_action,
             record_action: action_type == :interactive_record_action,
             collection_record_action: action_type == :interactive_record_action,
             resource_action: action_type == :interactive_resource_action

data/lib/plutonium/core/controller.rb

@@ -101,7 +101,8 @@ module Plutonium
         end
 
         # Preserve the request format unless explicitly specified
-        if !url_args.key?(:format) && request.present? && request.format.present? && request.format.symbol != :html
+        # Don't preserve turbo_stream as it's for streaming updates, not page navigation
+        if !url_args.key?(:format) && request.present? && request.format.present? && !request.format.symbol.in?([:html, :turbo_stream])
           url_args[:format] = request.format.symbol
         end
 

data/lib/plutonium/definition/actions.rb

@@ -37,11 +37,11 @@ module Plutonium
           icon: Phlex::TablerIcons::Plus, position: 10)
 
         action(:show, route_options: {action: :show},
-          collection_record_action: true,
+          collection_record_action: true, category: :primary,
           icon: Phlex::TablerIcons::Eye, position: 10)
 
         action(:edit, route_options: {action: :edit},
-          record_action: true, collection_record_action: true,
+          record_action: true, collection_record_action: true, category: :primary,
           icon: Phlex::TablerIcons::Edit, position: 20)
 
         action(:destroy, route_options: {method: :delete},

data/lib/plutonium/lib/deep_freezer.rb

@@ -4,6 +4,9 @@ module Plutonium
   module Lib
     class DeepFreezer
       def self.freeze(object)
+        # Never freeze Class or Module objects - they have mutable state that Rails needs
+        return object if object.is_a?(Class) || object.is_a?(Module)
+
         #  Recursive calling #deep_freeze for enumerable objects.
         if object.respond_to? :each
           if object.instance_of?(Hash)
@@ -13,13 +16,6 @@ module Plutonium
           end
         end
 
-        # #  Freezing of all instance variable values.
-        # object.instance_variables.each do |var|
-        #   frozen_val = instance_variable_get(var)
-        #   frozen_val.deep_freeze
-        #   instance_variable_set(var, frozen_val)
-        # end
-
         if object.frozen?
           object
         else

data/lib/plutonium/query/filter.rb

@@ -3,6 +3,20 @@ module Plutonium
     class Filter < Base
       attr_reader :key
 
+      class << self
+        # Lookup a filter class by type symbol or return the class if already a Filter
+        # @param type [Symbol, Class] The type symbol (e.g., :text, :select) or a Filter class
+        # @return [Class] The filter class
+        def lookup(type)
+          return type if type.is_a?(Class) && type < Filter
+
+          class_name = "Plutonium::Query::Filters::#{type.to_s.classify}"
+          class_name.constantize
+        rescue NameError
+          raise ArgumentError, "Unknown filter type: #{type}. Expected #{class_name} to exist."
+        end
+      end
+
       def initialize(key:)
         super()
         @key = key

data/lib/plutonium/query/filters/association.rb

@@ -0,0 +1,49 @@
+module Plutonium
+  module Query
+    module Filters
+      # Select filter for association records
+      #
+      # @example Basic - infers Category class from :category key
+      #   filter :category, with: :association
+      #
+      # @example With explicit class
+      #   filter :author, with: :association, class_name: User
+      #
+      # @example With multiple selection
+      #   filter :tags, with: :association, class_name: Tag, multiple: true
+      #
+      class Association < Filter
+        def initialize(class_name: nil, multiple: false, **)
+          super(**)
+          @association_class = class_name
+          @multiple = multiple
+        end
+
+        def apply(scope, value:)
+          return scope if value.blank?
+
+          foreign_key = :"#{key}_id"
+          if @multiple && value.is_a?(Array)
+            scope.where(foreign_key => value.reject(&:blank?))
+          else
+            scope.where(foreign_key => value)
+          end
+        end
+
+        def customize_inputs
+          input :value,
+            as: :resource_select,
+            association_class: association_class,
+            multiple: @multiple,
+            include_blank: @multiple ? false : "All"
+        end
+
+        private
+
+        def association_class
+          @association_class || key.to_s.classify.constantize
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/query/filters/boolean.rb

@@ -0,0 +1,35 @@
+module Plutonium
+  module Query
+    module Filters
+      # Boolean filter for true/false columns
+      #
+      # @example Basic usage
+      #   filter :active, with: :boolean
+      #
+      # @example With custom labels
+      #   filter :published, with: :boolean, true_label: "Published", false_label: "Draft"
+      #
+      class Boolean < Filter
+        def initialize(true_label: "Yes", false_label: "No", **)
+          super(**)
+          @true_label = true_label
+          @false_label = false_label
+        end
+
+        def apply(scope, value:)
+          return scope if value.blank?
+
+          bool_value = ActiveModel::Type::Boolean.new.cast(value)
+          scope.where(key => bool_value)
+        end
+
+        def customize_inputs
+          input :value,
+            as: :select,
+            choices: [[@true_label, "true"], [@false_label, "false"]],
+            include_blank: "All"
+        end
+      end
+    end
+  end
+end