tailwind_merge 1.5.1 → 1.5.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2be310d25aa48823e2782965b3d44202a26986ad59aaaf5672867e432c06dc15
-  data.tar.gz: 17e4ef04d443ab193c6b5b468008f2e0d1a9db1aaa6c37533e296531505c6bea
+  metadata.gz: '059b8e52b3a7bc182e6cae5db2a2c8dee46aa1d1176b6b7d26dd7f2313f566cc'
+  data.tar.gz: c94346250084798c59da34357f9e16acc058943eb5e64f759f87b06701adac7c
 SHA512:
-  metadata.gz: 260b41ff06162e8b0b25f65f269f978f3d947b19f418b2d77d8b6fc760a684826a3a7a9246aae0c86aae6791a21e87fef46961eae552e3a88bd495699eef057e
-  data.tar.gz: 46e891d347c8d5e73af2d3a92f6f4bb8e7c1e0b63b6fb32305183c7d36834cc8870a7b7e0f1dfb8c529ab0726ecf92d5fb2c24620b6a0320bd035fc60980056c
+  metadata.gz: 61dc28329c357f7b1bb060b499c56d6d419672f2ccade9a3cb8442ae1c77da2f3c9c9526894c836294ef6128a78041adbd1b0c291b9c6b7fa33ef34b527400f1
+  data.tar.gz: 76ea9d360488b4945ce4b2a3ac642fdd20a0cd0eee20b85a3baec2f363ce3dcddbbd3dc9a6be2f7207d30a5776aeff328df792b742770e5b2d1c63867a076eac

data/CHANGELOG.md

