RubyGems - modal_stack - Versions diffs - 0.1.1 - Mend

modal_stack 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (37) hide show

checksums.yaml +7 -0
data/CHANGELOG.md +37 -0
data/CODE_OF_CONDUCT.md +10 -0
data/LICENSE.txt +21 -0
data/README.md +748 -0
data/Rakefile +12 -0
data/app/assets/javascripts/modal_stack.js +756 -0
data/app/assets/stylesheets/modal_stack/bootstrap.css +232 -0
data/app/assets/stylesheets/modal_stack/tailwind.css +303 -0
data/app/assets/stylesheets/modal_stack/vanilla.css +219 -0
data/app/javascript/modal_stack/controllers/modal_stack_controller.js +149 -0
data/app/javascript/modal_stack/controllers/modal_stack_link_controller.js +34 -0
data/app/javascript/modal_stack/index.js +15 -0
data/app/javascript/modal_stack/install.js +15 -0
data/app/javascript/modal_stack/orchestrator.js +98 -0
data/app/javascript/modal_stack/orchestrator.test.js +260 -0
data/app/javascript/modal_stack/runtime.js +217 -0
data/app/javascript/modal_stack/runtime.test.js +134 -0
data/app/javascript/modal_stack/state.js +315 -0
data/app/javascript/modal_stack/state.test.js +508 -0
data/app/views/layouts/modal.html.erb +6 -0
data/lib/generators/modal_stack/install/install_generator.rb +224 -0
data/lib/generators/modal_stack/install/templates/initializer.rb +57 -0
data/lib/modal_stack/capybara/minitest.rb +9 -0
data/lib/modal_stack/capybara/rspec.rb +9 -0
data/lib/modal_stack/capybara.rb +85 -0
data/lib/modal_stack/configuration.rb +90 -0
data/lib/modal_stack/controller_extensions.rb +73 -0
data/lib/modal_stack/engine.rb +44 -0
data/lib/modal_stack/helpers/modal_link_helper.rb +65 -0
data/lib/modal_stack/helpers/modal_stack_assets_helper.rb +45 -0
data/lib/modal_stack/helpers/modal_stack_container_helper.rb +36 -0
data/lib/modal_stack/initializer_version_check.rb +33 -0
data/lib/modal_stack/turbo_streams_extension.rb +73 -0
data/lib/modal_stack/version.rb +5 -0
data/lib/modal_stack.rb +36 -0
metadata +130 -0

data/lib/generators/modal_stack/install/install_generator.rb ADDED Viewed

