sass-embedded 1.99.0 → 1.101.0

data/ext/sass/platform.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# The {Platform} module.
+#
+# @!visibility private
+module Platform
+  HOST_CPU = RbConfig::CONFIG['host_cpu'].downcase
+
+  CPU = case HOST_CPU
+        when /amd64|x86_64|x64/
+          'x86_64'
+        when /i\d86|x86|i86pc/
+          'i386'
+        when /arm64|aarch64/
+          'aarch64'
+        when /arm/
+          'arm'
+        when /ppc64le|powerpc64le/
+          'ppc64le'
+        else
+          HOST_CPU
+        end
+
+  HOST_OS = RbConfig::CONFIG['host_os'].downcase
+
+  OS = case HOST_OS
+       when /darwin/
+         'darwin'
+       when /linux-android/
+         'linux-android'
+       when /linux-musl/
+         'linux-musl'
+       when /linux-none/
+         'linux-none'
+       when /linux-uclibc/
+         'linux-uclibc'
+       when /linux/
+         'linux'
+       when *Gem::WIN_PATTERNS
+         'windows'
+       else
+         HOST_OS
+       end
+
+  ARCH = "#{CPU}-#{OS}".freeze
+end

data/ext/sass/sass_config.rb

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+require_relative 'platform'
+
+# The {SassConfig} module.
+#
+# @!visibility private
+module SassConfig
+  module_function
+
+  def package_json(path = '.')
+    require 'json'
+
+    JSON.parse(File.read(File.absolute_path('package.json', path)))
+  end
+
+  def dart_support?
+    %w[darwin linux linux-android linux-musl windows].include?(Platform::OS) &&
+      %w[x86_64 aarch64 arm riscv64].include?(Platform::CPU)
+  end
+
+  def dart_sass_version
+    package_json(__dir__)['dependencies']['sass']
+      # TODO: remove after https://github.com/sass/dart-sass/pull/2413
+      .delete_prefix('file:sass-').delete_suffix('.tgz')
+  end
+
+  def dart_sass
+    repo = 'https://github.com/sass/dart-sass'
+
+    tag_name = dart_sass_version
+
+    message = "dart-sass for #{Platform::ARCH} not available at #{repo}/releases/tag/#{tag_name}"
+
+    env = ''
+
+    os = case Platform::OS
+         when 'darwin'
+           'macos'
+         when 'linux'
+           'linux'
+         when 'linux-android'
+           'android'
+         when 'linux-musl'
+           env = '-musl'
+           'linux'
+         when 'windows'
+           'windows'
+         else
+           raise NotImplementedError, message
+         end
+
+    cpu = case Platform::CPU
+          when 'x86_64'
+            'x64'
+          when 'aarch64'
+            'arm64'
+          when 'arm'
+            'arm'
+          when 'riscv64'
+            'riscv64'
+          else
+            raise NotImplementedError, message
+          end
+
+    ext = Platform::OS == 'windows' ? 'zip' : 'tar.gz'
+
+    "#{repo}/releases/download/#{tag_name}/dart-sass-#{tag_name}-#{os}-#{cpu}#{env}.#{ext}"
+  end
+
+  def protoc
+    repo = 'https://repo.maven.apache.org/maven2/com/google/protobuf/protoc'
+
+    dependency = Gem::Dependency.new('google-protobuf')
+
+    spec = dependency.to_spec
+
+    version = spec.version
+
+    message = "protoc for #{Platform::ARCH} not available at #{repo}/#{version}"
+
+    os = case Platform::OS
+         when 'darwin'
+           'osx'
+         when 'linux', 'linux-android', 'linux-musl', 'linux-none', 'linux-uclibc'
+           'linux'
+         when 'windows'
+           'windows'
+         else
+           raise NotImplementedError, message
+         end
+
+    cpu = case Platform::CPU
+          when 'i386'
+            'x86_32'
+          when 'x86_64'
+            'x86_64'
+          when 'aarch64'
+            Platform::OS == 'windows' ? 'x86_64' : 'aarch_64'
+          when 'ppc64le'
+            'ppcle_64'
+          when 's390x'
+            's390_64'
+          else
+            raise NotImplementedError, message
+          end
+
+    uri = "#{repo}/#{version}/protoc-#{version}-#{os}-#{cpu}.exe"
+
+    Utils.fetch_https("#{uri}.sha1")
+
+    uri
+  rescue Gem::RemoteFetcher::FetchError
+    dependency_request = Gem::Resolver::DependencyRequest.new(dependency, nil)
+
+    versions = Gem::Resolver::BestSet.new.find_all(dependency_request).filter_map do |s|
+      s.version if s.platform == Gem::Platform::RUBY
+    end
+
+    versions.sort.reverse_each do |v|
+      uri = "#{repo}/#{v}/protoc-#{v}-#{os}-#{cpu}.exe"
+
+      Utils.fetch_https("#{uri}.sha1")
+
+      return uri
+    rescue Gem::RemoteFetcher::FetchError
+      next
+    end
+
+    raise NotImplementedError, message
+  end
+
+  def embedded_sass_protocol
+    require 'json'
+
+    rubyarchdir = ENV.fetch('RUBYARCHDIR', nil)
+
+    rubylibdir = ENV.fetch('RUBYLIBDIR', nil)
+
+    version = Utils.capture(RbConfig.ruby,
+                            "-I#{File.absolute_path('../../lib', __dir__)}",
+                            *("-I#{rubyarchdir}" if rubyarchdir),
+                            *("-I#{rubylibdir}" if rubylibdir),
+                            File.absolute_path('../../exe/sass', __dir__),
+                            '--embedded',
+                            '--version')
+
+    tag_name = JSON.parse(version)['protocolVersion']
+
+    "https://github.com/sass/sass/raw/embedded-protocol-#{tag_name}/spec/embedded_sass.proto"
+  end
+
+  def development?
+    File.exist?('../../Gemfile')
+  end
+
+  def gem_version
+    require_relative '../../lib/sass/embedded/version'
+
+    development? ? dart_sass_version : Sass::Embedded::VERSION
+  end
+
+  def gem_platform
+    platform = Gem::Platform.new("#{Platform::CPU}-#{Platform::HOST_OS}")
+    case Platform::OS
+    when 'darwin'
+      case platform.cpu
+      when 'aarch64'
+        Gem::Platform.new(['arm64', platform.os])
+      else
+        platform
+      end
+    when 'linux'
+      if platform.version&.start_with?('gnu')
+        platform
+      else
+        Gem::Platform.new([platform.cpu, platform.os, "gnu#{platform.version}"])
+      end
+    when 'windows'
+      case platform.cpu
+      when 'x86_64'
+        Gem::Platform.new('x64-mingw-ucrt')
+      else
+        Gem::Platform.new([platform.cpu, 'mingw', 'ucrt'])
+      end
+    else
+      platform
+    end
+  end
+end

