plutonium 0.23.5 → 0.24.1

data/docs/public/plutonium.mdc

@@ -121,6 +121,20 @@ class PostDefinition < Plutonium::Resource::Definition
   input :content, as: :rich_text
   input :category, as: :select, collection: %w[Tech Business Lifestyle]
 
+  # New: Custom component classes
+  input :color_picker, as: ColorPickerComponent
+  display :status_badge, as: StatusBadgeComponent
+
+  # Input blocks for custom logic (must use form builder methods)
+  input :birth_date do |f|
+    case object.age_category
+    when 'adult'
+      f.date_tag(min: 18.years.ago.to_date)
+    else
+      f.date_tag
+    end
+  end
+
   # Conditional inputs (for forms only)
   # Use for COSMETIC/STATE-BASED logic only, NOT authorization (use policies for that)
   input :debug_info, condition: -> { Rails.env.development? }
@@ -467,201 +481,72 @@ include Plutonium::Auth::Rodauth(:admin)    # For admin authentication
 include Plutonium::Auth::Public             # For public access
 ```
 
-## Multi-Tenancy & Entity Scoping
-
-### Path-Based Scoping
-```ruby
-# Portal engine
-scope_to_entity Organization, strategy: :path
-
-# Generates routes like: /organizations/:organization_id/posts
-# Automatically scopes all queries to the organization
-```
+## Routing & Custom Routes
 
-### Database Associations for Scoping
+### Resource Registration
 ```ruby
-# Direct association (auto-detected)
-class Post < ApplicationRecord
-  belongs_to :organization
-end
-
-# Indirect association (auto-detected)
-class Post < ApplicationRecord
-  belongs_to :author, class_name: 'User'
-  has_one :organization, through: :author
-end
-
-# Custom scope (manual)
-class Comment < ApplicationRecord
-  belongs_to :post
+# Basic resource registration
+register_resource Post
+
+# Custom routes with member/collection actions
+register_resource Post do
+  member do
+    get :publish      # /posts/1/publish
+    post :archive     # /posts/1/archive
+  end
 
-  scope :associated_with_organization, ->(organization) do
-    joins(post: :author).where(users: { organization_id: organization.id })
+  collection do
+    get :search       # /posts/search
   end
 end
 ```
 
-## Query Objects & Filtering
+### Common Routing Errors
 
-### Automatic Query Handling
-Controllers automatically handle:
-- Search: `?q[search]=rails`
-- Filters: `?q[published]=true`
-- Sorting: `?q[sort_fields][]=created_at&q[sort_directions][created_at]=desc`
-- Scopes: `?q[scope]=published`
+#### "Unresolvable Association" Error
+When adding custom routes inside `register_resource` blocks, Plutonium may interpret them as nested resources and fail with:
+```
+RuntimeError (Could not resolve the association between 'Model' and 'Model')
+```
 
-### Custom Query Objects
+**Problem**: Routes like this create nested resource interpretation:
 ```ruby
-query_object = Plutonium::Resource::QueryObject.new(Post, params[:q] || {}, request.path) do |query|
-  # Custom search
-  query.define_search proc { |scope, search:|
-    scope.joins(:author, :tags)
-         .where("posts.title ILIKE :search OR users.name ILIKE :search", search: "%#{search}%")
-         .distinct
-  }
-
-  # Custom filter
-  query.define_filter :date_range, proc { |scope, start_date:, end_date:|
-    scope.where(created_at: start_date.beginning_of_day..end_date.end_of_day)
-  }
-
-  # Custom sorter
-  query.define_sorter :author_name, proc { |scope, direction:|
-    scope.joins(:author).order("users.name #{direction}")
-  }
+register_resource ::UniversalFlow::Definition do
+  get "editor", to: "universal_flow/definitions#editor"
 end
 ```
 
-## UI Components & Theming
-
-### Component Architecture
-Built on Phlex, components inherit from `Plutonium::UI::Component::Base`:
+**Solutions**:
 
+1. **Add custom scope to model (Recommended)**:
 ```ruby
-class CustomComponent < Plutonium::UI::Component::Base
-  def initialize(title:, content: nil)
-    @title = title
-    @content = content
-  end
-
-  def view_template
-    div(class: "custom-component") do
-      h2(class: "text-xl font-bold") { @title }
-      div(class: "content") { @content } if @content
-    end
-  end
+class UniversalFlow::Definition < ApplicationRecord
+  scope :associated_with_universal_flow_definition, ->(universal_flow_definition) {
+    all # or specific logic for your use case
+  }
 end
 ```
 
-### Layout Customization
+2. **Use member/collection routes**:
 ```ruby
-# Custom page classes in definitions
-class PostDefinition < Plutonium::Resource::Definition
-  class ShowPage < Plutonium::UI::Page::Show
-    def render_content
-      # Custom show page rendering
-      super
-    end
+register_resource ::UniversalFlow::Definition do
+  member do
+    get :editor
   end
 end
 ```
 
-## Configuration
-
-### Main Configuration
+3. **Create separate controller**:
 ```ruby
