slimi 0.7.8 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29937913d2bf6ac3b92dcb1e94964655b79ee48d8e891890ca53618afb3f63db
-  data.tar.gz: b15a369b677fe16bb18b837cd523dd01f317a05b0135b3f1c690bbc8f2d389fc
+  metadata.gz: 1f85a2a7fb060ffa915242323704ec46c52f7bc224084013c08b7832ccaaa4e2
+  data.tar.gz: d76831908983154a2f80f8f2ed433ee76e29d5d016eb7a9b29e2b0f292d7f54f
 SHA512:
-  metadata.gz: 45fe23fedad4989d7b0241a28ef46de56dca448f9e67fa68cfb47058dfc73055a891c84775e53e0ca89f6dd8e6efe5ce381ad3e5df31d8d0e04300a25ca89e5c
-  data.tar.gz: 859ee454f3ec3712540981e1ea315b9049aeda13473d42b0f5a0edeba8f186a44ad266925441f354e9c78e2414d6cbaf3cd2e9614f17b2c4c56876998bf60e32
+  metadata.gz: 4fac9d1b99931a94dee91a14721e0f657b1abd44f8f71110240d50bed95583793f42fee67bd5c0986857fcc356aae5efc2d20c077569c7658898bbf7af2e69b2
+  data.tar.gz: b21697a773720dc4604f7a21df0625df5671c52e7b4f48bcefcfc8bb5941b8f7af3b2776e0dc881d8eef218f53bb4f551d064e5180e68408d5167f5248fc58cf

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 0.8.0 - 2026-06-13
+
+- Support splat attributes.
+
 ## 0.7.5 - 2024-07-25
 
 ### Fixed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    slimi (0.7.8)
+    slimi (0.8.0)
       temple
       thor
       tilt

data/README.md

@@ -62,7 +62,7 @@ Commands:
     - [x] Boolean attributes
     - [x] Attribute merging
     - [x] Attribute shortcuts
-    - [ ] Splat attributes
+    - [x] Splat attributes
 - Plugins
     - [ ] Include partials
     - [ ] Translator/I18n

data/lib/slimi/engine.rb

@@ -24,6 +24,7 @@ module Slimi
     use Filters::Control
     use Filters::Output
     use Filters::Text
+    use Filters::Splat
     html :AttributeSorter
     html :AttributeMerger
     use Filters::Attribute

data/lib/slimi/errors.rb

@@ -62,5 +62,14 @@ module Slimi
 
     class UnknownLineIndicatorError < SlimSyntaxError
     end
+
+    class RenderError < BaseError
+    end
+
+    class InvalidAttributeNameError < RenderError
+    end
+
+    class MultipleAttributesError < RenderError
+    end
   end
 end

