plutonium 0.38.0 → 0.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a3ade68b80487615f8ad46432edb306cde755d712e7222b11705427f9a283ca
-  data.tar.gz: 10e95e8c085c8b7229929f50517fce9d964a1ff2ca31b0ee20662ca863c88f47
+  metadata.gz: 7c8fc50a1fe8c28ef9db4c7bef8b632c2b3c15524be2572085433e7185ed6923
+  data.tar.gz: 3dacb628155eeb439002f145c16fac47237ce55f1dc2d90c0253df36ec7f70a4
 SHA512:
-  metadata.gz: e4a5ac3024c168686c6c315d2d7fa280c708a7e807580a422cb20223b6ccf2f95e96876e6a56d9ca88ee8fcbb63cc906dba33ad02af73a62f167bd91431a1a08
-  data.tar.gz: a0644bf92081d308e0ef306d38168d63138864c54534fea161c20b9f2d79e8556914239dd3122854686e0fee140758f9aa49b2b9c72248a48868045405fffbd5
+  metadata.gz: '03919fed054eca767c0904b360c575af0b217b90acabec6688622e17fdfeabccbf024fd6343e8cc51ea0497ac53a37eb483e567063ec08a7a499eeaa86a5e96a'
+  data.tar.gz: e810b4a35375822961f4aad503603d3970a4c6217d65f4a9394f5b4952bc860b519bb405c0319dcef4418aa13711c5b04f2a5a0918070a6ad6f6b6cbeacf557b

data/.claude/skills/plutonium-controller/SKILL.md

@@ -151,6 +151,19 @@ class PostsController < ::ResourceController
 end
 ```
 
+**Important:** When adding custom routes, always use the `as:` option to name them:
+
+```ruby
+# config/routes.rb or portal routes
+resources :posts do
+  member do
+    post :publish, as: :publish  # Named route required!
+  end
+end
+```
+
+This ensures `resource_url_for` can generate correct URLs, especially for nested resources.
+
 Note: For most custom operations, use Interactive Actions in definitions instead.
 
 ## Key Methods

data/.claude/skills/plutonium-definition-actions/SKILL.md

@@ -37,6 +37,19 @@ class PostDefinition < ResourceDefinition
 end
 ```
 
+**Important:** When adding custom routes for actions, always use the `as:` option to name them:
+
+```ruby
+# In your portal routes or config/routes.rb
+resources :posts do
+  collection do
+    get :reports, as: :reports  # Named route required!
+  end
+end
+```
+
+This ensures `resource_url_for` can generate correct URLs, especially for nested resources.
+
 **Note:** For custom operations with business logic, use **Interactive Actions** with an Interaction class instead. That's the recommended approach for most custom actions.
 
 ## Interactive Actions (with Interaction)

data/.claude/skills/plutonium-nested-resources/SKILL.md

@@ -316,15 +316,17 @@ Add custom member/collection routes to nested resources:
 ```ruby
 register_resource ::Property do
   member do
-    get :analytics
-    post :archive
+    get :analytics, as: :analytics
+    post :archive, as: :archive
   end
 end
 ```
 
+**Important:** Always use the `as:` option to name custom routes. This ensures `resource_url_for` can generate correct URLs for nested resources. Without named routes, URL generation will fail.
+
 Generates nested routes:
-- `/companies/:company_id/properties/:id/analytics`
-- `/companies/:company_id/properties/:id/archive`
+- `/companies/:company_id/nested_properties/:id/analytics`
+- `/companies/:company_id/nested_properties/:id/archive`
 
 ## Related Skills
 

data/CHANGELOG.md

@@ -1,4 +1,4 @@
-## [0.38.0] - 2026-01-25
+## [0.39.0] - 2026-01-26
 
 ### 🚀 Features
 
@@ -14,9 +14,14 @@
 - Remove duplicate kv store controller and move improvements into original
 - *(filters)* Improve association filter class resolution
 - *(ui)* Improve dropdown positioning with viewport boundary
