tail_merge 0.4.2-arm64-darwin

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e984ca5df1f1324bfe0911c53c9f111130d8aa62b91ac7035e1a1a85959c57d6
+  data.tar.gz: ef0d179ddeb7008fea6cddbdff8264c4bc4c4b50197d3e050a2ee6d773c99116
+SHA512:
+  metadata.gz: 34df6ede5531c36f325c672a5ea6e09ce8cc4d329289480e2d4cdb363aaaf09a1e19187a11520ed77a1262e9cda3991b785222800604c88fabe83d3b1b5e6aca
+  data.tar.gz: 206fb5aade2decf1684d5836a6972ac1145f2f2590df57743a1711fb5fa1d0cea9914e67812f3415f36f9d9b3aaf9eb35ed5accc20b04faa58c00e33298571ca

data/.rubocop.yml

@@ -0,0 +1,14 @@
+AllCops:
+  TargetRubyVersion: 3.1
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Metrics/BlockLength:
+  Enabled: false
+
+Layout/LineLength:
+  Enabled: false

data/README.md

@@ -0,0 +1,151 @@
+# TailMerge
+
+TailMerge is a super-fast utility library to merge Tailwind CSS classes without conflicts.
+
+```ruby
+TailMerge.merge %w[px-2 py-1 bg-red hover:bg-dark-red p-3 bg-[#B91C1C]]
+=> "hover:bg-dark-red p-3 bg-[#B91C1C]"
+```
+
+Classes that appear later in the list override earlier ones.
+
+By leveraging the Rust crate [rustui_merge](https://docs.rs/rustui_merge/latest/rustui_merge/), TailMerge merges classes significantly faster than pure Ruby alternatives.
+
+## Purpose
+
+When you use Tailwind CSS to style components, you'll often want to adjust the styling of a component in certain situations.
+
+An example:
+
+```ruby
+class Well < ApplicationComponent
+  def initialize(**options)
+    @classes = options.delete(:classes)
+  end
+
+  def call
+    tag.div class: default_classes + @classes do
+      content
+    end
+  end
+
+  def default_classes
+    %w[bg-gray-100 rounded-lg p-4]
+  end
+end
+```
+
+If you want to render this component somewhere with a different background, ideally you'd be able to do this:
+
+```erb
+<%= render Well.new(classes: %w[bg-blue-50 p-2]) do %>
+  <p>Hello</p>
+<% end %>
+```
+
+Sadly, this will not work. The div will have a gray-100 background and a padding of 4 instead of the intended blue-50 and p-2.
+
+This is where TailMerge comes in. It allows you to merge classes without conflicts.
+
+```ruby
+TailMerge.merge %w[bg-gray-100 rounded-lg p-4] + %w[bg-blue-50 p-2]
+=> "rounded-lg bg-blue-50 p-2"
+```
+
+Implementing this in your component is easy:
+
+```ruby
+class Well < ApplicationComponent
+  def initialize(**options)
+    @classes = options.delete(:classes)
+  end
+
+  def call
+    tag.div class: TailMerge.merge(default_classes + @classes) do
+      content
+    end
+  end
+
+  def default_classes
+    %w[bg-gray-100 rounded-lg p-4]
+  end
+end
+```
+
+No more conflicts!
+
+## Installation
+
+Add the gem to your Gemfile:
+
+```ruby
+gem "tail_merge"
+```
+
+Run `bundle install` to install the gem.
+
+## Usage
+
+You can pass either a string or an array of strings to the merge method. Values passed later override previous ones. The result is always a string, ready for use in ERB templates.
+
+```ruby
+TailMerge.merge %w[px-2 py-1 bg-red hover:bg-dark-red p-3 bg-[#B91C1C]]
+=> "hover:bg-dark-red p-3 bg-[#B91C1C]"
+```
+
+```ruby
+TailMerge.merge "px-2 py-1 bg-red hover:bg-dark-red p-3 bg-[#B91C1C]"
+=> "hover:bg-dark-red p-3 bg-[#B91C1C]"
+```
+
+## More speed?
+
+You can create an instance of TailMerge and call `merge` on it instead of on the `TailMerge` class. This will cache the results of the merge.
+
+This is useful in cases where you need to merge the same classes repeatedly, such as when rendering a list of the same component.
+
+```ruby
+tail_merge_instance = TailMerge.new
+tail_merge_instance.merge %w[px-2 py-1 bg-red hover:bg-dark-red p-3 bg-[#B91C1C]]
+=> "hover:bg-dark-red p-3 bg-[#B91C1C]" # Write to cache, still fast though
+
+# Second time, same key, read from cache
+tail_merge_instance.merge %w[px-2 py-1 bg-red hover:bg-dark-red p-3 bg-[#B91C1C]]
+=> "hover:bg-dark-red p-3 bg-[#B91C1C]" # Read from cache, much faster!
+
+# Third time, string key instead of array, read from same cache
+tail_merge_instance.merge "px-2 py-1 bg-red hover:bg-dark-red p-3 bg-[#B91C1C]"
+=> "hover:bg-dark-red p-3 bg-[#B91C1C]" # Read from cache, much faster!
+```
+
+This caching technique was inspired by [Tailwind Merge](https://github.com/dcastil/tailwind-merge).
+
+## Benchmark
+
+So how fast is TailMerge?
+
+I've benchmarked TailMerge with and without caching, and compared it to Tailwind Merge (also with and without caching). Here are the results:
+
+```
+                                                  user     system      total        real
+Rust: TailMerge.merge (all samples):          0.371744   0.019642   0.391386 (  0.391821)
+Rust: Cached TailMerge.merge (all samples):   0.012976   0.000580   0.013556 (  0.013560)
+Ruby: TailwindMerge each time (all samples): 51.488919   0.225130  51.714049 ( 51.883713)
+Ruby:Cached TailwindMerge (all samples):      0.019882   0.000166   0.020048 (  0.020051)
+```
+
+As you can see, TailMerge is much faster than using pure Ruby to merge classes.
+
+The benchmark loops through an array of strings and arrays and merges them 1000 times.
+
+The difference between the cached runs, obviously, is much smaller as we are basically benchmarking the cache lookup and not the actual merge.
+
+In reality, you will not need to perform 1000 merges per page, and I suspect you'll be much closer to the non-cached runs.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/abuisman/tail_merge . Merging will be done at my own pace and discretion.
+
+## License
+
+This gem is available as open source under under the MIT License.

data/Rakefile

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+begin
+  require "rubocop/rake_task"
+  RuboCop::RakeTask.new
+rescue LoadError
+  # RuboCop is an optional dev dependency; skip in minimal build environments
+end
+
+require "rb_sys/extensiontask"
+
+task build: :compile
+
+GEMSPEC = Gem::Specification.load("tail_merge.gemspec")
+
+# Limit cross-compiled Ruby versions to those supported by this gem and dependencies
+# Format matches rake-compiler's RUBY_CC_VERSION (colon-separated list)
+ENV["RUBY_CC_VERSION"] ||= "3.1.6:3.2.6:3.3.7:3.4.1"
+
+PLATFORMS = %w[
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  x64-mingw-ucrt
+  x64-mingw32
+  x86-linux-gnu
+  x86-linux-musl
+  x86-mingw32
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
+].freeze
+
+RbSys::ExtensionTask.new("merger", GEMSPEC) do |ext|
+  ext.lib_dir = "lib/tail_merge"
+  ext.cross_compile = true
+  ext.cross_platform = %w[x86-mingw32 x64-mingw-ucrt x64-mingw32 x86-linux x86_64-linux x86_64-darwin arm64-darwin]
+end
+
+desc "Build native extension for a given platform (i.e. `rake 'native[x86_64-linux]'`)"
+task :native, [:platform] do |_t, platform:|
+  sh "bundle", "exec", "rb-sys-dock", "--platform", platform, "--build"
+end
+
+task default: %i[compile test rubocop]

data/benchmark/benchmark.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require "benchmark"
+require "tailwind_merge"
+
+require "bundler/setup"
+require "tail_merge"
+
+samples = [
+  ["relative"],
+  ["self-center"],
+  ["self-start"],
+  %w[shadow-inner size-4 text-xs],
+  %w[shadow-inner size-7],
+  ["size-10"],
+  ["static"],
+  ["upload-attachment", "flex-none", "rounded-3xl", "min-h-16", "group", "relative"],
+  %w[w-full py-2 px-2 rounded-md w-44],
+  "relative",
+  "self-center",
+  "self-start",
+  "shadow-inner size-4 text-xs",
+  "shadow-inner size-7",
+  "size-10",
+  "static",
+  "upload-attachment flex-none rounded-3xl min-h-16 group relative",
+  "w-full py-2 px-2 rounded-md w-44",
+  ["p-4", "px-2", "py-6", "m-3", "mx-8", "my-2", "bg-blue-500", "bg-red-600", "text-sm", "text-lg", "font-bold",
+   "font-normal", "rounded-lg", "rounded-xl", "shadow-md", "shadow-lg", "hover:bg-blue-700", "hover:bg-red-800", "focus:ring-2", "focus:ring-4"],
+  %w[grid flex inline-flex grid-cols-3 grid-cols-4 gap-2 gap-4 items-center items-start
+     justify-between justify-center p-8 p-4 bg-gray-100 bg-white border border-2 rounded-full rounded-md],
+  ["transform", "scale-100", "scale-110", "rotate-45", "rotate-90", "translate-x-2", "translate-x-4", "skew-y-3",
+   "skew-y-6", "transition", "duration-200", "duration-500", "ease-in", "ease-out", "delay-150", "delay-300"],
+  ["w-full", "w-1/2", "w-3/4", "h-screen", "h-full", "h-32", "min-h-0", "min-h-full", "max-w-xs", "max-w-xl",
+   "overflow-hidden", "overflow-scroll", "object-cover", "object-contain", "opacity-75", "opacity-100"],
+  %w[text-left text-center text-right text-justify tracking-wide tracking-wider leading-tight
+     leading-loose uppercase lowercase capitalize normal-case truncate line-clamp-2 line-clamp-3],
+  %w[border-t border-b border-l border-r border-solid border-dashed border-red-500
+     border-blue-600 divide-y divide-x divide-gray-200 divide-blue-300 ring-2 ring-4 ring-offset-2],
+  %w[cursor-pointer cursor-wait select-none select-text resize resize-none z-10 z-50
+     float-left float-right clear-both clear-none box-border box-content],
+  %w[bg-opacity-50 bg-opacity-75 backdrop-blur-sm backdrop-blur-lg backdrop-filter filter
+     brightness-90 brightness-110 contrast-75 contrast-125 saturate-50 saturate-200],
+  ["focus:outline-none", "focus:ring-2", "focus:ring-offset-2", "focus:border-blue-500", "hover:scale-105",
+   "hover:rotate-3", "active:scale-95", "disabled:opacity-50", "disabled:cursor-not-allowed"],
+  ["sm:text-lg", "md:text-xl", "lg:text-2xl", "xl:text-3xl", "2xl:text-4xl", "sm:w-1/2", "md:w-2/3", "lg:w-3/4",
+   "xl:w-full", "2xl:max-w-screen-xl", "sm:p-4", "md:p-6", "lg:p-8", "xl:p-10"],
+  ["dark:bg-gray-800", "dark:text-white", "dark:border-gray-600", "dark:hover:bg-gray-700", "dark:focus:ring-blue-800",
+   "bg-white", "text-black", "border-gray-200", "hover:bg-gray-100"],
+  ["group-hover:scale-110", "group-hover:rotate-6", "group-focus:outline-none", "group-active:scale-95",
+   "peer-checked:bg-blue-500", "peer-checked:text-white", "peer-disabled:opacity-50"],
+  ["animate-spin", "animate-pulse", "animate-bounce", "animate-ping", "motion-safe:animate-spin",
+   "motion-reduce:animate-none", "transition-all", "duration-300", "ease-in-out", "delay-150"],
+  ["space-x-4", "space-x-reverse", "space-y-6", "space-y-reverse", "gap-x-4", "gap-y-6", "place-items-center",
+   "place-content-center", "place-self-center", "content-center"],
+  %w[from-blue-500 to-purple-500 via-pink-500 bg-gradient-to-r bg-gradient-to-br text-transparent
+     bg-clip-text bg-origin-border bg-no-repeat bg-cover],
+  %w[columns-2 columns-3 break-inside-avoid break-after-column aspect-square aspect-video
+     object-right-top object-left-bottom isolation-auto mix-blend-multiply],
+  ["first:pt-0", "last:pb-0", "odd:bg-gray-50", "even:bg-white", "first-letter:text-7xl", "first-line:uppercase",
+   "selection:bg-yellow-200", "selection:text-black"],
+  ["[mask-type:luminance]", "[mask-type:alpha]", "[transform-style:preserve-3d]", "[clip-path:circle(50%)]",
+   "[-webkit-text-stroke:2px]", "[text-align-last:justify]"],
+  %w[will-change-scroll will-change-transform scroll-smooth scroll-mt-2 scroll-pb-4 overscroll-contain
+     touch-pan-right touch-manipulation],
+  %w[hyphens-auto hyphens-manual text-underline-offset-2 text-decoration-thickness-2 indent-8 indent-16
+     vertical-align-sub vertical-align-super]
+]
+
+# Pre-initialize cached mergers
+cached_merger = TailwindMerge::Merger.new
+
+tail_merge_instance = TailMerge.new
+
+puts "Benchmarking class merging strategies (whole set)..."
+puts "-" * 50
+puts
+
+Benchmark.bm(30) do |x|
+  x.report("Rust: TailMerge.merge (all samples):") do
+    1000.times do
+      samples.each do |classes|
+        TailMerge.merge(classes)
+      end
+    end
+  end
+
+  x.report("Rust: Cached TailMerge.merge (all samples):") do
+    1000.times do
+      samples.each do |classes|
+        tail_merge_instance.merge(classes)
+      end
+    end
+  end
+
+  x.report("Ruby: TailwindMerge each time (all samples):") do
+    1000.times do
+      samples.each do |classes|
+        TailwindMerge::Merger.new.merge(classes)
+      end
+    end
+  end
+
+  x.report("Ruby:Cached TailwindMerge (all samples):") do
+    1000.times do
+      samples.each do |classes|
+        cached_merger.merge(classes)
+      end
+    end
+  end
+end

data/lib/tail_merge/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class TailMerge
+  VERSION = "0.4.2"
+end

data/lib/tail_merge.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require_relative "tail_merge/version"
+require_relative "tail_merge/merger"
+
+# Main class for merging tailwind classes.
+class TailMerge
+  class Error < StandardError; end
+
+  def self.merge(classes, options = {})
+    Merger.perform(classes, options)
+  end
+
+  attr_reader :options
+
+  def initialize(options = {})
+    @options = options
+    @class_hash = {}
+  end
+
+  def merge(classes)
+    return "" if classes.empty?
+
+    classes = classes.join(" ") if classes.is_a?(Array)
+    @class_hash[classes] ||= Merger.perform(classes, options)
+  end
+end

data/sig/tail_merge.rbs

@@ -0,0 +1,4 @@
+module TailMerge
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: tail_merge
+version: !ruby/object:Gem::Version
+  version: 0.4.2
+platform: arm64-darwin
+authors:
+- Achilleas Buisman
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2025-08-20 00:00:00.000000000 Z
+dependencies: []
+description: Merge Tailwind CSS classes
+email:
+- accounts@abuisman.nl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- README.md
+- Rakefile
+- benchmark/benchmark.rb
+- lib/tail_merge.rb
+- lib/tail_merge/3.1/merger.bundle
+- lib/tail_merge/3.2/merger.bundle
+- lib/tail_merge/3.3/merger.bundle
+- lib/tail_merge/3.4/merger.bundle
+- lib/tail_merge/version.rb
+- sig/tail_merge.rbs
+homepage: https://github.com/abuisman/tail_merge
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/abuisman/tail_merge
+  source_code_uri: https://github.com/abuisman/tail_merge
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.5.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.11
+requirements: []
+rubygems_version: 3.5.23
+signing_key: 
+specification_version: 4
+summary: Merge Tailwind CSS classes
+test_files: []