data/ext/sass/utils.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+# The {Utils} module.
+#
+# @!visibility private
+module Utils
+  module_function
+
+  def capture(...)
+    require 'open3'
+
+    stdout, stderr, status = Open3.capture3(...)
+
+    raise stderr unless status.success?
+
+    stdout
+  end
+
+  def fetch_https(source_uri)
+    require 'rubygems/remote_fetcher'
+
+    source_uri = begin
+      Gem::Uri.parse!(source_uri)
+    rescue NoMethodError
+      URI.parse(source_uri)
+    end
+
+    Gem::RemoteFetcher.fetcher.fetch_https(source_uri)
+  end
+
+  def windows_system_directory
+    path = capture('powershell.exe',
+                   '-NoLogo',
+                   '-NoProfile',
+                   '-NonInteractive',
+                   '-Command',
+                   '[Environment]::GetFolderPath([Environment+SpecialFolder]::System) | Write-Host -NoNewline')
+
+    File.absolute_path(path)
+  end
+end

data/lib/sass/compiler/channel.rb

@@ -29,24 +29,24 @@ module Sass
         end
       end
 
-      def stream(host)
+      def stream(session)
         @mutex.synchronize do
           raise IOError, 'closed compiler' if @dispatcher.nil?
 
-          Stream.new(@dispatcher, host)
+          Stream.new(@dispatcher, session)
         rescue Errno::EBUSY
           @dispatcher = Dispatcher.new(*@args, **@kwargs, &@block)
