daisyui 2.0.2 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 784f97cabf197c081daba3827d5d7cc67a4bfe68b1be95fd038cecaae9da127c
-  data.tar.gz: e1cc4be0135efdf03ed592a8c0d73e2b12d81c4cee47dacd7008ac34aa8bdbbe
+  metadata.gz: 41fa98f82c0377c4615fa5e4a1091ae8383688a951acb726122866cefa273665
+  data.tar.gz: 651713886837f46040942fc397089d1194dc35787ab1ba18308db97f12d94a06
 SHA512:
-  metadata.gz: d6331604dbf5bdd7b419dfcbb5494cf7569a1709b3d9b17dd7fe08d56d1e3fed14b16c4d1925534a4efdce23e4e85347901b5687580f466e02aa9081f5ca646f
-  data.tar.gz: 002c0ad206f54764209eb6ae752c852a91369adb97c84910fe39daf19ca993842b773f6f60ad27da12cc88d25e6d7df8cc6415018408a541c99533d214432193
+  metadata.gz: be24df2be52d01adbda5f9e257650d788352a0dfd286bee5c734dfce66aee0377dd0ad601269363ffd734d908cd0c2cde612062017dc59fde61086f4f53e716c
+  data.tar.gz: 2320af028c2539b849de1feb7c1d2690cc6ca0e75da24bd7d838415171c4d922f59b26f5833e1cc1a1e035c330ce532eaae75e21107bd89119f24653f7ab3eb4

data/CHANGELOG.md

