plutonium 0.56.3 → 0.58.0

data/docs/.vitepress/theme/components/HomeCta.vue

@@ -21,7 +21,7 @@
       </div>
 
       <div class="hc-term-wrap">
-        <pre class="pu-term hc-term"><span class="prompt">$</span> rails new my_app -m {{ activeUrl }}<span class="pu-term-cursor"></span></pre>
+        <pre class="pu-term hc-term"><span class="prompt">$</span> {{ activeCommand }}<span class="pu-term-cursor"></span></pre>
         <button class="hc-copy" :class="{ 'hc-copy--ok': copied }" @click="copy" :title="copied ? 'Copied' : 'Copy command'" :aria-label="copied ? 'Copied' : 'Copy command'">
           <component :is="copied ? IconCheck : IconCopy" :size="16" :stroke-width="2" />
         </button>
@@ -49,7 +49,7 @@ const options = [
 ]
 const selected = ref("plutonium")
 const activeUrl = computed(() => options.find(o => o.id === selected.value).url)
-const activeCommand = computed(() => `rails new my_app -m ${activeUrl.value}`)
+const activeCommand = computed(() => `rails new my_app -a propshaft -j esbuild -c tailwind -m ${activeUrl.value}`)
 const copied = ref(false)
 
 async function copy() {

data/docs/public/templates/base.rb

@@ -10,5 +10,5 @@ after_bundle do
   generate "pu:core:install"
 
   git add: "."
-  git commit: %( -m 'install plutonium' )
+  git commit: %( -m 'chore: install plutonium' )
 end

data/docs/public/templates/lite.rb

@@ -2,51 +2,51 @@ after_bundle do
   # SQLite infrastructure (replaces Redis/Postgres for simple deployments)
   generate "pu:lite:setup"
   git add: "."
-  git commit: %( -m 'setup sqlite') if `git status --porcelain`.present?
+  git commit: %( -m 'chore: setup sqlite') if `git status --porcelain`.present?
 
   generate "pu:lite:tune"
   git add: "."
-  git commit: %( -m 'tune sqlite pragmas') if `git status --porcelain`.present?
+  git commit: %( -m 'chore: tune sqlite pragmas') if `git status --porcelain`.present?
 
   unless ENV["SKIP_SOLID_QUEUE"]
     generate "pu:lite:solid_queue"
     git add: "."
-    git commit: %( -m 'add solid_queue') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add solid_queue') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_SOLID_CACHE"]
     generate "pu:lite:solid_cache"
     git add: "."
-    git commit: %( -m 'add solid_cache') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add solid_cache') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_SOLID_CABLE"]
     generate "pu:lite:solid_cable"
     git add: "."
-    git commit: %( -m 'add solid_cable') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add solid_cable') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_SOLID_ERRORS"]
     generate "pu:lite:solid_errors"
     git add: "."
-    git commit: %( -m 'add solid_errors') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add solid_errors') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_LITESTREAM"]
     generate "pu:lite:litestream"
     git add: "."
-    git commit: %( -m 'add litestream') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add litestream') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_RAILS_PULSE"]
     generate "pu:lite:rails_pulse"
     git add: "."
-    git commit: %( -m 'add rails_pulse') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add rails_pulse') if `git status --porcelain`.present?
   end
 
   unless ENV["SKIP_SQLITE_MAINTENANCE"]
     generate "pu:lite:maintenance"
     git add: "."
-    git commit: %( -m 'add sqlite maintenance job') if `git status --porcelain`.present?
+    git commit: %( -m 'chore: add sqlite maintenance job') if `git status --porcelain`.present?
   end
 end

data/docs/public/templates/plutonium.rb

@@ -1,6 +1,6 @@
 after_bundle do
   # We just installed Rails, let's create a commit
-  git(add: ".") && git(commit: %( -m 'initial commit' ))
+  git(add: ".") && git(commit: %( -m 'chore: initial commit' ))
 
   # Run the base install
   template_location = if ENV["LOCAL"]
@@ -12,20 +12,23 @@ after_bundle do
 
   # Add development tools
   generate "pu:gem:dotenv"
-  git(add: ".") && git(commit: %( -m 'add dotenv' ))
+  git(add: ".") && git(commit: %( -m 'chore: add dotenv' ))
 
   generate "pu:gem:annotated"
-  git(add: ".") && git(commit: %( -m 'add annotate' ))
+  git(add: ".") && git(commit: %( -m 'chore: add annotate' ))
 
   generate "pu:gem:standard"
-  git(add: ".") && git(commit: %( -m 'add standardrb' ))
+  git(add: ".") && git(commit: %( -m 'chore: add standardrb' ))
 
   generate "pu:gem:letter_opener"
-  git(add: ".") && git(commit: %( -m 'add letter_opener' ))
+  git(add: ".") && git(commit: %( -m 'chore: add letter_opener' ))
 
   generate "pu:gem:actual_db_schema"
-  git(add: ".") && git(commit: %( -m 'add actual_db_schema' ))
+  git(add: ".") && git(commit: %( -m 'chore: add actual_db_schema' ))
 
   generate "pu:core:assets"
-  git(add: ".") && git(commit: %( -m 'integrate assets' ))
+  git(add: ".") && git(commit: %( -m 'chore: integrate assets' ))
+
+  generate "pu:skills:sync"
+  git(add: ".") && git(commit: %( -m 'chore: sync plutonium skills' ))
 end

data/docs/reference/resource/query.md

@@ -214,6 +214,26 @@ When a default is set:
 - The default scope button is highlighted (not "All").
 - Clicking "All" shows the unscoped collection.
 
+### Conditional visibility — `condition:`
+
+Like `condition:` on [actions](./actions), a scope can be **defined but only render its button when a runtime proc is truthy**. The scope (and its URL) stays live either way — `condition:` only toggles the button.
+
+```ruby
+scope :admin_only,   condition: -> { current_user.admin? }
+scope :beta_feature, condition: -> { params[:beta] == "1" }
+
+# Expose a scope's URL (API/programmatic) without surfacing a button
+scope :internal, condition: -> { false }
+```
+
+The proc is evaluated against the view context so `current_user`, `params`, `request`, and `allowed_to?` are all available directly. There is no `object`/`record` — scopes have no single-record context.
+
+::: danger `condition:` is NOT authorization
+A hidden scope button still has a **live URL** anyone can navigate to. `condition:` decides whether the *button renders*, not whether the *records are accessible*.
+
+Use `condition:` for UI relevance ("show this tab to admins only"). Use the policy's `relation_scope` to restrict which records a user can see at all.
+:::
+
 ## Sorting
 
 ```ruby

data/gemfiles/rails_7.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.56.0)
+    plutonium (0.57.0)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 43.0)

data/gemfiles/rails_8.0.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.56.0)
+    plutonium (0.57.0)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 43.0)

data/gemfiles/rails_8.1.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    plutonium (0.56.0)
+    plutonium (0.57.0)
       action_policy (~> 0.7.0)
       listen (~> 3.8)
       pagy (~> 43.0)

data/lib/generators/pu/core/assets/assets_generator.rb

@@ -12,6 +12,7 @@ module Pu
       desc "Setup plutonium assets"
 
       def start
+        verify_prerequisites
         install_dependencies
         copy_tailwind_config
         configure_application
@@ -24,6 +25,22 @@ module Pu
 
       private
 
+      # The asset pipeline assumes the app was generated with esbuild + Tailwind.
+      # Without those, `application.tailwind.css` doesn't exist and the generator
+      # later crashes with a cryptic inject_into_file error. Fail early with a fix.
+      def verify_prerequisites
+        return if File.exist?("app/assets/stylesheets/application.tailwind.css")
+
+        error <<~MSG
+          Plutonium assets require a Rails app generated with esbuild and Tailwind.
+          Expected app/assets/stylesheets/application.tailwind.css, but it is missing.
+
+          Re-create the app with the required flags:
+            rails new myapp -a propshaft -j esbuild -c tailwind \\
+              -m https://radioactive-labs.github.io/plutonium-core/templates/plutonium.rb
+        MSG
+      end
+
       def copy_tailwind_config
         copy_file "tailwind.config.js", force: true
         copy_file "postcss.config.js", force: true

data/lib/generators/pu/rodauth/templates/config/initializers/url_options.rb

@@ -1,17 +1,11 @@
 # frozen_string_literal: true
 
-Rails.application.config.after_initialize do
-  default_url = ENV["RAILS_DEFAULT_URL"]
-  if default_url && Rails.application.config.action_mailer.default_url_options.blank?
-    uri = URI.parse(default_url)
-    Rails.application.config.action_mailer.default_url_options = {
-      host: uri.host,
-      port: uri.port,
-      protocol: uri.scheme
-    }
-  end
+if (default_url = ENV["RAILS_DEFAULT_URL"])
+  uri = URI.parse(default_url)
+  default_port = (uri.scheme == "https") ? 443 : 80
+  url_options = {host: uri.host, protocol: uri.scheme}
+    .tap { |opts| opts[:port] = uri.port if uri.port != default_port }
 
-  if Rails.application.routes.default_url_options.blank?
-    Rails.application.routes.default_url_options = Rails.application.config.action_mailer.default_url_options
-  end
+  ActionMailer::Base.default_url_options = url_options if ActionMailer::Base.default_url_options.blank?
+  Rails.application.routes.default_url_options = url_options if Rails.application.routes.default_url_options.blank?
 end

data/lib/plutonium/core/controllers/entity_scoping.rb

@@ -115,7 +115,10 @@ module Plutonium
         def remember_scoped_entity
           return unless scoped_to_entity?
 
-          session[scoped_entity_session_key] = current_scoped_entity.to_global_id.to_s
+          entity = current_scoped_entity
+          return unless entity
+
+          session[scoped_entity_session_key] = entity.to_global_id.to_s
         end
 
         # Retrieves the remembered scoped entity from the session.

data/lib/plutonium/interaction/base.rb

@@ -70,16 +70,14 @@ module Plutonium
       #
       # @return [Plutonium::Interaction::Outcome] The result of the interaction.
       def call
-        if valid?
-          outcome = execute
-          unless outcome.is_a?(Plutonium::Interaction::Outcome)
-            raise "#{self.class}#execute must return an instance of Plutonium::Interaction::Outcome.\n" \
-                  "#{outcome.inspect} received instead"
-          end
-          outcome
-        else
-          failure.with_message("An error occurred")
+        return failure unless valid?
+
+        outcome = execute
+        unless outcome.is_a?(Plutonium::Interaction::Outcome)
+          raise "#{self.class}#execute must return an instance of Plutonium::Interaction::Outcome.\n" \
+                "#{outcome.inspect} received instead"
         end
+        outcome
       end
 
       private

data/lib/plutonium/invites/concerns/invite_token.rb

@@ -41,7 +41,7 @@ module Plutonium
 
           # Callbacks
           before_validation :set_token_defaults, on: :create
-          after_create :send_invitation_email
+          after_commit :send_invitation_email, on: :create
 
           # Core validations
           validates :email, presence: true

data/lib/plutonium/resource/controller.rb

@@ -146,6 +146,21 @@ module Plutonium
         # 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 ||= begin
+          # Pre-populate from submitted params so condition: procs evaluate against submitted
+          # values during extraction. Without this, a select whose choices: depend on a sibling
+          # attribute would see nil for that sibling (fresh/cloned record) and resolve to empty
+          # choices, causing AcceptsChoices to nullify a valid submitted value.
+          # attribute_names covers DB columns and `attribute :` declarations.
+          # The union with respond_to? also covers attr_accessor virtual attributes.
+          submitted = params[resource_param_key]&.to_unsafe_h || {}
+          base_keys = extraction_record.attribute_names.map(&:to_s)
+          # Also include attr_accessor virtual attributes not in attribute_names.
+          # Exclude AR association writers — they expect object instances, not param strings.
+          extra_keys = (submitted.keys.map(&:to_s) - base_keys).select { |k|
+            extraction_record.respond_to?("#{k}=") &&
+              extraction_record.class.reflect_on_association(k.to_sym).nil?
+          }
+          extraction_record.assign_attributes(submitted.slice(*(base_keys | extra_keys)))
           extracted = build_form(extraction_record, form_action: false)
             .extract_input(params, view_context:)[resource_param_key.to_sym].compact
           clean_structured_inputs(current_definition, extracted)

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

@@ -262,6 +262,17 @@ module Plutonium
             elsif action.bulk_action?
               instance.resources = interactive_bulk
             end
+            # Pre-populate sibling attributes from submitted params before rendering
+            # the form for extraction. When a select input's `choices:` depends on a
+            # sibling attribute and `condition:` guards it, the condition evaluates to
+            # false on a fresh instance (sibling is nil), making AcceptsChoices
+            # validate against an empty choices list and nullify a valid submitted
+            # value. Pre-populating lets conditions evaluate against submitted values,
+            # so the real select (with correct choices) is used for extraction.
+            submitted = params[:interaction]&.to_unsafe_h || {}
+            base_keys = instance.attribute_names.map(&:to_s) - %w[resource resources]
+            extra_keys = submitted.keys.map(&:to_s).select { |k| instance.respond_to?("#{k}=") } - %w[resource resources]
+            instance.assign_attributes(submitted.slice(*(base_keys | extra_keys)))
             extracted = interaction
               .build_form(instance)
               .extract_input(params, view_context:)[:interaction]

data/lib/plutonium/resource/query_object.rb

@@ -31,9 +31,11 @@ module Plutonium
       #
       # @param name [Symbol] The name of the scope.
       # @param body [Proc, nil] The body of the scope.
-      def define_scope(name, body = nil, **)
+      # @param condition [Proc, nil] Display-only visibility gate (same semantics as condition: on actions).
+      def define_scope(name, body = nil, condition: nil, **)
         body ||= name
         scope_definitions[name] = build_query(body)
+        scope_conditions[name] = condition if condition
       end
 
       # Defines a sort with the given name and body.
@@ -118,6 +120,16 @@ module Plutonium
 
       def scope_definitions = @scope_definitions ||= {}.with_indifferent_access
 
+      def scope_conditions = @scope_conditions ||= {}.with_indifferent_access
+
+      # Display-only visibility gate for a scope, mirroring condition: on actions.
+      # Returns true when no condition is set.
+      def scope_visible?(name, view_context)
+        condition = scope_conditions[name]
+        return true if condition.nil?
+        Plutonium::Action::ConditionContext.new(view_context, nil).instance_exec(&condition)
+      end
+
       # Returns true if user explicitly selected "All" scope (no filtering)
       def all_scope_selected? = @all_scope_selected
 

data/lib/plutonium/ui/modal/slideover.rb

@@ -33,7 +33,7 @@ module Plutonium
           # showModal() and is dropped when the dialog leaves the top layer
           # on close(), so it still covers the panel's slide-out. Mirrors
           # the .pu-dialog::backdrop rule in components.css.
-          "fixed top-0 right-0 bottom-0 left-auto m-0 h-screen max-w-full max-h-screen " \
+          "fixed top-0 right-0 bottom-0 left-auto m-0 h-dvh max-w-full max-h-dvh " \
             "bg-[var(--pu-surface)] border-l border-[var(--pu-border)] " \
             "backdrop:bg-black/60 backdrop:backdrop-blur-sm " \
             "rounded-none p-0 " \

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

@@ -14,6 +14,7 @@ module Plutonium
               div(class: "flex flex-wrap items-center gap-2") do
                 render_all_scope_button
                 current_query_object.scope_definitions.each_key do |name|
+                  next unless current_query_object.scope_visible?(name, view_context)
                   render_scope_button(name)
                 end
               end
@@ -60,7 +61,7 @@ module Plutonium
           end
 
           def render?
-            current_query_object.scope_definitions.present?
+            current_query_object.scope_definitions.any? { |name, _| current_query_object.scope_visible?(name, view_context) }
           end
         end
       end

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

@@ -59,7 +59,7 @@ module Plutonium
           end
 
           def scopes
-            @scopes ||= current_query_object.scope_definitions
+            @scopes ||= current_query_object.scope_definitions.select { |name, _| current_query_object.scope_visible?(name, view_context) }
           end
         end
       end

data/lib/plutonium/version.rb

@@ -1,5 +1,5 @@
 module Plutonium
-  VERSION = "0.56.3"
+  VERSION = "0.58.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.56.3",
+  "version": "0.58.0",
   "description": "Build production-ready Rails apps in minutes, not days. Convention-driven, fully customizable, AI-ready.",
   "type": "module",
   "main": "src/js/core.js",

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: plutonium
 version: !ruby/object:Gem::Version
-  version: 0.56.3
+  version: 0.58.0
 platform: ruby
 authors:
 - Stefan Froelich
 bindir: exe
 cert_chain: []
-date: 2026-06-07 00:00:00.000000000 Z
+date: 2026-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk