stimulus-viz 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9dd3c9161d354f992c21bb961d52c51c41c41fd030a3b0202fa0ff1e8cf5c2ec
-  data.tar.gz: dae5536d6035f67546136f12ffe1fc52d602bdffc8dd5eeba120fec2313c4cd7
+  metadata.gz: 391418ec9f2ed71ca8b2c73f194e72631e12f69e7f6e031c87ce0b1662904cba
+  data.tar.gz: 7471e04568f5f51f191a2fec5bbf208c46f197f43f3b898567cfd748e2ef1bea
 SHA512:
-  metadata.gz: f114a88b5b966ffcb6c6f1116c22610c9c8b70f432f6dd790780b251aafaca07d3dd6e2dea05e89ab407147612d4e7f45596b291b17d4bdac99b855e2ae2f985
-  data.tar.gz: 8cf8d948c812075b068479e25737a0d43999831f2dea87a018d6d62fe8c1049d96bb27076f88173ed91d4bd4ae1939669d768402ee9e8ce8e5c215c14014d909
+  metadata.gz: 13d4bd2ff809adfb080cca759222a8b7348e567c053417b6aea109db34a064d3ea99ed9387c069ae4de2dc20c7085492562b22199ecb69c005246e790bb5955f
+  data.tar.gz: d55bdd8ac5525a40b1a33a7d45e9b684a7f85f77635acc87df935298d6299433f7e8bcffdb3d2d3dd4aa07a14cffb9f9c835a1f00e7c1e857ad86c6cc880e48e

