shakapacker 8.1.0 → 8.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50df828db39af7e84673e9ab8bd4569d644084e428902d02084574b77db9bd8e
-  data.tar.gz: 6aac530ddb579fc7f92888a1e65282bbf69c98bc2773fcd27d77ec19671ec74d
+  metadata.gz: e79664eb847e6cd529faef7596863300465e9ae31cccde5042e86363d3bf8a66
+  data.tar.gz: 57c9eb85b20b964f80bf458a1a6f8f0db79c5bf394819f7e687b973e10839a77
 SHA512:
-  metadata.gz: e6250e22762bd47aaf6dc0d2b93354bea65e3ca2e5d629177bec478495de3e6eaba5a458e3f0feda712bf08bf2b48f2f0a6f003baa6b2ffb354e49fb042e65d3
-  data.tar.gz: 45f445078b0d50f1eebc6d27f8a76ceeb3c8eb38cce4a4881562ab77d3a47f6e86d293f5c46a468a8fc4566bc217b39105cec85a78b5fdc1e77112c22a1d3ff8
+  metadata.gz: ed317c5485ff9db1aabc55ce8ac2e9a53975882f180faa65e1cb4565175956c416e9543d8e5683906d77d3b992f282159a049ef689d6b03de6a90c76d9269a6b
+  data.tar.gz: 557c44369b8af2c300f8bb71810fead6ab59b37770cd7b6898a11b901c73c4da241df82591190ccc65ec3d5b5b3e7b4ce4e055cee51e03bd297d585efd49ba3e

data/CHANGELOG.md

@@ -10,6 +10,11 @@ _next_ branch is for v8 changes
 ## [Unreleased]
 Changes since the last non-beta release.
 