-          Stream.new(@dispatcher, host)
+          Stream.new(@dispatcher, session)
         end
       end
 
-      # The {Stream} between {Dispatcher} and {Host}.
+      # The {Stream} between {Dispatcher} and {Session}.
       class Stream
         attr_reader :id
 
-        def initialize(dispatcher, host)
+        def initialize(dispatcher, session)
           @dispatcher = dispatcher
-          @id = @dispatcher.subscribe(host)
+          @id = @dispatcher.subscribe(session)
         end
 
         def close

data/lib/sass/compiler/dispatcher.rb

@@ -4,7 +4,7 @@ module Sass
   class Compiler
     # The {Dispatcher} class.
     #
-    # It dispatches messages between multiple instances of {Host} and a single {Connection} to the compiler.
+    # It dispatches messages between multiple instances of {Session} and a single {Connection} to the compiler.
     class Dispatcher
       def initialize(idle_timeout: 0)
         @id = 1

data/lib/sass/compiler/{host → session}/function_registry.rb

@@ -2,14 +2,14 @@
 
 module Sass
   class Compiler
-    class Host
+    class Session
       # The {FunctionRegistry} class.
       #
       # It stores sass custom functions and handles function calls.
       class FunctionRegistry
         attr_reader :compile_context, :global_functions
 
-        def initialize(functions, alert_color:)
+        def initialize(functions, session:)
           @compile_context = Object.new
           @global_functions = functions.keys.map!(&:to_s)
           @functions_by_name = functions.transform_keys do |signature|
@@ -26,7 +26,7 @@ module Sass
           @functions_by_id = {}.compare_by_identity
           @ids_by_function = {}.compare_by_identity
 
-          @highlight = alert_color
+          @session = session
         end
 
         def register(function)
@@ -68,9 +68,14 @@ module Sass
             accessed_argument_lists:
           )
         rescue StandardError => e
+          @session.backtrace = e.backtrace
           EmbeddedProtocol::InboundMessage::FunctionCallResponse.new(
             id: function_call_request.id,
-            error: e.full_message(highlight: @highlight, order: :top)
+            error: if e.respond_to?(:detailed_message)
+                     e.detailed_message(highlight: false)
+                   else # TODO: remove once ruby 3.1 support is dropped
+                     "#{e.message} (#{e.class.name})"
+                   end
           )
         end
 

data/lib/sass/compiler/{host → session}/importer_registry.rb

@@ -2,14 +2,14 @@
 
 module Sass
   class Compiler
-    class Host
+    class Session
       # The {ImporterRegistry} class.
       #
       # It stores importers and handles import requests.
       class ImporterRegistry
         attr_reader :importers
 
-        def initialize(importers, load_paths, alert_color:)
+        def initialize(importers, load_paths, session:)
           @id = 0
           @importers_by_id = {}.compare_by_identity
           @importers = importers
@@ -22,7 +22,7 @@ module Sass
                          end
                        )
 
-          @highlight = alert_color
+          @session = session
         end
 
         IMPORTER_ATTRS = %i[non_canonical_scheme].freeze
@@ -79,9 +79,14 @@ module Sass
             containing_url_unused: canonicalize_context.instance_variable_get(:@containing_url_unused)
           )
         rescue StandardError => e
+          @session.backtrace = e.backtrace
           EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
             id: canonicalize_request.id,
-            error: e.full_message(highlight: @highlight, order: :top)
+            error: if e.respond_to?(:detailed_message)
+                     e.detailed_message(highlight: false)
+                   else # TODO: remove once ruby 3.1 support is dropped
+                     "#{e.message} (#{e.class.name})"
+                   end
           )
         end
 
@@ -103,9 +108,14 @@ module Sass
             )
           )
         rescue StandardError => e
+          @session.backtrace = e.backtrace
           EmbeddedProtocol::InboundMessage::ImportResponse.new(
             id: import_request.id,
-            error: e.full_message(highlight: @highlight, order: :top)
+            error: if e.respond_to?(:detailed_message)
+                     e.detailed_message(highlight: false)
+                   else # TODO: remove once ruby 3.1 support is dropped
+                     "#{e.message} (#{e.class.name})"
+                   end
           )
         end
 