@@ -0,0 +1,224 @@
+# frozen_string_literal: true
+require "rails/generators"
+require "rails/generators/base"
+module ModalStack
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+      ASSETS_MODES = ModalStack::Configuration::ASSETS_MODES.map(&:to_s).freeze
+      CSS_PROVIDERS = ModalStack::Configuration::CSS_PROVIDERS.map(&:to_s).freeze
+      class_option :mode, type: :string, default: "auto", enum: ASSETS_MODES,
+                          desc: "JS asset strategy"
+      class_option :css_provider, type: :string, default: "tailwind",
+                                  enum: CSS_PROVIDERS,
+                                  desc: "CSS preset bundled with the install"
+      class_option :skip_layout, type: :boolean, default: false,
+                                 desc: "Skip injecting helpers / dialog into application layout"
+      class_option :skip_js, type: :boolean, default: false,
+                             desc: "Skip JS pin / install wiring"
+      class_option :skip_initializer, type: :boolean, default: false,
+                                      desc: "Skip generating config/initializers/modal_stack.rb"
+      def copy_initializer
+        return if options[:skip_initializer]
+        template "initializer.rb", "config/initializers/modal_stack.rb"
+      end
+      def configure_javascript
+        return if options[:skip_js]
+        case resolved_mode
+        when "importmap" then install_importmap
+        when "jsbundling" then install_jsbundling
+        when "sprockets" then install_sprockets
+        end
+      end
+      def inject_into_layout
+        return if options[:skip_layout]
+        layout = "app/views/layouts/application.html.erb"
+        return say_status(:skip, "#{layout} not found", :yellow) unless file_exists?(layout)
+        inject_stylesheet_helper(layout)
+        inject_dialog_helper(layout)
+      end
+      def show_readme
+        say <<~TXT, :green
+          modal_stack installed.
+          Mode:          #{resolved_mode}
+          CSS provider:  #{options[:css_provider]}
+          Next steps:
+            1. Confirm config/initializers/modal_stack.rb matches your needs.
+            2. Confirm <%= modal_stack_stylesheet_link_tag %> is in your <head>
+               and <%= modal_stack_dialog_tag %> is right before </body>.
+            3. Add a modal_link_to in any view:
+                 <%= modal_link_to "Edit", edit_thing_path(@thing) %>
+            4. Use the modal layout in the controller behind that link:
+                 class ThingsController < ApplicationController
+                   modal_stack_layout
+                   def edit; ...; end
+                 end
+          Docs: https://github.com/Metalzoid/modal_stack
+        TXT
+      end
+      private
+      def resolved_mode
+        @resolved_mode ||= detect_mode
+      end
+      def detect_mode
+        mode = options[:mode].to_s
+        return mode unless mode == "auto"
+        return "importmap" if file_exists?("config/importmap.rb")
+        return "sprockets" if file_exists?("app/assets/config/manifest.js") &&
+                              !file_exists?("config/importmap.rb") &&
+                              !file_exists?("package.json")
+        return "jsbundling" if file_exists?("package.json")
+        "importmap"
+      end
+      def install_importmap
+        importmap = "config/importmap.rb"
+        if file_exists?(importmap)
+          append_unique importmap, %(pin "modal_stack", to: "modal_stack.js", preload: true)
+        else
+          say_status :warn, "#{importmap} not found; cannot pin modal_stack", :yellow
+        end
+        target = stimulus_install_target
+        if target
+          inject_install_call(target)
+        else
+          say_status :warn, "no Stimulus app entry point found; add the install call manually", :yellow
+        end
+      end
+      def install_jsbundling
+        if file_exists?("bun.lockb") || file_exists?("bun.lock")
+          run "bun add @hotwired/stimulus", abort_on_failure: false
+        elsif file_exists?("yarn.lock")
+          run "yarn add @hotwired/stimulus", abort_on_failure: false
+        elsif file_exists?("package-lock.json")
+          run "npm install @hotwired/stimulus", abort_on_failure: false
+        elsif file_exists?("package.json")
+          say_status :warn, "no JS lockfile detected; install @hotwired/stimulus manually", :yellow
+        end
+        say_status :info, "modal_stack JS bundle: app/assets/javascripts/modal_stack.js (gem-served)", :cyan
+        say_status :info, "Add it to your bundler entry, or pin via importmap.", :cyan
+        target = stimulus_install_target
+        inject_install_call(target) if target
+      end
+      # Where to drop `installModalStack(application)`. The Rails 7+
+      # importmap default puts the Stimulus Application instance in
+      # app/javascript/controllers/application.js (and exports it from
+      # there), so we prefer that. Falling back to
+      # app/javascript/application.js is best-effort — older or custom
+      # layouts usually wire Stimulus themselves.
+      def stimulus_install_target
+        candidates = [
+          "app/javascript/controllers/application.js",
+          "app/javascript/application.js"
+        ]
+        candidates.find { |path| file_exists?(path) }
+      end
+      def install_sprockets
+        manifest = "app/assets/config/manifest.js"
+        if file_exists?(manifest)
+          append_unique manifest, "//= link modal_stack.js"
+          append_unique manifest, "//= link modal_stack/#{options[:css_provider]}.css" unless options[:css_provider] == "none"
+        else
+          say_status :warn, "#{manifest} not found; add `//= link modal_stack.js` manually", :yellow
+        end
+        layout_inject_javascript_tag
+      end
+      def inject_install_call(app_js)
+        content = File.read(File.join(destination_root, app_js))
+        if content.include?(%(from "modal_stack")) || content.include?(%('modal_stack'))
+          return say_status(:skip, "modal_stack already imported in #{app_js}", :yellow)
+        end
+        append_to_file app_js, <<~JS
+          import { install as installModalStack } from "modal_stack"
+          installModalStack(application)
+        JS
+      end
+      def inject_stylesheet_helper(layout)
+        content = File.read(File.join(destination_root, layout))
+        if content.include?("modal_stack_stylesheet_link_tag")
+          say_status :skip, "modal_stack_stylesheet_link_tag already in #{layout}", :yellow
+        elsif content =~ %r{</head>}
+          inject_into_file layout, before: %r{</head>} do
+            "    <%= modal_stack_stylesheet_link_tag %>\n  "
+          end
+        else
+          say_status :warn, "no </head> in #{layout}; insert <%= modal_stack_stylesheet_link_tag %> manually", :yellow
+        end
+      end
+      def inject_dialog_helper(layout)
+        content = File.read(File.join(destination_root, layout))
+        if content.include?("modal_stack_dialog_tag") || content.include?(%(id="modal-stack-root"))
+          say_status :skip, "modal_stack_dialog_tag already in #{layout}", :yellow
+        elsif content =~ %r{</body>}
+          inject_into_file layout, before: %r{</body>} do
+            "  <%= modal_stack_dialog_tag %>\n  "
+          end
+        else
+          say_status :warn, "no </body> in #{layout}; insert <%= modal_stack_dialog_tag %> manually", :yellow
+        end
+      end
+      def layout_inject_javascript_tag
+        return if options[:skip_layout]
+        layout = "app/views/layouts/application.html.erb"
+        return unless file_exists?(layout)
+        content = File.read(File.join(destination_root, layout))
+        return if content.include?("javascript_include_tag \"modal_stack\"") ||
+                  content.include?("javascript_include_tag 'modal_stack'")
+        inject_into_file layout, before: %r{</head>} do
+          "    <%= javascript_include_tag \"modal_stack\" %>\n  "
+        end
+      end
+      def append_unique(path, line)
+        full_path = File.join(destination_root, path)
+        content = File.read(full_path)
+        return if content.include?(line)
+        append_to_file path, "\n#{line}\n"
+      end
+      def file_exists?(path)
+        File.exist?(File.join(destination_root, path))
+      end
+    end
+  end
+end

