modal_stack 0.1.1 → 0.3.0

data/lib/modal_stack/configuration.rb

@@ -11,14 +11,17 @@ module ModalStack
   #   end
   #
   class Configuration
-    CSS_PROVIDERS = %i[tailwind bootstrap vanilla none].freeze
+    CSS_PROVIDERS = %i[tailwind_v3 tailwind_v4 bootstrap vanilla none].freeze
+    # Aliases accepted on input, normalized to a canonical CSS_PROVIDERS value.
+    # `:tailwind` predates the v3/v4 split — keep it working, map to v3 (no change
+    # in rendered CSS for existing apps).
+    CSS_PROVIDER_ALIASES = { tailwind: :tailwind_v3 }.freeze
     ASSETS_MODES = %i[importmap jsbundling sprockets auto].freeze
     VARIANTS = %i[modal drawer bottom_sheet confirmation].freeze
     SIZES = %i[sm md lg xl].freeze
+    MAX_DEPTH_STRATEGIES = %i[raise warn silent].freeze
 
     attr_accessor :default_classes,
-                  :default_dismissible,
-                  :max_depth,
                   :request_header,
                   :dialog_id,
                   :stack_root_data_attribute,
@@ -28,15 +31,22 @@ module ModalStack
                   :initializer_version,
                   :silence_initializer_warning
 
-    attr_reader :css_provider, :assets_mode, :default_variant, :default_size
+    attr_reader :css_provider,
+                :assets_mode,
+                :default_variant,
+                :default_size,
+                :default_dismissible,
+                :max_depth,
+                :max_depth_strategy
 
     def initialize
-      @css_provider = :tailwind
+      @css_provider = :tailwind_v3
       @assets_mode = :auto
       @default_variant = :modal
       @default_size = :md
       @default_dismissible = true
       @max_depth = 5
+      @max_depth_strategy = :warn
       @request_header = "X-Modal-Stack-Request"
       @dialog_id = "modal-stack-root"
       @stack_root_data_attribute = "modal-stack"
@@ -50,6 +60,7 @@ module ModalStack
 
     def css_provider=(value)
       value = value.to_sym
+      value = CSS_PROVIDER_ALIASES.fetch(value, value)
       raise ArgumentError, "css_provider must be one of #{CSS_PROVIDERS.inspect}, got #{value.inspect}" unless CSS_PROVIDERS.include?(value)
 
       @css_provider = value
@@ -76,6 +87,34 @@ module ModalStack
       @default_size = value
     end
 
+    def default_dismissible=(value)
+      raise ArgumentError, "default_dismissible must be true or false, got #{value.inspect}" unless [true, false].include?(value)
+
+      @default_dismissible = value
+    end
+
+    def max_depth=(value)
+      if value.nil?
+        @max_depth = nil
+        return
+      end
+
+      coerced = Integer(value, exception: false)
+      raise ArgumentError, "max_depth must be a positive integer or nil, got #{value.inspect}" if coerced.nil? || coerced < 1
+
+      @max_depth = coerced
+    end
+
+    def max_depth_strategy=(value)
+      value = value.to_sym
+      unless MAX_DEPTH_STRATEGIES.include?(value)
+        raise ArgumentError,
+              "max_depth_strategy must be one of #{MAX_DEPTH_STRATEGIES.inspect}, got #{value.inspect}"
+      end
+
+      @max_depth_strategy = value
+    end
+
     private
 
     def default_classes_hash

data/lib/modal_stack/controller_extensions.rb

@@ -5,7 +5,7 @@ module ModalStack
     extend ActiveSupport::Concern
 
     included do
-      helper_method :modal_stack_request?
+      helper_method :modal_stack_request?, :modal_stack_config
     end
 
     class_methods do
@@ -39,6 +39,13 @@ module ModalStack
       end
     end
 
