stimulus-rails 0.4.2 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e7e80a2e07dc6e40f109bc5c009bbea41b02057c8a7b489b638c0a964d14f22
-  data.tar.gz: aa0979ef349cd0c4a49b27c11448663cb40728643bbf43f68a3136ae491e7ab7
+  metadata.gz: d527795451c1f97bf1bc540f6cb5ce4171a4f016df1d8f60b30da8e96f7adf27
+  data.tar.gz: 7478ece303c9b51ed819d7a04e8ff3e7f578b6debb17ebc7ea00a8afd2fbd2f3
 SHA512:
-  metadata.gz: 694ab07e593aca69e7abfb0e22c4459ddc27be5d7a5f8cdaa35dfb957f05d6da45e580ec7b9c22af09911a0c2901b4b459a4fdad5ecbbf9165052c047d44d56e
-  data.tar.gz: 3c1412141e0c2a9c2b29fea34f3946c0c14610d69b37c15557100d0a12422948f9be6d6d8977b7059d8b0aa233e1456eb3d82b78ec164881df39a2d1c3a8dc1d
+  metadata.gz: 8dfe74aba6df874a5f3d8f8fe701f78b79d3f31577383a673f3556c1607c9cf1d80e5df6301327aa5bfb816b7ee36c3916d9b9ea1c57bdfc4b0fedf96c0b8fa6
+  data.tar.gz: 4dec5a152ecac26df7008230f791bf4270518de1ab48379c405a30f4485d07c5443dcde5bb892baab33351949f2bd529e31df1180a4d217db7adcb902586fb88

data/README.md

@@ -11,31 +11,24 @@ Stimulus for Rails makes it easy to use this modest framework with the asset pip
 2. Run `./bin/bundle install`.
 3. Run `./bin/rails stimulus:install`
 
-If using the asset pipeline to manage JavaScript, the last command will:
-
-1. Create an example controller in `app/assets/javascripts/controllers/hello_controller.js`.
-2. Append `import "@hotwired/stimulus-autoloader"` to your `app/assets/javascripts/application.js` entrypoint.
-
-Make sure you've already installed `importmap-rails` and that it's referenced before `stimulus-rails` (or `hotwire-rails`) in your Gemfile.
-
-If using Webpacker to manage JavaScript, the last command will:
-
-1. Import the controllers directory in the application pack.
-2. Create a controllers directory at `app/javascripts/controllers`.
-3. Create an example controller in `app/javascripts/controllers/hello_controller.js`.
-4. Install the Stimulus NPM package.
+The installer will automatically detect whether you're using an import map or node to manage your application's JavaScript. If you're using an import map, the Stimulus dependencies will be pinned to the versions of the library included with this gem. If you're using node, yarn will add the dependencies to your package.json file.
 
 
 ## Usage
 
-With the installation done, you'll automatically have activated Stimulus through the controller autoloader. You can now easily add new Stimulus controllers that'll be loaded via ESM dynamic imports.
+The installer amends your JavaScript entry point at `app/javascript/application.js` to import the `app/javascript/controllers/index.js` file, which is responsible for setting up your Stimulus application and registering your controllers.
+
+With an import-mapped application, controllers are automatically pinned and registered based on the file structure. With a node application, controllers need to be imported and registered directly in the index.js file, but this is done automatically using either the Stimulus generator (`./bin/rails generate stimulus [controller]`) or the dedicated `stimulus:manifest:update` task. Either will overwrite the `controllers/index.js` file.
 