+- *(auth)* Dynamically detect database adapter for Rodauth (#51)
 - *(crud)* Use correct action attributes for form re-rendering on errors
 - *(form)* Distinguish empty vs not-submitted key-value store fields
 - *(controller)* Use existing record context for form param extraction
+- *(controller)* Prevent UrlGenerationError when extracting params for nested resource update
+- *(routing)* Correct URL generation for interactive actions on nested resources
+- *(ui)* Replace deprecated phlex-rails `helpers` method with `view_context`
+- *(routing)* Add named routes for commit actions and document route naming requirement
 
 ### 📚 Documentation
 
@@ -34,6 +39,7 @@
 - Use chokidar to fix dev build cyclic dependency issues
 - Warn when running tests without Appraisal
 - Switch to yarn
+- Update og image
 ## [0.37.0] - 2026-01-21
 
 ### 🚀 Features

data/docs/guides/custom-actions.md

@@ -39,6 +39,20 @@ class PostDefinition < ResourceDefinition
 end
 ```
 
+::: warning Always Name Custom Routes
+When adding custom routes for actions, always use the `as:` option:
+
+```ruby
+resources :posts do
+  collection do
+    get :reports, as: :reports  # Named route required!
+  end
+end
+```
+
+This ensures `resource_url_for` can generate correct URLs, especially for nested resources.
+:::
+
 **Note:** For custom operations with business logic, use Interactive Actions with an Interaction class.
 
 ## Interactive Actions with Interactions

data/docs/guides/nested-resources.md

@@ -388,15 +388,19 @@ Add member/collection routes:
 ```ruby
 register_resource ::Comment do
   member do
-    post :approve
-    post :flag
+    post :approve, as: :approve
+    post :flag, as: :flag
   end
   collection do
-    get :pending
+    get :pending, as: :pending
   end
 end
 ```
 
+::: warning Always Name Custom Routes
+Always use the `as:` option when defining custom routes. This ensures `resource_url_for` can generate correct URLs. Without named routes, URL generation will fail for nested resources.
+:::
+
 Generates nested routes:
 - `POST /posts/:post_id/nested_comments/:id/approve`
 - `POST /posts/:post_id/nested_comments/:id/flag`

data/docs/og-image.html

@@ -0,0 +1,84 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <style>
+    * {
+      margin: 0;
+      padding: 0;
+      box-sizing: border-box;
+    }
+
+    body {
+      width: 1200px;
+      height: 630px;
+      background: #1e2330;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+    }
+
+    .container {
+      display: flex;
+      flex-direction: row;
+      align-items: center;
+      gap: 60px;
+    }
+
+    .logo {
+      width: 260px;
+      height: 260px;
+      object-fit: contain;
+    }
+
+    .content {
+      display: flex;
+      flex-direction: column;
+      gap: 16px;
+    }
+
+    .title {
+      font-size: 88px;
+      font-weight: 700;
+      color: #ffffff;
+      letter-spacing: -1px;
+    }
+
+    .tagline {
+      font-size: 40px;
+      color: #b8bcc8;
+      font-weight: 400;
+    }
+
+    .features {
+      display: flex;
+      gap: 24px;
+      margin-top: 12px;
+      font-size: 26px;
+      color: #e07c5a;
+      font-weight: 500;
+    }
+
+    .features span:not(:last-child)::after {
+      content: '·';
+      margin-left: 24px;
+      color: #e07c5a;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <img src="public/plutonium.png" alt="Plutonium" class="logo">
+    <div class="content">
+      <div class="title">Plutonium</div>
+      <div class="tagline">Build Rails Apps in Minutes, Not Days</div>
+      <div class="features">
+        <span>Convention-driven</span>
+        <span>AI-ready</span>
+        <span>Fully customizable</span>
+      </div>
+    </div>
+  </div>
+</body>
+</html>

data/docs/reference/controller/index.md

@@ -219,11 +219,15 @@ end
 # In portal routes or config/routes.rb
 register_resource Post do
   member do
-    post :publish
+    post :publish, as: :publish  # Always use as: option!
   end
 end
 ```
 
+::: warning Always Name Custom Routes
+Always use the `as:` option when defining custom routes. This ensures `resource_url_for` can generate correct URLs, especially for nested resources.
+:::
+
 ## Authorization
 
 ### Automatic Authorization

data/docs/reference/definition/actions.md

@@ -39,6 +39,20 @@ class PostDefinition < Plutonium::Resource::Definition
 end
 ```
 
+::: warning Always Name Custom Routes
+When adding custom routes for actions, always use the `as:` option:
+
+```ruby
+resources :posts do
+  collection do
+    get :reports, as: :reports  # Named route required!
+  end
+end
+```
+
+This ensures `resource_url_for` can generate correct URLs, especially for nested resources.
+:::
+
 **Note:** For custom operations with business logic, use **Interactive Actions** with an Interaction class.
 
 ## Interactive Actions

data/gemfiles/rails_7.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.37.0)
+    plutonium (0.38.0)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 9.0)
@@ -11,8 +11,8 @@ PATH
       phlex-tabler_icons
       phlexi-display (>= 0.2.0)
       phlexi-field (>= 0.2.0)
-      phlexi-form (>= 0.14.0)
-      phlexi-menu (>= 0.4.0)
+      phlexi-form (>= 0.14.1)
+      phlexi-menu (>= 0.4.1)
       phlexi-table (>= 0.2.0)
       rabl (~> 0.16.1)
       rails (>= 7.2)
@@ -230,12 +230,12 @@ GEM
       fiber-local
       phlex (~> 2.0)
       zeitwerk
-    phlexi-form (0.14.0)
+    phlexi-form (0.14.1)
       activesupport
       phlex (~> 2.0)
       phlexi-field (~> 0.2.0)
       zeitwerk
-    phlexi-menu (0.4.0)
+    phlexi-menu (0.4.1)
       phlex (~> 2.0)
       phlexi-field (~> 0.2.0)
       zeitwerk

data/gemfiles/rails_8.0.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.37.0)
+    plutonium (0.38.0)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 9.0)
@@ -11,8 +11,8 @@ PATH
       phlex-tabler_icons
       phlexi-display (>= 0.2.0)
       phlexi-field (>= 0.2.0)
-      phlexi-form (>= 0.14.0)
-      phlexi-menu (>= 0.4.0)
+      phlexi-form (>= 0.14.1)
+      phlexi-menu (>= 0.4.1)
       phlexi-table (>= 0.2.0)
       rabl (~> 0.16.1)
       rails (>= 7.2)
@@ -209,12 +209,12 @@ GEM
       fiber-local
       phlex (~> 2.0)
       zeitwerk
-    phlexi-form (0.14.0)
+    phlexi-form (0.14.1)
       activesupport
       phlex (~> 2.0)
       phlexi-field (~> 0.2.0)
       zeitwerk
-    phlexi-menu (0.4.0)
+    phlexi-menu (0.4.1)
       phlex (~> 2.0)
       phlexi-field (~> 0.2.0)
       zeitwerk

data/gemfiles/rails_8.1.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.37.0)
+    plutonium (0.38.0)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 9.0)
@@ -11,8 +11,8 @@ PATH
       phlex-tabler_icons
       phlexi-display (>= 0.2.0)
       phlexi-field (>= 0.2.0)
-      phlexi-form (>= 0.14.0)
-      phlexi-menu (>= 0.4.0)
+      phlexi-form (>= 0.14.1)
+      phlexi-menu (>= 0.4.1)
       phlexi-table (>= 0.2.0)
       rabl (~> 0.16.1)
       rails (>= 7.2)
@@ -211,12 +211,12 @@ GEM
       fiber-local
       phlex (~> 2.0)
       zeitwerk
-    phlexi-form (0.14.0)
+    phlexi-form (0.14.1)
       activesupport
       phlex (~> 2.0)
       phlexi-field (~> 0.2.0)
       zeitwerk
-    phlexi-menu (0.4.0)
+    phlexi-menu (0.4.1)
       phlex (~> 2.0)
       phlexi-field (~> 0.2.0)
       zeitwerk

data/lib/generators/pu/rodauth/install_generator.rb

@@ -1,20 +1,13 @@
 require "rails/generators/base"
 require "rails/generators/active_record/migration"
 require "securerandom"
+require "plutonium/auth/sequel_adapter"
 
 module Pu
   module Rodauth
     class InstallGenerator < ::Rails::Generators::Base
       include ::ActiveRecord::Generators::Migration
 
-      SEQUEL_ADAPTERS = {
-        "postgresql" => (RUBY_ENGINE == "jruby") ? "postgresql" : "postgres",
-        "mysql2" => (RUBY_ENGINE == "jruby") ? "mysql" : "mysql2",
-        "sqlite3" => "sqlite",
-        "oracle_enhanced" => "oracle",
-        "sqlserver" => (RUBY_ENGINE == "jruby") ? "mssql" : "tinytds"
-      }
-
       source_root "#{__dir__}/templates"
 
       desc "Install rodauth-rails"
@@ -61,15 +54,18 @@ module Pu
 
       private
 
+      # Delegates to the SequelAdapter module to avoid code duplication.
       def sequel_adapter
-        SEQUEL_ADAPTERS[activerecord_adapter] || activerecord_adapter
+        Plutonium::Auth::SequelAdapter.sequel_adapter
       end
 
+      # Delegates to the SequelAdapter module's internal ActiveRecord adapter detection.
+      # We still provide this method for use in create_install_migration.
       def activerecord_adapter
         if ActiveRecord::Base.respond_to?(:connection_db_config)
-          ActiveRecord::Base.connection_db_config.adapter
+          ActiveRecord::Base.connection_db_config&.adapter
         else
-          ActiveRecord::Base.connection_config.fetch(:adapter)
+          ActiveRecord::Base.connection_config&.fetch(:adapter, nil)
         end
       end
     end

data/lib/generators/pu/rodauth/templates/app/rodauth/rodauth_plugin.rb.tt

@@ -1,4 +1,5 @@
 require "sequel/core"
+require "plutonium/auth/sequel_adapter"
 
 class RodauthPlugin < Rodauth::Rails::Auth
   attr_accessor :url_options
@@ -17,11 +18,8 @@ class RodauthPlugin < Rodauth::Rails::Auth
     # ==> General
 
     # Initialize Sequel and have it reuse Active Record's database connection.
-<% if RUBY_ENGINE == "jruby" -%>
-    db Sequel.connect("jdbc:<%= sequel_adapter %>://", extensions: :activerecord_connection, keep_reference: false)
-<% else -%>
-    db Sequel.<%= sequel_adapter %>(extensions: :activerecord_connection, keep_reference: false)
-<% end -%>
+    # The adapter is detected dynamically at runtime to support database changes.
+    db Plutonium::Auth::SequelAdapter.db
 
     # Change prefix of table and foreign key column names from default "account"
     # accounts_table :users

data/lib/plutonium/auth/sequel_adapter.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "sequel/core"
+
+module Plutonium
+  module Auth
+    # Provides runtime detection of the database adapter for Sequel configuration.
+    # This module dynamically detects the ActiveRecord adapter and returns the
+    # corresponding Sequel adapter, allowing users to change their database
+    # without needing to regenerate rodauth files.
+    module SequelAdapter
+      # Maps ActiveRecord adapter names to their corresponding Sequel adapter names.
+      # JRuby uses JDBC adapters which have different naming conventions.
+      SEQUEL_ADAPTERS = {
+        "postgresql" => (RUBY_ENGINE == "jruby") ? "postgresql" : "postgres",
+        "mysql2" => (RUBY_ENGINE == "jruby") ? "mysql" : "mysql2",
+        "sqlite3" => "sqlite",
+        "oracle_enhanced" => "oracle",
+        "sqlserver" => (RUBY_ENGINE == "jruby") ? "mssql" : "tinytds"
+      }.freeze
+
+      class << self
+        # Returns a Sequel database connection that reuses ActiveRecord's connection.
+        # Automatically detects the correct adapter based on the current ActiveRecord config.
+        #
+        # @return [Sequel::Database] configured Sequel database connection
+        # @raise [RuntimeError] if the Sequel adapter initialization fails
+        def db
+          adapter = sequel_adapter
+          begin
+            if RUBY_ENGINE == "jruby"
+              Sequel.connect("jdbc:#{adapter}://", extensions: :activerecord_connection, keep_reference: false)
+            else
+              Sequel.public_send(adapter, extensions: :activerecord_connection, keep_reference: false)
+            end
+          rescue => e
+            raise "Failed to initialize Sequel with adapter '#{adapter}'. " \
+                  "Please ensure your database configuration is correct and the required " \
+                  "database gems are installed. Original error: #{e.message}"
+          end
+        end
+
+        # Returns the Sequel adapter name based on the current ActiveRecord adapter.
+        # If the ActiveRecord adapter is not in the SEQUEL_ADAPTERS mapping, the
+        # ActiveRecord adapter name is returned as-is, which may work for adapters
+        # where the names match between ActiveRecord and Sequel.
+        #
+        # @return [String] the Sequel adapter name
+        def sequel_adapter
+          SEQUEL_ADAPTERS[activerecord_adapter] || activerecord_adapter
+        end
+
+        private
+
+        # Returns the current ActiveRecord adapter name.
+        #
+        # @return [String] the ActiveRecord adapter name
+        # @raise [RuntimeError] if the ActiveRecord adapter cannot be determined
+        def activerecord_adapter
+          adapter = if ActiveRecord::Base.respond_to?(:connection_db_config)
+            ActiveRecord::Base.connection_db_config&.adapter
+          else
+            ActiveRecord::Base.connection_config&.fetch(:adapter, nil)
+          end
+
+          unless adapter
+            raise "Unable to determine the ActiveRecord database adapter. " \
+                  "Please ensure ActiveRecord is properly configured with a database connection."
+          end
+
+          adapter
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/core/controller.rb

@@ -166,9 +166,8 @@ module Plutonium
         end
 
         helper_suffix = case action
-        when :new then "new_"
-        when :edit then "edit_"
-        else ""
+        when :show, nil then ""
+        else "#{action}_"
         end
 
         helper_name = :"#{helper_suffix}#{helper_base}_path"

data/lib/plutonium/resource/controller.rb

@@ -135,8 +135,9 @@ module Plutonium
       # @return [Hash] The submitted resource parameters
       def submitted_resource_params
         # Use existing record (cloned) for context during param extraction, or new instance for create
+        # Pass form_action: false to prevent form from trying to generate URL (cloned record has id: nil)
         extraction_record = resource_record?&.dup || resource_class.new
-        @submitted_resource_params ||= build_form(extraction_record).extract_input(params, view_context:)[resource_param_key.to_sym].compact
+        @submitted_resource_params ||= build_form(extraction_record, form_action: false).extract_input(params, view_context:)[resource_param_key.to_sym].compact
       end
 
       # Returns the resource parameters, including scoped and parent parameters
@@ -273,7 +274,7 @@ module Plutonium
       def resource_url_args_for(*, **kwargs)
         kwargs[:parent] = current_parent unless kwargs.key?(:parent)
         # Pass the current association when in a nested context
-        if current_parent && !kwargs.key?(:association) && current_nested_association
+        if kwargs[:parent] && !kwargs.key?(:association) && current_nested_association
           kwargs[:association] = current_nested_association
         end
         super

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

@@ -46,8 +46,10 @@ module Plutonium
           current_definition.detail_class.new(resource_record!, resource_fields: presentable_attributes, resource_associations: permitted_associations, resource_definition: current_definition)
         end
 
-        def build_form(record = resource_record!, action: action_name)
-          current_definition.form_class.new(record, resource_fields: submittable_attributes_for(action), resource_definition: current_definition)
+        def build_form(record = resource_record!, action: action_name, form_action: nil, **)
+          form_options = {resource_fields: submittable_attributes_for(action), resource_definition: current_definition, **}
+          form_options[:action] = form_action unless form_action.nil?
+          current_definition.form_class.new(record, **form_options)
         end
 
         def present_parent? = false

data/lib/plutonium/routing/mapper_extensions.rb

@@ -127,8 +127,9 @@ module Plutonium
       def define_member_interactive_actions
         member do
           get "record_actions/:interactive_action", action: :interactive_record_action,
-            as: :record_action
-          post "record_actions/:interactive_action", action: :commit_interactive_record_action
+            as: :interactive_record_action
+          post "record_actions/:interactive_action", action: :commit_interactive_record_action,
+            as: :commit_interactive_record_action
         end
       end
 
@@ -138,12 +139,14 @@ module Plutonium
       def define_collection_interactive_actions
         collection do
           get "bulk_actions/:interactive_action", action: :interactive_bulk_action,
-            as: :bulk_action
-          post "bulk_actions/:interactive_action", action: :commit_interactive_bulk_action
+            as: :interactive_bulk_action
+          post "bulk_actions/:interactive_action", action: :commit_interactive_bulk_action,
+            as: :commit_interactive_bulk_action
 
           get "resource_actions/:interactive_action", action: :interactive_resource_action,
-            as: :resource_action
-          post "resource_actions/:interactive_action", action: :commit_interactive_resource_action
+            as: :interactive_resource_action
+          post "resource_actions/:interactive_action", action: :commit_interactive_resource_action,
+            as: :commit_interactive_resource_action
         end
       end
 

data/lib/plutonium/ui/action_button.rb

@@ -17,6 +17,13 @@ module Plutonium
         secondary: {default: "pu-btn-secondary", soft: "pu-btn-soft-secondary"}
       }.freeze
 
+      # Color to CSS class mapping for dropdown item variants
+      DROPDOWN_COLOR_CLASSES = {
+        danger: "text-danger-600 dark:text-danger-400 hover:bg-danger-50 dark:hover:bg-danger-900/30"
+      }.freeze
+
+      DROPDOWN_DEFAULT_COLOR = "text-[var(--pu-text)] hover:bg-[var(--pu-surface-alt)]"
+
       def initialize(action, url:, variant: :default)
         @action = action
         @url = url
@@ -24,24 +31,23 @@ module Plutonium
       end
 
       def view_template
-        if @action.route_options.method == :get
-          render_link
+        case @variant
+        when :dropdown, :row_dropdown
+          render_dropdown_item
         else
-          render_button
+          if @action.route_options.method == :get
+            render_link
+          else
+            render_button
+          end
         end
       end
 
       private
 
       def render_link
-        uri = URI.parse(@url)
-        params = Rack::Utils.parse_nested_query(uri.query)
-        params["return_to"] = @action.return_to.nil? ? request.original_url : @action.return_to
-        uri.query = params.to_query
-        uri.to_s
-
         link_to(
-          uri.to_s,
+          url_with_return_to,
           class: button_classes,
           data: {turbo_frame: @action.turbo_frame}
         ) do
@@ -53,7 +59,7 @@ module Plutonium
         button_to(
           @url,
           method: @action.route_options.method,
-          name: :return_to, value: (@action.return_to.nil? ? request.original_url : @action.return_to),
+          name: :return_to, value: return_to_url,
           class: "inline-block",
           form: {
             data: {
@@ -69,6 +75,28 @@ module Plutonium
         end
       end
 
+      def render_dropdown_item
+        link_attrs = {
+          href: url_with_return_to,
+          class: dropdown_item_classes
+        }
+
+        # Add turbo frame if specified
+        link_attrs[:data] = {turbo_frame: @action.turbo_frame} if @action.turbo_frame
+
+        # Add confirmation and method for non-GET requests
+        if @action.confirmation || @action.route_options.method != :get
+          link_attrs[:data] ||= {}
+          link_attrs[:data][:turbo_method] = @action.route_options.method if @action.route_options.method != :get
+          link_attrs[:data][:turbo_confirm] = @action.confirmation if @action.confirmation
+        end
+
+        a(**link_attrs) do
+          render @action.icon.new(class: "w-4 h-4") if @action.icon
+          span { @action.label }
+        end
+      end
+
       def render_button_content
         if @action.icon
           render @action.icon.new(class: icon_classes)
@@ -100,6 +128,39 @@ module Plutonium
         # Table variant uses soft (tinted) buttons, default uses solid buttons
         (@variant == :table) ? color_mapping[:soft] : color_mapping[:default]
       end
+
+      def dropdown_item_classes
+        base_classes = "flex items-center gap-2 text-sm transition-colors"
+        size_classes = (@variant == :row_dropdown) ? "px-3 py-1.5" : "px-4 py-2"
+
+        # Use same color determination as buttons: color || category
+        color_key = (@action.color || @action.category)&.to_sym
+        color_classes = DROPDOWN_COLOR_CLASSES[color_key] || DROPDOWN_DEFAULT_COLOR
+
+        "#{base_classes} #{size_classes} #{color_classes}"
+      end
+
+      def url_with_return_to
+        uri = URI.parse(@url)
+        params = Rack::Utils.parse_nested_query(uri.query)
+        params["return_to"] = return_to_url
+        uri.query = params.to_query
+        uri.to_s
+      end
+
+      def default_return_to
+        # When in a turbo frame with a parent, return to parent's show page
+        # instead of the frame's URL (which would be the nested index)
+        if current_turbo_frame && current_parent
+          resource_url_for(current_parent, parent: nil)
+        else
+          request.original_url
+        end
+      end
+
+      def return_to_url
+        @action.return_to.nil? ? default_return_to : @action.return_to
+      end
     end
   end
 end

data/lib/plutonium/ui/actions_dropdown.rb

@@ -56,35 +56,13 @@ module Plutonium
 
       def render_danger_actions
         div(class: "py-1") do
-          danger_actions.each { |action| render_action_item(action, danger: true) }
+          danger_actions.each { |action| render_action_item(action) }
         end
       end
 
-      def render_action_item(action, danger: false)
+      def render_action_item(action)
         url = route_options_to_url(action.route_options, @subject)
-
-        link_attrs = {
-          href: url,
-          class: tokens(
-            "flex items-center gap-2 px-4 py-2 text-sm transition-colors",
-            danger ? "text-danger-600 dark:text-danger-400 hover:bg-danger-50 dark:hover:bg-danger-900/30" : "text-[var(--pu-text)] hover:bg-[var(--pu-surface-alt)]"
-          )
-        }
-
-        # Add turbo frame if specified
-        link_attrs[:data] = {turbo_frame: action.turbo_frame} if action.turbo_frame
-
-        # Add confirmation if specified
-        if action.confirmation
-          link_attrs[:data] ||= {}
-          link_attrs[:data][:turbo_method] = :delete if action.route_options.method == :delete
-          link_attrs[:data][:turbo_confirm] = action.confirmation
-        end
-
-        a(**link_attrs) do
-          render action.icon.new(class: "w-4 h-4") if action.icon
-          span { action.label }
-        end
+        render ActionButton.new(action, url: url, variant: :dropdown)
       end
 
       def secondary_actions

data/lib/plutonium/ui/breadcrumbs.rb

@@ -15,7 +15,7 @@ module Plutonium
             # Dashboard
             li(class: "inline-flex items-center") do
               a(
-                href: helpers.root_path,
+                href: root_path,
                 class: "inline-flex items-center text-sm font-medium text-[var(--pu-text-muted)] hover:text-primary-600 transition-colors"
               ) do
                 svg(
@@ -101,7 +101,7 @@ module Plutonium
                       d: "m1 9 4-4-4-4"
                     )
                   end
-                  link_to helpers.nestable_resource_name_plural(resource_class),
+                  link_to nestable_resource_name_plural(resource_class),
                     resource_url_for(resource_class),
                     class: "ms-1 text-sm font-medium text-[var(--pu-text-muted)] hover:text-primary-600 md:ms-2 transition-colors"
                 end

data/lib/plutonium/ui/component/methods.rb

@@ -11,15 +11,19 @@ module Plutonium
         private
 
         def params
-          helpers.controller.params
+          view_context.controller.params
         end
 
         def request
-          helpers.controller.request
+          view_context.controller.request
         end
 
         def pagy_instance
-          helpers.controller.instance_variable_get(:@pagy)
+          view_context.controller.instance_variable_get(:@pagy)
+        end
+
+        def controller
+          view_context.controller
         end
 
         delegate \
@@ -29,6 +33,7 @@ module Plutonium
           :resource_record?,
           :resource_name,
           :resource_name_plural,
+          :nestable_resource_name_plural,
           :display_name_of,
           :resource_url_for,
           :route_options_to_url,
@@ -46,6 +51,8 @@ module Plutonium
           :allowed_to?,
           :registered_resources,
           :root_path,
+          :make_page_title,
+          :resource_logo_tag,
           to: :view_context
       end
     end

data/lib/plutonium/ui/form/base.rb

@@ -109,7 +109,7 @@ module Plutonium
         end
 
         def form_action
-          return @form_action unless object.present? && @form_action != false && helpers.present?
+          return @form_action unless object.present? && @form_action != false && view_context.present?
 
           @form_action ||= url_for(object, action: object.new_record? ? :create : :update)
         end

data/lib/plutonium/ui/form/interaction.rb

@@ -16,7 +16,7 @@ module Plutonium
 
         def form_action
           # Build the correct commit URL for the interactive action
-          action = helpers.current_interactive_action
+          action = current_interactive_action
           return nil unless action
 
           # Create route options for the commit action (convert GET to POST action)
@@ -28,8 +28,8 @@ module Plutonium
           )
 
           # Use existing infrastructure to build the URL
-          subject = action.record_action? ? helpers.resource_record! : helpers.resource_class
-          helpers.route_options_to_url(commit_route_options, subject)
+          subject = action.record_action? ? resource_record! : resource_class
+          route_options_to_url(commit_route_options, subject)
         end
 
         def commit_action_name(action_name)
@@ -52,10 +52,10 @@ module Plutonium
         end
 
         def render_bulk_action_ids
-          action = helpers.current_interactive_action
+          action = current_interactive_action
           return unless action&.bulk_action?
 
-          ids = Array(helpers.params[:ids])
+          ids = Array(params[:ids])
           ids.each do |id|
             input(type: :hidden, name: "ids[]", value: id)
           end

data/lib/plutonium/ui/form/query.rb

@@ -207,7 +207,7 @@ module Plutonium
         def count_active_filters
           count = 0
           query_object.filter_definitions.each do |filter_name, _|
-            filter_params = helpers.params.dig(:q, filter_name)
+            filter_params = params.dig(:q, filter_name)
             next unless filter_params.is_a?(Hash) || filter_params.is_a?(ActionController::Parameters)
 
             filter_params.each_value do |v|

data/lib/plutonium/ui/form/resource.rb

@@ -58,7 +58,7 @@ module Plutonium
         end
 
         def form_action
-          return @form_action unless object.present? && @form_action != false && helpers.present?
+          return @form_action unless object.present? && @form_action != false && view_context.present?
 
           @form_action ||= resource_url_for(object, action: object.new_record? ? :create : :update)
         end

data/lib/plutonium/ui/layout/base.rb

@@ -22,7 +22,7 @@ module Plutonium
 
         def lang = nil
 
-        def page_title = helpers.controller.instance_variable_get(:@page_title)
+        def page_title = view_context.controller.instance_variable_get(:@page_title)
 
         def html_attributes = {lang:, data_controller: "color-mode"}
 

data/lib/plutonium/ui/layout/basic_layout.rb

@@ -5,8 +5,8 @@ module Plutonium
         private
 
         def page_title
-          helpers.make_page_title(
-            helpers.controller.instance_variable_get(:@page_title)
+          make_page_title(
+            controller.instance_variable_get(:@page_title)
           )
         end
       end

data/lib/plutonium/ui/layout/resource_layout.rb

@@ -9,8 +9,8 @@ module Plutonium
         })
 
         def page_title
-          helpers.make_page_title(
-            helpers.controller.instance_variable_get(:@page_title)
+          make_page_title(
+            controller.instance_variable_get(:@page_title)
           )
         end
 

data/lib/plutonium/ui/layout/rodauth_layout.rb

@@ -7,7 +7,7 @@ module Plutonium
         private
 
         def page_title
-          helpers.controller.instance_variable_get(:@page_title)
+          controller.instance_variable_get(:@page_title)
         end
 
         def main_attributes = mix(super, {
@@ -26,7 +26,7 @@ module Plutonium
 
         def render_logo
           link_to root_path, class: "flex items-center text-2xl font-semibold text-[var(--pu-text)] mb-2" do
-            helpers.resource_logo_tag classname: "w-24 h-24 mr-2 rounded-[var(--pu-radius-md)]"
+            resource_logo_tag classname: "w-24 h-24 mr-2 rounded-[var(--pu-radius-md)]"
           end
         end
 

data/lib/plutonium/ui/page/index.rb

@@ -7,7 +7,7 @@ module Plutonium
         private
 
         def page_title
-          super || current_definition.index_page_title || helpers.nestable_resource_name_plural(resource_class)
+          super || current_definition.index_page_title || nestable_resource_name_plural(resource_class)
         end
 
         def page_description

data/lib/plutonium/ui/page/interactive_action.rb

@@ -17,7 +17,7 @@ module Plutonium
         end
 
         def render_default_content
-          if helpers.current_turbo_frame == "remote_modal"
+          if current_turbo_frame == "remote_modal"
             dialog(
               closedby: "any",
               class: "rounded-[var(--pu-radius-lg)] w-full max-w-3xl

data/lib/plutonium/ui/table/components/row_actions_dropdown.rb

@@ -56,35 +56,13 @@ module Plutonium
 
           def render_danger_actions
             div(class: "py-1") do
-              danger_actions.each { |action| render_action_item(action, danger: true) }
+              danger_actions.each { |action| render_action_item(action) }
             end
           end
 
-          def render_action_item(action, danger: false)
+          def render_action_item(action)
             url = route_options_to_url(action.route_options, @record)
-
-            link_attrs = {
-              href: url,
-              class: tokens(
-                "flex items-center gap-2 px-3 py-1.5 text-sm transition-colors",
-                danger ? "text-danger-600 dark:text-danger-400 hover:bg-danger-50 dark:hover:bg-danger-900/30" : "text-[var(--pu-text)] hover:bg-[var(--pu-surface-alt)]"
-              )
-            }
-
-            # Add turbo frame if specified
-            link_attrs[:data] = {turbo_frame: action.turbo_frame} if action.turbo_frame
-
-            # Add confirmation if specified
-            if action.confirmation
-              link_attrs[:data] ||= {}
-              link_attrs[:data][:turbo_method] = action.route_options.method if action.route_options.method
-              link_attrs[:data][:turbo_confirm] = action.confirmation
-            end
-
-            a(**link_attrs) do
-              render action.icon.new(class: "w-4 h-4") if action.icon
-              span { action.label }
-            end
+            render Plutonium::UI::ActionButton.new(action, url: url, variant: :row_dropdown)
           end
 
           def secondary_actions

data/lib/plutonium/version.rb

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

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radioactive-labs/plutonium",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Build production-ready Rails apps in minutes, not days. Convention-driven, fully customizable, AI-ready.",
   "type": "module",
   "main": "src/js/core.js",

data/plutonium.gemspec

@@ -44,10 +44,10 @@ Gem::Specification.new do |spec|
   spec.add_dependency "phlex-rails"
   spec.add_dependency "phlex-tabler_icons"
   spec.add_dependency "phlexi-field", ">= 0.2.0"
-  spec.add_dependency "phlexi-form", ">= 0.14.0"
+  spec.add_dependency "phlexi-form", ">= 0.14.1"
   spec.add_dependency "phlexi-table", ">= 0.2.0"
   spec.add_dependency "phlexi-display", ">= 0.2.0"
-  spec.add_dependency "phlexi-menu", ">= 0.4.0"
+  spec.add_dependency "phlexi-menu", ">= 0.4.1"
   spec.add_dependency "tailwind_merge"
   spec.add_dependency "phlex-slotable", ">= 1.0.0"
   spec.add_dependency "redcarpet"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plutonium
 version: !ruby/object:Gem::Version
-  version: 0.38.0
+  version: 0.39.0
 platform: ruby
 authors:
 - Stefan Froelich
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-25 00:00:00.000000000 Z
+date: 2026-01-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -184,14 +184,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.14.0
+        version: 0.14.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.14.0
+        version: 0.14.1
 - !ruby/object:Gem::Dependency
   name: phlexi-table
   requirement: !ruby/object:Gem::Requirement
@@ -226,14 +226,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.4.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.4.1
 - !ruby/object:Gem::Dependency
   name: tailwind_merge
   requirement: !ruby/object:Gem::Requirement
@@ -542,6 +542,7 @@ files:
 - docs/guides/theming.md
 - docs/guides/troubleshooting.md
 - docs/index.md
+- docs/og-image.html
 - docs/public/android-chrome-192x192.png
 - docs/public/android-chrome-512x512.png
 - docs/public/apple-touch-icon.png
@@ -776,6 +777,7 @@ files:
 - lib/plutonium/auth.rb
 - lib/plutonium/auth/public.rb
 - lib/plutonium/auth/rodauth.rb
+- lib/plutonium/auth/sequel_adapter.rb
 - lib/plutonium/configuration.rb
 - lib/plutonium/core/.DS_Store
 - lib/plutonium/core/controller.rb