+    # Request-scoped accessor for `ModalStack.configuration`. Memoized so
+    # helpers that read several config values per render hit the global
+    # singleton once instead of N times.
+    def modal_stack_config
+      @modal_stack_config ||= ModalStack.configuration
+    end
+
     # True when the current request was issued by the modal_stack JS runtime
     # (signaled by the X-Modal-Stack-Request header on the fetch).
     def modal_stack_request?

data/lib/modal_stack/helpers/modal_stack_assets_helper.rb

@@ -11,7 +11,7 @@ module ModalStack
       # Returns an empty SafeBuffer when `config.css_provider = :none`,
       # so apps can call this unconditionally.
       def modal_stack_stylesheet_link_tag(**)
-        provider = ModalStack.configuration.css_provider
+        provider = _modal_stack_config.css_provider
         return ActiveSupport::SafeBuffer.new if provider == :none
 
         stylesheet_link_tag("modal_stack/#{provider}", **)
@@ -23,23 +23,43 @@ module ModalStack
       #   <%= modal_stack_dialog_tag %>
       #
       def modal_stack_dialog_tag(**html_options)
-        config = ModalStack.configuration
+        config = _modal_stack_config
         attrs = html_options.dup
         attrs[:id] ||= config.dialog_id
-
-        existing_data = attrs[:data] || {}
-        controllers = [existing_data[:controller], config.stack_root_data_attribute].compact.join(" ").strip
-        attrs[:data] = existing_data.merge(controller: controllers)
+        attrs[:data] = build_dialog_data(attrs[:data], config)
 
         content_tag(:dialog, "".html_safe, attrs)
       end
 
+      # Merges caller-provided data attrs with the gem-managed ones (controller,
+      # max-depth value/strategy). Caller data wins on key collision.
+      def build_dialog_data(provided, config)
+        existing = provided || {}
+        controllers = [existing[:controller], config.stack_root_data_attribute].compact.join(" ").strip
+        data = existing.merge(controller: controllers)
+        data[:modal_stack_max_depth_value] ||= config.max_depth if config.max_depth
+        data[:modal_stack_max_depth_strategy_value] ||= config.max_depth_strategy.to_s
+        data
+      end
+
       # Emits a no-op SafeBuffer for now — kept as a stable hook for apps
       # that prefer a single line in their layout. The actual JS loading
       # is handled by the host app's bundler / importmap.
       def modal_stack_javascript_tag(**)
         ActiveSupport::SafeBuffer.new
       end
+
+      private
+
+      # Prefers the request-scoped accessor injected by ControllerExtensions
+      # so we hit `ModalStack.configuration` once per request, not per call.
+      # Falls back to the global singleton for non-controller render contexts
+      # (mailers, ActionCable, isolated view tests).
+      def _modal_stack_config
+        return modal_stack_config if respond_to?(:modal_stack_config, true)
+
+        ModalStack.configuration
+      end
     end
   end
 end

data/lib/modal_stack/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ModalStack
-  VERSION = "0.1.1"
+  VERSION = "0.3.0"
 end

data/lib/modal_stack.rb

@@ -14,7 +14,7 @@ module ModalStack
   # Bumped when config/initializers/modal_stack.rb gains/loses an option,
   # so apps that haven't regenerated their initializer get a one-line
   # boot warning.  Independent from the gem's VERSION.
-  INITIALIZER_VERSION = "0.1.0"
+  INITIALIZER_VERSION = "0.3.0"
 
   class << self
     def configuration

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: modal_stack
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Florian Gagnaire
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-02 00:00:00.000000000 Z
+date: 2026-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -70,7 +70,8 @@ files:
 - Rakefile
 - app/assets/javascripts/modal_stack.js
 - app/assets/stylesheets/modal_stack/bootstrap.css
-- app/assets/stylesheets/modal_stack/tailwind.css
+- app/assets/stylesheets/modal_stack/tailwind_v3.css
+- app/assets/stylesheets/modal_stack/tailwind_v4.css
 - app/assets/stylesheets/modal_stack/vanilla.css
 - app/javascript/modal_stack/controllers/modal_stack_controller.js
 - app/javascript/modal_stack/controllers/modal_stack_link_controller.js