@@ -1,4 +1,41 @@
-## [Unreleased]
+## [2.1.0]
+
+### DaisyUI finalizes itself at boot: class merging in any Ractor (#58)
+
+At boot DaisyUI now freezes its configuration and every component's
+registries, so a non-main Ractor can read them. `DaisyUI::ClassMerge.merge`
+then works in any Ractor; each Ractor builds its own merger and LRU.
+
+- Automatic: `DaisyUI.configure` finalizes at its end, and the Rails engine
+  finalizes again in `after_initialize`, with no app code. A Rails-less app
+  that never calls `configure` calls `DaisyUI.finalize!` at the end of boot.
+- **The configuration is frozen after `DaisyUI.configure` (and, in a Rails
+  app, after boot).** Writing to `DaisyUI.configuration` directly now raises
+  `FrozenError`, e.g. `DaisyUI.configuration.unknown_modifiers = :ignore` in a
+  spec: use `DaisyUI.configure { |config| config.unknown_modifiers = :ignore }`.
+  `DaisyUI.configure` can be called again at any time: it yields a writable
+  copy and publishes it once that is finalized, so no reader ever meets a
+  half-changed configuration, and a block that raises changes nothing. A
+  Ractor that already built its merger rebuilds it from the new
+  configuration.
+- Finalizing never raises. A configured value that cannot be made shareable
+  is kept as it is, unfrozen, and the configuration is then readable on the
+  main Ractor only: a callable `unknown_modifiers` or a raw `class_merge`
+  validator that closes over app state (such as
+  `->(error) { Appsignal.report_error(error) }` in an initializer), or an
+  object that holds a logger.
+- Component registries (`register_modifiers`, `register_flags`,
+  `self.component_class =`) are frozen as they are written, so a component
+  that loads after boot (lazy loading in development) is readable from any
+  Ractor too. Writers now replace them instead of mutating them, and
+  mutating one in place raises `FrozenError`.
+- Thread safety: the Tailwind class groups behind `ClassMerge` were built
+  with an unguarded `||=` (8 threads built them 8 times); they are now built
+  once per Ractor.
+- Rendering components inside a Ractor waits on Phlex
+  ([yippee-fun/phlex#1055](https://github.com/yippee-fun/phlex/pull/1055)).
+
+## [2.0.2] and earlier
 
 ### Unknown modifiers are reported (#54)
 

data/README.md

@@ -209,6 +209,45 @@ end
 Keyword arguments are not validated: `Toggle(primray: true)` renders a
 `primray` attribute, because unknown keywords are HTML attributes.
 
+## Threads, fibers and Ractors
+
+Components and `DaisyUI::ClassMerge` are safe to share between threads (Puma)
+and fibers (Falcon). For Ractors, DaisyUI finalizes itself at boot: it freezes
+the configuration and every component's registries, so
+`DaisyUI::ClassMerge.merge` runs in any Ractor (as long as the configuration
+is shareable, see below), each Ractor with a merger of its own.
+`DaisyUI.configure` finalizes at its end and the Rails engine
+finalizes again once the app has booted, so there is nothing to call. A
+Rails-less app that never calls `configure` calls `DaisyUI.finalize!` at the
+end of boot.
+
+After that the configuration is frozen: writing to `DaisyUI.configuration`
+directly raises `FrozenError`. `DaisyUI.configure` keeps working at any time:
+it yields a writable copy and publishes it once that is finalized, and a
+Ractor that already built its merger rebuilds it from the new configuration.
+A test that changes a setting goes through it too:
+
+```ruby
+around do |example|
+  DaisyUI.configure { |config| config.unknown_modifiers = :ignore }
+  example.run
+ensure
+  DaisyUI.configure { |config| config.unknown_modifiers = :raise }
+end
+```
+
+Finalizing never raises. A configured value that cannot be made shareable is
+kept as it is, and the configuration is then readable on the main Ractor only:
+a callable `unknown_modifiers` or a raw `class_merge` validator that closes
+over app state (`->(error) { Appsignal.report_error(error) }` in an
+initializer), or an object that holds a logger. A lambda is shareable when it
+captures no local variables and is defined inside a module, or made with
+`Ractor.shareable_lambda` on Ruby 4.0. A component that loads after boot (lazy
+loading in development) freezes its registries as it writes them, so any
+Ractor can read it; a Ractor that already built its merger picks up its groups
+after the next `configure`. Rendering components inside a Ractor waits on Phlex
+([yippee-fun/phlex#1055](https://github.com/yippee-fun/phlex/pull/1055)).
+
 # Compatibility Notes
 
 ## @tailwindcss/forms plugin

data/lib/daisy_ui/base.rb

@@ -118,14 +118,37 @@ module DaisyUI
       error: "bg-error text-error-content"
     }.freeze
 
+    # Component registries: written by the class body (register_modifiers,
+    # register_flags, `self.component_class =`) and by `inherited`, on the main
+    # Ractor while the class loads; rendering only reads them. Every writer
+    # assigns a new value instead of mutating the old one and freezes it as it
+    # writes (Shareable.share), so a non-main Ractor can read the registries of
+    # a component that loaded after boot too, and a later register_* still
+    # works.
     class << self
-      attr_writer :component_class, :modifier_groups, :flags
-      attr_accessor :modifiers
+      # rubocop:disable ThreadSafety/ClassInstanceVariable -- see above
+      attr_reader :modifiers
+
+      def modifiers=(modifiers)
+        @modifiers = Shareable.share(modifiers)
+      end
+
+      def modifier_groups=(groups)
+        @modifier_groups = Shareable.share(groups)
+      end
+
+      def flags=(flags)
+        @flags = Shareable.share(flags)
+      end
+
+      def component_class=(component_class)
+        @component_class = Shareable.share(component_class)
+      end
 
       # Positional symbols a component handles itself (e.g. Dropdown's
       # :popover): accepted as modifiers, but they emit no class.
       def flags
-        @flags ||= []
+        @flags || []
       end
 
       def register_flags(*names)
@@ -135,20 +158,24 @@ module DaisyUI
       # { group => [modifier, ...] }: modifiers in one group are alternatives
       # (sizes, colors, ...), so ClassMerge keeps only the last one.
       def modifier_groups
-        @modifier_groups ||= {}
+        @modifier_groups || {}
       end
 
+      # Derived from the class name on first use, the same value every time.
+      # Remembered on the main Ractor only (DaisyUI.finalize! derives it at
+      # boot); a non-main Ractor cannot set a class ivar, so it derives it.
       def component_class
         return @component_class if instance_variable_defined?(:@component_class)
 
-        @component_class = begin
+        derived = begin
           # Convert "DaisyUI::Button" -> "button"
           class_name = name.split("::").last # demodulize
           class_name.gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
             .gsub(/([a-z\d])([A-Z])/, '\1_\2')
             .tr("_", "-")
-            .downcase
+            .downcase.freeze
         end
+        Store.main_ractor? ? (@component_class = derived) : derived
       end
 
       def inherited(subclass)
@@ -161,6 +188,7 @@ module DaisyUI
 
         subclass.component_class = @component_class
       end
+      # rubocop:enable ThreadSafety/ClassInstanceVariable
 
       # Registers modifiers. A Hash value declares a group of alternatives:
       #
@@ -178,15 +206,23 @@ module DaisyUI
           end
         end
 
-        modifier_groups.each_value { |members| members.delete_if { |member| flat.key?(member) } }
+        groups = modifier_groups.transform_values { |members| members.reject { |member| flat.key?(member) } }
         mods.each do |group, value|
-          (modifier_groups[group] ||= []).concat(value.keys) if value.is_a?(Hash)
+          groups[group] = (groups[group] || []) + value.keys if value.is_a?(Hash)
         end
-        modifier_groups.delete_if { |_group, members| members.empty? }
 
+        self.modifier_groups = groups.reject { |_group, members| members.empty? }
         self.modifiers = (modifiers || {}).merge(flat)
         ClassMerge.reset!
       end
+
+      # @api private Called by DaisyUI.finalize! for every component: derives
+      # component_class on the main Ractor and makes sure every registry is
+      # frozen for non-main Ractors.
+      def finalize!
+        [component_class, modifiers, modifier_groups, flags].each { |registry| Shareable.share(registry) }
+        self
+      end
     end
 
     def initialize(*modifiers, as: :div, id: nil, **options)

data/lib/daisy_ui/class_merge/configuration.rb

@@ -24,6 +24,20 @@ module DaisyUI
         @conflicts = {}
       end
 
+      def initialize_copy(source)
+        super
+        @theme = @theme.transform_values(&:dup)
+        @class_groups = @class_groups.transform_values(&:dup)
+        @conflicts = @conflicts.transform_values(&:dup)
+      end
+
+      # @api private Called by DaisyUI.finalize!. A raw class group's
+      # validator that closes over app state is kept as it is.
+      def finalize!
+        [@theme, @class_groups, @conflicts].each { |settings| Shareable.share(settings) }
+        freeze
+      end
+
       # Registers utilities that behave like an existing one:
       # `utility("text-display", like: "text-lg")` makes `text-display` a font
       # size, so it replaces `text-sm` and sits next to `text-error`.
@@ -57,11 +71,12 @@ module DaisyUI
         append(@conflicts, conflicts)
       end
 
-      # @api private The config passed to Merger.new, including the daisyUI groups.
-      def merger_config
+      # @api private The config passed to Merger.new, including the daisyUI
+      # groups of +configuration+ (the DaisyUI configuration holding this one).
+      def merger_config(configuration = DaisyUI.configuration)
         {
           theme: @theme,
-          class_groups: DaisyGroups.build.merge(@class_groups) { |_id, existing, added| existing + added },
+          class_groups: DaisyGroups.build(configuration).merge(@class_groups) { |_id, existing, added| existing + added },
           conflicting_class_groups: @conflicts
         }
       end

data/lib/daisy_ui/class_merge/daisy_groups.rb

@@ -18,8 +18,9 @@ module DaisyUI
     # @api private
     module DaisyGroups
       class << self
-        # Class groups for the merger: `{ "daisy:group:btn-size" => ["btn-xs", ...], ... }`.
-        def build(prefix: DaisyUI.configuration.prefix)
+        # Class groups for the merger: `{ "daisy:group:btn-size" => ["btn-xs", ...], ... }`,
+        # from one configuration's prefix and modifiers.
+        def build(configuration = DaisyUI.configuration, prefix: configuration.prefix)
           components = self.components
           groups = {}
 
@@ -37,7 +38,7 @@ module DaisyUI
           end
 
           # Configured modifiers join the component's own group of that name.
-          DaisyUI.configuration.modifiers.groups.each do |(component, group), classes|
+          configuration.modifiers.groups.each do |(component, group), classes|
             owner = component ? component.component_class || component.name : "global"
             add(groups, "daisy:group:#{owner}-#{group}", classes.flat_map(&:split), prefix)
           end
@@ -51,9 +52,11 @@ module DaisyUI
 
         # Every named DaisyUI::Base subclass: the gem's components (eager
         # loaded) and any app component loaded so far. An app component that
-        # loads later resets the merger through `register_modifiers`.
+        # loads later resets the merger through `register_modifiers`. Only the
+        # main Ractor can eager-load; DaisyUI.finalize! did it there before
+        # any other Ractor builds a merger.
         def components
-          Zeitwerk::Loader.eager_load_namespace(DaisyUI)
+          Zeitwerk::Loader.eager_load_namespace(DaisyUI) if Store.main_ractor?
           descendants(DaisyUI::Base).select(&:name)
         end
 

data/lib/daisy_ui/class_merge/tailwind_config.rb

@@ -8,21 +8,6 @@ module DaisyUI
     module TailwindConfig
       include Validators
 
-      class << self
-        private
-
-        # 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.
-        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 = %w[
         color
         font
@@ -46,8 +31,8 @@ module DaisyUI
       ].freeze
       THEME_KEYS.each do |key|
         const_set("THEME_#{key.upcase.tr('-', '_')}", lambda { |config|
-                                                        config[:theme].fetch(key, nil)
-                                                      }
+          config[:theme].fetch(key, nil)
+        }
         )
       end
 
@@ -2465,7 +2450,12 @@ module DaisyUI
           "selection"
         ]
       }.freeze