data/lib/generators/modal_stack/install/templates/initializer.rb ADDED Viewed

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+ModalStack.configure do |config|
+  # Stamps this initializer against the template version that shipped with
+  # the installed gem. The boot-time check warns if you upgrade modal_stack
+  # to a version with a newer template — regenerate with:
+  #   bin/rails g modal_stack:install --skip-layout --skip-js --force
+  # Set `config.silence_initializer_warning = true` to silence.
+  config.initializer_version = "<%= ModalStack::INITIALIZER_VERSION %>"
+  # CSS provider. Determines which stylesheet
+  # `modal_stack_stylesheet_link_tag` resolves to.
+  #
+  #   :tailwind   — Tailwind-aligned tokens (default)
+  #   :bootstrap  — picks up Bootstrap 5 CSS variables
+  #   :vanilla    — neutral defaults, framework-free
+  #   :none       — emit no <link>; provide your own CSS
+  config.css_provider = :<%= options[:css_provider] %>
+  # JS asset strategy used by the install generator and by the
+  # `modal_stack_javascript_tag` helper.
+  #   :auto        — detect from importmap.rb / package.json (default)
+  #   :importmap   — pin in config/importmap.rb
+  #   :jsbundling  — esbuild / bun / yarn pipeline
+  #   :sprockets   — manifest-driven include
+  config.assets_mode = :<%= options[:mode] %>
+  # Defaults for modal_link_to / turbo_stream.modal_push when the call
+  # site doesn't specify them.
+  config.default_variant = :modal       # :modal / :drawer / :bottom_sheet / :confirmation
+  config.default_size = :md             # :sm / :md / :lg / :xl
+  config.default_dismissible = true
+  # The id of the singleton <dialog> root and the data-controller name.
+  # Override only if you have a name collision in your app.
+  config.dialog_id = "modal-stack-root"
+  config.stack_root_data_attribute = "modal-stack"
+  # Header sent on JS-initiated fetches so the controller can flip its
+  # layout to "modal" — read by `modal_stack_request?`.
+  config.request_header = "X-Modal-Stack-Request"
+  # Hard cap on stack depth (push past this is a runtime error).
+  config.max_depth = 5
+  # Replace `data-turbo-confirm` window.confirm with a modal_stack
+  # confirmation layer (cf. RFC §15.Q7). Off by default — opt-in.
+  config.replace_turbo_confirm = false
+  # Honor `prefers-reduced-motion`. The Tailwind / Bootstrap / vanilla
+  # presets already collapse transitions to 1ms when this OS preference
+  # is set; this flag is reserved for future JS-side opt-outs.
+  config.respect_reduced_motion = true
+  # I18n scope for user-facing strings (close, back, swipe-down hint, …).
+  config.i18n_scope = "modal_stack"
+end

data/lib/modal_stack/capybara/minitest.rb ADDED Viewed

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+require "modal_stack/capybara"
+# Minitest auto-include. Mirror the standard "include in
+# ActionDispatch::SystemTestCase" pattern.
+ActiveSupport.on_load(:action_dispatch_system_test_case) do
+  include ModalStack::Capybara
+end

data/lib/modal_stack/capybara/rspec.rb ADDED Viewed

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+require "modal_stack/capybara"
+require "rspec/core"
+RSpec.configure do |config|
+  config.include ModalStack::Capybara, type: :system
+  config.include ModalStack::Capybara, type: :feature
+end

data/lib/modal_stack/capybara.rb ADDED Viewed

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+require "capybara"
+module ModalStack
+  # Capybara helpers for system / feature specs.
+  #
+  # Opt in by requiring this file and including the module in your test
+  # context. For RSpec, prefer the auto-wired entrypoint:
+  #
+  #   # spec/spec_helper.rb (or rails_helper.rb)
+  #   require "modal_stack/capybara/rspec"
+  #
+  module Capybara
+    DIALOG_SELECTOR = "#modal-stack-root"
+    LAYER_SELECTOR = '[data-modal-stack-target="layer"]:not([data-leaving])'
+    # Scope Capybara matchers to a specific layer of the stack.
+    #
+    #   within_modal { expect(page).to have_content("Edit") }
+    #   within_modal(depth: 1) { ... }   # bottom-most layer
+    #   within_modal(depth: 2) { ... }   # second from the bottom
+    #
+    # When `depth:` is omitted the top-most layer is targeted.
+    def within_modal(depth: nil, **, &)
+      layers = ::Capybara.current_session.all(:css, LAYER_SELECTOR, minimum: 1, **)
+      target = depth ? layers[depth - 1] : layers.last
+      raise ::Capybara::ElementNotFound, "no modal_stack layer at depth #{depth}" unless target
+      ::Capybara.current_session.within(target, &)
+    end
+    # Capybara matcher: passes when the modal_stack <dialog> is open.
+    #
+    #   expect(page).to have_modal_open
+    def have_modal_open(**)
+      have_css("#{DIALOG_SELECTOR}[open]", **)
+    end
+    def have_no_modal_open(**)
+      have_no_css("#{DIALOG_SELECTOR}[open]", **)
+    end
+    # Capybara matcher: assert the live (non-leaving) layer count.
+    #
+    #   expect(page).to have_modal_stack(depth: 2)
+    #   expect(page).to have_modal_stack            # any open layer
+    def have_modal_stack(depth: nil, **)
+      if depth
+        have_css(LAYER_SELECTOR, count: depth, **)
+      else
+        have_css(LAYER_SELECTOR, **)
+      end
+    end
+    def have_no_modal_stack(**)
+      have_no_css(LAYER_SELECTOR, **)
+    end
+    # Send ESC to the dialog so the runtime pops the top layer (honors
+    # the layer's dismissible flag — a non-dismissible layer will not
+    # close).
+    def close_modal
+      ::Capybara.current_session.find(:css, DIALOG_SELECTOR).send_keys(:escape)
+    end
+    # Pop every layer by sending ESC repeatedly. Stops as soon as no
+    # live layer remains, or after `max` attempts as a safety net.
+    def close_all_modals(max: 16)
+      session = ::Capybara.current_session
+      max.times do
+        break unless session.has_css?(LAYER_SELECTOR, wait: 0)
+        close_modal
+        session.has_no_css?(LAYER_SELECTOR, wait: 1)
+      end
+    end
+    # Read the current stack depth from the live DOM. Useful when an
+    # explicit assertion would be clearer than `have_modal_stack`.
+    def modal_stack_depth
+      ::Capybara.current_session.all(:css, LAYER_SELECTOR, wait: 0).size
+    end
+  end
+end

