stimulus_plumbers_mcp 0.4.8 → 0.4.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33ad1eb09fa4ed8fa1780dffe068f475fc04f3b3e1f179d6cbda211190155dc9
-  data.tar.gz: 29fecb05f19a17c3b398d8eb9189167e87cfe2f6f13d2b511472884ed9ebc935
+  metadata.gz: 7d89f95c23f003c323773ab4dc24b1b21ca2fd891fdc388c77e65987942cb581
+  data.tar.gz: 5c32a25cf7e0cf97f11d0bf6f209dc4d3ff33068d1fd4fa10d83ccb2578e3474
 SHA512:
-  metadata.gz: cd757ac9c1c357f3b71c1683816ab497718215ac181e2773af6d02bca45f95114c725e501a3218a71aefa11a4e090d233efdaa085a0a01e7af399745f4082284
-  data.tar.gz: 8481e2f13c22dfccbfa0e089442bdec11fe9475c408e4d189567ea4b60b2557aa1f959698c5bc511d428b079f1fbcc5038b327729b4e43b7eb78da8f2261720c
+  metadata.gz: 1d8f30f1f03e404e8996f0e12012f624e2df37dab801accf2f194f5d5a758c6e56369e74525a0ffa91537d56a04f03273e9b0de546c78d4e9a6f1d27f2a8c558
+  data.tar.gz: e8feda10a77d64456f63ccb8bc88dc20061aa9a6145d0bff8e15adc18fea0b8491f0a1017d54186302a96079598789e7376d058e9cafac56571f00e37dda28b1

data/README.md

@@ -47,8 +47,12 @@ gem install stimulus_plumbers_mcp
 | `get_component_helper` | `name` | Full `sp_` helper surface — keyword options grouped by helper signature (incl. `icon_leading`) + slot methods |
 | `get_component_examples` | `name` | ERB code fences from docs |
 | `get_field_as_values` | `builder_method` (`field`/`collection_field`/`choice`) | Valid `as:` values |
+| `get_field_as_controller` | `as` | Stimulus controller identifier backing a controller-backed `as:` value |
+| `list_component_themes` | — | Component keys implementable in a custom theme |
 | `get_component_theme` | `name` | Method signature + return contract for custom theme |
+| `list_component_tailwind` | — | Component keys implemented by the Tailwind theme |
 | `get_component_tailwind` | `name` | Tailwind CSS utility classes per variant |
+| `list_icons` | — | All available icon names bundled with the Tailwind theme |
 | `list_controllers` | — | All Stimulus controller identifiers |
 | `get_controller_schema` | `name` | Targets, values, outlets, classes |
 | `list_controller_docs` | — | Controller doc families available at `controller://docs/{name}` |
@@ -70,7 +74,7 @@ gem install stimulus_plumbers_mcp
 }
 ```
 
-Requires Ruby >= 3.3. No `cwd` required. Pin a specific version by adding it to your `Gemfile` and running `bundle exec gem exec stimulus-plumbers-mcp`.
+Requires Ruby >= 3.3 for the `gem exec` subcommand (the gem itself supports Ruby >= 3.0). No `cwd` required. Pin a specific version by adding it to your `Gemfile` and running `bundle exec gem exec stimulus-plumbers-mcp`.
 
 ## Stimulus Manifest
 
@@ -82,6 +86,10 @@ Requires Ruby >= 3.3. No `cwd` required. Pin a specific version by adding it to
 
 No extra steps needed for setups 1 or 2.
 
+Each controller's schema also includes a `wiring` field (which methods/events/targets/values the
+`stimulus_plumbers` gem's Ruby helpers reference for it), sourced from that gem's own
+`vendor/component/manifest.json`, built by `rake build:manifest`.
+
 ## Development
 
 ```bash
@@ -92,6 +100,9 @@ bundle install
 # Build the Stimulus controller manifest (pure Node, no toolchain install needed)
 cd ../stimulus-plumbers && node --run build:manifest && cd -
 
