swal_rails 0.3.1.beta2 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8bb7a427540f6d06a45d6f18b7a4b29c9771a4890080bbab90dc6806e59502fb
-  data.tar.gz: e39bf17dfad033eb1d23b57710ae48f729ebb26da77139ef359a12f3bf88732b
+  metadata.gz: db0cf6b419c2e989dfcc877d644fc85244f2c85e0fc2e012661b594854d5cdad
+  data.tar.gz: f26da33eb89b79b5338eb822281f89d5bc43376ca3a22f39969aaba3c7440f66
 SHA512:
-  metadata.gz: 72f6a4f2df33ecc991599e09e59bcbcb46f9f328b27803c53c0d4d06f3ad6eb665d9fe23170850e52cf1b277ce211cffe6762edf300ca8525225a3fc8d798cc1
-  data.tar.gz: 770db1bd51acd17a16e0601d67217bd44428d38fdcff73abcc753192371ce49a5ba451735dd181b476465f90db5de65c6ece483a8ed20d79ec8f30106f427133
+  metadata.gz: 35d5a3a5d411f39870070332ab2516987d9f6345ca3cf17f3fb6b0958f1ae9680608bb1a355ce2ffad3257cabb3e384fee9533018756c90784a29fc176c456c9
+  data.tar.gz: e48305dfd6fdb0bcb3bab2cbafbf4f56a017006e5d2d95cb716ecff61fa15ffd4abea636206c04e7e57f76a15a7d9888bd64cf6f114ce21bf78a346b52b43424

data/CHANGELOG.md

@@ -6,44 +6,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.3.1.beta2] - 2026-04-24
+## [0.3.3] - 2026-04-25
 
-### Fixed
-- Flash runtime now also boots on `turbo:render`, not just `turbo:load`.
-  Form submissions that render in place (`render :index, status:
-  :unprocessable_entity` for `flash.now` payloads) trigger `turbo:render`
-  but not `turbo:load`, so the `swal-flash` meta tag emitted in the new
-  body never reached the runtime. The existing `data-swal-consumed`
-  guard on the meta tag dedupes the double-fire on full navigations.
-- Stacked-mode clones now render at SA2's standard toast width (360px,
-  capped at viewport width minus 2rem) instead of stretching to the full
-  page. The fix applies CSS to `#swal-rails-stack` mirroring SA2's
-  internal `body.swal2-toast-shown .swal2-container` rules — necessary
-  because the cloned popups live outside SA2's container hierarchy.
-- Confirm `:turbo_override` / `:both` now writes to
-  `Turbo.config.forms.confirm` first (Turbo 8.1+) and only falls back to
-  the deprecated `Turbo.setConfirmMethod`. Silences the Turbo deprecation
-  warning logged on every page load.
-
-### Changed
-- `default_options` no longer ships with `focusConfirm: true` /
-  `returnFocus: true`. Both are already SA2's internal defaults, so
-  behavior is unchanged — but listing them explicitly made SA2 warn
-  ("incompatible with toasts") on every toast fire. The generator
-  template is updated to match.
-- `flash_map[:alert]` and `flash_map[:error]` now default to a toast
-  (top-end, 4s, error icon) instead of a blocking modal. This makes every
-  built-in flash key a toast out of the box — more consistent and more in
-  line with how Rails apps typically use `flash[:alert]`. Users who want
-  the old modal behavior can still opt in:
-  `config.flash_map[:alert] = { icon: "error", toast: false }`.
+### Added
+- Boot-time initializer drift detection. The gem ships
+  `SwalRails::INITIALIZER_VERSION`, the install template stamps
+  `config.initializer_version = "<current>"`, and a Rails initializer
+  hooked after `:load_config_initializers` logs a one-line warning when
+  the user's stamp is missing or trails the gem's expected value. Includes
+  the regenerate command in the message:
+  `bin/rails g swal_rails:install --skip-layout --force`.
+- `config.silence_initializer_warning` (Boolean, default `false`) opt-out
+  for users who don't want to regenerate.
+
+## [0.3.2] - 2026-04-25
+
+First stable release on top of the `0.3.1.beta1` + `0.3.1.beta2`
+prereleases. End users upgrading from `0.3.0` should read the
+consolidated entry below.
 
 ### Added
 - `config.flash_array_mode` (`:sequential` default | `:stacked`) — how a
   multi-entry flash payload is played. Sequential waits for each Swal to
