sass-embedded 0.2.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: edeb1d7a1a3ba0d1485671e579478b4b1bc5d372350a25869cd4b0305bd2f356
-  data.tar.gz: 9eda21b2bdb2d7f278d03c9e5091eeec13956d9e0216ebb4a415988f8ac90b62
+  metadata.gz: c9afb73da6288ecf0360685cc9ddb4c072eb8840da50acaa8a52b67f09998e6c
+  data.tar.gz: 1a20d885e2e9f55ffd861f9428499f4c3bdea64a4aea81e44f356af8be69eccc
 SHA512:
-  metadata.gz: 2cc608b5597a0c820633f1dc386de5e9125b00ed99004c5237e0223d5a181d4782da4b2025983f86fad47409ef738e1a5954e810f35e9f443dd319035b2aa4dc
-  data.tar.gz: a45ad64a3670c8d6f2136a287773eed2f77abaeb6911173931af8570fa1edeeed53a747ebc747288dc5b1941c08eb9ddc5c410ede3c536c380dd3297e0bf8092
+  metadata.gz: 679cfc5b502de2fdc5b33c8117b7e1d68f94acd62c7afbe04ebb17f9bceacdc677e8b35197cf239f92fed4e3d523468d71798d899c360d8402be127bdb50ac48
+  data.tar.gz: e1d698b3980914299ee2ce570bd1f109a875859c147f8930366df8e2dabcae94f0e0795339f6614f3f7828e365c191ba24554e30869e4bd106f565f1cbbb9af2

data/.github/workflows/build.yml

@@ -27,7 +27,7 @@ jobs:
         bundler-cache: true
 
     - name: Download dart-sass-embedded
-      run: bundle exec rake download
+      run: bundle exec rake extconf
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
@@ -41,4 +41,4 @@ jobs:
 
     - name: Test Gem
       run: |-
-        ruby -r sass -e "puts Sass.render({ data: 'h1 { color: black; }' })[:css]"
+        ruby -r sass -e "puts Sass.render(data: 'h1 { color: black; }')[:css]"

data/.rubocop.yml

@@ -0,0 +1,14 @@
+AllCops:
+  Exclude:
+    - '**/*_pb.rb'
+    - 'vendor/**/*'
+
+  TargetRubyVersion: 2.6
+
+  NewCops: enable
+
+Layout/LineLength:
+  Enabled: false
+
+Metrics:
+  Enabled: false

data/README.md

@@ -1,5 +1,7 @@
 # Embedded Sass Host for Ruby
 