data/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] - 2024-01-01
+
+### Changed
+- Update gemspec metadata for better discoverability
+- Improve gem description and summary
+
+## [0.1.0] - 2024-01-01
+
+### Added
+- Initial release of StimulusViz
+- Static analysis of Stimulus controllers in Rails projects
+- DOM binding extraction from ERB templates
+- Lint checks for unknown controllers, suspicious actions, and empty bindings
+- CLI commands: scan, list, bindings, lint, export
+- JSON and DOT export formats
+- Comprehensive test suite using yasslab/sample_apps fixtures
+- Support for Ruby >= 3.1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 StimulusViz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,168 @@
+# StimulusViz
+
+Rails/Hotwire Stimulus visualization tool for static analysis of Stimulus controllers and DOM bindings.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'stimulus-viz'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install stimulus-viz
+
+## Setup
+
+If you're using the development version with git submodules:
+
+```bash
+git submodule update --init --recursive
+```
+
+## Usage
+
+### Scan Rails Project
+
+Scan your Rails project for Stimulus controllers and DOM bindings:
+
+```bash
+stimulus-viz scan --root /path/to/rails/project --out .stimulus-viz.json
+```
+
+### List Controllers
+
+List all discovered controllers:
+
+```bash
+stimulus-viz list --cache .stimulus-viz.json
+```
+
+### Show Bindings
+
+Show DOM bindings, optionally filtered by controller:
+
+```bash
+stimulus-viz bindings --cache .stimulus-viz.json
+stimulus-viz bindings --cache .stimulus-viz.json --controller presence
+```
+
+### Lint Analysis
+
+Run lint checks on your Stimulus usage:
+
+```bash
+stimulus-viz lint --cache .stimulus-viz.json
+stimulus-viz lint --cache .stimulus-viz.json --fail-on warn
+```
+
+Lint levels:
+- `info`: Empty bindings (controller without actions/targets/values)
+- `warn`: Unknown controllers, suspicious action formats
+- `error`: Critical issues
+
+### Export Data
+
+Export scan results in different formats:
+
+```bash
+# Export as pretty JSON
+stimulus-viz export --cache .stimulus-viz.json --format json --out output.json
+
+# Export as DOT graph
+stimulus-viz export --cache .stimulus-viz.json --format dot --out graph.dot
+```
+
+## Output Schema
+
+The tool generates JSON with the following structure:
+
+```json
+{
+  "meta": {
+    "root": "/path/to/project",
+    "generated_at": "2024-01-01T12:00:00Z"
+  },
+  "controllers": [
+    {
+      "name": "presence",
+      "module": "app/javascript/controllers/presence_controller.js",
+      "elements": 3,
+      "actions": ["highlight", "connect"],
+      "targets": ["list", "item"],
+      "values": ["fadeMs", "url"]
+    }
+  ],
+  "bindings": [
+    {
+      "id": "el_0001",
+      "selector": "app/views/home/index.html.erb:42 <div#presence>",
+      "controllers": ["presence"],
+      "actions": ["turbo:before-stream-render->presence#highlight"],
+      "targets": [
+        {
+          "controller": "presence",
+          "name": "list",
+          "selector": "(static)"
+        }
+      ],
+      "values": [
+        {
+          "controller": "presence", 
+          "name": "fadeMs",
+          "value": "250"
+        }
+      ],
+      "broken": false
+    }
+  ],
+  "lint": [
+    {
+      "level": "warn",
+      "title": "Unknown controller",
+      "detail": "Controller 'missing' is referenced but not found",
+      "hint": "Check controller name spelling",
+      "where": "app/views/test/index.html.erb:10"
+    }
+  ]
+}
+```
+
+## Development
+
+After checking out the repo, run:
+
+```bash
+git submodule update --init --recursive
+bundle install
+```
+
+To run tests:
+
+```bash
+bundle exec rake test
+```
+
+To install this gem onto your local machine:
+
+```bash
+bundle exec rake install
+```
+
+## Testing
+
+The test suite uses the [yasslab/sample_apps](https://github.com/yasslab/sample_apps) repository as fixtures via git submodules. Tests create temporary directories with minimal Stimulus setups to verify scanning functionality.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/test_*.rb"]
+end
+
+task default: :test

data/example.json

@@ -0,0 +1,135 @@
+{
+  "meta": {
+    "root": "/Users/minorisugimura/GitHub/stimulus-viz/example_project",
+    "generated_at": "2026-01-01T23:49:27+09:00"
+  },
+  "controllers": [
+    {
+      "name": "hello",
+      "module": "app/javascript/controllers/hello_controller.js",
+      "elements": 2,
+      "actions": [],
+      "targets": [],
+      "values": [
+        "name"
+      ]
+    }
+  ],
+  "bindings": [
+    {
+      "id": "el_0001",
+      "selector": "app/views/home/index.html.erb:1 <div data-controller=...>",
+      "controllers": [
+        "hello"
+      ],
+      "actions": [],
+      "targets": [],
+      "values": [
+        {
+          "controller": "hello",
+          "name": "name",
+          "value": "World"
+        }
+      ]
+    },
+    {
+      "id": "el_0002",
+      "selector": "app/views/home/index.html.erb:2 <input data-hello-tar...>",
+      "controllers": [],
+      "actions": [],
+      "targets": [
+        {
+          "controller": "hello",
+          "name": "name",
+          "selector": "(static)"
+        }
+      ],
+      "values": []
+    },
+    {
+      "id": "el_0003",
+      "selector": "app/views/home/index.html.erb:3 <button data-action=\"...>",
+      "controllers": [],
+      "actions": [
+        "click->hello#greet"
+      ],
+      "targets": [],
+      "values": []
+    },
+    {
+      "id": "el_0004",
+      "selector": "app/views/home/index.html.erb:4 <p data-hello-target=...>",
+      "controllers": [],
+      "actions": [],
+      "targets": [
+        {
+          "controller": "hello",
+          "name": "output",
+          "selector": "(static)"
+        }
+      ],
+      "values": []
+    },
+    {
+      "id": "el_0005",
+      "selector": "app/views/home/index.html.erb:7 <div data-controller=...>",
+      "controllers": [
+        "unknown-controller"
+      ],
+      "actions": [],
+      "targets": [],
+      "values": [],
+      "broken": true
+    },
+    {
+      "id": "el_0006",
+      "selector": "app/views/home/index.html.erb:8 <span data-action=\"in...>",
+      "controllers": [],
+      "actions": [
+        "invalid-format"
+      ],
+      "targets": [],
+      "values": []
+    },
+    {
+      "id": "el_0007",
+      "selector": "app/views/home/index.html.erb:11 <div data-controller=...>",
+      "controllers": [
+        "hello"
+      ],
+      "actions": [],
+      "targets": [],
+      "values": [],
+      "broken": true
+    }
+  ],
+  "lint": [
+    {
+      "level": "warn",
+      "title": "Unknown controller",
+      "detail": "Controller 'unknown-controller' is referenced but not found in controllers directory",
+      "where": "app/views/home/index.html.erb:7 <div data-controller=...>"
+    },
+    {
+      "level": "info",
+      "title": "Empty binding",
+      "detail": "Element has data-controller but no actions, targets, or values",
+      "hint": "Consider adding data-action, targets, or values to make the controller useful",
+      "where": "app/views/home/index.html.erb:7 <div data-controller=...>"
+    },
+    {
+      "level": "warn",
+      "title": "Suspicious action format",
+      "detail": "Action 'invalid-format' doesn't match expected 'event->controller#method' format",
+      "hint": "Expected format: 'click->controller#method'",
+      "where": "app/views/home/index.html.erb:8 <span data-action=\"in...>"
+    },
+    {
+      "level": "info",
+      "title": "Empty binding",
+      "detail": "Element has data-controller but no actions, targets, or values",
+      "hint": "Consider adding data-action, targets, or values to make the controller useful",
+      "where": "app/views/home/index.html.erb:11 <div data-controller=...>"
+    }
+  ]
+}

data/example_project/app/javascript/controllers/hello_controller.js

@@ -0,0 +1,10 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static targets = ["name", "output"]
+  static values = { name: String }
+
+  greet() {
+    this.outputTarget.textContent = `Hello, ${this.nameValue || this.nameTarget.value}!`
+  }
+}