-  close before firing the next (current behavior); stacked renders every
-  toast in parallel in a fixed top-right container with a configurable
-  delay between each appearance.
+  close before firing the next; stacked renders every toast in parallel in
+  a fixed top-right container with a configurable delay between each
+  appearance.
 - `config.flash_stack_delay` (ms, default 500) — gap between stacked
   toasts in `:stacked` mode.
 - `swal_flash(key, messages, mode:, delay:, now:, **options)` helper,
@@ -53,15 +40,52 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Reserved meta-keys `_arrayMode` / `_stackDelay` on flash entry options,
   stripped by the JS runtime before being passed to `Swal.fire`.
 
-## [0.3.1.beta1] - 2026-04-21
-
 ### Changed
-- First public release on [RubyGems.org](https://rubygems.org/gems/swal_rails). Prior `0.x` tags lived on GitHub Packages only.
+- `flash_map[:alert]` and `flash_map[:error]` now default to a toast
+  (top-end, 4s, error icon) instead of a blocking modal. Every built-in
+  flash key is a toast out of the box — more consistent and in line with
+  how Rails apps typically use `flash[:alert]`. The old modal behavior is
+  still opt-in: `config.flash_map[:alert] = { icon: "error", toast: false }`.
+- `default_options` no longer ships with `focusConfirm: true` /
+  `returnFocus: true`. Both are SA2's internal defaults already, so
+  behavior is unchanged — but listing them explicitly made SA2 warn
+  ("incompatible with toasts") on every toast fire. Generator template
+  updated to match.
+- Generator initializer comment for `:turbo_override` now mentions
+  `Turbo.config.forms.confirm` (Turbo 8.1+) with a fallback to the legacy
+  `setConfirmMethod`.
 - Release workflow now publishes to RubyGems via [Trusted Publishing](https://guides.rubygems.org/trusted-publishing/) (OIDC), no long-lived API key.
+- First public release on [RubyGems.org](https://rubygems.org/gems/swal_rails). Prior `0.x` tags lived on GitHub Packages only.
+
+### Fixed
+- Flash runtime also boots on `turbo:render`, not just `turbo:load`. Form
+  submissions that render in place (`render :index, status:
+  :unprocessable_entity` for `flash.now` payloads) trigger `turbo:render`
+  but not `turbo:load`, so the `swal-flash` meta tag emitted in the new
+  body never reached the runtime. The `data-swal-consumed` guard on the
+  meta tag dedupes the double-fire on full navigations.
+- Stacked-mode clones render at SA2's standard toast width (360px, capped
+  at `calc(100vw - 2rem)`) instead of stretching to the full page. CSS on
+  `#swal-rails-stack` mirrors SA2's `body.swal2-toast-shown .swal2-container`
+  rules — necessary because the cloned popups live outside SA2's container
+  hierarchy.
+- Confirm `:turbo_override` / `:both` writes to `Turbo.config.forms.confirm`
+  first (Turbo 8.1+) and falls back to the deprecated
+  `Turbo.setConfirmMethod`. Silences the Turbo deprecation warning.
 
 ### Security
-- `.gitignore` hardened preventively against `.env`, `master.key`, `config/credentials/*.key`, `*.pem`, `*.key`.
-- Gemspec now pins `allowed_push_host` to `https://rubygems.org` as a safety net against accidental push to other hosts.
+- `.gitignore` hardened preventively against `.env`, `master.key`,
+  `config/credentials/*.key`, `*.pem`, `*.key`.
+- Gemspec pins `allowed_push_host` to `https://rubygems.org` as a safety
+  net against accidental push to other hosts.
+
+## [0.3.1.beta2] - 2026-04-24
+
+Prerelease snapshot — superseded by [0.3.2].
+
+## [0.3.1.beta1] - 2026-04-21
+
+Prerelease snapshot — superseded by [0.3.2].
 
 ## [0.3.0] - 2026-04-21
 

data/gemfiles/rails_7_2.gemfile

@@ -14,12 +14,12 @@ group :development, :test do
   gem "appraisal", "~> 2.5"
   gem "capybara", "~> 3.40"
   gem "cuprite", "~> 0.15"
-  gem "puma", "~> 6.4"
+  gem "puma", "~> 8.0"
   gem "rspec", "~> 3.12"
-  gem "rspec-rails", "~> 6.1"
+  gem "rspec-rails", "~> 8.0"
   gem "rubocop", "~> 1.60", require: false
   gem "rubocop-rspec", require: false
-  gem "sqlite3", "~> 1.7"
+  gem "sqlite3", "~> 2.9"
 end
 
 gemspec path: "../"

data/gemfiles/rails_8_0.gemfile

@@ -14,12 +14,12 @@ group :development, :test do
   gem "appraisal", "~> 2.5"
   gem "capybara", "~> 3.40"
   gem "cuprite", "~> 0.15"
-  gem "puma", "~> 6.4"
+  gem "puma", "~> 8.0"
   gem "rspec", "~> 3.12"
-  gem "rspec-rails", "~> 6.1"
+  gem "rspec-rails", "~> 8.0"
   gem "rubocop", "~> 1.60", require: false
   gem "rubocop-rspec", require: false
-  gem "sqlite3", "~> 1.7"
+  gem "sqlite3", "~> 2.9"
 end
 
 gemspec path: "../"

data/gemfiles/rails_8_1.gemfile

@@ -14,12 +14,12 @@ group :development, :test do
   gem "appraisal", "~> 2.5"
   gem "capybara", "~> 3.40"
   gem "cuprite", "~> 0.15"
-  gem "puma", "~> 6.4"
+  gem "puma", "~> 8.0"
   gem "rspec", "~> 3.12"
-  gem "rspec-rails", "~> 6.1"
+  gem "rspec-rails", "~> 8.0"
   gem "rubocop", "~> 1.60", require: false
   gem "rubocop-rspec", require: false
-  gem "sqlite3", "~> 1.7"
+  gem "sqlite3", "~> 2.9"
 end
 
 gemspec path: "../"

data/gemfiles/rails_8_1_sprockets.gemfile

@@ -14,12 +14,12 @@ group :development, :test do
   gem "appraisal", "~> 2.5"
   gem "capybara", "~> 3.40"
   gem "cuprite", "~> 0.15"
-  gem "puma", "~> 6.4"
+  gem "puma", "~> 8.0"
   gem "rspec", "~> 3.12"
-  gem "rspec-rails", "~> 6.1"
+  gem "rspec-rails", "~> 8.0"
   gem "rubocop", "~> 1.60", require: false
   gem "rubocop-rspec", require: false
-  gem "sqlite3", "~> 1.7"
+  gem "sqlite3", "~> 2.9"
 end
 
 gemspec path: "../"

data/lib/generators/swal_rails/install/templates/initializer.rb

@@ -1,10 +1,18 @@
 # frozen_string_literal: true
 
 SwalRails.configure do |config|
+  # Stamps this initializer against the template version that shipped with
+  # the installed gem. The boot-time check warns if you upgrade the gem to
+  # a version with a newer template — regenerate with:
+  #   bin/rails g swal_rails:install --skip-layout --force
+  # Set `config.silence_initializer_warning = true` to silence.
+  config.initializer_version = "<%= SwalRails::INITIALIZER_VERSION %>"
+
   # How confirmation modals are wired.
   #   :off             — do nothing, use Swal manually
   #   :data_attribute  — intercept clicks/submits on [data-swal-confirm] (default, non-intrusive)
-  #   :turbo_override  — replace Turbo.setConfirmMethod globally
+  #   :turbo_override  — replace Turbo.config.forms.confirm globally (Turbo 8.1+),
+  #                      falls back to legacy Turbo.setConfirmMethod on older Turbo
   #   :both            — both mechanisms at once
   config.confirm_mode = :<%= options[:confirm_mode] %>
 

data/lib/swal_rails/configuration.rb

@@ -17,7 +17,9 @@ module SwalRails
                   :flash_keys_as_meta,
                   :respect_reduced_motion,
                   :expose_window_swal,
-                  :flash_stack_delay
+                  :flash_stack_delay,
+                  :initializer_version,
+                  :silence_initializer_warning
     attr_reader :confirm_mode, :flash_map, :i18n_scope, :flash_array_mode
 
     def initialize
@@ -28,6 +30,12 @@ module SwalRails
       @flash_array_mode = :sequential
       @flash_stack_delay = 500
       @i18n_scope = "swal_rails"
+      # `initializer_version` left nil — apps that haven't regenerated
+      # their initializer since `SwalRails::INITIALIZER_VERSION` was
+      # introduced (0.3.3) get a one-line warning at boot. Setting it
+      # explicitly in the initializer template silences it.
+      @initializer_version = nil
+      @silence_initializer_warning = false
       # `focusConfirm` / `returnFocus` are intentionally omitted: SA2 already
       # defaults both to `true` internally, and passing them explicitly makes
       # SA2 warn on every toast ("incompatible with toasts"). Listing them

data/lib/swal_rails/engine.rb

@@ -52,6 +52,13 @@ module SwalRails
     initializer "swal_rails.i18n" do
       config.i18n.load_path += Dir[root.join("config/locales/*.yml").to_s]
     end
+
+    # Run AFTER user initializers so we can read whatever value they set
+    # (or didn't set) for `config.initializer_version`. One-shot, idempotent,
+    # opt-out via `config.silence_initializer_warning = true`.
+    initializer "swal_rails.check_initializer_version", after: :load_config_initializers do
+      SwalRails::InitializerVersionCheck.run!
+    end
   end
 end
 

data/lib/swal_rails/initializer_version_check.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module SwalRails
+  # Compares the user's `config.initializer_version` against the gem's
+  # `SwalRails::INITIALIZER_VERSION` and logs a one-line warning when the
+  # initializer is missing the stamp or trails the gem's expected value.
+  #
+  # Wired into the engine after `:load_config_initializers` so it sees
+  # whatever the user set. Silenced via
+  # `config.silence_initializer_warning = true`.
+  module InitializerVersionCheck
+    module_function
+
+    def run!(logger: default_logger, config: SwalRails.configuration)
+      return if config.silence_initializer_warning
+
+      message = stale_message(config)
+      return unless message
+
+      logger.warn(message)
+    end
+
+    def stale_message(config)
+      user = config.initializer_version
+      current = SwalRails::INITIALIZER_VERSION
+
+      return nil if user == current
+
+      regen = "Run `bin/rails g swal_rails:install --skip-layout --force` to regenerate, or set " \
+              "`config.silence_initializer_warning = true` to silence."
+
+      if user.nil?
+        "[swal_rails] config/initializers/swal_rails.rb predates v#{current} " \
+          "(no `config.initializer_version` set). New options may be missing. #{regen}"
+      else
+        "[swal_rails] initializer template advanced to v#{current} (yours: v#{user}). #{regen}"
+      end
+    end
+
+    def default_logger
+      defined?(Rails) && Rails.respond_to?(:logger) && Rails.logger ? Rails.logger : Logger.new($stderr)
+    end
+  end
+end

data/lib/swal_rails/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module SwalRails
-  VERSION = "0.3.1.beta2"
+  VERSION = "0.3.3"
   SWEETALERT2_VERSION = "11.26.24"
 end

data/lib/swal_rails.rb

@@ -5,6 +5,14 @@ require_relative "swal_rails/version"
 module SwalRails
   class Error < StandardError; end
 
+  # The initializer template version this release of the gem ships.
+  # Bump only when the template content changes in a way users should
+  # know about (new option, removed option, default flip). Compared at
+  # boot against `config.initializer_version` to warn about stale
+  # config/initializers/swal_rails.rb files. Independent from gem VERSION
+  # so non-template-touching releases don't trigger spurious warnings.
+  INITIALIZER_VERSION = "0.3.3"
+
   class << self
     def configuration
       @configuration ||= Configuration.new
@@ -21,5 +29,6 @@ module SwalRails
 end
 
 require_relative "swal_rails/configuration"
+require_relative "swal_rails/initializer_version_check"
 require_relative "swal_rails/helpers"
 require_relative "swal_rails/engine" if defined?(Rails::Engine)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: swal_rails
 version: !ruby/object:Gem::Version
-  version: 0.3.1.beta2
+  version: 0.3.3
 platform: ruby
 authors:
 - Florian Gagnaire
@@ -73,6 +73,7 @@ files:
 - lib/swal_rails/configuration.rb
 - lib/swal_rails/engine.rb
 - lib/swal_rails/helpers.rb
+- lib/swal_rails/initializer_version_check.rb
 - lib/swal_rails/version.rb
 - vendor/javascript/sweetalert2/LICENSE
 - vendor/javascript/sweetalert2/sweetalert2.all.js