parselly 0.1.0 → 1.0.0

data/lib/parselly/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Parselly
+  VERSION = '1.0.0'
+end

data/lib/parselly.rb

@@ -2,18 +2,19 @@
 
 require 'strscan'
 
-class Parselly
-  VERSION = "0.1.0"
+require_relative 'parselly/lexer'
+require_relative 'parselly/node'
+require_relative 'parselly/parser'
+require_relative 'parselly/version'
 
-  def self.sanitize(selector)
+module Parselly
+  def sanitize(selector)
     scanner = StringScanner.new(selector)
     result = +''
 
     # Special case: if the selector is of length 1 and
     # the first character is `-`
-    if selector.length == 1 && scanner.peek(1) == '-'
-      return "\\#{selector}"
-    end
+    return "\\#{selector}" if selector.length == 1 && scanner.peek(1) == '-'
 
     until scanner.eos?
       # NULL character (U+0000)
@@ -27,7 +28,7 @@ class Parselly
         result << escaped_hex(scanner.matched)
       # Second character is a digit and first is `-`
       elsif scanner.pos == 1 && scanner.scan(/\d/) &&
-          scanner.pre_match == '-'
+            scanner.pre_match == '-'
         result << escaped_hex(scanner.matched)
       # Alphanumeric characters, `-`, `_`
       elsif scanner.scan(/[a-zA-Z0-9\-_]/)
@@ -41,8 +42,9 @@ class Parselly
     result
   end
 
-  def self.escaped_hex(char)
+  def escaped_hex(char)
     "\\#{char.ord.to_s(16)} "
   end
-  private_class_method :escaped_hex
+
+  module_function :sanitize, :escaped_hex
 end

data/parser.y