data/lib/slimi/filters/splat.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+module Slimi
+  module Filters
+    class Splat < Base
+      define_options :attr_quote, :format, :merge_attrs, :sort_attrs, use_html_safe: ''.respond_to?(:html_safe?)
+
+      # @param [Array] exp
+      # @return [Array]
+      def call(exp)
+        @splat_options = nil
+        exp = compile(exp)
+        if @splat_options
+          [:multi, [:code, "#{@splat_options} = #{splat_builder_options.inspect}"], exp]
+        else
+          exp
+        end
+      end
+
+      # @param [Array<Array>] attrs
+      # @return [Array]
+      def on_html_attrs(*attrs)
+        return super unless attrs.any? { |attr| splat?(attr) }
+
+        @splat_options ||= unique_name
+        builder = unique_name
+        result = [:multi]
+        result << [:code, "#{builder} = ::#{Builder.name}.new(#{@splat_options})"]
+        attrs.each do |attr|
+          result << compile_attribute(builder, attr)
+        end
+        result << [:dynamic, "#{builder}.to_s"]
+      end
+
+      private
+
+      # @param [String] builder
+      # @param [Array] attr
+      # @return [Array]
+      def compile_attribute(builder, attr)
+        return [:code, "#{builder}.splat((#{attr[2]}))"] if splat?(attr)
+
+        _, _, name, value = attr
+        if value[0] == :slimi && value[1] == :attrvalue
+          # Pass the raw expression and escape flag through, so that the Builder can
+          # apply the same merge / boolean / nil / escape rules as Filters::Attribute.
+          [:code, "#{builder}.code_attribute(#{name.to_s.inspect}, #{value[2]}, (#{value[3]}))"]
+        elsif value == [:multi]
+          # Boolean attribute, e.g. `div(*foo disabled)`.
+          [:code, "#{builder}.code_attribute(#{name.to_s.inspect}, false, true)"]
+        else
+          # Static or interpolated value whose escaping is compiled into the capture,
+          # so the Builder must not escape it again.
+          tmp = unique_name
+          [:multi,
+           [:capture, tmp, compile(value)],
+           [:code, "#{builder}.attribute(#{name.to_s.inspect}, #{tmp})"]]
+        end
+      end
+
+      # @param [Array] attr
+      # @return [Boolean]
+      def splat?(attr)
+        attr[0] == :slimi && attr[1] == :splat
+      end
+
+      # @return [Hash]
+      def splat_builder_options
+        {
+          attr_quote: options[:attr_quote],
+          format: options[:format],
+          merge_attrs: options[:merge_attrs],
+          sort_attrs: options[:sort_attrs],
+          use_html_safe: options[:use_html_safe]
+        }
+      end
+
+      class Builder
+        # https://html.spec.whatwg.org/multipage/syntax.html#attributes-2
+        INVALID_ATTRIBUTE_NAME_REGEXP = %r{[ \0"'>/=]}.freeze
+
+        # @param [Hash] options
+        def initialize(options)
+          @attr_quote = options[:attr_quote]
+          @format = options[:format]
+          @merge_attrs = options[:merge_attrs] || {}
+          @sort_attrs = options.fetch(:sort_attrs, true)
+          @use_html_safe = options[:use_html_safe]
+          @attributes = {}
+        end
+
+        # Add an attribute value already rendered and escaped by the compiled template.
+        # @param [String] name
+        # @param [String] value
+        def attribute(name, value)
+          store(name, value)
+        end
+
+        # Add an attribute value, applying merge / boolean / nil / escape rules.
+        # @param [String] name
+        # @param [Boolean] escape
+        # @param [Object] value
+        def code_attribute(name, escape, value)
+          if (delimiter = @merge_attrs[name])
+            value = value.is_a?(::Array) ? value.flatten.map(&:to_s).reject(&:empty?).join(delimiter) : value.to_s
+            store(name, escape_html(escape, value)) unless value.empty?
+          elsif value.is_a?(::Hash)
+            value.each do |key, nested_value|
+              code_attribute("#{name}-#{key}", escape, nested_value)
+            end
+          elsif value != false && !value.nil?
+            store(name, value == true ? true : escape_html(escape, value.to_s))
+          end
+        end
+
+        # @param [Hash] hash
+        def splat(hash)
+          hash.each do |name, value|
+            code_attribute(name.to_s, true, value)
+          end
+        end
+
+        # @return [String]
+        def to_s
+          attributes = @sort_attrs ? @attributes.sort_by(&:first) : @attributes
+          attributes.map { |name, value| render(name, value) }.join
+        end
+
+        private
+
+        # @param [String] name
+        # @param [String, true] value
+        def store(name, value)
+          raise Errors::InvalidAttributeNameError, "Invalid attribute name '#{name}' was rendered" if INVALID_ATTRIBUTE_NAME_REGEXP.match?(name)
+
+          if @attributes.key?(name)
+            delimiter = @merge_attrs[name]
+            raise Errors::MultipleAttributesError, "Multiple #{name} attributes specified" unless delimiter
+
+            @attributes[name] = "#{@attributes[name]}#{delimiter}#{value}"
+          else
+            @attributes[name] = value
+          end
+        end
+
+        # @param [String] name
+        # @param [String, true] value
+        # @return [String]
+        def render(name, value)
+          if value == true
+            if @format == :xhtml
+              " #{name}=#{@attr_quote}#{@attr_quote}"
+            else
+              " #{name}"
+            end
+          else
+            " #{name}=#{@attr_quote}#{value}#{@attr_quote}"
+          end
+        end
+
+        # @param [Boolean] escape
+        # @param [String] string
+        # @return [String]
+        def escape_html(escape, string)
+          return string unless escape
+
+          if @use_html_safe
+            ::Temple::Utils.escape_html_safe(string)
+          else
+            ::Temple::Utils.escape_html(string)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slimi/filters.rb

@@ -11,6 +11,7 @@ module Slimi
     autoload :EndInserter, 'slimi/filters/end_inserter'
     autoload :Interpolation, 'slimi/filters/interpolation'
     autoload :Output, 'slimi/filters/output'
+    autoload :Splat, 'slimi/filters/splat'
     autoload :Text, 'slimi/filters/text'
     autoload :Unposition, 'slimi/filters/unposition'
   end

data/lib/slimi/parser.rb

@@ -38,6 +38,7 @@ module Slimi
       @attribute_shortcut_regexp = factory.attribute_shortcut_regexp
       @attribute_delimiter_regexp = factory.attribute_delimiter_regexp
       @quoted_attribute_regexp = factory.quoted_attribute_regexp
+      @splat_attribute_regexp = factory.splat_attribute_regexp
       @tag_name_regexp = factory.tag_name_regexp
       @attribute_name_regexp = factory.attribute_name_regexp
       @ruby_attribute_regexp = factory.ruby_attribute_regexp
@@ -259,9 +260,13 @@ module Slimi
         attribute_delimiter_closing_part_regexp = /[ \t]*#{attribute_delimiter_closing_regexp}/
       end
 
-      # TODO: Support splat attributes.
       loop do
-        if @scanner.skip(@quoted_attribute_regexp)
+        if @scanner.skip(@splat_attribute_regexp)
+          charpos = @scanner.charpos
+          code = parse_ruby_attribute_value(attribute_delimiter_closing)
+          syntax_error!(Errors::InvalidEmptyAttributeError) if code.empty?
+          attributes << [:slimi, :position, charpos, charpos + code.length, [:slimi, :splat, code]]
+        elsif @scanner.skip(@quoted_attribute_regexp)
           attribute_name = @scanner[1]
           escape = @scanner[2].empty?
           quote = @scanner[3]
@@ -676,6 +681,11 @@ module Slimi
         /#{attribute_name_regexp}[ \t]*=(=?)[ \t]*("|')/
       end
 
+      # @return [Regexp]
+      def splat_attribute_regexp
+        /[ \t]*\*(?=[^\s])/
+      end
+
       # @return [Regexp]
       def ruby_attribute_delimiter_regexp
         ::Regexp.union(@ruby_attribute_delimiters.keys)

data/lib/slimi/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Slimi
-  VERSION = '0.7.8'
+  VERSION = '0.8.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: slimi
 version: !ruby/object:Gem::Version
-  version: 0.7.8
+  version: 0.8.0
 platform: ruby
 authors:
 - Ryo Nakamura
@@ -85,6 +85,7 @@ files:
 - lib/slimi/filters/end_inserter.rb
 - lib/slimi/filters/interpolation.rb
 - lib/slimi/filters/output.rb
+- lib/slimi/filters/splat.rb
 - lib/slimi/filters/text.rb
 - lib/slimi/filters/unposition.rb
 - lib/slimi/parser.rb