-# config/initializers/plutonium.rb
-Plutonium.configure do |config|
-  config.load_defaults 1.0
-
-  # Development settings
-  config.development = Rails.env.development?
-  config.cache_discovery = !Rails.env.development?
-  config.enable_hotreload = Rails.env.development?
-
-  # Assets
-  config.assets.logo = "custom_logo.png"
-  config.assets.stylesheet = "custom_theme.css"
-  config.assets.script = "custom_plutonium.js"
-  config.assets.favicon = "custom_favicon.ico"
+# In routes file
+get 'universal_flow/editor/:id', to: 'universal_flow/editor#show'
+
+# Create dedicated controller
+class UniversalFlow::EditorController < CustomerPortal::ResourceController
+  def show
+    @definition = UniversalFlow::Definition.find(params[:id])
+    authorize_current! @definition
+    # ... custom logic
+  end
 end
 ```
-
-## Generator Commands
-
-### Core Setup
-```bash
-# Install Plutonium in existing app
-bin/rails app:template LOCATION=https://radioactive-labs.github.io/plutonium-core/templates/base.rb
-rails generate pu:core:install
-
-# Install authentication
-rails generate pu:rodauth:install
-rails generate pu:rodauth:account user
-```
-
-### Package Creation
-```bash
-# Create feature package
-rails generate pu:pkg:package blogging
-
-# Create portal package
-rails generate pu:pkg:portal admin
-```
-
-### Resource Management
-```bash
-# Full resource scaffold
-rails generate pu:res:scaffold Post user:belongs_to title:string content:text
-
-# Individual resource components
-rails generate pu:res:model Post title:string content:text
-rails generate pu:res:definition Post
-rails generate pu:res:policy Post
-```
-
-## Best Practices
-
-### Resource Design
-1. Keep models focused on data and basic validations
-2. Use definitions for UI configuration, not business logic
-3. Implement complex business logic in interactions
-4. Use policies for all authorization logic
-5. Leverage scopes for common queries
-
-### Package Organization
-1. Create feature packages for domain logic
-2. Use portal packages for different user interfaces
-3. Keep packages focused and cohesive
-4. Namespace everything properly to avoid conflicts
-
-### Security
-1. Always define explicit permissions in policies
-2. Use secure defaults (deny by default)
-3. Implement proper entity scoping for multi-tenancy
-4. Validate all user inputs in interactions
-5. Use CSRF protection and implement rate limiting
-
-### Performance
-1. Use `includes` and `joins` in relation scopes
-2. Add database indexes for filtered and sorted fields
-3. Implement caching where appropriate
-4. Use background jobs for heavy operations
-5. Monitor N+1 queries with tools like Prosopite
-
-### Code Organization
-1. Follow Rails naming conventions
-2. Keep controllers thin - use interactions for business logic
-3. Use consistent patterns across resources
-4. Write comprehensive tests for policies and interactions
-5. Document complex business logic
-
-### Development Workflow
-1. Start with resource scaffolding for rapid prototyping
-2. Customize definitions for UI requirements
-3. Implement business logic through interactions
-4. Add proper authorization with policies
-5. Create appropriate packages for organization
-6. Set up portals for different user types
-
-This comprehensive guide should enable you to build robust, maintainable Plutonium applications following the framework's conventions and best practices.

data/lib/plutonium/definition/nested_inputs.rb

@@ -5,14 +5,6 @@ module Plutonium
 
       included do
         defineable_prop :nested_input
-
-        # def self.nested_input(name, with: nil, **)
-        #   defined_nested_inputs[name] = {}
-        # end
-
-        # def nested_input(name, with: nil, **)
-        #   instance_defined_nested_inputs[name] = {}
-        # end
       end
     end
   end

data/lib/plutonium/resource/controller.rb

@@ -73,7 +73,7 @@ module Plutonium
       # Returns the submitted resource parameters
       # @return [Hash] The submitted resource parameters
       def submitted_resource_params
-        @submitted_resource_params ||= build_form(resource_class.new).extract_input(params, view_context:)[resource_param_key.to_sym]
+        @submitted_resource_params ||= build_form(resource_class.new).extract_input(params, view_context:)[resource_param_key.to_sym].compact
       end
 
       # Returns the resource parameters, including scoped and parent parameters

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

@@ -92,7 +92,11 @@ module Plutonium
             tag_attributes = display_options.except(:wrapper, :as, :condition)
             tag_block = display_definition[:block] || ->(f) {
               tag ||= f.inferred_field_component
-              f.send(:"#{tag}_tag", **tag_attributes)
+              if tag.is_a?(Class)
+                f.send :create_component, tag, tag.name.demodulize.underscore.sub(/component$/, "").to_sym
+              else
+                f.send(:"#{tag}_tag", **tag_attributes)
+              end
             }
 
             wrapper_options = display_options[:wrapper] || {}

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

@@ -68,7 +68,11 @@ module Plutonium
           end
           tag_block = input_definition[:block] || ->(f) do
             tag ||= f.inferred_field_component
-            f.send(:"#{tag}_tag", **tag_attributes)
+            if tag.is_a?(Class)
+              f.send :create_component, tag, tag.name.demodulize.underscore.sub(/component$/, "").to_sym
+            else
+              f.send(:"#{tag}_tag", **tag_attributes)
+            end
           end
 
           field_options = field_options.except(:as, :condition)

data/lib/plutonium/version.rb

@@ -1,5 +1,5 @@
 module Plutonium
-  VERSION = "0.23.5"
+  VERSION = "0.24.1"
   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.23.5
+  version: 0.24.1
 platform: ruby
 authors:
 - Stefan Froelich
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-21 00:00:00.000000000 Z
+date: 2025-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk