antlers 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 375ebfb2e841c81843bb17b1025d8cd43dbe851f803f4845afb73f6d24f8ef30
-  data.tar.gz: a7db1372364cb6633b6ce6ae2492966ecf1c6d2a20f3d7af214ce14e18feda21
+  metadata.gz: 6ce3c9ccc84415933ff474d8187c420e28618fa7c15c56bffe0060e2364750d2
+  data.tar.gz: cc69421e1365a4c3f38975aadd7eee7390797ba48c2aff399ad425f2bb05160e
 SHA512:
-  metadata.gz: c0b9b231ebe71d01f50443bebcec9210c3f97fe238138d172974ef5c298d5c543af1371a3806f45e54cc8e5a6a8cb32d6e51e17547465ed96682a633393c0ca4
-  data.tar.gz: d7c42c19f7c1aa9a5bcb27d30fe2fe0118054897bb5e2388f266b7127bf6c89bdc35b7da4fa20e39f969a20f6a7a2ce9c6e8325ac32e0a9f78720b85a06bb21c
+  metadata.gz: da91462599377c23cc6cfc92fe4fa74e917a216a6378f1ef353ac3fcd6c53a947644dfc9cb3c2bb3937adaf33c5644d28a1f9698ea570c31de36479a8964301e
+  data.tar.gz: 6c46c7a4aa39005d09ba125a7b2f4a1129383ade80691fffbe0757c3a19683144ecbbe12392ab22814b5894c83a3d489701ccdaa1da116e927881816e2cc4ad9

data/lib/antlers/lexer.rb

@@ -22,7 +22,8 @@ module Antlers
       sequence = []
 
       # Split on delimiters and retain capture groups.
-      segments = template.split(/(#{Regexp.union(@delimiters)})/).map(&:strip)
+      # Whitespace inside the template is kept, but not around it, like the indentation of a template in a method body.
+      segments = template.strip.split(/(#{Regexp.union(@delimiters)})/)
 
       until segments[@cursor].nil?
         if (segment = antlers_segment(segments:))
@@ -50,6 +51,7 @@ module Antlers
     end
 
     def antlers_lexeme(segment:, segments:)
+      segment = segment.strip
       name, props, keywords = parse_antlers_segment(segment:)
 
       return @var_lexeme.lexeme(segment:, raw: false) if @var_lexeme && brackets?(segments:)
@@ -73,7 +75,7 @@ module Antlers
 
       while (keyword = keywords.shift)
         keyword.strip!
-        value = keyword.end_with?(':') && value?(keywords.first.strip) ? keywords.shift.strip : nil
+        value = keyword.end_with?(':') && value?(keywords.first) ? keywords.shift.strip : nil
         key_values[keyword] = value
       end
 
@@ -81,7 +83,9 @@ module Antlers
     end
 
     def value?(string)
-      !(string.start_with?(':') || string.end_with?(':'))
+      # Support keywords without a value like "<{ form: }>" whose value will become an empty string.
+      string = string.to_s.strip
+      !string.empty? && !(string.start_with?(':') || string.end_with?(':'))
     end
 
     def brackets?(segments:)

data/lib/antlers/parser.rb

@@ -36,7 +36,13 @@ module Antlers
 
     def sub_branch(node:, sequence:, end_key:, end_name: nil)
       sub_sequence = []
-      sub_sequence << sequence.shift until sequence.first.is_a?(Hash) && sequence.first[end_key] == end_name
+
+      until sequence.first.is_a?(Hash) && sequence.first[end_key] == end_name
+        raise ParserError, "Missing end tag for #{node.class}" if sequence.empty?
+
+        sub_sequence << sequence.shift
+      end
+
       # Remove the end tag we just stopped before.
       sequence.shift
 

data/lib/antlers/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Antlers
-  VERSION = '1.1.0'
+  VERSION = '1.2.0'
 end

data/lib/antlers.rb

@@ -7,7 +7,7 @@ require_relative 'antlers/parser'
 module Antlers
   module_function
 
-  DEFAULT_ELEMENTS = %i[root html form for if prop slot yield var]
+  DEFAULT_ELEMENTS = %i[root html form for if prop slot yield var].freeze
 
   def ast(template:, namespace: nil, elements: Elements[*DEFAULT_ELEMENTS])
     sequence = Lexer.new(lexeme_types: elements[:lexeme]).parse(template:)

data/lib/interfaces/lexeme.rb

@@ -2,7 +2,7 @@
 
 module Antlers
   module Lexeme
-    KEYWORDS = []
+    KEYWORDS = [].freeze
 
     def match?(name: nil, keywords: {}) = false
 

data/lib/lexemes/form_lexeme.rb

@@ -14,10 +14,7 @@ module Antlers
     end
 
     def lexeme(keywords:, **)
-      if keywords.key?('form:')
-        action = keywords['form:'] ? keywords['form:'][1...-1] : nil
-        return { form_def: action }
-      end
+      return { form_def: keywords['form:'] } if keywords.key?('form:')
 
       { form_end: 'level_1' }
     end

data/lib/lexemes/var_lexeme.rb

@@ -9,15 +9,12 @@ module Antlers
     extend Queries
     extend self
 
-    # Variables are special and are matched by the lexer.
+    # Variables are special and are matched by the lexer in a hard-coded fashion.
     def match?(**)
       false
     end
 
     def lexeme(segment:, raw:, **)
-      # String is already interpolated or not depending on user input on the template layer, now we store it without those template quotes.
-      segment = segment[1..-2] if Queries.user_defined_string?(segment)
-
       return { raw_var: segment } if raw
 
       { var: segment }

data/lib/modules/props.rb

@@ -22,7 +22,7 @@ module Antlers
       evaluated_props = {}
 
       props.each do |name, value|
-        evaluated_props[name] = evaluate(name: value, current_binding:) || fallback(value)
+        evaluated_props[name] = evaluate(value:, current_binding:)
       end
 
       evaluated_props

data/lib/modules/variables.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'erb'
 require_relative '../support/queries'
 
 module Antlers
@@ -7,28 +8,29 @@ module Antlers
     extend Queries
 
     # Evaluation limited to the following for security and to stop a templating language becoming a programming language.
-    #  1. An instance variable
-    #  2. A method call/local variable
-    #  3. A method chain
-    #  4. A static string
-    def evaluate(name:, current_binding:)
-      return name.to_s unless current_binding
+    #  1. A static string
+    #  2. An instance variable
+    #  3. A method call/local variable
+    #  4. A method chain
+    def evaluate(value:, current_binding:, escape: true)
+      result = result(value:, current_binding:)
 
-      name, *chain = name.split('.')
+      return ERB::Util.html_escape(result) if escape
+
+      result
+    end
+
+    def result(value:, current_binding:)
+      return value[1..-2] if Queries.user_defined_string?(value)
+      return value unless current_binding
+
+      name, *chain = value.split('.')
 
       result = method_var(name:, current_binding:)
       return method_chain(result:, chain:) if chain.count > 0
       return result if result
 
       nil
-    rescue StandardError
-      nil
-    end
-
-    def fallback(value)
-      return value[1..-2] if Queries.user_defined_string?(value)
-
-      value
     end
 
     private

data/lib/nodes/for_node.rb

@@ -23,7 +23,7 @@ module Antlers
     def render(current_binding: nil, parent_binding: nil, slot_node: nil, metadata: {})
       output = ''
 
-      evaluate(name: @items, current_binding:).each do |value|
+      evaluate(value: @items, current_binding:, escape: false).each do |value|
         key, value = value if @key
 
         # TODO: Parallelize by creating new bindings and ensuring children have any args they need via RenderEvent.

data/lib/nodes/form_node.rb

@@ -20,7 +20,7 @@ module Antlers
     end
 
     def render(current_binding: nil, parent_binding: nil, slot_node: nil, metadata: {})
-      output = "<form action='#{@action}' method='#{@method}'>"
+      output = "<form action='#{action(current_binding:)}' method='#{@method}'>"
 
       @children.each do |child|
         output += child.render(current_binding:, parent_binding:, slot_node:, metadata:) || ''
@@ -30,9 +30,17 @@ module Antlers
       output
     end
 
+    private
+
+    def action(current_binding:)
+      return if @action.nil?
+
+      evaluate(value: @action, current_binding:)
+    end
+
     class << self
       def match?(segment:)
-        segment[DEF_KEY]
+        segment.is_a?(Hash) && segment.key?(DEF_KEY)
       end
 
       def build(segment:, **)

data/lib/nodes/if_node.rb

@@ -21,7 +21,7 @@ module Antlers
     def render(current_binding: nil, parent_binding: nil, slot_node: nil, metadata: {})
       output = ''.dup
 
-      if evaluate(name: @value, current_binding:)
+      if evaluate(value: @value, current_binding:, escape: false)
         @children.each do |child|
           output += child.render(current_binding:, parent_binding:, slot_node:, metadata:) || ''
         end

data/lib/nodes/var_node.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'erb'
-
 require_relative '../interfaces/leaf_node'
 require_relative '../modules/variables'
 
@@ -19,11 +17,7 @@ module Antlers
     end
 
     def render(current_binding: nil, parent_binding: nil, slot_node: nil, metadata: {})
-      result = evaluate(name: @value, current_binding:) || fallback(@value)
-
-      return result if @raw
-
-      ERB::Util.html_escape(result)
+      evaluate(value: @value, current_binding:, escape: !@raw).to_s
     end
 
     class << self
@@ -32,7 +26,7 @@ module Antlers
       end
 
       def build(segment:, **)
-        new(value: segment[:var] || segment[:raw_var], raw: !!segment[:raw_var])
+        new(value: segment[:var] || segment[:raw_var], raw: !segment[:raw_var].nil?)
       end
     end
   end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: antlers
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - maedi
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: erb
@@ -108,7 +108,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Templating language inside HTML inside Ruby
 test_files: []