data/example_project/app/views/home/index.html.erb

@@ -0,0 +1,13 @@
+<div data-controller="hello" data-hello-name-value="World">
+  <input data-hello-target="name" type="text" placeholder="Enter your name">
+  <button data-action="click->hello#greet">Greet</button>
+  <p data-hello-target="output"></p>
+</div>
+
+<div data-controller="unknown-controller">
+  <span data-action="invalid-format">Bad action</span>
+</div>
+
+<div data-controller="hello">
+  <!-- Empty binding - no actions, targets, or values -->
+</div>

data/exe/stimulus-viz

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/stimulus_viz"
+
+StimulusViz::CLI.start(ARGV)

data/lib/stimulus_viz/cli.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+require "thor"
+require "json"
+
+module StimulusViz
+  class CLI < Thor
+    desc "scan [OPTIONS]", "Scan Rails project for Stimulus controllers and bindings"
+    option :root, type: :string, default: ".", desc: "Root path of Rails project"
+    option :out, type: :string, default: ".stimulus-viz.json", desc: "Output file path"
+    def scan
+      root_path = File.expand_path(options[:root])
+      output_path = File.expand_path(options[:out])
+      
+      scanner = Scanner.new(root: root_path)
+      result = scanner.run
+      
+      File.write(output_path, JSON.pretty_generate(result))
+      puts "Scan completed. Results saved to #{output_path}"
+    end
+
+    desc "list [OPTIONS]", "List controllers from cache"
+    option :cache, type: :string, default: ".stimulus-viz.json", desc: "Cache file path"
+    def list
+      data = load_cache(options[:cache])
+      
+      puts "Controllers:"
+      data[:controllers].each do |controller|
+        puts "  #{controller[:name]} (#{controller[:module]})"
+        puts "    Elements: #{controller[:elements]}"
+        puts "    Actions: #{controller[:actions].join(', ')}" unless controller[:actions].empty?
+        puts "    Targets: #{controller[:targets].join(', ')}" unless controller[:targets].empty?
+        puts "    Values: #{controller[:values].join(', ')}" unless controller[:values].empty?
+        puts
+      end
+    end
+
+    desc "bindings [OPTIONS]", "Show DOM bindings"
+    option :cache, type: :string, default: ".stimulus-viz.json", desc: "Cache file path"
+    option :controller, type: :string, desc: "Filter by controller name"
+    def bindings
+      data = load_cache(options[:cache])
+      
+      bindings = data[:bindings]
+      if options[:controller]
+        bindings = bindings.select { |b| b[:controllers].include?(options[:controller]) }
+      end
+      
+      puts "Bindings:"
+      bindings.each do |binding|
+        puts "  #{binding[:id]} - #{binding[:selector]}"
+        puts "    Controllers: #{binding[:controllers].join(', ')}" unless binding[:controllers].empty?
+        puts "    Actions: #{binding[:actions].join(', ')}" unless binding[:actions].empty?
+        puts "    Targets: #{binding[:targets].map { |t| "#{t[:controller]}.#{t[:name]}" }.join(', ')}" unless binding[:targets].empty?
+        puts "    Values: #{binding[:values].map { |v| "#{v[:controller]}.#{v[:name]}=#{v[:value]}" }.join(', ')}" unless binding[:values].empty?
+        puts "    ⚠️  BROKEN" if binding[:broken]
+        puts
+      end
+    end
+
+    desc "lint [OPTIONS]", "Run lint checks"
+    option :cache, type: :string, default: ".stimulus-viz.json", desc: "Cache file path"
+    option :fail_on, type: :string, default: "none", desc: "Fail on level: info|warn|error|none"
+    def lint
+      data = load_cache(options[:cache])
+      
+      puts "Lint Results:"
+      exit_code = 0
+      fail_levels = %w[info warn error]
+      fail_threshold = fail_levels.index(options[:fail_on]) || -1
+      
+      data[:lint].each do |issue|
+        level_index = fail_levels.index(issue[:level]) || -1
+        exit_code = 1 if level_index >= fail_threshold && fail_threshold >= 0
+        
+        puts "  [#{issue[:level].upcase}] #{issue[:title]}"
+        puts "    #{issue[:detail]}"
+        puts "    Hint: #{issue[:hint]}" if issue[:hint]
+        puts "    Location: #{issue[:where]}" if issue[:where]
+        puts
+      end
+      
+      exit(exit_code) if exit_code > 0
+    end
+
+    desc "export [OPTIONS]", "Export data in different formats"
+    option :cache, type: :string, default: ".stimulus-viz.json", desc: "Cache file path"
+    option :format, type: :string, required: true, desc: "Output format: json|dot"
+    option :out, type: :string, required: true, desc: "Output file path"
+    def export
+      data = load_cache(options[:cache])
+      
+      case options[:format]
+      when "json"
+        File.write(options[:out], JSON.pretty_generate(data))
+      when "dot"
+        dot_content = generate_dot(data)
+        File.write(options[:out], dot_content)
+      else
+        puts "Unknown format: #{options[:format]}"
+        exit(1)
+      end
+      
+      puts "Exported to #{options[:out]} in #{options[:format]} format"
+    end
+
+    private
+
+    def load_cache(cache_path)
+      unless File.exist?(cache_path)
+        puts "Cache file not found: #{cache_path}"
+        puts "Run 'stimulus-viz scan' first"
+        exit(1)
+      end
+      
+      JSON.parse(File.read(cache_path), symbolize_names: true)
+    end
+
+    def generate_dot(data)
+      lines = ["digraph stimulus {"]
+      lines << "  rankdir=LR;"
+      lines << "  node [shape=box];"
+      
+      # Add controller nodes
+      data[:controllers].each do |controller|
+        lines << "  \"#{controller[:name]}\" [label=\"#{controller[:name]}\\n(#{controller[:elements]} elements)\"];"
+      end
+      
+      # Add binding edges
+      data[:bindings].each do |binding|
+        binding[:controllers].each do |controller|
+          lines << "  \"#{binding[:selector]}\" -> \"#{controller}\" [label=\"data-controller\"];"
+        end
+        
+        binding[:actions].each do |action|
+          if action =~ /^(.+)->(.+)#(.+)$/
+            event, controller_method = $1, $2
+            lines << "  \"#{event}\" -> \"#{controller_method}\" [label=\"#{action}\"];"
+          end
+        end
+      end
+      
+      lines << "}"
+      lines.join("\n")
+    end
+  end
+end