-      deep_freeze(DEFAULTS)
+
+      # Every constant above, DEFAULTS deeply, is made Ractor-shareable so a
+      # non-main Ractor can build its own merger from them: the scale and theme
+      # lambdas are capture-free (THEME_* only reads its frozen key) and their
+      # self is this module.
+      constants(false).each { |name| Shareable.make(const_get(name)) }
 
       # Extends DEFAULTS with incoming_config without mutating either.
       # Theme scales are appended. Unlike upstream, `class_groups` and

data/lib/daisy_ui/class_merge/validators.rb

@@ -197,6 +197,10 @@ module DaisyUI
       IS_LABEL_SHADOW = lambda { |label|
         label == "shadow"
       }
+
+      # Ractor-shareable, so a non-main Ractor can read them: every validator
+      # is a capture-free lambda whose self is this module.
+      constants(false).each { |name| Shareable.make(const_get(name)) }
     end
   end
 end

data/lib/daisy_ui/class_merge.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "monitor"
-
 module DaisyUI
   # Merges CSS class lists so that later classes win over earlier conflicting
   # ones, for Tailwind utilities and daisyUI modifiers alike:
@@ -16,10 +14,10 @@ module DaisyUI
   module ClassMerge
     TAILWIND_MERGE_VERSION = "1.5.6"
 
-    # Reentrant, so a reset! triggered while the merger is being built (e.g. a
-    # component file configuring DaisyUI as it loads) cannot deadlock.
-    @monitor = Monitor.new
-
+    # The merger (with its LRU) and the Tailwind class groups live in
+    # DaisyUI::Store: one per Ractor, built on first use under the store's
+    # reentrant lock, so a reset! triggered while the merger is being built
+    # (e.g. a component file configuring DaisyUI as it loads) cannot deadlock.
     class << self
       # Accepts strings, nested arrays, nil and false (dropped, as Phlex does
       # for `class:`). Returns a frozen String, "" when empty.
@@ -27,20 +25,33 @@ module DaisyUI
         merger.merge(parts.flatten.select(&:itself).join(" "))
       end
 
+      # Each Ractor's merger remembers the configuration it was built from
+      # and is rebuilt once DaisyUI.configure publishes another, also in a
+      # Ractor where reset! never ran.
       def merger
-        @merger || @monitor.synchronize do
-          @merger ||= Merger.new(config: DaisyUI.configuration.class_merge.merger_config)
-        end
+        configuration = DaisyUI.configuration
+        built_for, merger = Store.fetch(:daisy_ui_class_merger) { build_merger(configuration) }
+        return merger if built_for.equal?(configuration)
+
+        Store.delete(:daisy_ui_class_merger)
+        Store.fetch(:daisy_ui_class_merger) { build_merger(configuration) }.last
       end
 
       # @api private The stock Tailwind class groups, for classifying tokens.
       def tailwind_utils
-        @tailwind_utils ||= ClassGroupUtils.new(TailwindConfig::DEFAULTS)
+        Store.fetch(:daisy_ui_tailwind_utils) { ClassGroupUtils.new(TailwindConfig::DEFAULTS) }
       end
 
-      # Drops the memoized merger so the next merge picks up configuration changes.
+      # Drops the current Ractor's merger so its next merge picks up
+      # configuration changes.
       def reset!
-        @monitor.synchronize { @merger = nil }
+        Store.delete(:daisy_ui_class_merger)
+      end
+
+      private
+
+      def build_merger(configuration)
+        [configuration, Merger.new(config: configuration.class_merge.merger_config(configuration))]
       end
     end
   end

data/lib/daisy_ui/configurable/report_log.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module DaisyUI
+  module Configurable
+    # @api private The unknown modifiers already reported, so :warn and a
+    # callable fire once per key. Remembers up to `limit` keys, then starts
+    # over, so modifiers built from user input cannot grow it without bound.
+    # One per Ractor (DaisyUI::Store), so its Mutex is never shared.
+    class ReportLog
+      def initialize(limit)
+        @limit = limit
+        @keys = Set.new
+        @lock = Mutex.new
+      end
+
+      # True the first time a key is seen.
+      def first?(key)
+        @lock.synchronize do
+          return false if @keys.include?(key)
+
+          @keys.clear if @keys.size >= @limit
+          @keys.add(key)
+          true
+        end
+      end
+
+      def clear
+        @lock.synchronize { @keys.clear }
+      end
+
+      def size
+        @lock.synchronize { @keys.size }
+      end
+    end
+  end
+end

data/lib/daisy_ui/configurable.rb

@@ -2,15 +2,45 @@
 
 module DaisyUI
   module Configurable
+    # Created when DaisyUI extends this module, at load, so `configuration` is
+    # a plain read with no check-then-set race.
+    def self.extended(base)
+      base.instance_variable_set(:@configuration, Configuration.new)
+    end
+
+    # Yields a writable copy of the configuration, then finalizes the copy
+    # (see finalize!) and publishes it. Calling configure again keeps
+    # working, no reader (another thread, a non-main Ractor) meets a
+    # half-changed or writable configuration, and a block that raises
+    # publishes nothing. Calls are serialized, so each starts from what the
+    # previous one published.
     def configure
-      self.configuration ||= Configuration.new
-      yield(configuration) if block_given?
-      ClassMerge.reset!
-      configuration
+      configure_lock.synchronize do
+        draft = configuration.dup
+        yield(draft) if block_given?
+        @configuration = draft.finalize!
+        ClassMerge.reset!
+        finalize!
+        configuration
+      end
     end
 
     def configuration
-      @configuration ||= Configuration.new
+      @configuration
+    end
+
+    # Freezes what a non-main Ractor reads (this configuration and every
+    # component's registries) so DaisyUI::ClassMerge.merge runs in any Ractor.
+    # configure calls it, and the Rails engine calls it once the app has
+    # booted; an app with neither calls it at the end of boot. Afterwards
+    # change settings only through configure: writing to the frozen
+    # configuration raises. A configured value that cannot be made shareable
+    # is kept as it is (see Shareable.share), never raised on.
+    def finalize!
+      ClassMerge::DaisyGroups.components.each(&:finalize!)
+      configuration.finalize!
+      ClassMerge.tailwind_utils
+      self
     end
 
     class Modifiers
@@ -19,6 +49,19 @@ module DaisyUI
         @groups = {}
       end
 
+      def initialize_copy(source)
+        super
+        @modifiers = @modifiers.transform_values(&:dup)
+        @groups = @groups.dup
+      end
+
+      # @api private Called by DaisyUI.finalize!.
+      def finalize!
+        Shareable.share(@modifiers)
+        Shareable.share(@groups)
+        freeze
+      end
+
       # `group:` makes the modifier an alternative to the component's other
       # modifiers in that group, e.g. `add(:huge, classes: "btn-xl",
       # component: DaisyUI::Button, group: :size)`.
@@ -59,8 +102,24 @@ module DaisyUI
 
       def initialize
         @prefix = nil
-        @reported_unknown_modifiers = Set.new
-        @reported_unknown_modifiers_lock = Mutex.new
+      end
+
+      def initialize_copy(source)
+        super
+        @class_merge = @class_merge&.dup
+        @modifiers = @modifiers&.dup
+      end
+
+      # @api private Called by DaisyUI.configure and DaisyUI.finalize!. A
+      # callable unknown_modifiers that cannot be made shareable (a lambda
+      # that closes over app state, an object holding a logger) is kept: the
+      # configuration is then frozen but readable on the main Ractor only.
+      def finalize!
+        class_merge.finalize!
+        modifiers.finalize!
+        Shareable.share(@prefix)
+        Shareable.share(@unknown_modifiers)
+        freeze
       end
 
       # What a component does with a positional modifier it does not know:
