command_deck 0.3.2 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebceefafcd11660d8efdd358ad30b1d779b236d1cd135286b9fdb79871dd11bf
-  data.tar.gz: 9d4bffc3981b9959dfd491d4d17a5f1e8e89465f54c461d20ffa63eb9b62328a
+  metadata.gz: db8d14ada48c592f9b29c2eb963733d4a8f612cdd757d2f1c27ddb8e0cd05087
+  data.tar.gz: 6be87cf67b3aa82c3df82b1c2458adc1df2e22ed159198ede724da4cadb0d784
 SHA512:
-  metadata.gz: 9ea6c387e844f38d2cbdf0772b53979df7c93be42b8626f7be1120e61e9a052ae42fa0bb53bab411af1572723ce6824743137f16e1bf20ce040951c06ec7eda2
-  data.tar.gz: 11969e5bff8030f91e81cd4a6ddf466fea747d35843da09661377e17f835d847b3dc9c185be941da7ca63597f88877965e6748c4b38214ec71dadfa8588dccf8
+  metadata.gz: 0db0f2c1ac8b73e7fff36ebba8369c60f4c1e741ef90bad6661fc9d2d234db890489af97354e1a2bf52b9c48b5ad07ab8b36b37131318eb83b53dc228d903c91
+  data.tar.gz: fa048ba9895ef507917aae29ca04a7e5cf60a208f5cb9db103e945eb9254676828925a2abbf36a32ede61b2d1b8d7bdd465cede0870a10690d52477f06b2284b

data/.rubocop.yml

@@ -19,3 +19,22 @@ Style/StringLiterals:
 
 Style/StringLiteralsInInterpolation:
   EnforcedStyle: double_quotes
+
+Metrics/MethodLength:
+  Exclude:
+    - "test/**/*"
+
+Metrics/ClassLength:
+  Exclude:
+    - "test/**/*"
+
+Metrics/AbcSize:
+  Exclude:
+    - "test/**/*"
+
+Minitest/MultipleAssertions:
+  Enabled: false
+
+Lint/EmptyBlock:
+  Exclude:
+    - "test/**/*"

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # CHANGELOG
 
+## [0.3.3] - 2025-12-15
+
+### Added
+
+- **Configurable context provider**: New `CommandDeck.configure` block allows injecting application context (current user, session, etc.) into action `perform` blocks via the `ctx` parameter
+- **Loading spinner**: Actions now display a spinner animation while running
+- **Full test coverage**: Comprehensive Minitest suite achieving 100% line coverage and 97.73% branch coverage
+
+### Fixed
+
+- **Panel hot-reload**: Changed from `require_dependency` to `load` for more reliable panel reloading in development, also catches `SyntaxError` for better error reporting
+- **Large panels overflow**: Added max-height and scrollbar support for panels with many actions
+
+### Changed
+
+- Relaxed RuboCop metrics for test files to allow comprehensive test methods
+
 ## [0.3.2] - 2025-10-15
 
 ### Added

data/README.md

@@ -169,6 +169,44 @@ Selector-specific options:
 
 The `perform` block receives coerced params and a context hash. Return any JSON-serializable object (Hash recommended).
 
+## Context Provider
+
+The `ctx` parameter in perform blocks is populated via a configurable context provider. This allows you to inject application-specific context like the current user:
+
+```ruby
+# config/initializers/command_deck.rb
+CommandDeck.configure do |config|
+  config.context_provider = ->(request) do
+    {
+      current_user: request.env['warden']&.user,  # Works with Devise
+      session: request.session,
+      # Add any other context your actions need
+    }
+  end
+end
+```
+
+Then in your panels:
+
+```ruby
+action 'Toggle Admin', key: 'user.toggle_admin' do
+  perform do |_params, ctx|
+    user = ctx[:current_user]
+    return { error: 'Not logged in' } unless user
+
+    user.update!(admin: !user.admin?)
+    { ok: true, admin: user.admin? }
+  end
+end
+```
+
+The context provider receives the full `ActionDispatch::Request` object, giving you access to:
+
+- `request.env['warden']` - Warden/Devise user
+- `request.session` - Rails session
+- `request.cookies` - Request cookies
+- `request.env` - Full Rack environment
+
 ## Security
 
 Intended for development only. **DO NOT ENABLE IN PRODUCTION**.

data/Rakefile

@@ -3,7 +3,12 @@
 require "bundler/gem_tasks"
 require "minitest/test_task"
 
-Minitest::TestTask.create
+Minitest::TestTask.create do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_prelude = 'require "test_helper"'
+  t.test_globs = ["test/*_test.rb"]
+end
 
 require "rubocop/rake_task"
 