@@ -121,9 +131,14 @@ module Sass
             containing_url_unused: canonicalize_context.instance_variable_get(:@containing_url_unused)
           )
         rescue StandardError => e
+          @session.backtrace = e.backtrace
           EmbeddedProtocol::InboundMessage::FileImportResponse.new(
             id: file_import_request.id,
-            error: e.full_message(highlight: @highlight, order: :top)
+            error: if e.respond_to?(:detailed_message)
+                     e.detailed_message(highlight: false)
+                   else # TODO: remove once ruby 3.1 support is dropped
+                     "#{e.message} (#{e.class.name})"
+                   end
           )
         end
 

data/lib/sass/compiler/{host → session}/logger_registry.rb

@@ -2,7 +2,7 @@
 
 module Sass
   class Compiler
-    class Host
+    class Session
       # The {LoggerRegistry} class.
       #
       # It stores logger and handles log events.
@@ -24,13 +24,13 @@ module Sass
             if @logger_respond_to_debug
               @logger.debug(event.message, DebugContext.new(event))
             else
-              Kernel.warn(event.formatted)
+              Kernel.warn(Path.pretty_formatted!(+event.formatted, event.span.url))
             end
           when :DEPRECATION_WARNING, :WARNING
             if @logger_respond_to_warn
               @logger.warn(event.message, WarnContext.new(event))
             else
-              Kernel.warn(event.formatted)
+              Kernel.warn(StackTrace.pretty_formatted!(+event.formatted, event.stack_trace))
             end
           else
             raise ArgumentError, "Unknown LogEvent.type #{event.type}"

data/lib/sass/compiler/session/path.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Sass
+  class Compiler
+    class Session
+      # @see https://pub.dev/documentation/path/latest/path/
+      module Path
+        module_function
+
+        # @see https://pub.dev/documentation/path/latest/path/Context/prettyUri.html
+        def pretty_uri(uri)
+          return uri unless uri&.start_with?('file:')
+
+          absolute_path = Uri.file_uri_to_path(uri)
+          relative_path = Uri.decode_uri_component(Uri.relative(uri, Uri.pwd))
+          relative_path.count('/') > absolute_path.count('/') ? absolute_path : relative_path
+        end
+
+        def pretty_formatted!(formatted, uri)
+          index = formatted.index(uri)
+          return formatted unless index
+
+          replacement = pretty_uri(uri)
+          return formatted if uri == replacement
+
+          formatted[index, uri.length] = replacement
+          formatted
+        end
+      end
+
+      private_constant :Path
+    end
+  end
+end

data/lib/sass/compiler/{host → session}/protofier.rb

@@ -2,7 +2,7 @@
 
 module Sass
   class Compiler
-    class Host
+    class Session
       # The {Protofier} class.
       #
       # It converts Pure Ruby types and Protobuf Ruby types.

data/lib/sass/compiler/session/stack_trace.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Sass
+  class Compiler
+    class Session
+      # @see https://pub.dev/documentation/stack_trace/latest/stack_trace/
+      module StackTrace
+        module_function
+
+        # @see https://pub.dev/documentation/stack_trace/latest/stack_trace/Trace/toString.html
+        def pretty_formatted!(formatted, stack_trace)
+          longest = 0
+
+          frames = stack_trace.lines("\n", chomp: true).map do |frame|
+            location, member = frame.split(/  +/, 2)
+            uri, line_column = location.split(' ', 2)
+
+            uri = Path.pretty_uri(uri)
+            location = line_column.nil? ? uri : "#{uri} #{line_column}"
+
+            longest = location.length if location.length > longest
+            [frame, location, member]
+          end
+
+          offset = formatted.length
+
+          frames.reverse_each do |frame, location, member|
+            index = formatted.rindex(frame, offset)
+            next unless index
+
+            offset = index
+
+            replacement = "#{location.ljust(longest)}  #{member}"
+            next if frame == replacement
+
+            formatted[index, frame.length] = replacement
+          end
+
+          formatted
+        end
+      end
+
+      private_constant :StackTrace
+    end
+  end
+end

data/lib/sass/compiler/{host → session}/struct.rb

@@ -2,7 +2,7 @@
 
 module Sass
   class Compiler
-    class Host
+    class Session
       # The {Struct} class.
       #
       # It creates {::Struct}-like objects from {::Hash}.

