lookbook 1.0.8 → 1.1.0

data/lib/lookbook/tag_options.rb

@@ -0,0 +1,111 @@
+module Lookbook
+  class TagOptions
+    SYMBOL_MATCH = /(:([a-zA-Z_\d]+))$/
+    EVAL_OPTION_MATCH = /(\{\{\s?(.*)\s?\}\})$/
+    YAML_HASH_MATCH = /(\{(.*?)\})$/m
+    YAML_ARRAY_MATCH = /(\[(.*?)\])$/m
+    FILE_PATH_MATCH = /(\S+\.(json|yml))$/
+
+    MATCHERS = [YAML_ARRAY_MATCH, YAML_HASH_MATCH, SYMBOL_MATCH, EVAL_OPTION_MATCH, FILE_PATH_MATCH]
+
+    def initialize(options_str, eval_scope: nil, base_dir: nil)
+      @options_str = options_str.is_a?(String) ? options_str.strip : ""
+      @eval_scope = eval_scope
+      @base_dir = base_dir
+    end
+
+    def options
+      resolve.is_a?(Hash) ? resolve.symbolize_keys : resolve
+    end
+
+    def resolve
+      @resolved_options ||= begin
+        if @options_str.present?
+          if @options_str.end_with?(".json", ".yml")
+            file_path = resolve_file_path
+            if file_path
+              options_file_content = File.read(file_path)
+            else
+              raise "Tag options data file not found"
+            end
+          end
+          if file_path&.extname == ".json"
+            JSON.parse(options_file_content)
+          elsif file_path&.extname == ".yml"
+            YAML.safe_load(options_file_content)
+          elsif evaluatable?
+            evaluate
+          else
+            YAML.safe_load(@options_str || "{}")
+          end
+        else
+          {}
+        end
+      rescue => exception
+        Lookbook.logger.warn Lookbook::Error.new(exception)
+        {}
+      end
+    end
+
+    def resolve_file_path
+      path = if @options_str.start_with?(".") && @base_dir.present?
+        File.expand_path(@options_str, @base_dir)
+      else
+        Rails.root.join(@options_str)
+      end
+      Pathname.new path
+    end
+
+    def evaluate
+      if Lookbook.config.preview_params_options_eval == true
+        if @eval_scope.nil?
+          raise "Preview params eval must be scoped to an object"
+        else
+          @eval_scope.instance_eval(statement)
+        end
+      else
+        raise "The config option `preview_params_options_eval` must be set to `true` before param options can be evaluated at runtime"
+      end
+    end
+
+    def self.extract_options(str)
+      str ||= ""
+      str.strip!
+      opts_str = ""
+
+      MATCHERS.each do |regexp|
+        match_data = str.match(regexp)
+        unless match_data.nil?
+          str.gsub!(regexp, "").strip!
+          opts_str = match_data[1]
+          break
+        end
+      end
+
+      [str, opts_str]
+    end
+
+    def self.resolveable?(str)
+      return unless str.is_a?(String)
+      str.strip!
+      MATCHERS.each do |regexp|
+        return true if str.match?(regexp)
+      end
+      false
+    end
+
+    private
+
+    def statement
+      evaluatable? ? eval_match_data[2].strip : "{}"
+    end
+
+    def evaluatable?
+      eval_match_data.present?
+    end
+
+    def eval_match_data
+      @eval_match_data ||= @options_str.match(EVAL_OPTION_MATCH) || @options_str.match(SYMBOL_MATCH)
+    end
+  end
+end

data/lib/lookbook/tags.rb

@@ -11,11 +11,15 @@ module Lookbook
       Lookbook.config.preview_tags[name] = opts
     end
 
-    def self.process_tags(tag_objects)
+    def self.process_tags(tag_objects, file: nil, eval_scope: nil)
       return [] if tag_objects.none?
       tag_objects.map do |tag_object|
         opts = Lookbook.config.preview_tags[tag_object.tag_name] || {}
-        Lookbook::Tag.new(tag_object, opts[:args], **opts.except(:args))
+        Lookbook::Tag.new(tag_object,
+          opts[:args],
+          **opts.except(:args),
+          file: file,
+          eval_scope: eval_scope)
       end.compact
     end
   end

data/lib/lookbook/template_parser.rb

