Bundle for Production, Dev-Builds and prebuilt JavaScript with the gem

[marcoroth]

Type of PR

Enhancement

Description

This PR

• bundles the JavaScript packages analog to Introduce Rollup for production builds cable_ready#165
• introduces dev-builds analog to Setup automated dev-builds cable_ready#177
• ships the pre-built StimulusReflex JavaScript client with the Rubygem analog to Ship prebuilt JavaScript with the cable_ready gem cable_ready#191.

Why should this be added

• This brings the bundling in-line with CableReady
• Eases the support for us to support all the different JavaScript/assets pipelines that come with Rails 6/7
• Bundles the JavaScript packages upfront so it's more compatible for setups where no build-pipeline is used
• Prepares a future where the stimulus_reflex gem also ships a pre-built JavaScript dist file
• Switches the internal dependency from stimulus to @hotwired/stimulus
• Also introduces dev-builds for StimulusReflex via https://github.com/stimulusreflex/dev-builds
• Rewrites the JavaScript test suite to @web/test-runner
• Bundles the pre-built JavaScript client with the Rubygem

JavaScript Client:

This enables Rails Applications to easily include the StimulusReflex JavaScript client into their app by just installing the stimulus_reflex Rubygem.

# Gemfile

gem 'stimulus_reflex', '~> 3.5'

Either with Import maps:

# config/importmap.rb

# ...

pin 'stimulus_reflex', to: 'stimulus_reflex.min.js', preload: true

Or with the regular Asset pipeline:

<!-- app/views/layouts/application.html.erb -->

<%= javascript_include_tag "stimulus_reflex.umd.min.js", "data-turbo-track": "reload" %>

Checklist

• My code follows the style guidelines of this project
• Checks (StandardRB & Prettier-Standard) are passing
• This is not a documentation update

[leastbad]

I suppose that reality of the longer than anticipated release cycle is that it's harder and harder to justify waiting until a future v4 to switch to @hotwired/stimulus.

[leastbad]

If it's still possible to consider releasing an officially blessed alternative package that imports from stimulus - something like stimulus_reflex-compat - I think that we should at least try to do so.

[marcoroth]

@leastbad I don't think there is a need for it. It's just the internal dependency which is switched over. If you are still using stimulus in your app you don't even notice anything 🙂