markdowndocs 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cebbfbc9bd8562902775c6661f2241c7c5556b1ccecdc4cc6b993804d4c58e02
-  data.tar.gz: af7ab61db222e6dbd9dbecb557cc713068809fdd26604ed629c7b6a49c122e42
+  metadata.gz: a6f2f9ae54ee9769434428aec5808626c4bcc08a55137c339c9310df30fe5973
+  data.tar.gz: c8e029017e1b6739c2b3f2740a016bdf42ff02e87d5935330601ea5f6bd2fb0e
 SHA512:
-  metadata.gz: 5389780ce9d8ad500df799b93bc5790cbca71651f2d320249be1d77cccb85124a484fc519c889e3fd2d8a8d1ec4458d9b65ba0925e706af2835261468e65bbdf
-  data.tar.gz: 9ccbdda3525cc1bd2268214dd684643d5c200da356495cdeeb8f99fa364bee4615910ad20334ee943dd95b75502bc20afb8a5888ab95ed7f45cb0baa0b92804e
+  metadata.gz: 751e5771036b40187003bbbdeaa0fc9ed27142b9d3e542a1e712d74b9f02ac174e82ae8f9ebb1a32b29b42fe3083c2990c746a92aac04fb50a31914a638bb66d
+  data.tar.gz: 22e8544a817e4402d071163c5fc809f316d90a13f7239f50d37e6d3756fd182535f869af85f34d594b94a566445ca799092fc2f0e6558b088b7749384a50fcf7

data/CHANGELOG.md

@@ -5,6 +5,14 @@ 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.2.2] - 2026-03-18
+
+### Changed
+
+- Stimulus controllers now auto-register via a single JS entry point (`import "markdowndocs"`), following the ActionText/Trix pattern. Host apps no longer need to pin individual controllers in their importmap.
+- Install generator adds `import "markdowndocs"` to the host app's `application.js` instead of injecting importmap pins.
+- Added engine and generator specs for the new JS registration flow.
+
 ## [0.2.1] - 2026-02-21
 
 ### Fixed
@@ -76,6 +84,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - i18n support for all UI strings
 - Install generator (`rails generate markdowndocs:install`)
 
+[0.2.2]: https://github.com/dschmura/markdowndocs/releases/tag/v0.2.2
 [0.2.1]: https://github.com/dschmura/markdowndocs/releases/tag/v0.2.1
 [0.2.0]: https://github.com/dschmura/markdowndocs/releases/tag/v0.2.0
 [0.1.5]: https://github.com/dschmura/markdowndocs/releases/tag/v0.1.5

data/app/assets/javascripts/markdowndocs/application.js

@@ -0,0 +1,11 @@
+import DocsSearchController from "markdowndocs/controllers/docs_search_controller"
+import DocsModeController from "markdowndocs/controllers/docs_mode_controller"
+
+// Auto-register if Stimulus application exists on window, otherwise
+// the host app can import and register these controllers manually.
+if (window.Stimulus) {
+  window.Stimulus.register("docs-search", DocsSearchController)
+  window.Stimulus.register("docs-mode", DocsModeController)
+}
+
+export { DocsSearchController, DocsModeController }

data/config/importmap.rb

@@ -3,6 +3,7 @@
 # Importmap pins for Markdowndocs engine.
 # These are automatically registered with the host app when importmap-rails is present.
 
+pin "markdowndocs", to: "markdowndocs/application.js"
 pin "markdowndocs/controllers/docs_search_controller", to: "markdowndocs/controllers/docs_search_controller.js"
 pin "markdowndocs/controllers/docs_mode_controller", to: "markdowndocs/controllers/docs_mode_controller.js"
 pin "minisearch", to: "markdowndocs/vendor/minisearch.min.js"

data/lib/generators/markdowndocs/install/install_generator.rb

@@ -20,25 +20,18 @@ module Markdowndocs
         route 'mount Markdowndocs::Engine, at: "/docs"'
       end
 
-      def pin_importmap_assets
-        importmap_file = Rails.root.join("config/importmap.rb").to_s
-        return unless File.exist?(importmap_file)
-
-        importmap_content = File.read(importmap_file)
-
-        pins = {
-          'pin "markdowndocs/controllers/docs_search_controller", to: "markdowndocs/controllers/docs_search_controller.js"' => "docs_search_controller",
-          'pin "markdowndocs/controllers/docs_mode_controller", to: "markdowndocs/controllers/docs_mode_controller.js"' => "docs_mode_controller",
-          'pin "minisearch", to: "markdowndocs/vendor/minisearch.min.js"' => "minisearch"
-        }
-
-        pins.each do |pin_line, name|
-          if importmap_content.include?(pin_line)
-            say_status :skip, "importmap pin for #{name} already present", :yellow
-          else
-            append_to_file importmap_file, "\n#{pin_line}\n"
-            say_status :pin, name, :green
-          end
+      def add_markdowndocs_import
+        js_file = Rails.root.join("app/javascript/application.js").to_s
+        return unless File.exist?(js_file)
+
+        js_content = File.read(js_file)
+        import_line = 'import "markdowndocs"'
+
+        if js_content.include?(import_line)
+          say_status :skip, "markdowndocs import already present in application.js", :yellow
+        else
+          append_to_file js_file, "\n#{import_line}\n"
+          say_status :import, "markdowndocs in application.js", :green
         end
       end
 
@@ -76,10 +69,8 @@ module Markdowndocs
           say "    @source \"#{Markdowndocs::Engine.root.join("app", "views")}/**/*.erb\";"
           say ""
         end
-        say "  Stimulus controllers are auto-registered via importmap.", :green
-        say "  If you use a custom Stimulus setup, register these controllers:"
-        say "    - markdowndocs/controllers/docs_mode_controller"
-        say "    - markdowndocs/controllers/docs_search_controller (when search is enabled)"
+        say "  Stimulus controllers are auto-registered via: import \"markdowndocs\"", :green
+        say "  If this was not added automatically, add it to app/javascript/application.js"
         say ""
       end
 

data/lib/markdowndocs/engine.rb

@@ -19,5 +19,14 @@ module Markdowndocs
         app.config.importmap.paths << root.join("config/importmap.rb")
       end
     end
+
+    initializer "markdowndocs.stimulus" do
+      Rails.application.config.after_initialize do
+        if defined?(Importmap)
+          # The pin is already added via importmap.rb
+          # Host app just needs: import "markdowndocs" in their application.js
+        end
+      end
+    end
   end
 end

data/lib/markdowndocs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Markdowndocs
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: markdowndocs
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Dave Chmura
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-21 00:00:00.000000000 Z
+date: 2026-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -78,6 +78,7 @@ files:
 - CHANGELOG.md
 - README.md
 - Rakefile
+- app/assets/javascripts/markdowndocs/application.js
 - app/assets/javascripts/markdowndocs/controllers/docs_mode_controller.js
 - app/assets/javascripts/markdowndocs/controllers/docs_search_controller.js
 - app/assets/javascripts/markdowndocs/vendor/minisearch.min.js