data/lib/modal_stack/configuration.rb ADDED Viewed

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+module ModalStack
+  # Runtime configuration for the gem. A default instance is created on
+  # first access; override via `config/initializers/modal_stack.rb`:
+  #
+  #   ModalStack.configure do |config|
+  #     config.css_provider = :bootstrap
+  #     config.default_size = :lg
+  #     config.replace_turbo_confirm = true
+  #   end
+  #
+  class Configuration
+    CSS_PROVIDERS = %i[tailwind bootstrap vanilla none].freeze
+    ASSETS_MODES = %i[importmap jsbundling sprockets auto].freeze
+    VARIANTS = %i[modal drawer bottom_sheet confirmation].freeze
+    SIZES = %i[sm md lg xl].freeze
+    attr_accessor :default_classes,
+                  :default_dismissible,
+                  :max_depth,
+                  :request_header,
+                  :dialog_id,
+                  :stack_root_data_attribute,
+                  :respect_reduced_motion,
+                  :replace_turbo_confirm,
+                  :i18n_scope,
+                  :initializer_version,
+                  :silence_initializer_warning
+    attr_reader :css_provider, :assets_mode, :default_variant, :default_size
+    def initialize
+      @css_provider = :tailwind
+      @assets_mode = :auto
+      @default_variant = :modal
+      @default_size = :md
+      @default_dismissible = true
+      @max_depth = 5
+      @request_header = "X-Modal-Stack-Request"
+      @dialog_id = "modal-stack-root"
+      @stack_root_data_attribute = "modal-stack"
+      @respect_reduced_motion = true
+      @replace_turbo_confirm = false
+      @i18n_scope = "modal_stack"
+      @initializer_version = nil
+      @silence_initializer_warning = false
+      @default_classes = default_classes_hash
+    end
+    def css_provider=(value)
+      value = value.to_sym
+      raise ArgumentError, "css_provider must be one of #{CSS_PROVIDERS.inspect}, got #{value.inspect}" unless CSS_PROVIDERS.include?(value)
+      @css_provider = value
+    end
+    def assets_mode=(value)
+      value = value.to_sym
+      raise ArgumentError, "assets_mode must be one of #{ASSETS_MODES.inspect}, got #{value.inspect}" unless ASSETS_MODES.include?(value)
+      @assets_mode = value
+    end
+    def default_variant=(value)
+      value = value.to_sym
+      raise ArgumentError, "default_variant must be one of #{VARIANTS.inspect}, got #{value.inspect}" unless VARIANTS.include?(value)
+      @default_variant = value
+    end
+    def default_size=(value)
+      value = value.to_sym
+      raise ArgumentError, "default_size must be one of #{SIZES.inspect}, got #{value.inspect}" unless SIZES.include?(value)
+      @default_size = value
+    end
+    private
+    def default_classes_hash
+      {
+        modal_panel: nil,
+        drawer_panel: nil,
+        bottom_sheet_panel: nil,
+        confirmation_panel: nil
+      }
+    end
+  end
+end

data/lib/modal_stack/controller_extensions.rb ADDED Viewed

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+module ModalStack
+  module ControllerExtensions
+    extend ActiveSupport::Concern
+    included do
+      helper_method :modal_stack_request?
+    end
+    class_methods do
+      # Switch to the `modal` layout for modal_stack-originated requests,
+      # fall back to the regular layout otherwise.
+      #
+      #   class Projects::EditController < ApplicationController
+      #     modal_stack_layout
+      #   end
+      #
+      # Accepts the same `only:` / `except:` filters as Rails' `layout`,
+      # so a controller can host both a non-modal index and a set of
+      # modal panel actions:
+      #
+      #   class ModalStack::DemosController < ApplicationController
+      #     modal_stack_layout except: [:index]
+      #   end
+      def modal_stack_layout(fallback: nil, **conditions)
+        layout(
+          lambda do
+            if modal_stack_request?
+              "modal"
+            elsif fallback.respond_to?(:call)
+              fallback.call
+            else
+              fallback
+            end
+          end,
+          conditions
+        )
+      end
+    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?
+      return false unless respond_to?(:request) && request
+      request.headers[ModalStack::REQUEST_HEADER] == "1"
+    end
+    # Convenience for re-rendering inside the modal layout, e.g. after a
+    # validation failure on update:
+    #
+    #   def update
+    #     if @project.update(project_params)
+    #       redirect_to @project
+    #     else
+    #       render_modal :edit, status: :unprocessable_entity
+    #     end
+    #   end
+    def render_modal(template_or_options = nil, **options)
+      render_args =
+        if template_or_options.is_a?(Hash)
+          template_or_options.merge(options)
+        elsif template_or_options
+          { template_or_options => true, **options }
+        else
+          options
+        end
+      render_args[:layout] = "modal" unless render_args.key?(:layout)
+      render(**render_args)
+    end
+  end
+end