data/app/controllers/command_deck/actions_controller.rb

@@ -6,7 +6,7 @@ module CommandDeck
     def create
       key = params[:key].to_s
       begin
-        result = Executor.call(key: key, params: params[:params])
+        result = Executor.call(key: key, params: params[:params], request: request)
         render json: { ok: true, result: result }
       rescue ArgumentError => e
         render json: { ok: false, error: e.message }, status: :not_found

data/lib/command_deck/assets/css/main.css

@@ -17,7 +17,7 @@
   align-items: center;
   justify-content: center;
   font: 600 14px system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif;
-  box-shadow: 0 6px 20px rgba(0, 0, 0, .25);
+  box-shadow: 0 6px 20px rgba(0, 0, 0, 0.25);
   cursor: pointer;
 }
 
@@ -25,7 +25,7 @@
 #command-deck-toggle.cd-theme-dark {
   background: #000; /* full black */
   color: #fff;
-  box-shadow: 0 6px 20px rgba(0, 0, 0, .6);
+  box-shadow: 0 6px 20px rgba(0, 0, 0, 0.6);
 }
 
 #command-deck-panel {
@@ -38,9 +38,9 @@
   background: #fff;
   color: #111;
   border-radius: 12px;
-  box-shadow: 0 12px 40px rgba(0, 0, 0, .28);
+  box-shadow: 0 12px 40px rgba(0, 0, 0, 0.28);
   padding: 12px;
-  border: 1px solid rgba(0, 0, 0, .06);
+  border: 1px solid rgba(0, 0, 0, 0.06);
 }
 
 /* Dark theme for panel */
@@ -48,7 +48,7 @@
   background: #000; /* full black */
   color: #f1f1f1;
   border-color: #222;
-  box-shadow: 0 12px 40px rgba(0,0,0,.7);
+  box-shadow: 0 12px 40px rgba(0, 0, 0, 0.7);
 }
 
 #command-deck-panel.cd-theme-dark #cd-tabs-wrap .cd-tab-btn,
@@ -62,7 +62,9 @@
   border-color: #333;
 }
 
-#command-deck-panel.cd-theme-dark .cd-action { border-color: #222; }
+#command-deck-panel.cd-theme-dark .cd-action {
+  border-color: #222;
+}
 
 /* Dark mode: improve readability of labels and placeholders */
 #command-deck-panel.cd-theme-dark .cd-form label {
@@ -102,7 +104,8 @@
 }
 
 #command-deck-panel * {
-  font: 500 13px/1.35 system-ui, -apple-system, Segoe UI, Roboto, Arial, sans-serif;
+  font: 500 13px/1.35 system-ui, -apple-system, Segoe UI, Roboto, Arial,
+    sans-serif;
 }
 
 /* ---------- Header & Settings ---------- */
@@ -168,7 +171,7 @@
   background: #fff;
   border: 1px solid #e5e5e5;
   border-radius: 8px;
-  box-shadow: 0 10px 28px rgba(0,0,0,.12);
+  box-shadow: 0 10px 28px rgba(0, 0, 0, 0.12);
   padding: 8px;
   z-index: 2147483001;
   min-width: 180px;
@@ -178,7 +181,7 @@
 #command-deck-panel.cd-theme-dark #cd-settings-panel {
   background: #0d0d0d;
   border-color: #333;
-  box-shadow: 0 10px 28px rgba(0,0,0,.6);
+  box-shadow: 0 10px 28px rgba(0, 0, 0, 0.6);
 }
 
 .cd-settings-title {
@@ -227,6 +230,8 @@
   display: flex;
   flex-direction: column;
   gap: 12px;
+  max-height: 50vh;
+  overflow-y: auto;
 }
 
 .cd-action {
@@ -309,18 +314,18 @@
   border: 1px solid #fecaca;
 }
 
-#command-deck-panel.cd-theme-dark .cd-param-hint { 
-    color: #bdbdbd;
+#command-deck-panel.cd-theme-dark .cd-param-hint {
+  color: #bdbdbd;
 }
-#command-deck-panel.cd-theme-dark .cd-badge.cd-on { 
-    background: #0b2f1c; 
-    color: #a7f3d0; 
-    border-color: #065f46; 
+#command-deck-panel.cd-theme-dark .cd-badge.cd-on {
+  background: #0b2f1c;
+  color: #a7f3d0;
+  border-color: #065f46;
 }
-#command-deck-panel.cd-theme-dark .cd-badge.cd-off { 
-    background: #3b0c0c; 
-    color: #fecaca; 
-    border-color: #7f1d1d; 
+#command-deck-panel.cd-theme-dark .cd-badge.cd-off {
+  background: #3b0c0c;
+  color: #fecaca;
+  border-color: #7f1d1d;
 }
 
 .cd-form .cd-run {
@@ -397,6 +402,23 @@
   overflow: auto;
 }
 