data/lib/stimulus_viz/scanner.rb

@@ -0,0 +1,279 @@
+# frozen_string_literal: true
+
+require "json"
+require "time"
+
+module StimulusViz
+  class Scanner
+    attr_reader :root
+
+    def initialize(root:)
+      @root = root
+      @controllers = []
+      @bindings = []
+      @binding_counter = 0
+    end
+
+    def run
+      scan_controllers
+      scan_erb_files
+      generate_lint_results
+      
+      {
+        meta: {
+          root: @root,
+          generated_at: Time.now.iso8601
+        },
+        controllers: aggregate_controllers,
+        bindings: @bindings,
+        lint: @lint_results
+      }
+    end
+
+    private
+
+    def scan_controllers
+      controller_pattern = File.join(@root, "app/javascript/controllers/**/*_controller.{js,ts}")
+      Dir.glob(controller_pattern).each do |file_path|
+        relative_path = file_path.sub(@root + "/", "")
+        basename = File.basename(file_path, ".*")
+        
+        # Convert filename to controller name: message_form_controller -> message-form
+        controller_name = basename.sub(/_controller$/, "").tr("_", "-")
+        
+        @controllers << {
+          name: controller_name,
+          module: relative_path,
+          file_path: file_path
+        }
+      end
+    end
+
+    def scan_erb_files
+      erb_pattern = File.join(@root, "app/views/**/*.erb")
+      Dir.glob(erb_pattern).each do |file_path|
+        scan_erb_file(file_path)
+      end
+    end
+
+    def scan_erb_file(file_path)
+      content = File.read(file_path)
+      relative_path = file_path.sub(@root + "/", "")
+      
+      # Find HTML tags by parsing character by character to handle quoted attributes
+      i = 0
+      while i < content.length
+        if content[i] == '<' && content[i + 1] =~ /[a-zA-Z]/
+          # Found start of tag, find the end
+          tag_start = i
+          i += 1
+          in_quotes = false
+          quote_char = nil
+          
+          while i < content.length
+            char = content[i]
+            
+            if !in_quotes && (char == '"' || char == "'")
+              in_quotes = true
+              quote_char = char
+            elsif in_quotes && char == quote_char
+              in_quotes = false
+              quote_char = nil
+            elsif !in_quotes && char == '>'
+              # Found end of tag
+              tag_end = i
+              full_tag = content[tag_start..tag_end]
+              
+              if full_tag.include?('data-')
+                line_number = content[0...tag_start].count("\n") + 1
+                process_element(full_tag, relative_path, line_number)
+              end
+              break
+            end
+            
+            i += 1
+          end
+        end
+        i += 1
+      end
+    end
+
+    def process_element(element, file_path, line_number)
+      @binding_counter += 1
+      binding_id = "el_%04d" % @binding_counter
+      
+      # Extract id attribute for better selector
+      id_match = element.match(/id=["']([^"']+)["']/)
+      selector_suffix = id_match ? "##{id_match[1]}" : ""
+      selector = "#{file_path}:#{line_number} <#{element[1..20]}...#{selector_suffix}>"
+      
+      binding = {
+        id: binding_id,
+        selector: selector,
+        controllers: extract_controllers(element),
+        actions: extract_actions(element),
+        targets: extract_targets(element),
+        values: extract_values(element)
+      }
+      
+      # Mark as broken if has controllers but no interactions
+      if !binding[:controllers].empty? && 
+         binding[:actions].empty? && 
+         binding[:targets].empty? && 
+         binding[:values].empty?
+        binding[:broken] = true
+      end
+      
+      @bindings << binding
+    end
+
+    def extract_controllers(element)
+      match = element.match(/data-controller=["']([^"']+)["']/m)
+      return [] unless match
+      
+      match[1].split(/\s+/).reject(&:empty?)
+    end
+
+    def extract_actions(element)
+      match = element.match(/data-action=["']([^"']+)["']/m)
+      return [] unless match
+      
+      match[1].split(/\s+/).reject(&:empty?)
+    end
+
+    def extract_targets(element)
+      targets = []
+      
+      # Single target: data-controller-target="name"
+      element.scan(/data-([^-\s]+)-target=["']([^"']+)["']/m) do |controller, name|
+        targets << {
+          controller: controller.tr("_", "-"),
+          name: name,
+          selector: "(static)"
+        }
+      end
+      
+      # Multiple targets: data-controller-targets="name1 name2"
+      element.scan(/data-([^-\s]+)-targets=["']([^"']+)["']/m) do |controller, names|
+        names.split(/\s+/).each do |name|
+          targets << {
+            controller: controller.tr("_", "-"),
+            name: name,
+            selector: "(static)"
+          }
+        end
+      end
+      
+      targets
+    end
+
+    def extract_values(element)
+      values = []
+      
+      element.scan(/data-([^-\s]+)-([^-\s]+(?:-[^-\s]+)*)-value=["']([^"']+)["']/m) do |controller, value_name, value|
+        # Convert kebab-case to camelCase
+        camel_name = value_name.split("-").map.with_index do |part, index|
+          index == 0 ? part : part.capitalize
+        end.join
+        
+        values << {
+          controller: controller.tr("_", "-"),
+          name: camel_name,
+          value: value
+        }
+      end
+      
+      values
+    end
+
+    def aggregate_controllers
+      @controllers.map do |controller|
+        # Count elements that use this controller
+        elements_count = @bindings.count { |b| b[:controllers].include?(controller[:name]) }
+        
+        # Collect unique actions, targets, values for this controller
+        actions = []
+        targets = []
+        values = []
+        
+        @bindings.each do |binding|
+          next unless binding[:controllers].include?(controller[:name])
+          
+          # Extract actions for this controller
+          binding[:actions].each do |action|
+            if action =~ /^(.+)->([^#]+)#(.+)$/
+              _event, ctrl, method = $1, $2, $3
+              actions << method if ctrl == controller[:name]
+            end
+          end
+          
+          # Extract targets for this controller
+          binding[:targets].each do |target|
+            targets << target[:name] if target[:controller] == controller[:name]
+          end
+          
+          # Extract values for this controller
+          binding[:values].each do |value|
+            values << value[:name] if value[:controller] == controller[:name]
+          end
+        end
+        
+        {
+          name: controller[:name],
+          module: controller[:module],
+          elements: elements_count,
+          actions: actions.uniq.sort,
+          targets: targets.uniq.sort,
+          values: values.uniq.sort
+        }
+      end
+    end
+
+    def generate_lint_results
+      @lint_results = []
+      
+      controller_names = @controllers.map { |c| c[:name] }
+      
+      @bindings.each do |binding|
+        # Check for unknown controllers
+        binding[:controllers].each do |controller|
+          unless controller_names.include?(controller)
+            @lint_results << {
+              level: "warn",
+              title: "Unknown controller",
+              detail: "Controller '#{controller}' is referenced but not found in controllers directory",
+              where: binding[:selector]
+            }
+          end
+        end
+        
+        # Check for suspicious actions
+        binding[:actions].each do |action|
+          unless action =~ /^[^->]+->[^#]+#[^#]+$/
+            @lint_results << {
+              level: "warn", 
+              title: "Suspicious action format",
+              detail: "Action '#{action}' doesn't match expected 'event->controller#method' format",
+              hint: "Expected format: 'click->controller#method'",
+              where: binding[:selector]
+            }
+          end
+        end
+        
+        # Check for empty bindings
+        if !binding[:controllers].empty? && 
+           binding[:actions].empty? && 
+           binding[:targets].empty? && 
+           binding[:values].empty?
+          @lint_results << {
+            level: "info",
+            title: "Empty binding",
+            detail: "Element has data-controller but no actions, targets, or values",
+            hint: "Consider adding data-action, targets, or values to make the controller useful",
+            where: binding[:selector]
+          }
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_viz/version.rb

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

data/lib/stimulus_viz.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require_relative "stimulus_viz/version"
+require_relative "stimulus_viz/scanner"
+require_relative "stimulus_viz/cli"
+
+module StimulusViz
+  class Error < StandardError; end
+end

data/stimulus-viz.gemspec

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "lib/stimulus_viz/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "stimulus-viz"
+  spec.version = StimulusViz::VERSION
+  spec.authors = ["Minori Sugimura"]
+  spec.email = ["minorex.0117@gmail.com"]
+
+  spec.summary = "Rails/Hotwire Stimulus visualization tool"
+  spec.description = "Static analysis tool for Stimulus controllers and DOM bindings in Rails applications"
+  spec.homepage = "https://github.com/Minokiti11/stimulus-viz"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.1.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/CHANGELOG.md"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "thor", "~> 1.0"
+  spec.add_dependency "json", "~> 2.0"
+
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+end

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: stimulus-viz
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
-- Developer
+- Minori Sugimura
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -68,18 +68,32 @@ dependencies:
 description: Static analysis tool for Stimulus controllers and DOM bindings in Rails
   applications
 email:
-- developer@example.com
-executables: []
+- minorex.0117@gmail.com
+executables:
+- stimulus-viz
 extensions: []
 extra_rdoc_files: []
-files: []
-homepage: https://github.com/example/stimulus-viz
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- example.json
+- example_project/app/javascript/controllers/hello_controller.js
+- example_project/app/views/home/index.html.erb
+- exe/stimulus-viz
+- lib/stimulus_viz.rb
+- lib/stimulus_viz/cli.rb
+- lib/stimulus_viz/scanner.rb
+- lib/stimulus_viz/version.rb
+- stimulus-viz.gemspec
+homepage: https://github.com/Minokiti11/stimulus-viz
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/example/stimulus-viz
-  source_code_uri: https://github.com/example/stimulus-viz
-  changelog_uri: https://github.com/example/stimulus-viz/CHANGELOG.md
+  homepage_uri: https://github.com/Minokiti11/stimulus-viz
+  source_code_uri: https://github.com/Minokiti11/stimulus-viz
+  changelog_uri: https://github.com/Minokiti11/stimulus-viz/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib
@@ -94,7 +108,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Rails/Hotwire Stimulus visualization tool
 test_files: []