@@ -0,0 +1,372 @@
+class Parselly::Parser
+  expect 0
+  error_on_expect_mismatch
+  token IDENT STRING NUMBER
+        HASH DOT STAR
+        LBRACKET RBRACKET
+        LPAREN RPAREN
+        COLON COMMA
+        CHILD ADJACENT SIBLING DESCENDANT
+        EQUAL INCLUDES DASHMATCH
+        PREFIXMATCH SUFFIXMATCH SUBSTRINGMATCH
+        MINUS
+
+  # Precedence rules to resolve shift/reduce conflicts in an_plus_b grammar
+  # These rules ensure that in patterns like "2n+1" or "n-3", the operators
+  # (+/-) are shifted rather than reducing early. This allows proper parsing
+  # of An+B notation used in :nth-child() and similar pseudo-classes.
+  # Lower precedence comes first
+  prechigh
+    left ADJACENT MINUS  # In an_plus_b context, shift these operators
+    nonassoc IDENT       # Prevent premature reduction when IDENT follows NUMBER
+  preclow
+rule
+  selector_list
+    : complex_selector (COMMA complex_selector)*
+      {
+        result = Node.new(:selector_list, nil, @current_position)
+        result.add_child(val[0])
+        val[1].each { |pair| result.add_child(pair[1]) }
+      }
+    ;
+
+  complex_selector
+    : compound_selector (combinator compound_selector)*
+      {
+        if val[1].empty?
+          result = val[0]
+        else
+          result = val[0]
+          val[1].each do |pair|
+            node = Node.new(:selector, nil, result.position)
+            node.add_child(result)
+            node.add_child(pair[0])
+            node.add_child(pair[1])
+            result = node
+          end
+        end
+      }
+    ;
+
+  combinator
+    : CHILD
+      { result = Node.new(:child_combinator, '>', @current_position) }
+    | ADJACENT
+      { result = Node.new(:adjacent_combinator, '+', @current_position) }
+    | SIBLING
+      { result = Node.new(:sibling_combinator, '~', @current_position) }
+    | DESCENDANT
+      { result = Node.new(:descendant_combinator, ' ', @current_position) }
+    ;
+
+  compound_selector
+    : simple_selector_head simple_selector_tail
+      {
+        result = Node.new(:simple_selector_sequence, nil, val[0].position)
+        result.add_child(val[0])
+        val[1].each { |sel| result.add_child(sel) } unless val[1].empty?
+      }
+    ;
+
+  simple_selector_head
+    : type_selector
+      { result = val[0] }
+    | subclass_selector
+      { result = val[0] }
+    ;
+
+  simple_selector_tail
+    : subclass_selector*
+      { result = val[0] }
+    ;
+
+  type_selector
+    : IDENT
+      { result = Node.new(:type_selector, val[0], @current_position) }
+    | STAR
+      { result = Node.new(:universal_selector, '*', @current_position) }
+    ;
+
+  subclass_selector
+    : id_selector
+      { result = val[0] }
+    | class_selector
+      { result = val[0] }
+    | attribute_selector
+      { result = val[0] }
+    | pseudo_class_selector
+      { result = val[0] }
+    | pseudo_element_selector
+      { result = val[0] }
+    ;
+
+  id_selector
+    : HASH IDENT
+      { result = Node.new(:id_selector, val[1], @current_position) }
+    ;
+
+  class_selector
+    : DOT IDENT
+      { result = Node.new(:class_selector, val[1], @current_position) }
+    ;
+
+  attribute_selector
+    : LBRACKET IDENT RBRACKET
+      { result = Node.new(:attribute_selector, val[1], @current_position) }
+    | LBRACKET IDENT attr_matcher STRING RBRACKET
+      {
+        result = Node.new(:attribute_selector, nil, @current_position)
+        result.add_child(Node.new(:attribute, val[1], @current_position))
+        result.add_child(val[2])
+        result.add_child(Node.new(:value, val[3], @current_position))
+      }
+    | LBRACKET IDENT attr_matcher IDENT RBRACKET
+      {
+        result = Node.new(:attribute_selector, nil, @current_position)
+        result.add_child(Node.new(:attribute, val[1], @current_position))
+        result.add_child(val[2])
+        result.add_child(Node.new(:value, val[3], @current_position))
+      }
+    ;
+
+  attr_matcher
+    : EQUAL
+      { result = Node.new(:equal_operator, '=', @current_position) }
+    | INCLUDES
+      { result = Node.new(:includes_operator, '~=', @current_position) }
+    | DASHMATCH
+      { result = Node.new(:dashmatch_operator, '|=', @current_position) }
+    | PREFIXMATCH
+      { result = Node.new(:prefixmatch_operator, '^=', @current_position) }
+    | SUFFIXMATCH
+      { result = Node.new(:suffixmatch_operator, '$=', @current_position) }
+    | SUBSTRINGMATCH
+      { result = Node.new(:substringmatch_operator, '*=', @current_position) }
+    ;
+
+  pseudo_class_selector
+    : COLON IDENT
+      { result = Node.new(:pseudo_class, val[1], @current_position) }
+    | COLON IDENT LPAREN any_value RPAREN
+      {
+        fn = Node.new(:pseudo_function, val[1], @current_position)
+        fn.add_child(val[3])
+        result = fn
+      }
+    ;
+
+  pseudo_element_selector
+    : COLON COLON IDENT
+      { result = Node.new(:pseudo_element, val[2], @current_position) }
+    ;
+
+  any_value
+    : STRING
+      { result = Node.new(:argument, val[0], @current_position) }
+    | an_plus_b
+      { result = val[0] }
+    | relative_selector_list
+      { result = val[0] }
+    ;
+
+  an_plus_b
+    # Positive coefficient cases
+    : NUMBER IDENT ADJACENT NUMBER
+      {
+        # Handle 'An+B' like '2n+1'
+        result = Node.new(:an_plus_b, "#{val[0]}#{val[1]}+#{val[3]}", @current_position)
+      }
+    | NUMBER IDENT MINUS NUMBER
+      {
+        # Handle 'An-B' like '2n-1'
+        result = Node.new(:an_plus_b, "#{val[0]}#{val[1]}-#{val[3]}", @current_position)
+      }
+    | NUMBER IDENT
+      {
+        # Handle 'An' like '2n' or composite like '2n-1' (when '-1' is part of IDENT)
+        result = Node.new(:an_plus_b, "#{val[0]}#{val[1]}", @current_position)
+      }
+    | IDENT ADJACENT NUMBER
+      {
+        # Handle 'n+B' like 'n+5' or keywords followed by offset (rare but valid)
+        result = Node.new(:an_plus_b, "#{val[0]}+#{val[2]}", @current_position)
+      }
+    | IDENT MINUS NUMBER
+      {
+        # Handle 'n-B' like 'n-3'
+        result = Node.new(:an_plus_b, "#{val[0]}-#{val[2]}", @current_position)
+      }
+    # Negative coefficient cases
+    | MINUS NUMBER IDENT ADJACENT NUMBER
+      {
+        # Handle '-An+B' like '-2n+1'
+        result = Node.new(:an_plus_b, "-#{val[1]}#{val[2]}+#{val[4]}", @current_position)
+      }
+    | MINUS NUMBER IDENT MINUS NUMBER
+      {
+        # Handle '-An-B' like '-2n-1'
+        result = Node.new(:an_plus_b, "-#{val[1]}#{val[2]}-#{val[4]}", @current_position)
+      }
+    | MINUS NUMBER IDENT
+      {
+        # Handle '-An' like '-2n' or composite like '-2n+1' (when '+1' is part of IDENT)
+        result = Node.new(:an_plus_b, "-#{val[1]}#{val[2]}", @current_position)
+      }
+    | MINUS IDENT ADJACENT NUMBER
+      {
+        # Handle '-n+B' like '-n+3'
+        result = Node.new(:an_plus_b, "-#{val[1]}+#{val[3]}", @current_position)
+      }
+    | MINUS IDENT MINUS NUMBER
+      {
+        # Handle '-n-B' like '-n-2'
+        result = Node.new(:an_plus_b, "-#{val[1]}-#{val[3]}", @current_position)
+      }
+    | MINUS IDENT
+      {
+        # Handle '-n' or composite like '-n+3' (when '+3' is part of IDENT)
+        result = Node.new(:an_plus_b, "-#{val[1]}", @current_position)
+      }
+    # Simple cases
+    | NUMBER
+      {
+        # Handle just a number like '3'
+        result = Node.new(:an_plus_b, val[0].to_s, @current_position)
+      }
+    ;
+
+  relative_selector_list
+    : relative_selector (COMMA relative_selector)*
+      {
+        result = Node.new(:selector_list, nil, @current_position)
+        result.add_child(val[0])
+        val[1].each { |pair| result.add_child(pair[1]) }
+      }
+    ;
+
+  relative_selector
+    : complex_selector
+      { result = val[0] }
+    | combinator complex_selector
+      {
+        result = Node.new(:selector, nil, val[0].position)
+        result.add_child(val[0])
+        result.add_child(val[1])
+      }
+    ;
+
+end
+
+---- header
+
+---- inner
+def parse(input)
+  @lexer = Parselly::Lexer.new(input)
+  @tokens = @lexer.tokenize
+  preprocess_tokens!
+  @index = 0
+  @current_position = { line: 1, column: 1 }
+  ast = do_parse
+  normalize_an_plus_b(ast)
+  ast
+end
+
+def preprocess_tokens!
+  new_tokens = []
+  i = 0
+  while i < @tokens.size
+    token = @tokens[i]
+    next_token = @tokens[i + 1]
+    new_tokens << token
+    if next_token && needs_descendant?(token, next_token)
+      pos = { line: token[2][:line], column: token[2][:column] }
+      new_tokens << [:DESCENDANT, ' ', pos]
+    end
+    i += 1
+  end
+
+  @tokens = new_tokens
+end
+
+# Insert DESCENDANT combinator if:
+# - Current token can end a compound selector
+# - Next token can start a compound selector
+# - EXCEPT when current is type_selector and next is subclass_selector
+#   (they belong to the same compound selector)
+def needs_descendant?(current, next_tok)
+  current_type = current[0]
+  next_type = next_tok[0]
+
+  can_end = can_end_compound?(current_type)
+  can_start = can_start_compound?(next_type)
+
+  # Type selector followed by subclass selector = same compound
+  if [:IDENT, :STAR].include?(current_type) &&
+     [:DOT, :HASH, :LBRACKET, :COLON].include?(next_type)
+    return false
+  end
+
+  can_end && can_start
+end
+
+def can_end_compound?(token_type)
+  [:IDENT, :STAR, :RPAREN, :RBRACKET].include?(token_type)
+end
+
+def can_start_compound?(token_type)
+  # Type selectors and subclass selectors can start a compound selector
+  [:IDENT, :STAR, :DOT, :HASH, :LBRACKET, :COLON].include?(token_type)
+end
+
+def normalize_an_plus_b(node)
+  return unless node.respond_to?(:children) && node.children
+
+  if node.type == :pseudo_function && nth_pseudo?(node.value)
+    child = node.children.first
+    if child && child.type == :selector_list
+      an_plus_b_value = extract_an_plus_b_value(child)
+      if an_plus_b_value
+        node.children[0] = Node.new(:an_plus_b, an_plus_b_value, child.position)
+      end
+    end
+  end
+  node.children.compact.each { |child| normalize_an_plus_b(child) }
+end
+
+def nth_pseudo?(name)
+  %w[nth-child nth-last-child nth-of-type nth-last-of-type nth-col nth-last-col].include?(name)
+end
+
+def extract_an_plus_b_value(selector_list_node)
+  return nil unless selector_list_node.children.size == 1
+
+  seq = selector_list_node.children.first
+  return nil unless seq.type == :simple_selector_sequence
+  return nil unless seq.children.size == 1
+
+  type_sel = seq.children.first
+  return nil unless type_sel.type == :type_selector
+
+  value = type_sel.value
+  if value =~ /^(even|odd|[+-]?\d*n(?:[+-]\d+)?|[+-]?n(?:[+-]\d+)?|\d+)$/
+    value
+  else
+    nil
+  end
+end
+
+def next_token
+  return [false, nil] if @index >= @tokens.size
+
+  token_type, token_value, token_position = @tokens[@index]
+  @index += 1
+  @current_position = token_position
+
+  [token_type, token_value]
+end
+
+def on_error(token_id, val, vstack)
+  token_name = token_to_str(token_id) || '?'
+  pos = @current_position || { line: '?', column: '?' }
+  raise "Parse error: unexpected #{token_name} '#{val}' at #{pos[:line]}:#{pos[:column]}"
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: parselly
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Yudai Takada
 bindir: exe
 cert_chain: []
-date: 2025-01-24 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Parselly is a pure Ruby CSS selector parser. Provides a simple and easy-to-use
   API for parsing CSS selectors.
@@ -17,10 +17,16 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".rspec"
 - MIT
 - README.md
 - Rakefile
 - lib/parselly.rb
+- lib/parselly/lexer.rb
+- lib/parselly/node.rb
+- lib/parselly/parser.rb
+- lib/parselly/version.rb
+- parser.y
 homepage: https://github.com/ydah/parselly
 licenses:
 - MIT
@@ -38,14 +44,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.0.dev
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Pure Ruby CSS selector parser.
 test_files: []