-For example, a more advanced `hello_controller` could look like this:
+You're encouraged to use the generator to add new controllers like so:
 
 ```javascript
+// Run "./bin/rails g stimulus hello" to create the file and update the index, then amend:
+
 // app/assets/javascripts/controllers/hello_controller.js
-import { Controller } from "stimulus"
+import { Controller } from "@hotwired/stimulus"
 
+// Connects with data-controller="hello"
 export default class extends Controller {
   static targets = [ "name", "output" ]
 

data/lib/generators/stimulus/USAGE

@@ -0,0 +1,15 @@
+Description:
+============
+    Generates a new Stimulus controller at the passed path. If running under node,
+    it'll also call the stimulus:manifest:update task to update the controllers/index.js.
+
+Examples:
+=========
+    bin/rails generate stimulus chat
+
+    creates: app/javascript/controllers/chat_controller.js
+
+
+    bin/rails generate stimulus nested/chat
+
+    creates: app/javascript/controllers/nested/chat_controller.js

data/lib/generators/stimulus/stimulus_generator.rb

@@ -0,0 +1,16 @@
+require "rails/generators/named_base"
+
+class StimulusGenerator < Rails::Generators::NamedBase # :nodoc:
+  source_root File.expand_path("templates", __dir__)
+
+  def copy_view_files
+    @attribute = stimulus_attribute_value(name)
+    template "controller.js", "app/javascript/controllers/#{name}_controller.js"
+    rails_command "stimulus:manifest:update" if Rails.root.join("package.json").exist?
+  end
+
+  private
+    def stimulus_attribute_value(name)
+      name.gsub(/\//, "--")
+    end
+end

data/lib/generators/stimulus/templates/controller.js.tt

@@ -0,0 +1,7 @@
+import { Controller } from "@hotwired/stimulus"
+
+// Connects to data-controller="<%= @attribute %>"
+export default class extends Controller {
+  connect() {
+  }
+}

data/lib/install/app/javascript/controllers/application.js

@@ -0,0 +1,10 @@
+import { Application } from "@hotwired/stimulus"
+
+const application = Application.start()
+
+// Configure Stimulus development experience
+application.warnings = true
+application.debug    = false
+window.Stimulus      = application
+
+export { application }

data/lib/install/app/javascript/controllers/index_for_importmap.js

@@ -1,12 +1,5 @@
-import { Application } from "@hotwired/stimulus"
-
-const application = Application.start()
-
-// Configure Stimulus development experience
-application.warnings = true
-application.debug    = false
-window.Stimulus      = application
-
 // Import and register all your controllers from the importmap under controllers/*
+
+import { application } from "controllers/application"
 import { registerControllersFrom } from "@hotwired/stimulus-importmap-autoloader"
 registerControllersFrom("controllers", application)

data/lib/install/app/javascript/controllers/index_for_node.js

@@ -1,11 +1,7 @@
-import { Application } from "@hotwired/stimulus"
+// This file is auto-generated by ./bin/rails stimulus:manifest:update
+// Run that command whenever you add a new controller
 
-const application = Application.start()
+import { application } from "./application"
 
-// Configure Stimulus development experience
-application.warnings = true
-application.debug    = false
-window.Stimulus      = application
-
-// Import and register all your controllers
-import("./hello_controller").then(c => application.register("hello", c.default))
+import HelloController from "./hello_controller"
+application.register("hello", HelloController)

data/lib/install/stimulus_with_importmap.rb

@@ -2,6 +2,8 @@ say "Create controllers directory"
 empty_directory "app/javascript/controllers"
 copy_file "#{__dir__}/app/javascript/controllers/index_for_importmap.js",
   "app/javascript/controllers/index.js"
+copy_file "#{__dir__}/app/javascript/controllers/application.js",
+  "app/javascript/controllers/application.js"
 copy_file "#{__dir__}/app/javascript/controllers/hello_controller.js",
   "app/javascript/controllers/hello_controller.js"
 

data/lib/install/stimulus_with_node.rb

@@ -1,14 +1,9 @@
 say "Create controllers directory"
 empty_directory "app/javascript/controllers"
-
-if Rails.root.join("config/webpacker.yml").exist?
-  copy_file "#{__dir__}/app/javascript/controllers/index_for_webpacker.js",
-    "app/javascript/controllers/index.js"
-else
-  copy_file "#{__dir__}/app/javascript/controllers/index_for_node.js",
-    "app/javascript/controllers/index.js"
-end
-
+copy_file "#{__dir__}/app/javascript/controllers/index_for_node.js",
+  "app/javascript/controllers/index.js"
+copy_file "#{__dir__}/app/javascript/controllers/application.js",
+  "app/javascript/controllers/application.js"
 copy_file "#{__dir__}/app/javascript/controllers/hello_controller.js",
   "app/javascript/controllers/hello_controller.js"
 

data/lib/stimulus/manifest.rb

@@ -0,0 +1,23 @@
+module Stimulus::Manifest
+  extend self
+
+  def generate_from(controllers_path)
+    extract_controllers_from(controllers_path).collect do |controller_path|
+      module_path = controller_path.relative_path_from(controllers_path).to_s.remove(".js")
+      controller_class_name = module_path.camelize.gsub(/::/, "__")
+      tag_name = module_path.remove("_controller").gsub(/\//, "--")
+  
+      <<-JS
+
+import #{controller_class_name} from "./#{module_path}"
+application.register("#{tag_name}", #{controller_class_name})
+      JS
+    end
+  end
+
+  def extract_controllers_from(directory)
+    (directory.children.select { |e| e.to_s =~ /_controller.js$/ } +
+      directory.children.select(&:directory?).collect { |d| extract_controllers_from(d) }
+    ).flatten
+  end
+end

data/lib/stimulus/version.rb

@@ -1,3 +1,3 @@
 module Stimulus
-  VERSION = "0.4.2"
+  VERSION = "0.5.0"
 end

data/lib/tasks/stimulus_tasks.rake

@@ -1,3 +1,5 @@
+require "stimulus/manifest"
+
 def run_stimulus_install_template(path) system "#{RbConfig.ruby} ./bin/rails app:template LOCATION=#{File.expand_path("../install/#{path}.rb",  __dir__)}" end
 
 namespace :stimulus do
@@ -23,4 +25,23 @@ namespace :stimulus do
       run_stimulus_install_template "stimulus_with_node"
     end
   end
+
+  namespace :manifest do
+    task :display do
+      puts Stimulus::Manifest.generate_from(Rails.root.join("app/javascript/controllers"))
+    end
+
+    task :update do
+      manifest =
+        Stimulus::Manifest.generate_from(Rails.root.join("app/javascript/controllers"))
+
+      File.open(Rails.root.join("app/javascript/controllers/index.js"), "w+") do |index|
+        index.puts "// This file is auto-generated by ./bin/rails stimulus:manifest:update"
+        index.puts "// Run that command whenever you add a new controller"
+        index.puts
+        index.puts %(import { application } from "./application")
+        index.puts manifest
+      end
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stimulus-rails
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.5.0
 platform: ruby
 authors:
 - Sam Stephenson
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-04 00:00:00.000000000 Z
+date: 2021-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -40,15 +40,18 @@ files:
 - app/assets/javascripts/stimulus.js
 - app/assets/javascripts/stimulus@2.js
 - app/assets/javascripts/stimulus@3.0.0-beta.1.js
+- lib/generators/stimulus/USAGE
+- lib/generators/stimulus/stimulus_generator.rb
+- lib/generators/stimulus/templates/controller.js.tt
+- lib/install/app/javascript/controllers/application.js
 - lib/install/app/javascript/controllers/hello_controller.js
 - lib/install/app/javascript/controllers/index_for_importmap.js
 - lib/install/app/javascript/controllers/index_for_node.js
-- lib/install/app/javascript/controllers/index_for_webpacker.js
-- lib/install/install.rb
 - lib/install/stimulus_with_importmap.rb
 - lib/install/stimulus_with_node.rb
 - lib/stimulus-rails.rb
 - lib/stimulus/engine.rb
+- lib/stimulus/manifest.rb
 - lib/stimulus/version.rb
 - lib/tasks/stimulus_tasks.rake
 homepage: https://stimulus.hotwired.dev

data/lib/install/app/javascript/controllers/index_for_webpacker.js

@@ -1,14 +0,0 @@
-import { Application } from "@hotwired/stimulus"
-
-const application = Application.start()
-
-// Configure Stimulus development experience
-application.warnings = true
-application.debug    = false
-window.Stimulus      = application
-
-// Import and register all your controllers within this directory and all subdirectories
-// Controller files must be named *_controller.js or *_controller.ts
-import { definitionsFromContext } from "@hotwired/stimulus"
-const context = require.context("controllers", true, /_controller\.(js|ts)$/)
-application.load(definitionsFromContext(context))

data/lib/install/install.rb

@@ -1,10 +0,0 @@
-if (js_entrypoint_path = Rails.root.join("app/javascript/application.js")).exist?
-  say "Appending Stimulus setup code to JavaScript entrypoint"
-  append_to_file "app/javascript/application.js", %(\nimport "controllers")
-else
-end
-
-say "Creating controllers directory"
-directory "#{__dir__}/app/javascript/controllers", "app/javascript/controllers"
-
-say "Add @hotwired/stimulus package"