@@ -1,3 +1,28 @@
+## [1.5.3](https://github.com/gjtorikian/tailwind_merge/compare/v1.5.2...v1.5.3) (2026-08-11)
+
+### Bug Fixes
+
+* **config:** classify shadow-inner into the shadow class group ([99bccc2](https://github.com/gjtorikian/tailwind_merge/commit/99bccc2b66d5a6e94735515676102534a3f29e37))
+
+### Performance Improvements
+
+* **parse:** skip modifiers array alloc for no-modifier classes ([0ee620e](https://github.com/gjtorikian/tailwind_merge/commit/0ee620e7e464074fb490fd363afaa5b404a4faf4))
+
+### Miscellaneous Chores
+
+* trigger release-please run ([65e80ae](https://github.com/gjtorikian/tailwind_merge/commit/65e80ae41d08e813c0d6ce9317aa235454bfc935))
+* **config:** deep-freeze DEFAULTS to prevent global-state mutation ([9bf4778](https://github.com/gjtorikian/tailwind_merge/commit/9bf47789b778b4d1e0503e9b69ce30d407826483))
+
+
+# [v1.5.2] - 06-07-2026
+## What's Changed
+* fix: thread-safety of Merger's internal LRU cache by @svyatov in https://github.com/gjtorikian/tailwind_merge/pull/79
+* perf: reduce allocations in merge hot path (~35% faster, ~56% fewer allocations) by @svyatov in https://github.com/gjtorikian/tailwind_merge/pull/80
+
+## New Contributors
+* @svyatov made their first contribution in https://github.com/gjtorikian/tailwind_merge/pull/79
+
+**Full Changelog**: https://github.com/gjtorikian/tailwind_merge/compare/v1.5.1...v1.5.2
 # [v1.5.1] - 18-05-2026
 ## What's Changed
 * Fix memory leak when passing  in config by @ibrahima in https://github.com/gjtorikian/tailwind_merge/pull/77

data/benchmark/benchmark.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Benchmark for the cache-miss merge path.
+#
+# Usage: ruby benchmark/benchmark.rb
+#
+# Measures `merge_class_list` directly: `merge` memoizes whole input strings
+# in an LRU cache, so benchmarking it with a fixed corpus would mostly
+# measure a Hash lookup. The uncached path is what runs for every
+# first-seen class string in a real app.
+
+require "bundler/inline"
+
+gemfile do
+  source "https://rubygems.org"
+  gem "benchmark-ips"
+  gem "memory_profiler"
+  gem "sin_lru_redux"
+end
+
+require_relative "../lib/tailwind_merge"
+
+CORPUS = [
+  # simple conflicts
+  "px-2 px-4",
+  "text-sm text-lg font-bold",
+  "block inline flex",
+  # modifiers
+  "hover:focus:!bg-red-500 hover:focus:!bg-blue-600",
+  "md:hover:underline md:hover:no-underline",
+  "dark:sm:hover:bg-gray-800 dark:sm:hover:bg-gray-900",
+  # postfix modifiers
+  "bg-red-500/50 bg-red-500/75",
+  "text-white/90 leading-7",
+  # arbitrary values / properties / variables
+  "p-[2px] p-[4px]",
+  "[mask-type:luminance] [mask-type:alpha]",
+  "bg-(--brand-color) bg-red-500",
+  "content-['hello'] content-['world']",
+  # non-tailwind classes mixed in
+  "my-custom-class px-2 another-class px-4",
+  # long realistic string (shadcn-style button + overrides)
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md " \
+    "text-sm font-medium transition-colors focus-visible:outline-none " \
+    "focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none " \
+    "disabled:opacity-50 bg-primary text-primary-foreground shadow " \
+    "hover:bg-primary/90 h-9 px-4 py-2 rounded-lg px-6 text-base w-full",
+].freeze
+
+merger = TailwindMerge::Merger.new
+
+# sanity check: outputs must be non-empty
+CORPUS.each do |s|
+  result = merger.send(:merge_class_list, s)
+  raise "unexpected empty result for #{s.inspect}" if result.empty?
+end
+
+puts "ruby #{RUBY_VERSION} (#{RUBY_ENGINE}), tailwind_merge #{TailwindMerge::VERSION}"
+puts
+
+Benchmark.ips do |x|
+  x.report("merge_class_list (corpus of #{CORPUS.size})") do
+    CORPUS.each { |s| merger.send(:merge_class_list, s) }
+  end
+  x.report("merge_class_list (long string)") do
+    merger.send(:merge_class_list, CORPUS.last)
+  end
+end
+
+puts
+report = MemoryProfiler.report do
+  CORPUS.each { |s| merger.send(:merge_class_list, s) }
+end
+puts "allocations for one corpus pass: " \
+  "#{report.total_allocated} objects, #{report.total_allocated_memsize} bytes"

data/lib/tailwind_merge/class_group_utils.rb

@@ -23,25 +23,26 @@ module TailwindMerge
       get_group_recursive(class_parts, @class_map) || get_group_id_for_arbitrary_property(class_name)
     end
 
-    def get_group_recursive(class_parts, class_part_object)
-      return class_part_object[:class_group_id] if class_parts.empty?
+    def get_group_recursive(class_parts, class_part_object, index = 0)
+      return class_part_object[:class_group_id] if index == class_parts.length
 
-      current_class_part = class_parts.first
+      current_class_part = class_parts[index]
 
       next_class_part_object = class_part_object[:next_part][current_class_part]
 
       if next_class_part_object
-        class_group_from_next_class_part = get_group_recursive(class_parts.drop(1), next_class_part_object)
+        class_group_from_next_class_part = get_group_recursive(class_parts, next_class_part_object, index + 1)
         return class_group_from_next_class_part if class_group_from_next_class_part
       end
 
       return if class_part_object[:validators].empty?
 
-      class_rest = class_parts.join(CLASS_PART_SEPARATOR)
+      class_rest = index.zero? ? class_parts.join(CLASS_PART_SEPARATOR) : class_parts[index..].join(CLASS_PART_SEPARATOR)
 
+      # Theme procs are expanded at trie-build time (see process_classes_recursively),
+      # so validators here are always plain value validators.
       result = class_part_object[:validators].find do |v|
-        validator = v[:validator]
-        from_theme?(validator) ? validator.call(@config) : validator.call(class_rest)
+        v[:validator].call(class_rest)
       end
 
       result&.fetch(:class_group_id, nil)

data/lib/tailwind_merge/config.rb

@@ -6,6 +6,19 @@ module TailwindMerge
   module Config
     include Validators
 
+    class << self
+      # Recursively freezes nested Hash/Array structures so shared config
+      # constants can't be mutated in place. Keys are strings/symbols and are
+      # already immutable, so only values need walking.
+      private def deep_freeze(object)
+        case object
+        when Hash then object.each_value { |value| deep_freeze(value) }
+        when Array then object.each { |value| deep_freeze(value) }
+        end
+        object.freeze
+      end
+    end
+
     THEME_KEYS = [
       "color",
       "font",
@@ -1432,6 +1445,8 @@ module TailwindMerge
             "shadow" => [
               # Deprecated since Tailwind CSS v4.0.0
               "",
+              # Deprecated since Tailwind CSS v4.0.0
+              "inner",
               "none",
               THEME_SHADOW,
               IS_ARBITRARY_VARIABLE_SHADOW,
@@ -2441,7 +2456,8 @@ module TailwindMerge
         "placeholder",
         "selection",
       ],
-    }.freeze
+    }
+    deep_freeze(DEFAULTS)
 
     def merge_config(incoming_config)
       extended_config = TailwindMerge::Config::DEFAULTS.dup

data/lib/tailwind_merge/parse_class_name.rb

@@ -6,9 +6,17 @@ module TailwindMerge
 
   module ParseClassName
     IMPORTANT_MODIFIER = "!"
+    EMPTY_MODIFIERS = [].freeze
     MODIFIER_SEPARATOR = ":"
     MODIFIER_SEPARATOR_LENGTH = MODIFIER_SEPARATOR.length
 
+    MODIFIER_SEPARATOR_BYTE = MODIFIER_SEPARATOR.ord
+    POSTFIX_SEPARATOR_BYTE = "/".ord
+    OPEN_BRACKET_BYTE = "[".ord
+    CLOSE_BRACKET_BYTE = "]".ord
+    OPEN_PAREN_BYTE = "(".ord
+    CLOSE_PAREN_BYTE = ")".ord
+
     ##
     # Parse class name into parts.
     #
@@ -22,7 +30,7 @@ module TailwindMerge
         else
           return TailwindClass.new(
             is_external: true,
-            modifiers: [],
+            modifiers: EMPTY_MODIFIERS,
             has_important_modifier: false,
             base_class_name: class_name,
             maybe_postfix_modifier_position: nil,
@@ -30,32 +38,48 @@ module TailwindMerge
         end
       end
 
-      modifiers = []
+      # Stays nil until the first modifier separator, so the common no-modifier
+      # class (`px-2`, `block`) never allocates an array.
+      modifiers = nil
 
       bracket_depth = 0
       paren_depth = 0
       modifier_start = 0
       postfix_modifier_position = nil
 
-      class_name.each_char.with_index do |char, index|
+      # Byte-wise scan: all separators are ASCII, so byte positions are safe
+      # for multibyte class names (UTF-8 continuation bytes never match ASCII).
+      # Positions produced here (including maybe_postfix_modifier_position)
+      # are byte offsets and must be consumed with String#byteslice.
+      index = 0
+      size = class_name.bytesize
+      while index < size
+        byte = class_name.getbyte(index)
+
         if bracket_depth.zero? && paren_depth.zero?
-          if char == MODIFIER_SEPARATOR
-            modifiers << class_name[modifier_start...index]
+          if byte == MODIFIER_SEPARATOR_BYTE
+            (modifiers ||= []) << class_name.byteslice(modifier_start, index - modifier_start)
             modifier_start = index + MODIFIER_SEPARATOR_LENGTH
+            index += 1
             next
-          elsif char == "/"
+          elsif byte == POSTFIX_SEPARATOR_BYTE
             postfix_modifier_position = index
+            index += 1
             next
           end
         end
 
-        bracket_depth += 1 if char == "["
-        bracket_depth -= 1 if char == "]"
-        paren_depth += 1 if char == "("
-        paren_depth -= 1 if char == ")"
+        case byte
+        when OPEN_BRACKET_BYTE then bracket_depth += 1
+        when CLOSE_BRACKET_BYTE then bracket_depth -= 1
+        when OPEN_PAREN_BYTE then paren_depth += 1
+        when CLOSE_PAREN_BYTE then paren_depth -= 1
+        end
+
+        index += 1
       end
 
-      base_class_name_with_important_modifier = modifiers.empty? ? class_name : class_name[modifier_start..]
+      base_class_name_with_important_modifier = modifiers ? class_name.byteslice(modifier_start, size - modifier_start) : class_name
 
       base_class_name, has_important_modifier = strip_important_modifier(base_class_name_with_important_modifier)
 
@@ -65,7 +89,7 @@ module TailwindMerge
 
       TailwindClass.new(
         is_external: false,
-        modifiers:,
+        modifiers: modifiers || EMPTY_MODIFIERS,
         has_important_modifier:,
         base_class_name: base_class_name,
         maybe_postfix_modifier_position:,

data/lib/tailwind_merge/validators.rb

@@ -97,7 +97,7 @@ module TailwindMerge
     }
 
     IS_ARBITRARY_VALUE = ->(value) {
-      ARBITRARY_VALUE_REGEX.match(value)
+      ARBITRARY_VALUE_REGEX.match?(value)
     }
 
     IS_ARBITRARY_LENGTH = ->(value) {
@@ -129,7 +129,7 @@ module TailwindMerge
     }
 
     IS_ARBITRARY_VARIABLE = ->(value) {
-      ARBITRARY_VARIABLE_REGEX.match(value)
+      ARBITRARY_VARIABLE_REGEX.match?(value)
     }
 
     IS_ARBITRARY_VARIABLE_LENGTH = ->(value) {

data/lib/tailwind_merge/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TailwindMerge
-  VERSION = "1.5.1"
+  VERSION = "1.5.3"
 end

data/lib/tailwind_merge.rb

@@ -18,14 +18,13 @@ module TailwindMerge
     include ParseClassName
     include SortModifiers
 
-    SPLIT_CLASSES_REGEX = /\s+/
-
     def initialize(config: {})
       @config = merge_config(config)
       @config[:important_modifier] = @config[:important_modifier].to_s
       @class_utils = TailwindMerge::ClassGroupUtils.new(@config)
-      @cache = LruRedux::Cache.new(@config[:cache_size], @config[:ignore_empty_cache])
+      @cache = LruRedux::ThreadSafeCache.new(@config[:cache_size], @config[:ignore_empty_cache])
       @postfix_lookup_class_group_ids = build_postfix_lookup_class_group_ids(@config[:postfix_lookup_class_groups])
+      @order_sensitive_modifiers = Set.new(@config[:order_sensitive_modifiers]).freeze
     end
 
     def merge(classes)
@@ -42,14 +41,14 @@ module TailwindMerge
       # @example 'float'
       # @example 'hover:focus:bg-color'
       # @example 'md:!pr'
-      trimmed = class_list.strip
-      return "" if trimmed.empty?
+      class_names = class_list.split
+      return "" if class_names.empty?
 
       class_groups_in_conflict = Set.new
 
       merged_classes = []
 
-      trimmed.split(SPLIT_CLASSES_REGEX).reverse_each do |original_class_name|
+      class_names.reverse_each do |original_class_name|
         result = parse_class_name(original_class_name, prefix: @config[:prefix])
         is_external = result.is_external
         modifiers = result.modifiers
@@ -65,7 +64,8 @@ module TailwindMerge
         has_postfix_modifier = maybe_postfix_modifier_position ? true : false
 
         if has_postfix_modifier
-          base_class_name_without_postfix = base_class_name[0...maybe_postfix_modifier_position]
+          # maybe_postfix_modifier_position is a byte offset (see ParseClassName)
+          base_class_name_without_postfix = base_class_name.byteslice(0, maybe_postfix_modifier_position)
           class_group_id = @class_utils.class_group_id(base_class_name_without_postfix)
 
           if class_group_id && @postfix_lookup_class_group_ids[class_group_id]
@@ -97,10 +97,13 @@ module TailwindMerge
           has_postfix_modifier = false
         end
 
-        variant_modifier = sort_modifiers(modifiers, @config[:order_sensitive_modifiers]).join(":")
+        variant_modifier = sort_modifiers(modifiers, @order_sensitive_modifiers).join(":")
 
         modifier_id = has_important_modifier ? "#{variant_modifier}#{IMPORTANT_MODIFIER}" : variant_modifier
-        class_id = "#{modifier_id}#{class_group_id}"
+        has_modifier_id = !modifier_id.empty?
+        # `to_s` matches the previous interpolation behavior: group ids may be
+        # Symbols (custom configs) or Strings (defaults, where to_s is free)
+        class_id = has_modifier_id ? "#{modifier_id}#{class_group_id}" : class_group_id.to_s
 
         # Tailwind class omitted due to conflict
         next if class_groups_in_conflict.include?(class_id)
@@ -108,14 +111,14 @@ module TailwindMerge
         class_groups_in_conflict << class_id
 
         @class_utils.get_conflicting_class_group_ids(class_group_id, has_postfix_modifier).each do |conflicting_id|
-          class_groups_in_conflict << "#{modifier_id}#{conflicting_id}"
+          class_groups_in_conflict << (has_modifier_id ? "#{modifier_id}#{conflicting_id}" : conflicting_id.to_s)
         end
 
         # Tailwind class not in conflict
         merged_classes << original_class_name
       end
 
-      merged_classes.reverse.join(" ")
+      merged_classes.reverse!.join(" ")
     end
 
     private def build_postfix_lookup_class_group_ids(class_group_ids)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tailwind_merge
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 1.5.3
 platform: ruby
 authors:
 - Garen J. Torikian
@@ -64,6 +64,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- benchmark/benchmark.rb
 - lib/tailwind_merge.rb
 - lib/tailwind_merge/class_group_utils.rb
 - lib/tailwind_merge/config.rb
@@ -73,15 +74,15 @@ files:
 - lib/tailwind_merge/version.rb
 - script/test
 - tailwind_merge.gemspec
-homepage: https://github.com/gjtorikian/tailwind_merge/tree/v1.5.1
+homepage: https://github.com/gjtorikian/tailwind_merge/tree/v1.5.3
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/gjtorikian/tailwind_merge/tree/v1.5.1
-  source_code_uri: https://github.com/gjtorikian/tailwind_merge/tree/v1.5.1
-  changelog_uri: https://github.com/gjtorikian/tailwind_merge/blob/v1.5.1/CHANGELOG.md
+  homepage_uri: https://github.com/gjtorikian/tailwind_merge/tree/v1.5.3
+  source_code_uri: https://github.com/gjtorikian/tailwind_merge/tree/v1.5.3
+  changelog_uri: https://github.com/gjtorikian/tailwind_merge/blob/v1.5.3/CHANGELOG.md
   bug_tracker_uri: https://github.com/gjtorikian/tailwind_merge/issues
-  documentation_uri: https://rubydoc.info/gems/tailwind_merge/1.5.1
+  documentation_uri: https://rubydoc.info/gems/tailwind_merge/1.5.3
   funding_uri: https://github.com/sponsors/gjtorikian
   rubygems_mfa_required: 'true'
 rdoc_options: []