Breaking change on importer function signature

Author: ntkme

lib/sass/canonicalize_context.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Sass
+  # Contextual information passed to `canonicalize` and `find_file_url`.
+  # Not all importers will need this information to resolve loads, but some may find it useful.
+  #
+  # @see https://sass-lang.com/documentation/js-api/interfaces/canonicalizecontext/
+  class CanonicalizeContext
+    # @return [String, nil]
+    attr_reader :containing_url
+
+    # @return [Boolean]
+    attr_reader :from_import
+
+    def initialize(containing_url, from_import)
+      @containing_url = containing_url
+      @from_import = from_import
+    end
+  end
+end

lib/sass/embedded.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative '../../ext/sass/cli'
+require_relative 'canonicalize_context'
 require_relative 'compile_error'
 require_relative 'compile_result'
 require_relative 'embedded/connection'

lib/sass/embedded/host/importer_registry.rb

@@ -26,7 +26,7 @@ def initialize(importers, load_paths, alert_color:)
         end
 
         def register(importer)
-          importer = Structifier.to_struct(importer, :canonicalize, :load, :find_file_url)
+          importer = Structifier.to_struct(importer, :canonicalize, :load, :non_canonical_scheme, :find_file_url)
 
           is_importer = importer.respond_to?(:canonicalize) && importer.respond_to?(:load)
           is_file_importer = importer.respond_to?(:find_file_url)
@@ -39,7 +39,17 @@ def register(importer)
           @importers_by_id[id] = importer
           if is_importer
             EmbeddedProtocol::InboundMessage::CompileRequest::Importer.new(
-              importer_id: id
+              importer_id: id,
+              non_canonical_scheme: if importer.respond_to?(:non_canonical_scheme)
+                                      non_canonical_scheme = importer.non_canonical_scheme
+                                      if non_canonical_scheme.is_a?(String)
+                                        [non_canonical_scheme]
+                                      else
+                                        non_canonical_scheme || []
+                                      end
+                                    else
+                                      []
+                                    end
             )
           else
             EmbeddedProtocol::InboundMessage::CompileRequest::Importer.new(
@@ -50,7 +60,8 @@ def register(importer)
 
         def canonicalize(canonicalize_request)
           importer = @importers_by_id[canonicalize_request.importer_id]
-          url = importer.canonicalize(canonicalize_request.url, from_import: canonicalize_request.from_import)&.to_s
+          url = importer.canonicalize(canonicalize_request.url,
+                                      Protofier.from_proto_canonicalize_context(canonicalize_request))&.to_s
 
           EmbeddedProtocol::InboundMessage::CanonicalizeResponse.new(
             id: canonicalize_request.id,
@@ -84,7 +95,8 @@ def import(import_request)
 
         def file_import(file_import_request)
           importer = @importers_by_id[file_import_request.importer_id]
-          file_url = importer.find_file_url(file_import_request.url, from_import: file_import_request.from_import)&.to_s
+          file_url = importer.find_file_url(file_import_request.url,
+                                            Protofier.from_proto_canonicalize_context(file_import_request))&.to_s
 
           EmbeddedProtocol::InboundMessage::FileImportResponse.new(
             id: file_import_request.id,

lib/sass/embedded/protofier.rb

@@ -8,6 +8,13 @@ class Embedded
     module Protofier
       module_function
 
+      def from_proto_canonicalize_context(canonicalize_request)
+        CanonicalizeContext.new(
+          canonicalize_request.containing_url == '' ? nil : canonicalize_request.containing_url,
+          canonicalize_request.from_import
+        )
+      end
+
       def from_proto_compile_response(compile_response)
         oneof = compile_response.result
         result = compile_response.public_send(oneof)