+/* ---------- Spinner ---------- */
+.cd-spinner {
+  display: inline-block;
+  width: 12px;
+  height: 12px;
+  border: 2px solid currentColor;
+  border-right-color: transparent;
+  border-radius: 50%;
+  animation: cd-spin 0.75s linear infinite;
+  vertical-align: middle;
+  margin-right: 4px;
+}
+
+@keyframes cd-spin {
+  to { transform: rotate(360deg); }
+}
+
 /* ---------- Corner Positioning ---------- */
 #command-deck-toggle.cd-pos-tl {
   left: 16px;

data/lib/command_deck/assets/js/ui/overlay/result_view.js

@@ -57,7 +57,7 @@ export class ResultView {
 
   setRunning() {
     this.setVisible(true);
-    this.pre.textContent = 'Running...';
+    this.pre.innerHTML = '<span class="cd-spinner"></span> Running...';
   }
 
   setResult(obj) {

data/lib/command_deck/configuration.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+# Command Deck configuration module.
+# Configure context providers and other global settings here.
+module CommandDeck
+  # Configuration for Command Deck
+  #
+  # Example usage in an initializer:
+  #
+  #   # config/initializers/command_deck.rb
+  #   CommandDeck.configure do |config|
+  #     config.context_provider = ->(request) do
+  #       {
+  #         current_user: request.env['warden']&.user,
+  #         session: request.session
+  #       }
+  #     end
+  #   end
+  class Configuration
+    # A proc that receives the ActionDispatch::Request and returns a hash
+    # to be passed as the `ctx` parameter in perform blocks.
+    #
+    # @example
+    #   config.context_provider = ->(request) do
+    #     { current_user: request.env['warden']&.user }
+    #   end
+    attr_accessor :context_provider
+
+    def initialize
+      @context_provider = ->(_request) { {} }
+    end
+
+    # Builds the context hash from the given request
+    #
+    # @param request [ActionDispatch::Request] the current request
+    # @return [Hash] context to pass to perform blocks
+    def build_context(request)
+      return {} unless context_provider.respond_to?(:call)
+
+      context_provider.call(request) || {}
+    rescue StandardError => e
+      Rails.logger.warn "[CommandDeck] Context provider error: #{e.message}" if defined?(Rails)
+      {}
+    end
+  end
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+end

data/lib/command_deck/engine.rb

@@ -40,8 +40,8 @@ module CommandDeck
 
       Engine.discover_panel_paths.each do |path|
         Dir.glob(path.join("**/*.rb")).each do |file|
-          require_dependency file
-        rescue LoadError, NameError => e
+          load file
+        rescue LoadError, SyntaxError, NameError => e
           Rails.logger.warn "[CommandDeck] Could not load panel #{file}: #{e.message}"
         end
       end

data/lib/command_deck/executor.rb

@@ -3,12 +3,13 @@
 module CommandDeck
   # Executor for running actions
   class Executor
-    def self.call(key:, params:)
+    def self.call(key:, params:, request: nil)
       action = Registry.find_action(key)
       raise ArgumentError, "Unknown action #{key}" unless action
 
       coerced = coerce(action.params, params || {})
-      action.block.call(coerced, {})
+      ctx = request ? CommandDeck.configuration.build_context(request) : {}
+      action.block.call(coerced, ctx)
     end
 
     def self.coerce(schema, raw)

data/lib/command_deck/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CommandDeck
-  VERSION = "0.3.2"
+  VERSION = "0.3.3"
 end

data/lib/command_deck.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "command_deck/version"
+require "command_deck/configuration"
 require "command_deck/registry"
 require "command_deck/executor"
 require "command_deck/base_panel"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: command_deck
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.3
 platform: ruby
 authors:
 - crowrojas
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
@@ -90,6 +89,7 @@ files:
 - lib/command_deck/assets/js/ui/panel_selector.js
 - lib/command_deck/assets/js/ui/settings_dropdown.js
 - lib/command_deck/base_panel.rb
+- lib/command_deck/configuration.rb
 - lib/command_deck/engine.rb
 - lib/command_deck/executor.rb
 - lib/command_deck/injector.rb
@@ -108,7 +108,6 @@ metadata:
   source_code_uri: https://github.com/crow-rojas/command_deck/tree/master
   changelog_uri: https://github.com/crow-rojas/command_deck/blob/master/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -123,8 +122,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Dev-oriented floating panel for running custom actions in Rails apps
 test_files: []