+### Added
+
+- Support for `async` attribute in `javascript_pack_tag`, `append_javascript_pack_tag`, and `prepend_javascript_pack_tag`. [PR 554](https://github.com/shakacode/shakapacker/pull/554) by [AbanoubGhadban](https://github.com/abanoubghadban).
+- Allow `babel-loader` v10. [PR 552](https://github.com/shakacode/shakapacker/pull/552) by [shoeyn](https://github.com/shoeyn).
+
 ## [v8.1.0] - January 20, 2025
 
 ### Added

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    shakapacker (8.1.0)
+    shakapacker (8.2.0)
       activesupport (>= 5.2)
       package_json
       rack-proxy (>= 0.6.1)

data/README.md

@@ -275,7 +275,7 @@ You can provide multiple packs and other attributes. Note, `defer` defaults to s
 ```
 
 The resulting HTML would look like this:
-```
+```html
 <script src="/packs/vendor-16838bab065ae1e314.js" data-turbo-track="reload" defer></script>
 <script src="/packs/calendar~runtime-16838bab065ae1e314.js" data-turbo-track="reload" defer></script>
 <script src="/packs/calendar-1016838bab065ae1e314.js" data-turbo-track="reload" defer"></script>
@@ -287,6 +287,26 @@ In this output, both the calendar and map codes might refer to other common libr
 
 Note, the default of "defer" for the `javascript_pack_tag`. You can override that to `false`. If you expose jquery globally with `expose-loader,` by using `import $ from "expose-loader?exposes=$,jQuery!jquery"` in your `app/javascript/application.js`, pass the option `defer: false` to your `javascript_pack_tag`.
 
+The `javascript_pack_tag` also supports the `async` attribute, which you can enable by passing `async: true`:
+
+```erb
+<%= javascript_pack_tag 'application', async: true %>
+```
+
+This will generate script tags with the `async` attribute, which allows the browser to download and execute the script asynchronously without blocking HTML parsing:
+
+```html
+<script src="/packs/vendor-16838bab065ae1e314.js" async></script>
+<script src="/packs/application~runtime-16838bab065ae1e314.js" async></script>
+<script src="/packs/application-1016838bab065ae1e314.js" async></script>
+```
+
+Note that when using `async: true`, scripts may execute in any order as soon as they're downloaded, which could cause issues if your code has dependencies between files. In most cases, `defer` (the default) is preferred as it maintains execution order.
+
+> [!NOTE]
+>
+> When both `async` and `defer` attributes are specified, `async` takes precedence according to HTML5 specifications. So if you pass both `async: true` and `defer: true`, the script tag will use `async`.
+
 **Important:** Pass all your pack names as multiple arguments, not multiple calls, when using `javascript_pack_tag` and the `stylesheet_pack_tag`. Otherwise, you will get duplicated chunks on the page. 
 
 ```erb

data/gemfiles/Gemfile-rails.6.0.x

@@ -7,3 +7,4 @@ gem "rake", ">= 11.1"
 gem "rack-proxy", require: false
 gem "rspec-rails", "~> 5.0.0"
 gem "byebug"
+gem "concurrent-ruby", "1.3.4"

data/gemfiles/Gemfile-rails.6.1.x

@@ -9,3 +9,4 @@ gem "rake", ">= 11.1"
 gem "rack-proxy", require: false
 gem "rspec-rails", "~> 6.0.0"
 gem "byebug"
+gem "concurrent-ruby", "1.3.4"

data/gemfiles/Gemfile-rails.7.0.x

@@ -9,3 +9,4 @@ gem "rake", ">= 11.1"
 gem "rack-proxy", require: false
 gem "rspec-rails", "~> 7.0"
 gem "byebug"
+gem "concurrent-ruby", "1.3.4"

data/lib/shakapacker/helper.rb

@@ -95,22 +95,25 @@ module Shakapacker::Helper
   #
   #   <%= javascript_pack_tag 'calendar' %>
   #   <%= javascript_pack_tag 'map' %>
-  def javascript_pack_tag(*names, defer: true, **options)
+  def javascript_pack_tag(*names, defer: true, async: false, **options)
     if @javascript_pack_tag_loaded
       raise "To prevent duplicated chunks on the page, you should call javascript_pack_tag only once on the page. " \
       "Please refer to https://github.com/shakacode/shakapacker/blob/main/README.md#view-helpers-javascript_pack_tag-and-stylesheet_pack_tag for the usage guide"
     end
 
-    append_javascript_pack_tag(*names, defer: defer)
-    non_deferred = sources_from_manifest_entrypoints(javascript_pack_tag_queue[:non_deferred], type: :javascript)
-    deferred = sources_from_manifest_entrypoints(javascript_pack_tag_queue[:deferred], type: :javascript) - non_deferred
+    append_javascript_pack_tag(*names, defer: defer, async: async)
+    sync = sources_from_manifest_entrypoints(javascript_pack_tag_queue[:sync], type: :javascript)
+    async = sources_from_manifest_entrypoints(javascript_pack_tag_queue[:async], type: :javascript) - sync
+    deferred = sources_from_manifest_entrypoints(javascript_pack_tag_queue[:deferred], type: :javascript) - sync - async
 
     @javascript_pack_tag_loaded = true
 
     capture do
-      concat javascript_include_tag(*deferred, **options.tap { |o| o[:defer] = true })
-      concat "\n" if non_deferred.any? && deferred.any?
-      concat javascript_include_tag(*non_deferred, **options.tap { |o| o[:defer] = false })
+      concat javascript_include_tag(*async, **options.dup.tap { |o| o[:async] = true })
+      concat "\n" if async.any? && deferred.any?
+      concat javascript_include_tag(*deferred, **options.dup.tap { |o| o[:defer] = true })
+      concat "\n" if sync.any? && deferred.any?
+      concat javascript_include_tag(*sync, **options)
     end
   end
 
@@ -179,27 +182,35 @@ module Shakapacker::Helper
     nil
   end
 
-  def append_javascript_pack_tag(*names, defer: true)
-    update_javascript_pack_tag_queue(defer: defer) do |hash_key|
+  def append_javascript_pack_tag(*names, defer: true, async: false)
+    update_javascript_pack_tag_queue(defer: defer, async: async) do |hash_key|
       javascript_pack_tag_queue[hash_key] |= names
     end
   end
 
-  def prepend_javascript_pack_tag(*names, defer: true)
-    update_javascript_pack_tag_queue(defer: defer) do |hash_key|
+  def prepend_javascript_pack_tag(*names, defer: true, async: false)
+    update_javascript_pack_tag_queue(defer: defer, async: async) do |hash_key|
       javascript_pack_tag_queue[hash_key].unshift(*names)
     end
   end
 
   private
 
-    def update_javascript_pack_tag_queue(defer:)
+    def update_javascript_pack_tag_queue(defer:, async:)
       if @javascript_pack_tag_loaded
         raise "You can only call #{caller_locations(1..1).first.base_label} before javascript_pack_tag helper. " \
         "Please refer to https://github.com/shakacode/shakapacker/blob/main/README.md#view-helper-append_javascript_pack_tag-prepend_javascript_pack_tag-and-append_stylesheet_pack_tag for the usage guide"
       end
 
-      yield(defer ? :deferred : :non_deferred)
+      # When both async and defer are specified, async takes precedence per HTML5 spec
+      hash_key = if async
+        :async
+      elsif defer
+        :deferred
+      else
+        :sync
+      end
+      yield(hash_key)
 
       # prevent rendering Array#to_s representation when used with <%= … %> syntax
       nil
@@ -207,8 +218,9 @@ module Shakapacker::Helper
 
     def javascript_pack_tag_queue
       @javascript_pack_tag_queue ||= {
+        async: [],
         deferred: [],
-        non_deferred: []
+        sync: []
       }
     end
 

data/lib/shakapacker/version.rb

@@ -1,4 +1,4 @@
 module Shakapacker
   # Change the version in package.json too, please!
-  VERSION = "8.1.0".freeze
+  VERSION = "8.2.0".freeze
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shakapacker",
-  "version": "8.1.0",
+  "version": "8.2.0",
   "description": "Use webpack to manage app-like JavaScript modules in Rails",
   "homepage": "https://github.com/shakacode/shakapacker",
   "bugs": {
@@ -55,7 +55,7 @@
     "@babel/runtime": "^7.17.9",
     "@types/babel__core": "^7.0.0",
     "@types/webpack": "^5.0.0",
-    "babel-loader": "^8.2.4 || ^9.0.0",
+    "babel-loader": "^8.2.4 || ^9.0.0 || ^10.0.0",
     "compression-webpack-plugin": "^9.0.0 || ^10.0.0|| ^11.0.0",
     "terser-webpack-plugin": "^5.3.1",
     "webpack": "^5.72.0",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shakapacker
 version: !ruby/object:Gem::Version
-  version: 8.1.0
+  version: 8.2.0
 platform: ruby
 authors:
 - David Heinemeier Hansson
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-21 00:00:00.000000000 Z
+date: 2025-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -284,7 +284,7 @@ homepage: https://github.com/shakacode/shakapacker
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/shakacode/shakapacker/tree/v8.1.0
+  source_code_uri: https://github.com/shakacode/shakapacker/tree/v8.2.0
 post_install_message:
 rdoc_options: []
 require_paths: