tailmix 0.2.0 → 0.4.6

data/lib/tailmix/runtime/facade_builder.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Tailmix
+  module Runtime
+    class FacadeBuilder
+      def self.build(definition)
+        Class.new(Tailmix::Runtime::Context) do
+          definition.elements.each_key do |element_name|
+            define_method(element_name) do |runtime_dimensions = {}|
+              attributes_for(element_name, runtime_dimensions)
+            end
+          end
+
+          def inspect
+            component_name = @component_instance.class.name || "AnonymousComponent"
+            elements_list = @definition.elements.keys.join(", ")
+            "#<Tailmix::UI for #{component_name} elements=[#{elements_list}] dimensions=#{@dimensions.inspect}>"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tailmix/runtime/stimulus/compiler.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Tailmix
+  module Runtime
+    module Stimulus
+      class Compiler
+
+        def self.call(definition:, data_map:, root_definition:, component:)
+          (definition.definitions || []).each do |rule|
+            builder = data_map.stimulus
+
+            case rule[:type]
+            when :controller
+              builder.controller(rule[:name])
+            when :action
+              action_data = rule[:data]
+              controller_name = rule[:controller]
+
+              action_string = case action_data[:type]
+              when :raw
+                action_data[:content]
+              when :hash
+                action_data[:content].map { |event, method| "#{event}->#{controller_name}##{method}" }.join(" ")
+              when :tuple
+                event, method = action_data[:content]
+                "#{event}->#{controller_name}##{method}"
+              end
+
+              builder.context(controller_name).action(action_string)
+            when :target
+              builder.context(rule[:controller]).target(rule[:name])
+            when :value
+              source = rule[:source]
+
+              resolved_value = case source[:type]
+              when :literal
+                source[:content]
+              when :proc
+                source[:content].call
+              when :method
+                component.public_send(source[:content])
+              else
+                # type code here
+              end
+
+              builder.context(rule[:controller]).value(rule[:name], resolved_value)
+
+            when :param
+              builder.context(rule[:controller]).param(rule[:params])
+            when :action_payload
+              action = root_definition.actions.fetch(rule[:action_name])
+              builder.context(rule[:controller]).value(rule[:value_name], action.to_h)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tailmix/runtime.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "set"
+require_relative "runtime/context"
+require_relative "runtime/facade_builder"
+require_relative "runtime/stimulus/compiler"
+require_relative "html/attributes"
+require_relative "runtime/action"
+
+
+module Tailmix
+  module Runtime
+  end
+end

data/lib/tailmix/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tailmix
-  VERSION = "0.2.0"
+  VERSION = "0.4.6"
 end

data/lib/tailmix.rb

@@ -1,38 +1,33 @@
 # frozen_string_literal: true
 
 require_relative "tailmix/version"
-require_relative "tailmix/schema"
-require_relative "tailmix/resolver"
-require_relative "tailmix/manager"
-require_relative "tailmix/part"
-require_relative "tailmix/dimension"
-require_relative "tailmix/element"
-require_relative "tailmix/utils"
-require_relative "tailmix/action"
+require_relative "tailmix/configuration"
+require_relative "tailmix/dsl"
+require_relative "tailmix/definition"
+require_relative "tailmix/runtime"
 
 module Tailmix
-  def self.included(base)
-    base.extend(ClassMethods)
-    base.instance_variable_set(:@tailmix_schema, nil)
+  class Error < StandardError; end
 
-    base.define_singleton_method(:tailmix_schema) do
-      @tailmix_schema
-    end
+  class << self
+    attr_writer :configuration
 
-    base.define_singleton_method(:tailmix_schema=) do |value|
-      @tailmix_schema = value
+    def configuration
+      @configuration ||= Configuration.new
     end
-  end
 
-  module ClassMethods
-    def tailmix(&block)
-      self.tailmix_schema = Schema.new(&block)
+    def configure
+      yield(configuration)
     end
   end
 
-  private
+  def self.included(base)
+    base.extend(DSL)
+  end
 
-  def tailmix(options = {})
-    Manager.new(self.class.tailmix_schema, options)
+  def tailmix(dimensions = {})
+    self.class.tailmix_facade_class.new(self, self.class.tailmix_definition, dimensions)
   end
 end
+
+require_relative "tailmix/engine" if defined?(Rails)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tailmix
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.6
 platform: ruby
 authors:
 - Alexander Fokin
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-14 00:00:00.000000000 Z
+date: 2025-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -68,17 +68,42 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- examples/interactive_component.rb
-- examples/status_badge_component.rb
+- app/javascript/tailmix/finder.js
+- app/javascript/tailmix/index.js
+- app/javascript/tailmix/mutator.js
+- app/javascript/tailmix/runner.js
+- app/javascript/tailmix/stimulus_adapter.js
+- examples/_modal_component.arb
+- examples/modal_component.rb
+- lib/generators/tailmix/install_generator.rb
 - lib/tailmix.rb
-- lib/tailmix/action.rb
-- lib/tailmix/dimension.rb
-- lib/tailmix/element.rb
-- lib/tailmix/manager.rb
-- lib/tailmix/part.rb
-- lib/tailmix/resolver.rb
-- lib/tailmix/schema.rb
-- lib/tailmix/utils.rb
+- lib/tailmix/configuration.rb
+- lib/tailmix/definition.rb
+- lib/tailmix/definition/context_builder.rb
+- lib/tailmix/definition/contexts/action_builder.rb
+- lib/tailmix/definition/contexts/actions/element_builder.rb
+- lib/tailmix/definition/contexts/attribute_builder.rb
+- lib/tailmix/definition/contexts/dimension_builder.rb
+- lib/tailmix/definition/contexts/element_builder.rb
+- lib/tailmix/definition/contexts/stimulus_builder.rb
+- lib/tailmix/definition/contexts/variant_builder.rb
+- lib/tailmix/definition/merger.rb
+- lib/tailmix/definition/result.rb
+- lib/tailmix/dev/docs.rb
+- lib/tailmix/dev/stimulus_generator.rb
+- lib/tailmix/dev/tools.rb
+- lib/tailmix/dsl.rb
+- lib/tailmix/engine.rb
+- lib/tailmix/html/attributes.rb
+- lib/tailmix/html/class_list.rb
+- lib/tailmix/html/data_map.rb
+- lib/tailmix/html/selector.rb
+- lib/tailmix/html/stimulus_builder.rb
+- lib/tailmix/runtime.rb
+- lib/tailmix/runtime/action.rb
+- lib/tailmix/runtime/context.rb
+- lib/tailmix/runtime/facade_builder.rb
+- lib/tailmix/runtime/stimulus/compiler.rb
 - lib/tailmix/version.rb
 - sig/tailmix.rbs
 homepage: https://github.com/alexander-s-f/tailmix

data/examples/interactive_component.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../lib/tailmix"
-
-class InteractiveComponent
-  include Tailmix
-
-  tailmix do
-    element :container, "p-4 rounded-md"
-    element :label, "font-bold"
-
-    action :highlight, behavior: :toggle do
-      element :container, "ring-2 ring-blue-500 bg-blue-50"
-      element :label, "text-blue-700"
-    end
-  end
-
-  attr_reader :classes
-
-  def initialize
-    @classes = tailmix
-  end
-
-  def toggle_highlight
-    @classes.actions.highlight.apply!
-  end
-
-  def render
-    # ...
-  end
-end
-
-component = InteractiveComponent.new
-puts "Initial container: '#{component.classes.container}'"
-# => Initial container: 'p-4 rounded-md'
-
-component.toggle_highlight
-puts "After highlight:   '#{component.classes.container}'"
-# => After highlight:   'p-4 rounded-md ring-2 ring-blue-500 bg-blue-50'
-
-puts "JSON Recipe: #{component.classes.actions.highlight.to_json}"
-# => JSON Recipe: {"behavior":"toggle","classes":{"container":"ring-2...","label":"text-blue-700"}}

data/examples/status_badge_component.rb

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "../lib/tailmix"
-
-class StatusBadgeComponent
-  include Tailmix
-
-  tailmix do
-    element :badge, "inline-flex items-center font-medium px-2.5 py-0.5 rounded-full" do
-      size do
-        option :sm, "text-xs", default: true
-        option :lg, "text-base"
-      end
-      status do
-        option :success, "bg-green-100 text-green-800", default: true
-        option :warning, "bg-yellow-100 text-yellow-800"
-        option :error,   "bg-red-100 text-red-800"
-      end
-    end
-  end
-
-  attr_reader :classes
-
-  def initialize(status: :success, size: :sm)
-    @classes = tailmix(status: status, size: size)
-  end
-
-  def highlight!
-    @classes.badge.add("ring-2 ring-offset-2 ring-blue-500")
-  end
-
-  def render
-    "<span class='#{@classes.badge}'>Status</span>"
-  end
-end
-
-badge1 = StatusBadgeComponent.new(status: :error, size: :lg)
-puts "Error badge: #{badge1.render}"
-# => Error badge: <span class='inline-flex ... text-base bg-red-100 text-red-800'>Status</span>
-
-badge2 = StatusBadgeComponent.new(status: :success)
-badge2.highlight!
-puts "Success badge (highlighted): #{badge2.render}"
-# => Success badge (highlighted): <span class='inline-flex ... text-xs bg-green-100 text-green-800 ring-2 ring-offset-2 ring-blue-500'>Status</span>

data/lib/tailmix/action.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-
-module Tailmix
-  class Action
-    def initialize(manager, behavior:, classes_by_part:)
-      @manager = manager
-      @behavior = behavior
-      @classes_by_part = classes_by_part
-    end
-
-    def apply!
-      @classes_by_part.each do |part_name, classes|
-        part_object = @manager.public_send(part_name)
-        part_object.public_send(@behavior, classes)
-      end
-    end
-
-    def to_json(*_args)
-      {
-        behavior: @behavior,
-        classes: @classes_by_part
-      }.to_json
-    end
-  end
-end

data/lib/tailmix/dimension.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-module Tailmix
-  class Dimension
-    attr_reader :options, :default_option
-
-    def initialize(&block)
-      @options = {}
-      @default_option = nil
-      instance_eval(&block) if block_given?
-    end
-
-    def option(name, classes, default: false)
-      @options[name.to_sym] = classes
-      @default_option = name.to_sym if default
-    end
-  end
-end

data/lib/tailmix/element.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "dimension"
-
-module Tailmix
-  class Element
-    attr_reader :base_classes, :dimensions
-
-    def initialize(base_classes, &block)
-      @base_classes = base_classes
-      @dimensions = {}
-      instance_eval(&block) if block_given?
-    end
-
-    def method_missing(method_name, &block)
-      dimension_name = method_name.to_sym
-      @dimensions[dimension_name] = Dimension.new(&block)
-    end
-
-    def respond_to_missing?(method_name, include_private = false)
-      true
-    end
-  end
-end

data/lib/tailmix/manager.rb

@@ -1,86 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "resolver"
-require_relative "part"
-require_relative "utils"
-require_relative "action"
-
-module Tailmix
-  class Manager
-    def initialize(schema, initial_variants = {})
-      @schema = schema
-      @current_variants = {}
-      @part_objects = {}
-
-      defaults = get_defaults_from_schema
-      combine(Utils.deep_merge(defaults, initial_variants))
-    end
-
-    def combine(variants_to_apply = {})
-      @current_variants = Utils.deep_merge(@current_variants, variants_to_apply)
-      rebuild_parts!
-      self
-    end
-
-    def method_missing(method_name, *args, &block)
-      part_name = method_name.to_sym
-      if @part_objects.key?(part_name)
-        @part_objects[part_name]
-      else
-        super
-      end
-    end
-
-    def respond_to_missing?(method_name, include_private = false)
-      @part_objects.key?(method_name.to_sym) || super
-    end
-
-    def actions
-      @action_proxy ||= ActionProxy.new(self, @schema)
-    end
-
-    class ActionProxy
-      def initialize(manager, schema)
-        @manager = manager
-        @schema = schema
-      end
-
-      def method_missing(method_name, *args, &block)
-        action_name = method_name.to_sym
-
-        if @schema.actions.key?(action_name)
-          action_definition = @schema.actions[action_name]
-
-          Action.new(@manager, **action_definition)
-        else
-          super
-        end
-      end
-
-      def respond_to_missing?(method_name, include_private = false)
-        @schema.actions.key?(method_name.to_sym) || super
-      end
-    end
-
-    private
-
-    def rebuild_parts!
-      resolved_struct = Resolver.call(@schema, @current_variants)
-      @part_objects = {}
-
-      resolved_struct.to_h.each do |part_name, class_string|
-        @part_objects[part_name] = Part.new(class_string || "")
-      end
-    end
-
-    def get_defaults_from_schema
-      defaults = {}
-      @schema.elements.each_value do |element|
-        element.dimensions.each do |dim_name, dim|
-          defaults[dim_name] = dim.default_option if dim.default_option
-        end
-      end
-      defaults
-    end
-  end
-end

data/lib/tailmix/part.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-require "set"
-
-module Tailmix
-  class Part
-    def initialize(class_string)
-      @classes = Set.new(class_string.to_s.split)
-    end
-
-    def add(*new_classes)
-      @classes.merge(process_args(new_classes))
-      self
-    end
-
-    def remove(*classes_to_remove)
-      @classes.subtract(process_args(classes_to_remove))
-      self
-    end
-
-    def toggle(*classes_to_toggle)
-      process_args(classes_to_toggle).each do |cls|
-        @classes.delete?(cls) || @classes.add(cls)
-      end
-      self
-    end
-
-    def to_s
-      @classes.to_a.join(" ")
-    end
-    alias to_str to_s
-
-    private
-
-    def process_args(args)
-      args.flat_map { |arg| arg.to_s.split }
-    end
-  end
-end

data/lib/tailmix/resolver.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require "ostruct"
-
-module Tailmix
-  module Resolver
-    def self.call(schema, active_variants = {})
-      resolved_parts = schema.elements.each_with_object({}) do |(element_name, element), result|
-        class_list = []
-
-        class_list << element.base_classes
-
-        element.dimensions.each do |dimension_name, dimension|
-          active_option = active_variants[dimension_name] || dimension.default_option
-
-          if active_option
-            variant_class = dimension.options[active_option]
-            class_list << variant_class
-          end
-        end
-
-        result[element_name] = class_list.compact.join(" ")
-      end
-
-      OpenStruct.new(resolved_parts)
-    end
-  end
-end

data/lib/tailmix/schema.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "element"
-
-module Tailmix
-  class Schema
-    attr_reader :elements, :actions
-
-    def initialize(&block)
-      @elements = {}
-      @actions = {}
-      instance_eval(&block) if block_given?
-    end
-
-    def element(name, base_classes, &block)
-      @elements[name.to_sym] = Element.new(base_classes, &block)
-    end
-
-    def action(name, behavior: :toggle, &block)
-      builder = ActionBuilder.new
-      builder.instance_eval(&block)
-
-      @actions[name.to_sym] = {
-        behavior: behavior,
-        classes_by_part: builder.classes_by_part
-      }
-    end
-
-    class ActionBuilder
-      attr_reader :classes_by_part
-
-      def initialize
-        @classes_by_part = {}
-      end
-
-      def element(name, classes)
-        @classes_by_part[name.to_sym] = classes
-      end
-    end
-  end
-end

data/lib/tailmix/utils.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Tailmix
-  module Utils
-    def self.deep_merge(original_hash, other_hash)
-      other_hash.each_with_object(original_hash.dup) do |(key, value), result|
-        if value.is_a?(Hash) && result[key].is_a?(Hash)
-          result[key] = deep_merge(result[key], value)
-        else
-          result[key] = value
-        end
-      end
-    end
-  end
-end