deadfire 0.2.0 → 0.4.0

data/lib/deadfire/interpreter.rb

@@ -0,0 +1,84 @@
+# Frozen_string_literal: true
+
+module Deadfire
+  class Interpreter # :nodoc:
+    singleton_class.attr_accessor :cached_apply_rules
+    self.cached_apply_rules = Hash.new { |h, k| h[k] = nil }
+
+    def initialize(error_reporter)
+      @error_reporter = error_reporter
+    end
+
+    def interpret(node)
+      node.accept(self)
+    end
+
+    def visit_stylesheet_node(node)
+      node.statements.each { |child| child.accept(self) }
+    end
+
+    def visit_at_rule_node(node)
+      if node.block
+        visit_block_node(node.block, node)
+      end
+    end
+
+    def visit_ruleset_node(node)
+      if node.block
+        visit_block_node(node.block, node)
+
+        unless Interpreter.cached_apply_rules[node.selector.selector]
+          Interpreter.cached_apply_rules[node.selector.selector] = node.block if node.selector.cacheable?
+        end
+      end
+    end
+
+    def visit_block_node(node, parent)
+      node.declarations.each do |declaration|
+        case declaration
+        when ApplyNode
+          apply_mixin(declaration, node)
+        else
+          # we may not need to visit this as we don't process/transform/optimize
+        end
+      end
+    end
+
+    def visit_comment_node(node)
+      # node.accept(self)
+    end
+
+    def visit_apply_node(node)
+      # do nothing for now
+    end
+
+    def visit_newline_node(node)
+    end
+
+    private
+
+    def apply_mixin(mixin, node)
+      updated_declarations = []
+      mixin.mixin_names.each do |mixin_name|
+        if Interpreter.cached_apply_rules[mixin_name]
+          cached_block = Interpreter.cached_apply_rules[mixin_name]
+
+          # NOTE: remove the left and right brace but we probably don't need to do this, how can this be simplified?
+          cached_block.declarations[1...-1].each do |cached_declaration|
+            updated_declarations << cached_declaration
+          end
+          updated_declarations.shift if updated_declarations.first.type == :newline
+          updated_declarations.pop if updated_declarations.last.type == :newline
+        else
+          @error_reporter.error(mixin.lineno, "Mixin #{mixin_name} not found") # TODO: we need the declarations lineno, not the block
+        end
+      end
+
+      if updated_declarations.any?
+        index = node.declarations.index(mixin)
+        node.declarations.delete_at(index)
+        node.declarations.insert(index, *updated_declarations)
+      end
+    end
+  end
+end

data/lib/deadfire/parser_engine.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Deadfire
+  class ParserEngine # :nodoc:
+    attr_reader :error_reporter, :options, :current
+
+    def initialize(content, options = {})
+      @error_reporter = ErrorReporter.new
+      @options = {}
+      @scanner = FrontEnd::Scanner.new(content, error_reporter)
+    end
+
+    def parse
+      ast = _parse
+      interpreter = Interpreter.new(error_reporter)
+      ast.statements.each do |node|
+        interpreter.interpret(node)
+      end
+      CssGenerator.new(ast).generate
+    end
+
+    def print_ast
+      ast = _parse
+      printer = AstPrinter.new
+      ast.statements.each do |node|
+        printer.print(node)
+      end
+    end
+
+    def errors?
+      @error_reporter.errors?
+    end
+
+    private
+
+    def _parse
+      tokens = @scanner.tokenize
+      FrontEnd::Parser.new(tokens, error_reporter).parse
+    end
+  end
+end

data/lib/deadfire/spec.rb