@@ -0,0 +1,72 @@
+require "css_parser"
+
+module Lookbook
+  class TemplateParser
+    STYLE_TAGS_REGEX = /<style(?:\s[^>]*)?>((?:(?!<\/style>).)*)<\/style>/m
+    FRONTMATTER_REGEX = /\A---(.|\n)*?---/
+
+    def initialize(content)
+      @raw_content = content.strip
+      @parsed_content = nil
+      @styles = nil
+      @frontmatter = nil
+    end
+
+    def content
+      parse
+      @parsed_content.strip.html_safe
+    end
+
+    def styles
+      parse
+      @styles
+    end
+
+    def frontmatter
+      parse
+      @frontmatter
+    end
+
+    private
+
+    def parse
+      if @parsed_content.nil?
+        @styles = extract_styles(@raw_content)
+        content = strip_styles(@raw_content)
+
+        @frontmatter = extract_frontmatter(content)
+        content = strip_frontmatter(content)
+
+        @parsed_content = content
+      end
+    end
+
+    def extract_styles(text)
+      styles = []
+      css_parser = ::CssParser::Parser.new
+      text.scan(STYLE_TAGS_REGEX).flatten.map(&:strip).each do |css|
+        css_parser.load_string! css.strip
+      end
+      css_parser.each_selector do |selector, declarations, specificity|
+        styles << "#{selector} { #{declarations} }"
+      end
+      styles
+    end
+
+    def strip_styles(text)
+      text.gsub(STYLE_TAGS_REGEX, "")
+    end
+
+    def extract_frontmatter(text)
+      frontmatter = {}
+      text.match(FRONTMATTER_REGEX) do |m|
+        frontmatter = YAML.safe_load(m[0])
+      end
+      frontmatter.deep_symbolize_keys
+    end
+
+    def strip_frontmatter(text)
+      text.gsub(FRONTMATTER_REGEX, "")
+    end
+  end
+end

data/lib/lookbook/theme.rb

@@ -41,7 +41,7 @@ module Lookbook
       return @css unless @css.nil?
       @css ||= if @overrides.present?
         styles = [":root {"]
-        styles << @overrides.select { |key| !key.start_with?("favicon") }.map do |key, value|
+        styles << @overrides.reject { |key| key.to_s.start_with?("favicon") }.map do |key, value|
           "  --lookbook-#{key.to_s.underscore.tr("_", "-")}: #{value};"
         end
         styles.push "}"

data/lib/lookbook/utils.rb

@@ -4,6 +4,29 @@ module Lookbook
 
     POSITION_PREFIX_REGEX = /^(\d+?)[-_]/
     FRONTMATTER_REGEX = /\A---(.|\n)*?---/
+    ACTION_VIEW_ANNOTATIONS_REGEX = /<!-- (BEGIN|END) (.*) -->/
+
+    def self.strip_action_view_annotations!(text)
+      text&.gsub!(ACTION_VIEW_ANNOTATIONS_REGEX, "")
+    end
+
+    def self.without_action_view_annotations
+      original_value = ActionView::Base.annotate_rendered_view_with_filenames
+      ActionView::Base.annotate_rendered_view_with_filenames = false
+      res = yield
+      ActionView::Base.annotate_rendered_view_with_filenames = original_value
+      res
+    end
+
+    def self.with_optional_action_view_annotations
+      if ActionView::Base.respond_to?(:annotate_rendered_view_with_filenames) && Lookbook.config.preview_disable_action_view_annotations
+        without_action_view_annotations do
+          yield
+        end
+      else
+        yield
+      end
+    end
 
     protected
 

data/lib/lookbook/version.rb

@@ -1,3 +1,3 @@
 module Lookbook
-  VERSION = "1.0.8"
+  VERSION = "1.1.0"
 end

data/lib/lookbook.rb

@@ -10,6 +10,7 @@ module Lookbook
   autoload :Utils, "lookbook/utils"
   autoload :Lang, "lookbook/lang"
   autoload :Params, "lookbook/params"
+  autoload :TagOptions, "lookbook/tag_options"
   autoload :Page, "lookbook/page"
   autoload :Tag, "lookbook/tag"
   autoload :PageSection, "lookbook/page_section"
@@ -24,6 +25,7 @@ module Lookbook
   autoload :PreviewExample, "lookbook/preview_example"
   autoload :PreviewGroup, "lookbook/preview_group"
   autoload :SourceInspector, "lookbook/source_inspector"
+  autoload :TemplateParser, "lookbook/template_parser"
   autoload :CodeFormatter, "lookbook/code_formatter"
   autoload :Markdown, "lookbook/markdown"
   autoload :Theme, "lookbook/theme"