cataract 0.1.3 → 0.2.0

data/lib/cataract/import_statement.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Cataract
+  # Represents a CSS @import statement
+  #
+  # @import statements are parsed and stored separately in the stylesheet's @_imports array.
+  # They can later be resolved by the ImportResolver to fetch and inline the imported CSS.
+  #
+  # Per CSS spec, @import must appear before all rules except @charset and @layer.
+  # Any @import that appears after a style rule is invalid and will be ignored with a warning.
+  #
+  # @example Basic import
+  #   @import "styles.css";
+  #   # => ImportStatement(url: "styles.css", media: nil)
+  #
+  # @example Import with media query
+  #   @import "mobile.css" screen and (max-width: 768px);
+  #   # => ImportStatement(url: "mobile.css", media: :"screen and (max-width: 768px)")
+  #
+  # @attr [Integer] id The import's position in the source (0-indexed)
+  # @attr [String] url The URL to import (without quotes or url() wrapper)
+  # @attr [Symbol, nil] media The media query as a symbol, or nil if no media query
+  # @attr [Boolean] resolved Whether this import has been resolved/processed
+  ImportStatement = Struct.new(:id, :url, :media, :resolved) unless const_defined?(:ImportStatement)
+
+  class ImportStatement
+    # Compare two ImportStatement objects for equality.
+    # Two imports are equal if they have the same URL and media query.
+    # The ID is ignored as it's an implementation detail.
+    #
+    # @param other [Object] Object to compare with
+    # @return [Boolean] true if equal, false otherwise
+    def ==(other)
+      return false unless other.is_a?(ImportStatement)
+
+      url == other.url && media == other.media
+    end
+
+    alias eql? ==
+
+    # Generate hash code for ImportStatement.
+    # Uses URL and media query (ignores ID).
+    #
+    # @return [Integer] Hash code
+    def hash
+      [url, media].hash
+    end
+  end
+end

data/lib/cataract/pure/byte_constants.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# Pure Ruby CSS parser - Byte constants for fast parsing
+# Using getbyte() instead of String#[] to avoid allocating millions of string objects
+
+module Cataract
+  # Whitespace bytes
+  BYTE_SPACE     = 32  # ' '
+  BYTE_TAB       = 9   # '\t'
+  BYTE_NEWLINE   = 10  # '\n'
+  BYTE_CR        = 13  # '\r'
+
+  # CSS structural characters
+  BYTE_AT        = 64  # '@'
+  BYTE_LBRACE    = 123 # '{'
+  BYTE_RBRACE    = 125 # '}'
+  BYTE_LPAREN    = 40  # '('
+  BYTE_RPAREN    = 41  # ')'
+  BYTE_LBRACKET  = 91  # '['
+  BYTE_RBRACKET  = 93  # ']'
+  BYTE_SEMICOLON = 59  # ';'
+  BYTE_COLON     = 58  # ':'
+  BYTE_COMMA     = 44  # ','
+
+  # Comment characters
+  BYTE_SLASH     = 47  # '/'
+  BYTE_STAR      = 42  # '*'
+
+  # Quote characters
+  BYTE_SQUOTE    = 39  # "'"
+  BYTE_DQUOTE    = 34  # '"'
+
+  # Selector characters
+  BYTE_HASH      = 35  # '#'
+  BYTE_DOT       = 46  # '.'
+  BYTE_GT        = 62  # '>'
+  BYTE_PLUS      = 43  # '+'
+  BYTE_TILDE     = 126 # '~'
+  BYTE_ASTERISK  = 42  # '*'
+  BYTE_AMPERSAND = 38  # '&'
+
+  # Other
+  BYTE_HYPHEN     = 45 # '-'
+  BYTE_UNDERSCORE = 95 # '_'
+  BYTE_BACKSLASH  = 92 # '\\'
+  BYTE_BANG       = 33 # '!'
+  BYTE_PERCENT    = 37 # '%'
+  BYTE_SLASH_FWD  = 47 # '/' (also defined as BYTE_SLASH above)
+
+  # Specific lowercase letters (for keyword matching)
+  BYTE_LOWER_U    = 117 # 'u'
+  BYTE_LOWER_R    = 114 # 'r'
+  BYTE_LOWER_L    = 108 # 'l'
+
+  # Letter ranges (a-z, A-Z)
+  BYTE_LOWER_A   = 97  # 'a'
+  BYTE_LOWER_Z   = 122 # 'z'
+  BYTE_UPPER_A   = 65  # 'A'
+  BYTE_UPPER_Z   = 90  # 'Z'
+  BYTE_CASE_DIFF = 32  # Difference between lowercase and uppercase ('a' - 'A')
+
+  # Digit range (0-9)
+  BYTE_DIGIT_0   = 48  # '0'
+  BYTE_DIGIT_9   = 57  # '9'
+
+  # Nesting styles (for CSS nesting support)
+  NESTING_STYLE_IMPLICIT = 0  # Implicit nesting: .parent { .child { ... } } => .parent .child
+  NESTING_STYLE_EXPLICIT = 1  # Explicit nesting: .parent { &:hover { ... } } => .parent:hover
+end