command_deck 0.1.0

data/lib/command_deck/registry.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+# Command Deck
+module CommandDeck
+  # Registry for actions and panels
+  class Registry
+    Action = Struct.new(:title, :key, :params, :block, keyword_init: true)
+    Tab    = Struct.new(:title, :actions, keyword_init: true)
+    Panel  = Struct.new(:title, :tabs, :owner, :group, :key, keyword_init: true)
+
+    class << self
+      def panels
+        @panels ||= []
+      end
+
+      def clear!
+        @panels = []
+      end
+
+      def panel(title, **opts, &blk)
+        PanelBuilder.new(title, **opts).tap { |pb| pb.instance_eval(&blk) if blk }.build.then { panels << _1 }
+      end
+
+      def find_action(key)
+        panels.each do |p|
+          p.tabs.each do |t|
+            t.actions.each do |a|
+              return a if a.key == key
+            end
+          end
+        end
+        nil
+      end
+    end
+
+    # Panel builder
+    class PanelBuilder
+      def initialize(title, **opts)
+        @title = title
+        @tabs = []
+        @owner = opts[:owner]
+        @group = opts[:group]
+        @key   = opts[:key] || slugify(title)
+      end
+
+      def tab(title, &blk)
+        @tabs << TabBuilder.new(title).tap { |tb| tb.instance_eval(&blk) if blk }.build
+      end
+
+      def build
+        Panel.new(title: @title, tabs: @tabs, owner: @owner, group: @group, key: @key)
+      end
+
+      private
+
+      def slugify(str)
+        str.to_s.downcase.gsub(/[^a-z0-9]+/, "-").gsub(/^-|-$/, "")
+      end
+    end
+
+    # Tab builder
+    class TabBuilder
+      def initialize(title)
+        @title = title
+        @actions = []
+      end
+
+      def action(title, key:, &blk)
+        @actions << ActionBuilder.new(title, key).tap { |ab| ab.instance_eval(&blk) if blk }.build
+      end
+
+      def build
+        Tab.new(title: @title, actions: @actions)
+      end
+    end
+
+    # Action builder
+    class ActionBuilder
+      def initialize(title, key)
+        @title  = title
+        @key    = key
+        @params = []
+        @block  = nil
+      end
+
+      def param(name, type, **opts)
+        @params << { name: name, type: type, **opts }
+      end
+
+      def perform(&block)
+        @block = block
+      end
+
+      def build
+        Action.new(title: @title, key: @key, params: @params, block: @block)
+      end
+    end
+  end
+
+  def self.panel(title, **opts, &blk)
+    Registry.panel(title, **opts, &blk)
+  end
+end

data/lib/command_deck/version.rb

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

data/lib/command_deck.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative "command_deck/version"
+require "command_deck/registry"
+require "command_deck/executor"
+
+module CommandDeck
+  class Error < StandardError; end
+end
+
+if defined?(Rails)
+  require "command_deck/railtie"
+  require "command_deck/engine"
+end

data/sig/command_deck.rbs

@@ -0,0 +1,4 @@
+module CommandDeck
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: command_deck
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- crowrojas
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-09-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+description: Command Deck is a tiny floating UI that allows you to run commands in
+  your Rails app.
+email:
+- cristobal.rojasbrito@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- TAGS
+- app/controllers/command_deck/actions_controller.rb
+- app/controllers/command_deck/assets_controller.rb
+- app/controllers/command_deck/base_controller.rb
+- app/controllers/command_deck/panels_controller.rb
+- config/routes.rb
+- lib/command_deck.rb
+- lib/command_deck/assets/css/main.css
+- lib/command_deck/assets/js/core/api.js
+- lib/command_deck/assets/js/core/dom.js
+- lib/command_deck/assets/js/core/store.js
+- lib/command_deck/assets/js/main.js
+- lib/command_deck/assets/js/ui/overlay.js
+- lib/command_deck/assets/js/ui/panel_selector.js
+- lib/command_deck/assets/js/ui/position_manager.js
+- lib/command_deck/assets/js/ui/settings_dropdown.js
+- lib/command_deck/assets/js/ui/theme_manager.js
+- lib/command_deck/engine.rb
+- lib/command_deck/executor.rb
+- lib/command_deck/injector.rb
+- lib/command_deck/middleware.rb
+- lib/command_deck/railtie.rb
+- lib/command_deck/registry.rb
+- lib/command_deck/version.rb
+- public/img/demo.png
+- sig/command_deck.rbs
+homepage: https://github.com/crow-rojas/command_deck
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/crow-rojas/command_deck
+  source_code_uri: https://github.com/crow-rojas/command_deck
+  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
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Command Deck is a tiny floating UI that allows you to run commands in your
+  Rails app.
+test_files: []