@@ -94,7 +153,7 @@ module DaisyUI
 
       # @api private
       def reset_reported_unknown_modifiers!
-        @reported_unknown_modifiers_lock.synchronize { @reported_unknown_modifiers.clear }
+        reported_unknown_modifiers.clear
       end
 
       def prefix=(prefix)
@@ -112,16 +171,14 @@ module DaisyUI
 
       private
 
-      # Remembers up to REPORTED_UNKNOWN_MODIFIERS_LIMIT keys, then starts over,
-      # so modifiers built from user input cannot grow it without bound.
       def first_report?(key)
-        @reported_unknown_modifiers_lock.synchronize do
-          return false if @reported_unknown_modifiers.include?(key)
+        reported_unknown_modifiers.first?(key)
+      end
 
-          @reported_unknown_modifiers.clear if @reported_unknown_modifiers.size >= REPORTED_UNKNOWN_MODIFIERS_LIMIT
-          @reported_unknown_modifiers.add(key)
-          true
-        end
+      # What was already reported lives per Ractor, outside the configuration,
+      # which stays shareable.
+      def reported_unknown_modifiers
+        Store.fetch(:daisy_ui_reported_unknown_modifiers) { ReportLog.new(REPORTED_UNKNOWN_MODIFIERS_LIMIT) }
       end
 
       def default_unknown_modifiers
@@ -130,5 +187,13 @@ module DaisyUI
         %w[development test].include?(::Rails.env.to_s) ? :raise : :warn
       end
     end
+
+    private
+
+    # Reentrant, and one per Ractor (DaisyUI::Store) so it is never shared;
+    # configure writes DaisyUI's ivar, so only the main Ractor gets that far.
+    def configure_lock
+      Store.fetch(:daisy_ui_configure_lock) { Monitor.new }
+    end
   end
 end

data/lib/daisy_ui/engine.rb

@@ -34,6 +34,13 @@ module DaisyUI
       precompile.concat(MINIFIED_ASSETS) if precompile.is_a?(Array)
     end
 
+    # Once the app has booted, freeze the configuration and component
+    # registries so a non-main Ractor can merge classes. DaisyUI.configure in
+    # an initializer already finalized; this also covers an app that never
+    # calls it and the components loaded during boot (eager loading).
+    # DaisyUI.configure keeps working afterwards, on a copy.
+    config.after_initialize { DaisyUI.finalize! }
+
     initializer "daisy_ui.importmap", before: "importmap" do |app|
       next unless app.config.respond_to?(:importmap)
 

data/lib/daisy_ui/mcp_server.rb

@@ -39,6 +39,7 @@ module DaisyUI
         }
       }
     ].freeze
+    Shareable.make(TOOLS) # the Hashes inside too
 
     EXCLUDED_CONSTANTS = %i[Base Configurable Configuration Modifiers VERSION UPDATED_AT McpServer].freeze
 

data/lib/daisy_ui/shareable.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module DaisyUI
+  # @api private Deep-freezes a value so a non-main Ractor can read it from a
+  # constant or a class ivar: `Ractor.make_shareable`, or, on engines without
+  # Ractor (JRuby, TruffleRuby), a walk freezing Hash values and Array elements.
+  module Shareable
+    class << self
+      # For the gem's own literals, which must all be shareable: raises if one
+      # is not.
+      def make(value)
+        ractor? ? ::Ractor.make_shareable(value) : deep_freeze(value)
+      end
+
+      # For what an app configures. Freezes Hashes, Arrays and Strings all the
+      # way down, makes a capture-free Proc shareable, and keeps anything else
+      # (a Proc that closes over app state, a logger) as it is, so whatever
+      # holds it is readable on the main Ractor only. Never raises, and never
+      # hands an object it does not know to Ractor.make_shareable, which
+      # freezes as it goes and would leave a logger frozen before failing.
+      def share(value)
+        case value
+        when Hash
+          value.each do |key, member|
+            share(key)
+            share(member)
+          end.freeze
+        when Array then value.each { |member| share(member) }.freeze
+        when String then value.freeze
+        when Proc then share_proc(value)
+        else value
+        end
+      end
+
+      def ractor?
+        defined?(::Ractor) ? ::Ractor.respond_to?(:make_shareable) : false
+      end
+
+      private
+
+      def share_proc(callable)
+        ractor? ? ::Ractor.make_shareable(callable) : callable
+      rescue ::Ractor::Error, ArgumentError
+        callable
+      end
+
+      def deep_freeze(value)
+        case value
+        when Hash then value.each_value { |member| deep_freeze(member) }
+        when Array then value.each { |member| deep_freeze(member) }
+        end
+        value.freeze
+      end
+    end
+  end
+end

data/lib/daisy_ui/store.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require "monitor"
+
+module DaisyUI
+  # @api private Per-Ractor lazy storage for caches that must not live in a
+  # class ivar or a constant (the class-merge merger, the Tailwind class
+  # groups, the unknown-modifier report log):
+  #
+  #   DaisyUI::Store.fetch(:daisy_ui_merger) { Merger.new(...) }
+  #   DaisyUI::Store.delete(:daisy_ui_merger)
+  #
+  # Adapted from conformance-kit's ConformanceKit::Store (MIT, same author),
+  # which daisyui cannot depend on at runtime, plus `delete`. Every Ractor has
+  # its own Monitor-guarded table: reentrant, so an initializer may fetch or
+  # delete other keys. On Ruby 3.4+ the table comes from
+  # `Ractor.store_if_absent`. Below 3.4 the main Ractor's table is created at
+  # load (never lazily, so there is no check-then-set race), and a non-main
+  # Ractor keeps its own in Ractor-local storage.
+  module Store
+    # One Ractor's values. Reads skip the lock once a key is stored.
+    class Table
+      def initialize
+        @monitor = Monitor.new
+        @values = {}
+      end
+
+      def fetch(key)
+        @values.fetch(key) do
+          @monitor.synchronize { @values.fetch(key) { @values[key] = yield } }
+        end
+      end
+
+      def delete(key)
+        @monitor.synchronize { @values.delete(key) }
+      end
+    end
+
+    class << self
+      def fetch(key, &init)
+        raise ArgumentError, "DaisyUI::Store.fetch(#{key.inspect}) needs an initializer block" unless init
+
+        table.fetch(key, &init)
+      end
+
+      def delete(key)
+        table.delete(key)
+      end
+
+      def main_ractor?
+        !defined?(::Ractor) || ::Ractor.current == ::Ractor.main
+      end
+
+      def native?
+        defined?(::Ractor) ? ::Ractor.respond_to?(:store_if_absent) : false
+      end
+
+      private
+
+      def table
+        return ::Ractor.store_if_absent(:daisy_ui_store) { Table.new } if native?
+        return ::Ractor.current[:daisy_ui_store] ||= Table.new unless main_ractor?
+
+        # Set once below, at load, below Ruby 3.4; only the main Ractor reads it.
+        @main_table # rubocop:disable ThreadSafety/ClassInstanceVariable
+      end
+    end
+
+    @main_table = Table.new unless native?
+  end
+end

data/lib/daisy_ui/updated_at.rb

@@ -3,5 +3,5 @@
 module DaisyUI
   # This timestamp is automatically updated when releasing a new version
   # Format: YYYY-MM-DD HH:MM:SS UTC
-  UPDATED_AT = "2026-10-11 16:15:37 UTC"
+  UPDATED_AT = "2026-10-15 20:45:37 UTC"
 end

data/lib/daisy_ui/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DaisyUI
-  VERSION = "2.0.2"
+  VERSION = "2.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: daisyui
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.1.0
 platform: ruby
 authors:
 - Mikael Henriksson
@@ -98,6 +98,7 @@ files:
 - lib/daisy_ui/collapse.rb
 - lib/daisy_ui/collapsible_sub_menu.rb
 - lib/daisy_ui/configurable.rb
+- lib/daisy_ui/configurable/report_log.rb
 - lib/daisy_ui/countdown.rb
 - lib/daisy_ui/diff.rb
 - lib/daisy_ui/divider.rb
@@ -141,11 +142,13 @@ files:
 - lib/daisy_ui/range.rb
 - lib/daisy_ui/rating.rb
 - lib/daisy_ui/select.rb
+- lib/daisy_ui/shareable.rb
 - lib/daisy_ui/skeleton.rb
 - lib/daisy_ui/stack.rb
 - lib/daisy_ui/stat.rb
 - lib/daisy_ui/status.rb
 - lib/daisy_ui/steps.rb
+- lib/daisy_ui/store.rb
 - lib/daisy_ui/sub_menu.rb
 - lib/daisy_ui/swap.rb
 - lib/daisy_ui/tab.rb