@@ -0,0 +1,135 @@
+module Deadfire
+  class Spec # :nodoc:
+    # EBNF
+    # stylesheet         = [ CDO | CDC | S | statement ]*;
+    # statement          = ruleset | at-rule;
+    # at-rule            = ATKEYWORD S* any-value* [ block | ';' S* ];
+    # block              = '{' S* [ S* (declaration | at-rule) ]* '}' S*;
+    # ruleset            = selector [ ',' S* selector ]* S* '{' S* declaration [ ';' S* declaration ]* '}' S*;
+    # selector           = simple-selector [ combinator selector | S+ [ combinator? selector ]? ];
+    # simple-selector    = element-name? [ '#' id-selector ]? [ '.' class-selector ]* [ '[' attrib-selector ']' ]*;
+    # id-selector        = NAME;
+    # class-selector     = '.' NAME;
+    # attrib-selector    = NAME [ [ '=' | INCLUDES | DASHMATCH ] any-value ]?;
+    # combinator         = '+' | '>' | '~' | S+;
+    # declaration        = property ':' S* value;
+    # property           = NAME;
+    # value              = any-value [ ',' S* any-value ]*;
+    # any-value          = IDENT | STRING | NUMBER | PERCENTAGE | DIMENSION | COLOR | URI | FUNCTION any-value* ')' | '(' any-value* ')' | '[' any-value* ']' | '{' any-value* '}' | ';';
+
+    CHARSET = "@charset"
+    IMPORT = "@import"
+    MEDIA = "@media"
+    PAGE = "@page"
+    FONT_FACE = "@font-face"
+    KEYFRAMES = "@keyframes"
+    SUPPORTS = "@supports"
+    NAMESPACE = "@namespace"
+    COUNTER_STYLE = "@counter-style"
+    VIEWPORT = "@viewport"
+    DOCUMENT = "@document"
+    APPLY = "@apply"
+    LAYER = "@layer"
+
+    CSS_AT_RULES = [
+      CHARSET,
+      IMPORT,
+      MEDIA,
+      PAGE,
+      FONT_FACE,
+      KEYFRAMES,
+      SUPPORTS,
+      NAMESPACE,
+      COUNTER_STYLE,
+      VIEWPORT,
+      DOCUMENT,
+      APPLY,
+      LAYER
+    ]
+
+    CSS_SELECTORS = [
+      ":root",
+      "::before",
+      "::after",
+      ":hover",
+      ":active",
+      ":focus",
+      ":first-child",
+      ":last-child",
+      ":nth-child(n)",
+      ":nth-last-child(n)",
+      ":only-child",
+      ":only-of-type",
+      ":first-of-type",
+      ":last-of-type",
+      ":nth-of-type(n)",
+      ":nth-last-of-type(n)",
+      ":checked",
+      ":disabled",
+      ":enabled",
+      ":empty",
+      "::first-line",
+      "::first-letter",
+      "::selection",
+      "~",
+      "+",
+      ">",
+      " ",
+      ".class",
+      "#id",
+      "[attribute]",
+      "[attribute=value]",
+      "[attribute~=value]",
+      "[attribute|=value]",
+      "[attribute^=value]",
+      "[attribute$=value]",
+      "[attribute*=value]",
+      ":not(selector)",
+      ":matches(selector)",
+      ":any(selector)",
+      ":has(selector)",
+      "::placeholder"
+    ]
+
+    CSS_POTENTIAL_VALUES_TYPES = [
+      :length_and_size, # e.g. 5px or 5em
+      :color, # e.g. hex codes, RGB and RGBA values, HSL and HSLA values, and named colors - #fff
+      :textual, # strings, keywords, and URLs - bold, url, etc.
+      :enumerated, # e.g. inline, block, list-item, etc.
+      :functional, # e.g.  calc(), attr(), and var() - calc(100% - 10px)
+      :other # everything else like inherit, initial, unset
+    ]
+
+    COMMON_CSS_PROPERTIES = [
+      "color",
+      "background-color",
+      "background-image",
+      "border",
+      "border-radius",
+      "box-shadow",
+      "font-family",
+      "font-size",
+      "font-weight",
+      "letter-spacing",
+      "line-height",
+      "margin",
+      "padding",
+      "text-align",
+      "text-decoration",
+      "text-transform",
+      "width",
+      "height",
+      "display",
+      "flex",
+      "flex-direction",
+      "justify-content",
+      "align-items",
+      "position",
+      "top",
+      "right",
+      "bottom",
+      "left",
+      "z-index"
+    ]
+  end
+end

data/lib/deadfire/version.rb

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

data/lib/deadfire.rb

@@ -1,28 +1,55 @@
 # frozen_string_literal: true
 
-require_relative "deadfire/css_buffer"
+require_relative "deadfire/ast_printer"
+require_relative "deadfire/css_generator"
 require_relative "deadfire/configuration"
 require_relative "deadfire/errors"