data/lib/sass/compiler/{host.rb → session.rb}

@@ -1,19 +1,24 @@
 # frozen_string_literal: true
 
-require_relative 'host/function_registry'
-require_relative 'host/importer_registry'
-require_relative 'host/logger_registry'
-require_relative 'host/protofier'
-require_relative 'host/struct'
+require_relative 'session/function_registry'
+require_relative 'session/importer_registry'
+require_relative 'session/logger_registry'
+require_relative 'session/path'
+require_relative 'session/protofier'
+require_relative 'session/stack_trace'
+require_relative 'session/struct'
 
 module Sass
   class Compiler
-    # The {Host} class.
+    # The {Session} class.
     #
     # It communicates with {Dispatcher} and handles the host logic.
-    class Host
+    class Session
+      attr_writer :backtrace
+
       def initialize(channel)
         @channel = channel
+        @backtrace = nil
       end
 
       def compile_request(path:,
@@ -38,8 +43,8 @@ module Sass
                           verbose:)
         alert_color = Exception.to_tty? if alert_color.nil?
 
-        @function_registry = FunctionRegistry.new(functions, alert_color:)
-        @importer_registry = ImporterRegistry.new(importers, load_paths, alert_color:)
+        @function_registry = FunctionRegistry.new(functions, session: self)
+        @importer_registry = ImporterRegistry.new(importers, load_paths, session: self)
         @logger_registry = LoggerRegistry.new(logger)
 
         compile_request = EmbeddedProtocol::InboundMessage::CompileRequest.new(
@@ -83,13 +88,15 @@ module Sass
         result = compile_response.public_send(oneof)
         case oneof
         when :failure
-          raise CompileError.new(
+          compile_error = CompileError.new(
             result.message,
-            result.formatted == '' ? nil : result.formatted,
+            result.formatted == '' ? nil : StackTrace.pretty_formatted!(+result.formatted, result.stack_trace),
             result.stack_trace == '' ? nil : result.stack_trace,
             result.span.nil? ? nil : Logger::SourceSpan.new(result.span),
             compile_response.loaded_urls.to_a
           )
+          compile_error.set_backtrace(@backtrace) unless @backtrace.nil?
+          raise compile_error
         when :success
           CompileResult.new(
             result.css,
@@ -221,6 +228,6 @@ module Sass
       end
     end
 
-    private_constant :Host
+    private_constant :Session
   end
 end

data/lib/sass/compiler.rb

@@ -5,7 +5,7 @@ require_relative 'compile_result'
 require_relative 'compiler/channel'
 require_relative 'compiler/connection'
 require_relative 'compiler/dispatcher'
-require_relative 'compiler/host'
+require_relative 'compiler/session'
 require_relative 'compiler/varint'
 require_relative 'embedded/version'
 require_relative 'embedded_protocol'
@@ -17,6 +17,7 @@ require_relative 'logger/source_location'
 require_relative 'logger/source_span'
 require_relative 'node_package_importer'
 require_relative 'serializer'
+require_relative 'uri'
 require_relative 'value'
 
 module Sass
@@ -86,7 +87,7 @@ module Sass
                 verbose: false)
       raise ArgumentError, 'path must be set' if path.nil?
 
-      Host.new(@channel).compile_request(
+      Session.new(@channel).compile_request(
         path:,
         source: nil,
         importer: nil,
@@ -169,7 +170,7 @@ module Sass
                        verbose: false)
       raise ArgumentError, 'source must be set' if source.nil?
 
-      Host.new(@channel).compile_request(
+      Session.new(@channel).compile_request(
         path: nil,
         source:,
         importer:,
@@ -198,7 +199,7 @@ module Sass
     def info
       @info ||= [
         ['sass-embedded', Embedded::VERSION, '(Embedded Host)', '[Ruby]'].join("\t"),
-        Host.new(@channel).version_request.join("\t")
+        Session.new(@channel).version_request.join("\t")
       ].join("\n").freeze
     end
 

data/lib/sass/embedded/version.rb

@@ -2,6 +2,6 @@
 
 module Sass
   module Embedded
-    VERSION = '1.99.0'
+    VERSION = '1.101.0'
   end
 end