+[![build](https://github.com/ntkme/embedded-host-ruby/actions/workflows/build.yml/badge.svg)](https://github.com/ntkme/embedded-host-ruby/actions/workflows/build.yml)
+
 This is a Ruby library that implements the host side of the [Embedded Sass protocol](https://github.com/sass/sass-embedded-protocol).
 
 It exposes a Ruby API for Sass that's backed by a native [Dart Sass](https://sass-lang.com/dart-sass) executable.
@@ -9,9 +11,7 @@ It exposes a Ruby API for Sass that's backed by a native [Dart Sass](https://sas
 ``` ruby
 require "sass"
 
-Sass.render({
-  file: "style.scss"
-})
+Sass.render(file: "style.scss")
 ```
 
 ---

data/Rakefile

@@ -2,15 +2,22 @@
 
 require 'bundler/gem_tasks'
 
-task default: :test
+task default: %i[rubocop test]
 
 desc 'Download dart-sass-embedded'
-task :download do
-  require_relative 'ext/sass_embedded/extconf'
+task :extconf do
+  system('make', '-C', 'ext')
 end
 
 desc 'Run all tests'
-task :test do
+task test: :extconf do
   $LOAD_PATH.unshift('lib', 'test')
   Dir.glob('./test/**/*_test.rb').sort.each { |f| require f }
 end
+
+begin
+  require 'rubocop/rake_task'
+  RuboCop::RakeTask.new
+rescue LoadError
+  nil
+end

data/ext/Makefile

@@ -0,0 +1,51 @@
+ifeq ($(OS),Windows_NT)
+RM = cmd /c del /f /q /s
+else
+RM = rm -fr
+endif
+EXTCONF = ruby -- extconf.rb --without-sass-embedded --without-sass-embedded-protocol --without-protoc
+
+.PHONY: all
+all: sass_embedded embedded_sass_pb.rb
+
+.PHONY: install
+install:
+
+.PHONY: clean
+clean:
+	$(RM) embedded_sass_pb.rb protoc sass_embedded
+
+.PHONY: distclean
+distclean: clean
+	$(RM) embedded_sass.proto protoc-*.zip sass_embedded-*.tar.gz
+
+ifeq ($(OS),Windows_NT)
+sass_embedded-*.zip:
+else
+sass_embedded-*.tar.gz:
+endif
+	$(EXTCONF) --with-sass-embedded
+
+ifeq ($(OS),Windows_NT)
+sass_embedded: sass_embedded-*.zip
+	powershell -c "Get-Item $< | Expand-Archive -DestinationPath . -Force"
+else
+sass_embedded: sass_embedded-*.tar.gz
+	tar -vxzf $<
+endif
+
+protoc-*.zip:
+	$(EXTCONF) --with-protoc
+
+protoc: protoc-*.zip
+ifeq ($(OS),Windows_NT)
+	powershell -c "Get-Item $< | Expand-Archive -DestinationPath $@ -Force"
+else
+	unzip -od $@ $<
+endif
+
+embedded_sass.proto:
+	$(EXTCONF) --with-sass-embedded-protocol
+
+%_pb.rb: %.proto protoc
+	./protoc/bin/protoc --ruby_out=. $<

data/ext/extconf.rb

@@ -0,0 +1,160 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'mkmf'
+require 'json'
+require 'open-uri'
+require 'fileutils'
+require_relative '../lib/sass/platform'
+
+module Sass
+  # Install dependencies for sass-embedded during gem install
+  class Extconf
+    def initialize
+      get_with_config('sass-embedded', true) { latest_sass_embedded }
+      get_with_config('sass-embedded-protocol', true) { latest_sass_embedded_protocol }
+      get_with_config('protoc', true) { latest_protoc }
+    end
+
+    private
+
+    def get_with_config(config, default)
+      val = with_config(config, default)
+      case val
+      when true
+        if block_given?
+          get yield
+        else
+          get default
+        end
+      when false
+        nil
+      else
+        get val
+      end
+    end
+
+    def get(uri_s)
+      uri = URI.parse(uri_s)
+      path = File.absolute_path(File.basename(uri.path), __dir__)
+      if uri.is_a?(URI::File) || uri.instance_of?(URI::Generic)
+        FileUtils.copy_file uri.path, path
+      elsif uri.respond_to? :open
+        uri.open do |source|
+          File.open(path, 'wb') do |destination|
+            destination.write source.read
+          end
+        end
+      else
+        raise
+      end
+    rescue StandardError
+      raise "Failed to get: #{uri}"
+    end
+
+    def latest_release(repo, prerelease: false)
+      if prerelease
+        headers = {}
+        headers['Authorization'] = "token #{ENV['GITHUB_TOKEN']}" if ENV['GITHUB_TOKEN']
+        URI.parse("https://api.github.com/repos/#{repo}/releases").open(headers) do |file|
+          JSON.parse(file.read)[0]['tag_name']
+        end
+      else
+        URI.parse("https://github.com/#{repo}/releases/latest").open do |file|
+          File.basename file.base_uri.to_s
+        end
+      end
+    end
+
+    def latest_sass_embedded
+      repo = 'sass/dart-sass-embedded'
+
+      # TODO, don't use prerelease once a release is available
+      tag_name = latest_release repo, prerelease: true
+
+      os = case Sass::Platform::OS
+           when 'darwin'
+             'macos'
+           when 'linux'
+             'linux'
+           when 'windows'
+             'windows'
+           else
+             raise "Unsupported OS: #{Sass::Platform::OS}"
+           end
+
+      arch = case Sass::Platform::ARCH
+             when 'x86_64'
+               'x64'
+             when 'i386'
+               'ia32'
+             else
+               raise "Unsupported Arch: #{Sass::Platform::ARCH}"
+             end
+
+      ext = case os
+            when 'windows'
+              'zip'
+            else
+              'tar.gz'
+            end
+
+      "https://github.com/#{repo}/releases/download/#{tag_name}/sass_embedded-#{tag_name}-#{os}-#{arch}.#{ext}"
+    end
+
+    def latest_protoc
+      repo = 'protocolbuffers/protobuf'
+
+      tag_name = latest_release repo
+
+      os = case Sass::Platform::OS
+           when 'darwin'
+             'osx'
+           when 'linux'
+             'linux'
+           when 'windows'
+             'win'
+           else
+             raise "Unsupported OS: #{Sass::Platform::OS}"
+           end
+
+      arch = case Sass::Platform::ARCH
+             when 'aarch64'
+               'aarch_64'
+             when 'sparcv9'
+               's390'
+             when 'i386'
+               'x86_32'
+             when 'x86_64'
+               'x86_64'
+             when 'powerpc64'
+               'ppcle_64'
+             else
+               raise "Unsupported Arch: #{Sass::Platform::ARCH}"
+             end
+
+      os_arch = case os
+                when 'win'
+                  os + arch.split('_').last
+                else
+                  "#{os}-#{arch}"
+                end
+
+      ext = 'zip'
+
+      "https://github.com/#{repo}/releases/download/#{tag_name}/protoc-#{tag_name[1..]}-#{os_arch}.#{ext}"
+    end
+
+    def latest_sass_embedded_protocol
+      repo = 'sass/embedded-protocol'
+
+      # TODO: use latest release once available
+      # tag_name = latest_release repo
+      tag_name = 'HEAD'
+
+      "https://raw.githubusercontent.com/#{repo}/#{tag_name}/embedded_sass.proto"
+    end
+  end
+end
+
+Sass::Extconf.new

data/lib/sass.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+# The Sass module
 module Sass
   # The global include_paths for Sass files. This is meant for plugins and
   # libraries to register the paths to their Sass stylesheets to that they may
@@ -13,7 +14,7 @@ module Sass
   # (semicolon-separated on Windows).
   #
   # @example
-  #   Sass.include_paths << File.dirname(__FILE__ + '/sass')
+  #   Sass.include_paths << File.dirname(__FILE__) + '/sass'
   # @return [Array<String, Pathname>]
   def self.include_paths
     @include_paths ||= if ENV['SASS_PATH']
@@ -23,14 +24,21 @@ module Sass
                        end
   end
 
-  def self.render(options)
+  # The global render methods. This method automatically instantiates a
+  # global {Sass::Embedded} instance when invoked the first time and call
+  # `:render` method on the instance thereafter. The global {Sass::Embedded}
+  # is automatically closed via {Kernel.at_exit}.
+  # @example
+  #   Sass.render(options)
+  # @return [Hash]
+  def self.render(**kwargs)
     unless defined? @embedded
       @embedded = Sass::Embedded.new
       at_exit do
         @embedded.close
       end
     end
-    @embedded.render options
+    @embedded.render(**kwargs)
   end
 end
 

data/lib/sass/embedded.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
+require 'json'
+require 'base64'
+
 module Sass
+  # The interface for using dart-sass-embedded
   class Embedded
     def initialize
       @transport = Transport.new
@@ -8,198 +12,107 @@ module Sass
       @id = 0
     end
 
-    def render(options)
-      start = Sass::Util.now
-
-      raise Sass::NotRenderedError, 'Either :data or :file must be set.' if options[:file].nil? && options[:data].nil?
-
-      string = if options[:data]
-                 Sass::EmbeddedProtocol::InboundMessage::CompileRequest::StringInput.new(
-                   source: options[:data],
-                   url: options[:file] ? Sass::Util.file_uri(options[:file]) : 'stdin',
-                   syntax: options[:indented_syntax] == true ? Sass::EmbeddedProtocol::Syntax::INDENTED : Sass::EmbeddedProtocol::Syntax::SCSS
-                 )
-               end
-
-      path = options[:data] ? nil : options[:file]
+    def info
+      @transport.send EmbeddedProtocol::InboundMessage::VersionRequest.new(
+        id: next_id
+      )
+    end
 
-      style = case options[:output_style]&.to_sym
-              when :expanded, nil
-                Sass::EmbeddedProtocol::OutputStyle::EXPANDED
-              when :compressed
-                Sass::EmbeddedProtocol::OutputStyle::COMPRESSED
-              when :nested, :compact
-                raise Sass::UnsupportedValue, "#{options[:output_style]} is not a supported :output_style"
-              else
-                raise Sass::InvalidStyleError, "#{options[:output_style]} is not a valid :output_style"
-              end
+    def render(data: nil,
+               file: nil,
+               indented_syntax: false,
+               include_paths: [],
+               output_style: :expanded,
+               # precision: 5,
+               indent_type: :space,
+               indent_width: 2,
+               linefeed: :lf,
+               # source_comments: false,
+               source_map: false,
+               out_file: nil,
+               omit_source_map_url: false,
+               # source_map_contents: false,
+               source_map_embed: false,
+               source_map_root: '',
+               functions: {},
+               importer: [])
+      start = Util.now
 
-      source_map = options[:source_map].is_a?(String) || (options[:source_map] == true && !options[:out_file].nil?)
-
-      # 1. Loading a file relative to the file in which the @use or @import appeared.
-      # 2. Each custom importer.
-      # 3. Loading a file relative to the current working directory.
-      # 4. Each load path in includePaths
-      # 5. Each load path specified in the SASS_PATH environment variable, which should be semicolon-separated on Windows and colon-separated elsewhere.
-      importers = (if options[:importer]
-                     [
-                       Sass::EmbeddedProtocol::InboundMessage::CompileRequest::Importer.new(importer_id: 0)
-                     ]
-                   else
-                     []
-                   end).concat(
-                     (options[:include_paths] || []).concat(Sass.include_paths)
-                     .map do |include_path|
-                       Sass::EmbeddedProtocol::InboundMessage::CompileRequest::Importer.new(
-                         path: File.absolute_path(include_path)
-                       )
-                     end
-                   )
-
-      signatures = []
-      functions = {}
-      options[:functions]&.each do |signature, function|
-        signatures.push signature
-        functions[signature.to_s.split('(')[0].chomp] = function
-      end
+      indent_type = parse_indent_type(indent_type)
+      indent_width = parse_indent_width(indent_width)
+      linefeed = parse_linefeed(linefeed)
 
       compilation_id = next_id
 
-      compile_request = Sass::EmbeddedProtocol::InboundMessage::CompileRequest.new(
-        id: compilation_id,
-        string: string,
-        path: path,
-        style: style,
+      renderer = Renderer.new(
+        data: data,
+        file: file,
+        indented_syntax: indented_syntax,
+        include_paths: include_paths,
+        output_style: output_style,
         source_map: source_map,
-        importers: importers,
-        global_functions: options[:functions] ? signatures : [],
-        alert_color: true,
-        alert_ascii: true
+        out_file: out_file,
+        functions: functions,
+        importer: importer
       )
 
-      response = @transport.send compile_request, compilation_id
-
-      file = options[:file] || 'stdin'
-      canonicalizations = {}
-      imports = {}
+      response = @transport.send renderer.compile_request(compilation_id), compilation_id
 
       loop do
         case response
-        when Sass::EmbeddedProtocol::OutboundMessage::CompileResponse
+        when EmbeddedProtocol::OutboundMessage::CompileResponse
           break
-        when Sass::EmbeddedProtocol::OutboundMessage::CanonicalizeRequest
-          url = Sass::Util.file_uri(File.absolute_path(response.url, File.dirname(file)))
-
-          if canonicalizations.key? url
-            canonicalizations[url].id = response.id
-          else
-            resolved = nil
-            options[:importer].each do |importer|
-              begin
-                resolved = importer.call response.url, file
-              rescue StandardError => e
-                resolved = e
-              end
-              break if resolved
-            end
-            if resolved.nil?
-              canonicalizations[url] = Sass::EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
-                id: response.id,
-                url: url
-              )
-            elsif resolved.is_a? StandardError
-              canonicalizations[url] = Sass::EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
-                id: response.id,
-                error: resolved.message
-              )
-            elsif resolved.key? :contents
-              canonicalizations[url] = Sass::EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
-                id: response.id,
-                url: url
-              )
-              imports[url] = Sass::EmbeddedProtocol::InboundMessage::ImportResponse.new(
-                id: response.id,
-                success: Sass::EmbeddedProtocol::InboundMessage::ImportResponse::ImportSuccess.new(
-                  contents: resolved[:contents],
-                  syntax: Sass::EmbeddedProtocol::Syntax::SCSS,
-                  source_map_url: nil
-                )
-              )
-            elsif resolved.key? :file
-              canonicalized_url = Sass::Util.file_uri(resolved[:file])
-              canonicalizations[url] = Sass::EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
-                id: response.id,
-                url: canonicalized_url
-              )
-              imports[canonicalized_url] = Sass::EmbeddedProtocol::InboundMessage::ImportResponse.new(
-                id: response.id,
-                success: Sass::EmbeddedProtocol::InboundMessage::ImportResponse::ImportSuccess.new(
-                  contents: File.read(resolved[:file]),
-                  syntax: Sass::EmbeddedProtocol::Syntax::SCSS,
-                  source_map_url: nil
-                )
-              )
-            else
-              canonicalizations[url] = Sass::EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
-                id: response.id,
-                error: "Unexpected value returned from importer: #{resolved}"
-              )
-            end
-          end
-
-          response = @transport.send canonicalizations[url], compilation_id
-        when Sass::EmbeddedProtocol::OutboundMessage::ImportRequest
-          url = response.url
-
-          if imports.key? url
-            imports[url].id = response.id
-          else
-            imports[url] = Sass::EmbeddedProtocol::InboundMessage::ImportResponse.new(
-              id: response.id,
-              error: "Failed to import: #{url}"
-            )
-          end
-
-          response = @transport.send imports[url], compilation_id
-        when Sass::EmbeddedProtocol::OutboundMessage::FunctionCallRequest
-          begin
-            message = Sass::EmbeddedProtocol::InboundMessage::FunctionCallResponse.new(
-              id: response.id,
-              success: functions[response.name].call(*response.arguments)
-            )
-          rescue StandardError => e
-            message = Sass::EmbeddedProtocol::InboundMessage::FunctionCallResponse.new(
-              id: response.id,
-              error: e.message
-            )
-          end
-
-          response = @transport.send message, compilation_id
-        when Sass::EmbeddedProtocol::ProtocolError
-          raise Sass::ProtocolError, response.message
+        when EmbeddedProtocol::OutboundMessage::CanonicalizeRequest
+          response = @transport.send renderer.canonicalize_response(response), compilation_id
+        when EmbeddedProtocol::OutboundMessage::ImportRequest
+          response = @transport.send renderer.import_response(response), compilation_id
+        when EmbeddedProtocol::OutboundMessage::FunctionCallRequest
+          response = @transport.send renderer.function_call_response(response), compilation_id
+        when EmbeddedProtocol::ProtocolError
+          raise ProtocolError, response.message
         else
-          raise Sass::ProtocolError, "Unexpected packet received: #{response}"
+          raise ProtocolError, "Unexpected packet received: #{response}"
         end
       end
 
       if response.failure
-        raise Sass::CompilationError.new(
+        raise RenderError.new(
           response.failure.message,
           response.failure.formatted,
-          response.failure.span ? response.failure.span.url : nil,
+          if response.failure.span&.url == ''
+            'stdin'
+          else
+            Util.path(response.failure.span.url)
+          end,
           response.failure.span ? response.failure.span.start.line + 1 : nil,
           response.failure.span ? response.failure.span.start.column + 1 : nil,
           1
         )
       end
 
-      finish = Sass::Util.now
+      map, source_map = post_process_map(map: response.success.source_map,
+                                         file: file,
+                                         out_file: out_file,
+                                         source_map: source_map,
+                                         source_map_root: source_map_root)
+
+      css = post_process_css(css: response.success.css,
+                             indent_type: indent_type,
+                             indent_width: indent_width,
+                             linefeed: linefeed,
+                             map: map,
+                             out_file: out_file,
+                             omit_source_map_url: omit_source_map_url,
+                             source_map: source_map,
+                             source_map_embed: source_map_embed)
+
+      finish = Util.now
 
       {
-        css: response.success.css,
-        map: response.success.source_map,
+        css: css,
+        map: map,
         stats: {
-          entry: options[:file] || 'data',
+          entry: file.nil? ? 'data' : file,
           start: start,
           end: finish,
           duration: finish - start
@@ -209,20 +122,113 @@ module Sass
 
     def close
       @transport.close
+      nil
     end
 
     private
 
-    def info
-      version_response = @transport.send Sass::EmbeddedProtocol::InboundMessage::VersionRequest.new(
-        id: next_id
-      )
-      {
-        compiler_version: version_response.compiler_version,
-        protocol_version: version_response.protocol_version,
-        implementation_name: version_response.implementation_name,
-        implementation_version: version_response.implementation_version
-      }
+    def post_process_map(map:,
+                         file:,
+                         out_file:,
+                         source_map:,
+                         source_map_root:)
+      return if map.nil? || map.empty?
+
+      map_data = JSON.parse(map)
+
+      map_data['sourceRoot'] = source_map_root
+
+      source_map_path = if source_map.is_a? String
+                          source_map
+                        else
+                          "#{out_file}.map"
+                        end
+
+      source_map_dir = File.dirname(source_map_path)
+
+      if out_file
+        map_data['file'] = Util.relative(source_map_dir, out_file)
+      elsif file
+        ext = File.extname(file)
+        map_data['file'] = "#{file[0..(ext.empty? ? -1 : -ext.length - 1)]}.css"
+      else
+        map_data['file'] = 'stdin.css'
+      end
+
+      map_data['sources'].map! do |source|
+        if source.start_with? Util::FILE_PROTOCOL
+          Util.relative(source_map_dir, Util.path(source))
+        else
+          source
+        end
+      end
+
+      [-JSON.generate(map_data), source_map_path]
+    end
+
+    def post_process_css(css:,
+                         indent_type:,
+                         indent_width:,
+                         linefeed:,
+                         map:,
+                         omit_source_map_url:,
+                         out_file:,
+                         source_map:,
+                         source_map_embed:)
+      css = +css
+      if indent_width != 2 || indent_type.to_sym != :space
+        indent = indent_type * indent_width
+        css.gsub!(/^ +/) do |space|
+          indent * (space.length / 2)
+        end
+      end
+      css.gsub!("\n", linefeed) if linefeed != "\n"
+
+      unless map.nil? || omit_source_map_url == true
+        url = if source_map_embed
+                "data:application/json;base64,#{Base64.strict_encode64(map)}"
+              elsif out_file
+                Util.relative(File.dirname(out_file), source_map)
+              else
+                source_map
+              end
+        css += "#{linefeed}/*# sourceMappingURL=#{url} */"
+      end
+
+      -css
+    end
+
+    def parse_indent_type(indent_type)
+      case indent_type.to_sym
+      when :space
+        ' '
+      when :tab
+        "\t"
+      else
+        raise ArgumentError, 'indent_type must be :space or :tab'
+      end
+    end
+
+    def parse_indent_width(indent_width)
+      raise ArgumentError, 'indent_width must be an integer' unless indent_width.is_a? Integer
+      raise RangeError, 'indent_width must be in between 0 and 10 (inclusive)' unless indent_width.between? 0, 10
+
+      indent_width
+    end
+
+    def parse_linefeed(linefeed)
+      case linefeed.to_sym
+      when :lf
+        "\n"
+      when :lfcr
+        "\n\r"
+      when :cr
+        "\r"
+      when :crlf
+        "\r\n"
+      else
+        raise ArgumentError, 'linefeed must be one of :lf, :lfcr, :cr, :crlf'
+      end
     end
 
     def next_id
@@ -232,5 +238,199 @@ module Sass
         @id
       end
     end
+
+    # Helper class that maintains render state
+    class Renderer
+      def initialize(data:,
+                     file:,
+                     indented_syntax:,
+                     include_paths:,
+                     output_style:,
+                     source_map:,
+                     out_file:,
+                     functions:,
+                     importer:)
+        raise ArgumentError, 'either data or file must be set' if file.nil? && data.nil?
+
+        @data = data
+        @file = file
+        @indented_syntax = indented_syntax
+        @include_paths = include_paths
+        @output_style = output_style
+        @source_map = source_map
+        @out_file = out_file
+        @global_functions = functions.keys
+        @functions = functions.transform_keys do |key|
+          key.to_s.split('(')[0].chomp
+        end
+        @importer = importer
+        @import_responses = {}
+      end
+
+      def compile_request(id)
+        EmbeddedProtocol::InboundMessage::CompileRequest.new(
+          id: id,
+          string: string,
+          path: path,
+          style: style,
+          source_map: source_map,
+          importers: importers,
+          global_functions: global_functions,
+          alert_color: $stderr.tty?,
+          alert_ascii: Platform::OS == 'windows'
+        )
+      end
+
+      def canonicalize_response(canonicalize_request)
+        url = Util.file_uri(File.absolute_path(canonicalize_request.url, (@file.nil? ? 'stdin' : @file)))
+
+        begin
+          result = @importer[canonicalize_request.importer_id].call canonicalize_request.url, @file
+          raise result if result.is_a? StandardError
+        rescue StandardError => e
+          return EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
+            id: canonicalize_request.id,
+            error: e.message
+          )
+        end
+
+        if result&.key? :contents
+          @import_responses[url] = EmbeddedProtocol::InboundMessage::ImportResponse.new(
+            id: canonicalize_request.id,
+            success: EmbeddedProtocol::InboundMessage::ImportResponse::ImportSuccess.new(
+              contents: result[:contents],
+              syntax: EmbeddedProtocol::Syntax::SCSS,
+              source_map_url: nil
+            )
+          )
+          EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
+            id: canonicalize_request.id,
+            url: url
+          )
+        elsif result&.key? :file
+          canonicalized_url = Util.file_uri(result[:file])
+
+          # TODO: FileImportRequest is not supported yet.
+          # Workaround by reading contents and return it when server asks
+          @import_responses[canonicalized_url] = EmbeddedProtocol::InboundMessage::ImportResponse.new(
+            id: canonicalize_request.id,
+            success: EmbeddedProtocol::InboundMessage::ImportResponse::ImportSuccess.new(
+              contents: File.read(result[:file]),
+              syntax: EmbeddedProtocol::Syntax::SCSS,
+              source_map_url: nil
+            )
+          )
+
+          EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
+            id: canonicalize_request.id,
+            url: canonicalized_url
+          )
+        else
+          EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
+            id: canonicalize_request.id
+          )
+        end
+      end
+
+      def import_response(import_request)
+        url = import_request.url
+
+        if @import_responses.key? url
+          @import_responses[url].id = import_request.id
+        else
+          @import_responses[url] = EmbeddedProtocol::InboundMessage::ImportResponse.new(
+            id: import_request.id,
+            error: "Failed to import: #{url}"
+          )
+        end
+
+        @import_responses[url]
+      end
+
+      def function_call_response(function_call_request)
+        EmbeddedProtocol::InboundMessage::FunctionCallResponse.new(
+          id: function_call_request.id,
+          success: @functions[function_call_request.name].call(*function_call_request.arguments)
+        )
+      rescue StandardError => e
+        EmbeddedProtocol::InboundMessage::FunctionCallResponse.new(
+          id: function_call_request.id,
+          error: e.message
+        )
+      end
+
+      private
+
+      def syntax
+        if @indented_syntax == true
+          EmbeddedProtocol::Syntax::INDENTED
+        else
+          EmbeddedProtocol::Syntax::SCSS
+        end
+      end
+
+      def url
+        return if @file.nil?
+
+        Util.file_uri @file
+      end
+
+      def string
+        return if @data.nil?
+
+        EmbeddedProtocol::InboundMessage::CompileRequest::StringInput.new(
+          source: @data,
+          url: url,
+          syntax: syntax
+        )
+      end
+
+      def path
+        @file if @data.nil?
+      end
+
+      def style
+        case @output_style&.to_sym
+        when :expanded
+          EmbeddedProtocol::OutputStyle::EXPANDED
+        when :compressed
+          EmbeddedProtocol::OutputStyle::COMPRESSED
+        when :nested, :compact
+          raise ArgumentError, "#{@output_style} is not a supported output_style"
+        else
+          raise ArgumentError, "#{@output_style} is not a valid utput_style"
+        end
+      end
+
+      def source_map
+        @source_map.is_a?(String) || (@source_map == true && !@out_file.nil?)
+      end
+
+      attr_reader :global_functions
+
+      # Order
+      # 1. Loading a file relative to the file in which the @use or @import appeared.
+      # 2. Each custom importer.
+      # 3. Loading a file relative to the current working directory.
+      # 4. Each load path in includePaths
+      # 5. Each load path specified in the SASS_PATH environment variable, which should be semicolon-separated on Windows and colon-separated elsewhere.
+      def importers
+        custom_importers = @importer.map.with_index do |_, id|
+          EmbeddedProtocol::InboundMessage::CompileRequest::Importer.new(
+            importer_id: id
+          )
+        end
+
+        include_path_importers = @include_paths
+                                 .concat(Sass.include_paths)
+                                 .map do |include_path|
+          EmbeddedProtocol::InboundMessage::CompileRequest::Importer.new(
+            path: File.absolute_path(include_path)
+          )
+        end
+
+        custom_importers.concat include_path_importers
+      end
+    end
   end
 end