+# Build the Ruby wiring manifest (needs the controller manifest above)
+cd ../stimulus-plumbers-rails && bundle exec rake build:manifest && cd -
+
 # Start the server
 bundle exec ruby bin/server
 ```

data/lib/stimulus_plumbers/mcp/loaders/component_manifest_loader.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module MCP
+    # Reads the stimulus_plumbers gem's own generated wiring manifest (vendor/component/manifest.json).
+    # Unlike ControllerSchemaLoader, this never crosses ecosystems — stimulus_plumbers is always
+    # installed alongside this gem (hard runtime dependency), so there's no node_modules-style path.
+    class ComponentManifestLoader
+      MANIFEST_FILENAME = "manifest.json"
+
+      class << self
+        def call
+          path = resolved_path
+
+          unless path
+            StimulusPlumbers::Logger.warn(
+              "component manifest not found. Tried:\n" \
+              "#{manifest_paths.map { |p| "  - #{p}" }.join("\n")}\n" \
+              "Run `bundle exec rake build:manifest` in stimulus-plumbers-rails/ to generate it."
+            )
+            return {}
+          end
+
+          JSON.parse(File.read(path))
+        end
+
+        def resolved_path
+          manifest_paths.find { |p| File.exist?(p) }
+        end
+
+        private
+
+        def manifest_paths
+          [
+            # 1. gem exec / installed gem — vendored at release time
+            GemVendorPath.resolve("component", MANIFEST_FILENAME),
+            # 2. Monorepo dev fallback
+            File.expand_path(
+              File.join(__dir__, "../../../../..", "stimulus-plumbers-rails", "vendor", "component", MANIFEST_FILENAME)
+            )
+          ].compact
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/mcp/loaders/controller_schema_loader.rb

@@ -21,7 +21,11 @@ module StimulusPlumbers
             return {}
           end
 
-          JSON.parse(File.read(path))
+          controllers = JSON.parse(File.read(path))
+          wiring = ComponentManifestLoader.call
+          default_wiring = { "actions" => [], "listens" => [], "targets" => [], "values" => [] }
+
+          controllers.transform_values { |data| data.merge("wiring" => wiring[data["identifier"]] || default_wiring) }
         end
 
         # Reused by VersionsLoader to report which fallback location resolved.

data/lib/stimulus_plumbers/mcp/loaders/guide.md

@@ -19,7 +19,7 @@ identifier: `get_field_as_controller(as:)` — `component://{name}/schema` keys
 `get_component_schema(name)`; ERB examples: `get_component_examples(name)`. List everything with
 `list_components`; `list_component_docs` shows which components have full docs
 (`component://{name}/docs`) and helper signatures (`component://{name}/helper`). Icon options take a
-name from `component://icons` (or `list_icons`). All 77 schema components are queryable via
+name from `component://icons` (or `list_icons`). All schema components are queryable via
 `get_component_schema`; only a subset have full docs and ERB examples — use `list_component_docs` to
 see what's covered. Full form builder reference: `component://form/docs`.
 

data/lib/stimulus_plumbers/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module StimulusPlumbers
   module MCP
-    VERSION = "0.4.8"
+    VERSION = "0.4.9"
   end
 end

data/lib/stimulus_plumbers_mcp.rb

@@ -17,6 +17,7 @@ require_relative "stimulus_plumbers/mcp/loaders/component_requirements"
 require_relative "stimulus_plumbers/mcp/loaders/component_schema_loader"
 require_relative "stimulus_plumbers/mcp/loaders/component_theme_loader"
 
+require_relative "stimulus_plumbers/mcp/loaders/component_manifest_loader"
 require_relative "stimulus_plumbers/mcp/loaders/controller_docs_loader"
 require_relative "stimulus_plumbers/mcp/loaders/controller_schema_loader"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stimulus_plumbers_mcp
 version: !ruby/object:Gem::Version
-  version: 0.4.8
+  version: 0.4.9
 platform: ruby
 authors:
 - Ryan Chang
@@ -82,6 +82,7 @@ files:
 - lib/stimulus_plumbers/mcp/cli.rb
 - lib/stimulus_plumbers/mcp/loaders/aria_loader.rb
 - lib/stimulus_plumbers/mcp/loaders/component_docs_loader.rb
+- lib/stimulus_plumbers/mcp/loaders/component_manifest_loader.rb
 - lib/stimulus_plumbers/mcp/loaders/component_requirements.rb
 - lib/stimulus_plumbers/mcp/loaders/component_schema_loader.rb
 - lib/stimulus_plumbers/mcp/loaders/component_theme_loader.rb