liquidbook 0.1.0

data/lib/liquidbook/tags/render_tag.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Liquidbook
+  module Tags
+    # Handles {% render 'snippet' %} and {% render 'snippet' with object %}
+    # Also handles {% render 'snippet' for collection %}
+    class RenderTag < Liquid::Tag
+      SYNTAX = /['"]([^'"]+)['"](?:\s+(?:with|for)\s+(\S+)(?:\s+as\s+(\w+))?)?/
+
+      def initialize(tag_name, markup, tokens)
+        super
+        if markup.strip =~ SYNTAX
+          @snippet_name = Regexp.last_match(1)
+          @variable_expr = Regexp.last_match(2)
+          @alias_name = Regexp.last_match(3)
+        else
+          # Try simple variable assignments: {% render 'snippet', var: value %}
+          if markup.strip =~ /['"]([^'"]+)['"]\s*,?\s*(.*)/
+            @snippet_name = Regexp.last_match(1)
+            @inline_vars = parse_inline_vars(Regexp.last_match(2))
+          else
+            raise Liquid::SyntaxError, "Invalid syntax for render tag: #{markup}"
+          end
+        end
+      end
+
+      def render(context)
+        theme_root = context.registers[:theme_root] || Liquidbook.root
+        snippet_path = find_snippet(theme_root)
+
+        unless snippet_path
+          return "<!-- snippet '#{@snippet_name}' not found -->"
+        end
+
+        source = File.read(snippet_path)
+        template = Liquid::Template.parse(source, environment: Liquidbook.environment)
+
+        # Build isolated scope
+        inner = {}
+
+        if @variable_expr
+          value = context[@variable_expr]
+          alias_key = @alias_name || @snippet_name
+          inner[alias_key] = value
+        end
+
+        if @inline_vars
+          @inline_vars.each do |key, expr|
+            inner[key] = context[expr] || expr
+          end
+        end
+
+        # Merge parent assigns with inner scope
+        parent_assigns = {}
+        context.environments.each { |env| parent_assigns.merge!(env) if env.is_a?(Hash) }
+        assigns = parent_assigns.merge(inner)
+
+        template.render(
+          assigns,
+          registers: { theme_root: theme_root }
+        )
+      end
+
+      private
+
+      def find_snippet(theme_root)
+        paths = [
+          File.join(theme_root, "snippets", "#{@snippet_name}.liquid"),
+          File.join(theme_root, "sections", "#{@snippet_name}.liquid")
+        ]
+        paths.find { |p| File.exist?(p) }
+      end
+
+      def parse_inline_vars(str)
+        return {} if str.nil? || str.strip.empty?
+
+        vars = {}
+        str.scan(/(\w+)\s*:\s*([^,]+)/) do |key, value|
+          vars[key.strip] = value.strip.gsub(/\A['"]|['"]\z/, "")
+        end
+        vars
+      end
+    end
+  end
+end

data/lib/liquidbook/tags/section_tag.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Liquidbook
+  module Tags
+    # Handles {% section 'name' %} tags by rendering the referenced section file
+    class SectionTag < Liquid::Tag
+      SYNTAX = /['"](\w+)['"]/
+
+      def initialize(tag_name, markup, tokens)
+        super
+        if markup.strip =~ SYNTAX
+          @section_name = Regexp.last_match(1)
+        else
+          raise Liquid::SyntaxError, "Invalid syntax for section tag: #{markup}"
+        end
+      end
+
+      def render(context)
+        theme_root = context.registers[:theme_root] || Liquidbook.root
+        section_path = File.join(theme_root, "sections", "#{@section_name}.liquid")
+
+        unless File.exist?(section_path)
+          return "<!-- section '#{@section_name}' not found -->"
+        end
+
+        source = File.read(section_path)
+        parser = SchemaParser.new(source)
+        template = Liquid::Template.parse(parser.template_without_schema, environment: Liquidbook.environment)
+        template.render(context)
+      end
+    end
+  end
+end

data/lib/liquidbook/theme_renderer.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Liquidbook
+  # Renders a Liquid template with mock data and Shopify-compatible tags/filters
+  class ThemeRenderer
+    def initialize(theme_root: nil)
+      @theme_root = theme_root || Liquidbook.root
+      @mock_data = MockData.new(theme_root: @theme_root)
+    end
+
+    # Render a section file by name
+    def render_section(name, overrides: {})
+      path = File.join(@theme_root, "sections", "#{name}.liquid")
+      raise Error, "Section not found: #{name}" unless File.exist?(path)
+
+      source = File.read(path)
+      render_source(source, section: true, overrides: overrides)
+    end
+
+    # Render a snippet file by name, with optional parameter overrides
+    def render_snippet(name, overrides: {})
+      path = File.join(@theme_root, "snippets", "#{name}.liquid")
+      raise Error, "Snippet not found: #{name}" unless File.exist?(path)
+
+      source = File.read(path)
+      render_source(source, section: false, snippet_params: snippet_defaults(source).merge(overrides))
+    end
+
+    # Render raw Liquid source
+    def render_source(source, section: false, snippet_params: {}, overrides: {})
+      parser = SchemaParser.new(source)
+      template_source = parser.template_without_schema
+
+      assigns = if section
+                  @mock_data.with_section(parser)
+                else
+                  @mock_data.to_assigns
+                end
+
+      # Merge snippet @param defaults
+      assigns.merge!(snippet_params)
+
+      # Merge any overrides from the UI
+      assigns.merge!(overrides)
+
+      template = Liquid::Template.parse(template_source, environment: Liquidbook.environment)
+      template.render(
+        assigns,
+        registers: { theme_root: @theme_root }
+      )
+    end
+
+    # Extract @param definitions from a snippet
+    def snippet_params(name)
+      path = File.join(@theme_root, "snippets", "#{name}.liquid")
+      return [] unless File.exist?(path)
+
+      ParamParser.new(File.read(path)).parse
+    end
+
+    # List available sections
+    def sections
+      list_templates("sections")
+    end
+
+    # List available snippets
+    def snippets
+      list_templates("snippets")
+    end
+
+    private
+
+    def snippet_defaults(source)
+      ParamParser.new(source).default_assigns
+    end
+
+    def list_templates(dir)
+      pattern = File.join(@theme_root, dir, "*.liquid")
+      Dir.glob(pattern).map { |f| File.basename(f, ".liquid") }.sort
+    end
+  end
+end

data/lib/liquidbook/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Liquidbook
+  VERSION = "0.1.0"
+end

data/lib/liquidbook.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "liquid"
+require_relative "liquidbook/version"
+require_relative "liquidbook/config"
+require_relative "liquidbook/schema_parser"
+require_relative "liquidbook/param_parser"
+require_relative "liquidbook/mock_data"
+require_relative "liquidbook/filters/shopify_filters"
+require_relative "liquidbook/tags/section_tag"
+require_relative "liquidbook/tags/render_tag"
+require_relative "liquidbook/pid_manager"
+require_relative "liquidbook/theme_renderer"
+require_relative "liquidbook/server/app"
+
+module Liquidbook
+  class Error < StandardError; end
+
+  class << self
+    def root
+      @root || Dir.pwd
+    end
+
+    attr_writer :root
+
+    def environment
+      @environment ||= build_environment
+    end
+
+    def config
+      @config ||= Config.new(theme_root: root)
+    end
+
+    # Reset (useful when reloading)
+    def reset!
+      @environment = nil
+      @config = nil
+    end
+
+    private
+
+    def build_environment
+      Liquid::Environment.build do |e|
+        e.register_filter(Filters::ShopifyFilters)
+        e.register_tag("section", Tags::SectionTag)
+        e.register_tag("render", Tags::RenderTag)
+      end
+    end
+  end
+end

data/sig/liquidbook.rbs

@@ -0,0 +1,4 @@
+module liquidbook
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,153 @@
+--- !ruby/object:Gem::Specification
+name: liquidbook
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- sena-m09
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: liquid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: rackup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: listen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+description: A development tool that renders Shopify Liquid templates locally with
+  mock data, providing a browser-based preview for sections and snippets.
+email:
+- sena-murakami@gaji.jp
+executables:
+- liquidbook
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- LICENSE
+- README.md
+- Rakefile
+- docs/README.ja.md
+- exe/liquidbook
+- fixtures/default_mocks.yml
+- lib/liquidbook.rb
+- lib/liquidbook/cli.rb
+- lib/liquidbook/config.rb
+- lib/liquidbook/filters/shopify_filters.rb
+- lib/liquidbook/mock_data.rb
+- lib/liquidbook/param_parser.rb
+- lib/liquidbook/pid_manager.rb
+- lib/liquidbook/schema_parser.rb
+- lib/liquidbook/server/app.rb
+- lib/liquidbook/server/views/index.erb
+- lib/liquidbook/server/views/layout.erb
+- lib/liquidbook/server/views/preview.erb
+- lib/liquidbook/tags/render_tag.rb
+- lib/liquidbook/tags/section_tag.rb
+- lib/liquidbook/theme_renderer.rb
+- lib/liquidbook/version.rb
+- sig/liquidbook.rbs
+homepage: https://github.com/sena-m09/liquidbook
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/sena-m09/liquidbook
+  source_code_uri: https://github.com/sena-m09/liquidbook
+  changelog_uri: https://github.com/sena-m09/liquidbook/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Storybook-like preview server for Shopify Liquid sections and snippets
+test_files: []