data/lib/modal_stack/engine.rb ADDED Viewed

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+require "rails/engine"
+module ModalStack
+  class Engine < ::Rails::Engine
+    initializer "modal_stack.helpers" do
+      ActiveSupport.on_load(:action_view) do
+        require "modal_stack/helpers/modal_link_helper"
+        require "modal_stack/helpers/modal_stack_container_helper"
+        require "modal_stack/helpers/modal_stack_assets_helper"
+        include ModalStack::Helpers::ModalLinkHelper
+        include ModalStack::Helpers::ModalStackContainerHelper
+        include ModalStack::Helpers::ModalStackAssetsHelper
+      end
+    end
+    initializer "modal_stack.controller_extensions" do
+      ActiveSupport.on_load(:action_controller_base) do
+        require "modal_stack/controller_extensions"
+        include ModalStack::ControllerExtensions
+      end
+    end
+    initializer "modal_stack.turbo_streams" do
+      ActiveSupport.on_load(:turbo_streams_tag_builder) do
+        require "modal_stack/turbo_streams_extension"
+        include ModalStack::TurboStreamsExtension
+      end
+    end
+    initializer "modal_stack.assets" do |app|
+      next unless app.config.respond_to?(:assets)
+      app.config.assets.paths << root.join("app", "javascript").to_s
+      app.config.assets.paths << root.join("app", "assets", "javascripts").to_s
+      app.config.assets.paths << root.join("app", "assets", "stylesheets").to_s
+    end
+    config.after_initialize do
+      ModalStack::InitializerVersionCheck.perform
+    end
+  end
+end

data/lib/modal_stack/helpers/modal_link_helper.rb ADDED Viewed

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+module ModalStack
+  module Helpers
+    # View helper that turns a regular link into a modal stack trigger.
+    # Falls back to plain link_to when the request comes from Hotwire Native
+    # (cf. RFC §15 Q3 — "don't break" policy on native shells).
+    #
+    #   <%= modal_link_to "Edit", edit_project_path(@project) %>
+    #   <%= modal_link_to "Details", project_path(@project), as: :drawer, side: :right %>
+    #
+    module ModalLinkHelper
+      LINK_CONTROLLER = "modal-stack-link"
+      LINK_CLICK_ACTION = "click->modal-stack-link#open"
+      MODAL_OPTION_KEYS = %i[as side size width height dismissible].freeze
+      def modal_link_to(name = nil, options = nil, html_options = nil, &block)
+        if block_given?
+          html_options = options
+          options = name
+          name = block
+        end
+        html_options = (html_options || {}).dup
+        return link_to(name, options, html_options, &block) if hotwire_native_request?
+        modal_options = html_options.extract!(*MODAL_OPTION_KEYS)
+        html_options[:data] = build_modal_link_data(html_options[:data] || {}, modal_options)
+        link_to(name, options, html_options, &block)
+      end
+      private
+      def build_modal_link_data(existing_data, modal_options)
+        existing_data.merge(
+          controller: merged_token(existing_data[:controller], LINK_CONTROLLER),
+          action: merged_token(existing_data[:action], LINK_CLICK_ACTION),
+          **modal_link_data_attrs(modal_options)
+        )
+      end
+      def modal_link_data_attrs(opts)
+        {
+          modal_stack_link_variant: opts[:as],
+          modal_stack_link_side: opts[:side],
+          modal_stack_link_size: opts[:size],
+          modal_stack_link_width: opts[:width],
+          modal_stack_link_height: opts[:height],
+          modal_stack_link_dismissible: opts[:dismissible]&.to_s
+        }.compact
+      end
+      def merged_token(existing, addition)
+        [existing, addition].compact.join(" ").strip
+      end
+      def hotwire_native_request?
+        return false unless respond_to?(:request) && request
+        request.user_agent.to_s.include?("Hotwire Native")
+      end
+    end
+  end
+end