-require_relative "deadfire/parser"
-require_relative "deadfire/transformers/transformer"
+require_relative "deadfire/error_reporter"
+require_relative "deadfire/interpreter"
+require_relative "deadfire/parser_engine"
+require_relative "deadfire/spec"
+require_relative "deadfire/filename_helper"
 require_relative "deadfire/version"
+require_relative "deadfire/front_end/scanner"
+require_relative "deadfire/front_end/token"
+require_relative "deadfire/front_end/parser"
+require_relative "deadfire/front_end/base_node"
+require_relative "deadfire/front_end/apply_node"
+require_relative "deadfire/front_end/at_rule_node"
+require_relative "deadfire/front_end/block_node"
+require_relative "deadfire/front_end/comment_node"
+require_relative "deadfire/front_end/newline_node"
+require_relative "deadfire/front_end/ruleset_node"
+require_relative "deadfire/front_end/selector_node"
+require_relative "deadfire/front_end/stylesheet_node"
 
 module Deadfire
+  PERMISSIBLE_FILE_EXTENSIONS = [".css", ".scss"].freeze
+
   class << self
+    attr_reader :config
+
     def configuration
-      @configuration ||= Configuration.new
+      @config ||= Configuration.new
     end
 
     def reset
-      @configuration = Configuration.new
+      @config = Configuration.new
     end
 
     def configure
-      yield(@configuration)
+      yield(configuration)
     end
 
     def parse(content, options = {})
-      Parser.parse(content, options)
+      configure do |config|
+        config.root_path = options[:root_path]
+        config.compressed = options[:compressed]
+      end
+
+      parser = ParserEngine.new(content)
+      # TODO: hook into a logger and report the errors
+      parser.parse
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: deadfire
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Haroon Ahmed
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-10-25 00:00:00.000000000 Z
+date: 2024-05-18 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -31,17 +31,34 @@ files:
 - benchmarks/output.css.map
 - benchmarks/profilng.rb
 - benchmarks/tailwind.css
+- benchmarks/tailwind_parser.rb
 - bin/console
 - bin/setup
 - bin/test
 - changelog.md
 - deadfire.gemspec
 - lib/deadfire.rb
+- lib/deadfire/ast_printer.rb
 - lib/deadfire/configuration.rb
-- lib/deadfire/css_buffer.rb
+- lib/deadfire/css_generator.rb
+- lib/deadfire/error_reporter.rb
 - lib/deadfire/errors.rb
-- lib/deadfire/parser.rb
-- lib/deadfire/transformers/transformer.rb
+- lib/deadfire/filename_helper.rb
+- lib/deadfire/front_end/apply_node.rb
+- lib/deadfire/front_end/at_rule_node.rb
+- lib/deadfire/front_end/base_node.rb
+- lib/deadfire/front_end/block_node.rb
+- lib/deadfire/front_end/comment_node.rb
+- lib/deadfire/front_end/newline_node.rb
+- lib/deadfire/front_end/parser.rb
+- lib/deadfire/front_end/ruleset_node.rb
+- lib/deadfire/front_end/scanner.rb
+- lib/deadfire/front_end/selector_node.rb
+- lib/deadfire/front_end/stylesheet_node.rb
+- lib/deadfire/front_end/token.rb
+- lib/deadfire/interpreter.rb
+- lib/deadfire/parser_engine.rb
+- lib/deadfire/spec.rb
 - lib/deadfire/version.rb
 homepage: https://github.com/hahmed/deadfire
 licenses:
@@ -65,7 +82,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.5.6
 signing_key:
 specification_version: 4
 summary: Deadfire - lightweight css preprocessor

data/lib/deadfire/css_buffer.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-require "stringio"
-
-module Deadfire
-  class CssBuffer
-    attr_reader :lineno, :buffer
-
-    def initialize(content)
-      @content = StringIO.new(content)
-      @buffer = []
-      @lineno = 0
-    end
-
-    def gets(skip_buffer: false)
-      output = content.gets
-      if output && !skip_buffer
-        buffer << output
-      end
-      @lineno += 1
-      output
-    end
-
-    def peek
-      output = content.gets
-      content.ungetc(output)
-      output
-    end
-
-    def eof?
-      content.eof?
-    end
-
-    private
-
-    attr_reader :content
-  end
-end