stimulus_plumbers_mcp 0.4.4 → 0.4.8

data/lib/stimulus_plumbers/mcp/plugins/docs.rb

@@ -1,82 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module MCP
-    module Plugins
-      module Docs
-        extend Base
-
-        LOADER_KEY = :docs
-        LOADER     = DocsLoader
-
-        STATIC_RESOURCES = [].freeze
-        DYNAMIC_RESOURCE_TEMPLATES = [
-          ::MCP::ResourceTemplate.new(
-            uri_template: "docs://components/{name}",
-            name:         "component-docs",
-            description:  "Full markdown documentation and ERB examples for a component",
-            mime_type:    "text/markdown"
-          ),
-          ::MCP::ResourceTemplate.new(
-            uri_template: "helper://components/{name}",
-            name:         "component-helper-signature",
-            description:  "Full sp_ helper option surface: keyword options with defaults and slot methods",
-            mime_type:    "application/json"
-          )
-        ].freeze
-
-        def self.read(uri, store)
-          docs = store[:docs]
-
-          case uri
-          when %r{\Adocs://components/(.+)\z}
-            doc = docs[Regexp.last_match(1).to_sym]
-            doc ? text_resource(uri, "text/markdown", doc[:content]) : missing(uri, Regexp.last_match(1))
-          when %r{\Ahelper://components/(.+)\z}
-            doc = docs[Regexp.last_match(1).to_sym]
-            doc ? json_resource(uri, doc[:signature]) : missing(uri, Regexp.last_match(1))
-          end
-        end
-
-        def self.missing(uri, name)
-          json_resource(uri, { error: "no documentation for: #{name}" })
-        end
-        private_class_method :missing
-
-        def self.register_tools(server, store)
-          docs = store[:docs]
-
-          text_tool(
-            server,
-            name:        "list_docs",
-            description: "Lists components that have markdown docs (docs://components/{name}) and " \
-                         "helper signatures (helper://components/{name})"
-          ) do
-            JSON.generate(docs.keys)
-          end
-
-          text_tool(
-            server,
-            name:         "get_erb_examples",
-            description:  "Returns ERB usage examples for a component from the documentation",
-            input_schema: { properties: { component: { type: "string" } }, required: ["component"] }
-          ) do |component:|
-            examples = docs[component.to_sym]&.dig(:examples) || []
-            examples.empty? ? not_found("no examples for: #{component}") : examples.join("\n\n")
-          end
-
-          text_tool(
-            server,
-            name:         "get_helper_signature",
-            description:  "Returns the full sp_ helper surface for a component: keyword options with " \
-                          "defaults plus slot methods (e.g. icon_leading, card.with_action)",
-            input_schema: { properties: { component: { type: "string" } }, required: ["component"] }
-          ) do |component:|
-            doc = docs[component.to_sym]
-            doc ? JSON.generate(doc[:signature]) : not_found("no documentation for: #{component}")
-          end
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/mcp/plugins/schema.rb

@@ -1,110 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module MCP
-    module Plugins
-      module Schema
-        extend Base
-
-        LOADER_KEY = :schema
-        LOADER     = SchemaLoader
-
-        STATIC_RESOURCES = [
-          ::MCP::Resource.new(
-            uri:         "schema://components",
-            name:        "components-index",
-            description: "Index of all stimulus-plumbers component theme keys",
-            mime_type:   "application/json"
-          ),
-          ::MCP::Resource.new(
-            uri:         "schema://icons",
-            name:        "icons",
-            description: "All available icon names from the active theme registry",
-            mime_type:   "application/json"
-          ),
-          ::MCP::Resource.new(
-            uri:         "schema://stimulus",
-            name:        "stimulus-wiring",
-            description: "Mapping from Rails component name to the Stimulus controller identifiers it requires",
-            mime_type:   "application/json"
-          )
-        ].freeze
-
-        DYNAMIC_RESOURCE_TEMPLATES = [
-          ::MCP::ResourceTemplate.new(
-            uri_template: "schema://components/{name}",
-            name:         "component-schema",
-            description:  "Params, valid values, defaults, and required controllers for a component",
-            mime_type:    "application/json"
-          )
-        ].freeze
-
-        def self.read(uri, store)
-          schema = store[:schema]
-
-          case uri
-          when "schema://components"
-            json_resource(uri, schema[:components].keys)
-          when "schema://icons"
-            json_resource(uri, schema[:icons])
-          when "schema://stimulus"
-            json_resource(uri, schema[:stimulus])
-          when %r{\Aschema://components/(.+)\z}
-            key = Regexp.last_match(1).to_sym
-            json_resource(uri, component_data(schema, key) || { error: "unknown component: #{key}" })
-          end
-        end
-
-        def self.register_tools(server, store)
-          schema = store[:schema]
-          data_by_component = component_data_map(schema)
-
-          text_tool(server, name: "list_components", description: "Lists all stimulus-plumbers component theme keys") do
-            JSON.generate(schema[:components].keys)
-          end
-
-          text_tool(
-            server,
-            name:         "get_component_schema",
-            description:  "Returns themed params (e.g. type/variant/size) with valid values, defaults, and " \
-                          "required Stimulus controllers. For the full helper surface (icon options, slots) " \
-                          "use get_helper_signature",
-            input_schema: { properties: { component: { type: "string" } }, required: ["component"] }
-          ) do |component:|
-            data = data_by_component[component.to_sym]
-            data ? JSON.generate(data) : not_found("unknown component: #{component}")
-          end
-
-          text_tool(
-            server,
-            name:         "get_field_types",
-            description:  "Returns valid as: values for a form builder method",
-            input_schema: {
-              properties: { builder_method: { type: "string", enum: %w[field collection_field choice] } },
-              required:   ["builder_method"]
-            }
-          ) do |builder_method:|
-            values = schema[:field_as][builder_method.to_sym]
-            values ? JSON.generate(values) : not_found("unknown builder_method: #{builder_method}")
-          end
-        end
-
-        # Resolve component_data at module scope; define_tool blocks run in another context.
-        def self.component_data_map(schema)
-          keys = (schema[:components].keys + schema[:stimulus].keys).uniq
-          keys.to_h { |key| [key, component_data(schema, key)] }
-        end
-
-        def self.component_data(schema, key)
-          params = schema[:components][key]
-          wiring = schema[:stimulus]
-          return nil unless params || wiring.key?(key)
-
-          (params || {}).merge(controllers: wiring[key] || [])
-        end
-
-        private_class_method :component_data_map, :component_data
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/mcp/plugins/stimulus.rb

@@ -1,66 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module MCP
-    module Plugins
-      module Stimulus
-        extend Base
-
-        LOADER_KEY = :stimulus
-        LOADER     = StimulusManifest
-
-        STATIC_RESOURCES = [
-          ::MCP::Resource.new(
-            uri:         "stimulus://controllers",
-            name:        "stimulus-controllers-index",
-            description: "Index of all Stimulus controller identifiers in @stimulus-plumbers/controllers",
-            mime_type:   "application/json"
-          )
-        ].freeze
-
-        DYNAMIC_RESOURCE_TEMPLATES = [
-          ::MCP::ResourceTemplate.new(
-            uri_template: "stimulus://controllers/{identifier}",
-            name:         "stimulus-controller-schema",
-            description:  "Targets, values, outlets, and classes for a Stimulus controller",
-            mime_type:    "application/json"
-          )
-        ].freeze
-
-        def self.read(uri, store)
-          controllers = store[:stimulus]
-
-          case uri
-          when "stimulus://controllers"
-            json_resource(uri, controllers.keys)
-          when %r{\Astimulus://controllers/(.+)\z}
-            identifier = Regexp.last_match(1)
-            json_resource(uri, controllers[identifier] || { error: "unknown controller: #{identifier}" })
-          end
-        end
-
-        def self.register_tools(server, store)
-          controllers = store[:stimulus]
-
-          text_tool(
-            server,
-            name:        "list_controllers",
-            description: "Lists all Stimulus controller identifiers provided by @stimulus-plumbers/controllers"
-          ) do
-            JSON.generate(controllers.keys)
-          end
-
-          text_tool(
-            server,
-            name:         "get_controller_schema",
-            description:  "Returns targets, values (with types and defaults), outlets, and classes for a Stimulus controller",
-            input_schema: { properties: { controller: { type: "string" } }, required: ["controller"] }
-          ) do |controller:|
-            data = controllers[controller]
-            data ? JSON.generate(data) : not_found("unknown controller: #{controller}")
-          end
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/mcp/plugins/theme.rb

@@ -1,66 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module MCP
-    module Plugins
-      module Theme
-        extend Base
-
-        LOADER_KEY = :theme
-        LOADER     = ThemeLoader
-
-        STATIC_RESOURCES = [
-          ::MCP::Resource.new(
-            uri:         "theme://base",
-            name:        "theme-base",
-            description: "Guide for implementing a custom stimulus-plumbers theme: method convention, return format",
-            mime_type:   "text/markdown"
-          ),
-          ::MCP::Resource.new(
-            uri:         "theme://components",
-            name:        "theme-components-index",
-            description: "Index of all component keys that can be implemented in a custom theme",
-            mime_type:   "application/json"
-          )
-        ].freeze
-
-        DYNAMIC_RESOURCE_TEMPLATES = [
-          ::MCP::ResourceTemplate.new(
-            uri_template: "theme://components/{name}",
-            name:         "theme-component-interface",
-            description:  "Method name, param signature, and return contract for implementing a component in a custom theme",
-            mime_type:    "application/json"
-          )
-        ].freeze
-
-        def self.read(uri, store)
-          theme = store[:theme]
-
-          case uri
-          when "theme://base"
-            text_resource(uri, "text/markdown", theme[:base_doc])
-          when "theme://components"
-            json_resource(uri, theme[:components].keys)
-          when %r{\Atheme://components/(.+)\z}
-            key = Regexp.last_match(1).to_sym
-            json_resource(uri, theme[:components][key] || { error: "unknown component: #{key}" })
-          end
-        end
-
-        def self.register_tools(server, store)
-          theme = store[:theme]
-
-          text_tool(
-            server,
-            name:         "get_theme_interface",
-            description:  "Returns the method name, param signature, and return contract for a custom theme component",
-            input_schema: { properties: { component: { type: "string" } }, required: ["component"] }
-          ) do |component:|
-            data = theme[:components][component.to_sym]
-            data ? JSON.generate(data) : not_found("unknown component: #{component}")
-          end
-        end
-      end
-    end
-  end
-end