jekyll-sass-converter 2.2.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8210a4fb569272e154c0f114f04ec1a3d71ae306c9c4f2afc1fa19d96437f0c7
-  data.tar.gz: 02be36d0eef40d451be28efb65396093de0e1cee3b44843bb41cc19fb0e5a02b
+  metadata.gz: 103c0bfb64880d66c26803c4ab4152989630d2de956c5804c34cb499403c9f56
+  data.tar.gz: 95df7cdae357c75703ce0382443caf68f26ecf3163b2f4ed47c9d6bddf37d79e
 SHA512:
-  metadata.gz: 8e5420795ee103377c6562ec3e9435991af4a85981f96605f6e2c99e8ec203182ed9b21ea0a5ceabc4a7e5335fc4558fd53920f1958efafac22c0d3da4783c64
-  data.tar.gz: 2da5d0b5f96885c5e3357d1790679c62d129bb2cfa261578ead2e9dc5be562a7baf488118b441effd3c6619adebe7a10698c756d4a7e2eac92c2560d63fd2518
+  metadata.gz: 17eccbb64b470845fb69d43a92885be52d6d9744323cab930a102b8b98ae9c81bf630bbe23fc9bef330324fc132df9f6214f97935c21f192b47ca358ae87d5f4
+  data.tar.gz: dc9faee94ce564f6b7cc5cd0af8c53ebdc783f60662682a85ba0a5b70e6e70b6649bc5f6524ff9bfa044b5c1254a0c71daa1b17e640f1cc538dadf7c6b5749c8

data/lib/jekyll/converters/sass.rb

@@ -1,19 +1,17 @@
 # frozen_string_literal: true
 
-require "sassc"
-require "jekyll/utils"
 require "jekyll/converters/scss"
 
 module Jekyll
   module Converters
     class Sass < Scss
-      EXTENSION_PATTERN = %r!^\.sass$!i.freeze
+      EXTENSION_PATTERN = %r!^\.sass$!i
 
       safe true
       priority :low
 
       def syntax
-        :sass
+        :indented
       end
     end
   end

data/lib/jekyll/converters/scss.rb

@@ -1,14 +1,19 @@
 # frozen_string_literal: true
 
-require "sassc"
-require "jekyll/utils"
-require "jekyll/source_map_page"
+# stdlib
+require "json"
+
+# 3rd party
+require "addressable/uri"
+require "sass-embedded"
+
+# internal
+require_relative "../source_map_page"
 
 module Jekyll
   module Converters
     class Scss < Converter
-      BYTE_ORDER_MARK = %r!^\xEF\xBB\xBF!.freeze
-      EXTENSION_PATTERN = %r!^\.scss$!i.freeze
+      EXTENSION_PATTERN = %r!^\.scss$!i
 
       SyntaxError = Class.new(ArgumentError)
 
@@ -35,8 +40,7 @@ module Jekyll
         end
       end
 
-      ALLOWED_IMPLEMENTATIONS = %w(sassc sass-embedded).freeze
-      ALLOWED_STYLES = %w(nested expanded compact compressed).freeze
+      ALLOWED_STYLES = %w(expanded compressed).freeze
 
       # Associate this Converter with the "page" object that manages input and output files for
       # this converter.
@@ -85,20 +89,12 @@ module Jekyll
         @jekyll_sass_configuration ||= begin
           options = @config["sass"] || {}
           unless options["style"].nil?
-            options["style"] = options["style"].to_s.gsub(%r!\A:!, "").to_sym
+            options["style"] = options["style"].to_s.delete_prefix(":").to_sym
           end
           options
         end
       end
 
-      def sass_build_configuration_options(overrides)
-        return overrides if safe?
-
-        Jekyll::Utils.symbolize_hash_keys(
-          Jekyll::Utils.deep_merge_hashes(jekyll_sass_configuration, overrides)
-        )
-      end
-
       def syntax
         :scss
       end
@@ -109,17 +105,9 @@ module Jekyll
         jekyll_sass_configuration["sass_dir"]
       end
 
-      def sass_implementation
-        implementation = jekyll_sass_configuration["implementation"]
-        ALLOWED_IMPLEMENTATIONS.include?(implementation) ? implementation : "sassc"
-      end
-
       def sass_style
-        # `:expanded` is the default output style for newer sass implementations.
-        # For backward compatibility, `:compact` is kept as the default output style for sassc.
-        default = sass_implementation == "sassc" ? :compact : :expanded
-        style = jekyll_sass_configuration.fetch("style", default)
-        ALLOWED_STYLES.include?(style.to_s) ? style.to_sym : default
+        style = jekyll_sass_configuration["style"]
+        ALLOWED_STYLES.include?(style.to_s) ? style.to_sym : :expanded
       end
 
       def user_sass_load_paths
@@ -127,9 +115,8 @@ module Jekyll
       end
 
       def sass_dir_relative_to_site_source
-        @sass_dir_relative_to_site_source ||= begin
-          Jekyll.sanitized_path(site_source, sass_dir).sub(site.source + "/", "")
-        end
+        @sass_dir_relative_to_site_source ||=
+          Jekyll.sanitized_path(site_source, sass_dir).delete_prefix("#{site.source}/")
       end
 
       # rubocop:disable Metrics/AbcSize
@@ -155,74 +142,48 @@ module Jekyll
       end
       # rubocop:enable Metrics/AbcSize
 
-      def allow_caching?
-        !safe?
-      end
-
-      def add_charset?
-        !!jekyll_sass_configuration["add_charset"]
-      end
-
       def sass_configs
-        sass_build_configuration_options(
-          :style                => sass_style,
-          :syntax               => syntax,
-          :filename             => filename,
-          :output_path          => output_path,
-          :source_map_file      => source_map_file,
-          :load_paths           => sass_load_paths,
-          :omit_source_map_url  => !sourcemap_required?,
-          :source_map_contents  => true,
-          :line_comments_option => line_comments_option
-        )
-      end
-
-      def convert(content)
-        case sass_implementation
-        when "sass-embedded"
-          Jekyll::External.require_with_graceful_fail("sass-embedded")
-          sass_embedded_convert(content)
-        when "sassc"
-          sass_convert(content)
-        end
-      end
-
-      private
-
-      def sass_convert(content)
-        config = sass_configs
-        engine = SassC::Engine.new(content.dup, config)
-        output = engine.render
-        sass_generate_source_map(engine) if sourcemap_required?
-        replacement = add_charset? ? '@charset "UTF-8";' : ""
-        output.sub(BYTE_ORDER_MARK, replacement)
-      rescue SassC::SyntaxError => e
-        raise SyntaxError, e.to_s
-      end
-
-      def sass_embedded_config
         {
           :load_paths                 => sass_load_paths,
+          :charset                    => !associate_page_failed?,
           :source_map                 => sourcemap_required?,
           :source_map_include_sources => true,
           :style                      => sass_style,
-          :syntax                     => syntax == :sass ? :indented : syntax,
+          :syntax                     => syntax,
           :url                        => sass_file_url,
+          :quiet_deps                 => quiet_deps_option,
+          :verbose                    => verbose_option,
+          :fatal_deprecations         => fatal_deprecations,
+          :future_deprecations        => future_deprecations,
+          :silence_deprecations       => silence_deprecations,
         }
       end
 
-      def sass_embedded_convert(content)
-        output = ::Sass.compile_string(content, **sass_embedded_config)
-        sass_embedded_generate_source_map(output.source_map) if sourcemap_required?
-        replacement = add_charset? ? '@charset "UTF-8";' : ""
-        source_mapping_url = Addressable::URI.encode(File.basename(source_map_file))
-        eof = sourcemap_required? ? "\n\n/*# sourceMappingURL=#{source_mapping_url} */" : "\n"
-        output.css.sub(BYTE_ORDER_MARK, replacement) + eof
+      def convert(content)
+        output = ::Sass.compile_string(content, **sass_configs)
+        result = output.css
+
+        if sourcemap_required?
+          source_map = process_source_map(output.source_map)
+          generate_source_map_page(source_map)
+
+          if (sm_url = source_mapping_url)
+            result += "#{sass_style == :compressed ? "" : "\n\n"}/*# sourceMappingURL=#{sm_url} */"
+          end
+        end
+
+        result
       rescue ::Sass::CompileError => e
         Jekyll.logger.error e.full_message
-        raise SyntaxError, e.message
+        if livereload?
+          e.to_css # Render error message in browser window
+        else
+          raise SyntaxError, e.message
+        end
       end
 
+      private
+
       # The Page instance for which this object acts as a converter.
       attr_reader :sass_page
 
@@ -230,30 +191,16 @@ module Jekyll
         !sass_page
       end
 
-      # The name of the input scss (or sass) file. This information will be used for error
-      # reporting and will written into the source map file as main source.
-      #
-      # Returns the name of the input file or "stdin" if #associate_page failed
-      def filename
-        return "stdin" if associate_page_failed?
-
-        File.join(site_source_relative_from_pwd, sass_page.name)
+      # Returns `true` if jekyll is serving with livereload.
+      def livereload?
+        !!(@config["serving"] && @config["livereload"])
       end
 
       # The URL of the input scss (or sass) file. This information will be used for error reporting.
       def sass_file_url
         return if associate_page_failed?
 
-        file_url_from_path(File.join(site_source, sass_page.relative_path))
-      end
-
-      # The value of the `line_comments` option.
-      # When set to `true` causes the line number and filename of the source be emitted into the
-      # compiled CSS-file. Useful for debugging when the source-map is not available.
-      #
-      # Returns the value of the `line_comments`-option chosen by the user or 'false' by default.
-      def line_comments_option
-        jekyll_sass_configuration.fetch("line_comments", false)
+        file_url_from_path(Jekyll.sanitized_path(site_source, sass_page.relative_path))
       end
 
       # The value of the `sourcemap` option chosen by the user.
@@ -275,56 +222,49 @@ module Jekyll
         !(sourcemap_option == :development && Jekyll.env != "development")
       end
 
-      # The name of the generated css file. This information will be written into the source map
-      # file as a backward reference to the input.
-      #
-      # Returns the name of the css file or "stdin.css" if #associate_page failed
-      def output_path
-        return "stdin.css" if associate_page_failed?
-
-        File.join(site_source_relative_from_pwd, sass_page.basename + ".css")
-      end
-
-      # The name of the generated source map file. This information will be written into the
-      # css file to reference to the source map.
-      #
-      # Returns the name of the css file or "" if #associate_page failed
-      def source_map_file
-        return "" if associate_page_failed?
-
-        File.join(site_source_relative_from_pwd, sass_page.basename + ".css.map")
-      end
-
       def source_map_page
         return if associate_page_failed?
 
         @source_map_page ||= SourceMapPage.new(sass_page)
       end
 
-      # Reads the source-map from the engine and adds it to the source-map-page.
+      # Returns the directory that source map sources are relative to.
+      def sass_source_root
+        if associate_page_failed?
+          site_source
+        else
+          Jekyll.sanitized_path(site_source, File.dirname(sass_page.relative_path))
+        end
+      end
+
+      # Converts file urls in source map to relative paths.
       #
-      # @param [::SassC::Engine] engine The sass Compiler engine.
-      def sass_generate_source_map(engine)
+      # Returns processed source map string.
+      def process_source_map(source_map)
+        map_data = JSON.parse(source_map)
+        unless associate_page_failed?
+          map_data["file"] = Addressable::URI.encode("#{sass_page.basename}.css")
+        end
+        source_root_url = Addressable::URI.parse(file_url_from_path("#{sass_source_root}/"))
+        map_data["sources"].map! do |s|
+          s.start_with?("file:") ? Addressable::URI.parse(s).route_from(source_root_url).to_s : s
+        end
+        JSON.generate(map_data)
+      end
+
+      # Adds the source-map to the source-map-page and adds it to `site.pages`.
+      def generate_source_map_page(source_map)
         return if associate_page_failed?
 
-        source_map_page.source_map(engine.source_map)
+        source_map_page.source_map(source_map)
         site.pages << source_map_page
-      rescue ::SassC::NotRenderedError => e
-        Jekyll.logger.warn "Could not generate source map #{e.message} => #{e.cause}"
       end
 
-      # Reads the source-map and adds it to the source-map-page.
-      def sass_embedded_generate_source_map(source_map)
+      # Returns a source mapping url for given source-map.
+      def source_mapping_url
         return if associate_page_failed?
 
-        map_data = JSON.parse(source_map)
-        map_data["file"] = Addressable::URI.encode(File.basename(output_path))
-        map_data["sources"].map! do |s|
-          s.start_with?("file:") ? Addressable::URI.parse(s).route_from(site_source_url) : s
-        end
-
-        source_map_page.source_map(JSON.generate(map_data))
-        site.pages << source_map_page
+        Addressable::URI.encode("#{sass_page.basename}.css.map")
       end
 
       def site
@@ -335,17 +275,33 @@ module Jekyll
         site.source
       end
 
-      def site_source_relative_from_pwd
-        @site_source_relative_from_pwd ||=
-          Pathname.new(site_source).relative_path_from(Pathname.new(Dir.pwd)).to_s
+      def file_url_from_path(path)
+        Addressable::URI.encode("file://#{path.start_with?("/") ? "" : "/"}#{path}")
       end
 
-      def site_source_url
-        @site_source_url ||= file_url_from_path("#{site_source}/")
+      # Returns the value of the `quiet_deps`-option chosen by the user or 'false' by default.
+      def quiet_deps_option
+        !!jekyll_sass_configuration.fetch("quiet_deps", false)
       end
 
-      def file_url_from_path(path)
-        Addressable::URI.encode("file://#{path.start_with?("/") ? "" : "/"}#{path}")
+      # Returns the value of the `verbose`-option chosen by the user or 'false' by default.
+      def verbose_option
+        !!jekyll_sass_configuration.fetch("verbose", false)
+      end
+
+      # Returns the value of the `fatal_deprecations`-option or '[]' by default.
+      def fatal_deprecations
+        Array(jekyll_sass_configuration["fatal_deprecations"])
+      end
+
+      # Returns the value of the `future_deprecations`-option or '[]' by default.
+      def future_deprecations
+        Array(jekyll_sass_configuration["future_deprecations"])
+      end
+
+      # Returns the value of the `silence_deprecations`-option or '[]' by default.
+      def silence_deprecations
+        Array(jekyll_sass_configuration["silence_deprecations"])
       end
     end
   end

data/lib/jekyll/source_map_page.rb

@@ -11,7 +11,7 @@ module Jekyll
       @site = css_page.site
       @dir  = css_page.dir
       @data = css_page.data
-      @name = css_page.basename + ".css.map"
+      @name = "#{css_page.basename}.css.map"
 
       process(@name)
       Jekyll::Hooks.trigger :pages, :post_init, self

data/lib/jekyll-sass-converter/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JekyllSassConverter
-  VERSION = "2.2.0"
+  VERSION = "3.1.0"
 end

metadata

@@ -1,92 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-sass-converter
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Parker Moore
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-02-28 00:00:00.000000000 Z
+date: 2025-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: sassc
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">"
-      - !ruby/object:Gem::Version
-        version: 2.0.1
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">"
-      - !ruby/object:Gem::Version
-        version: 2.0.1
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rubocop-jekyll
+  name: sass-embedded
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.12.0
-  type: :development
+        version: '1.75'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.12.0
-description: 
+        version: '1.75'
+description:
 email:
 - parkrmoore@gmail.com
 executables: []
@@ -102,7 +40,7 @@ homepage: https://github.com/jekyll/jekyll-sass-converter
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -110,15 +48,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key: 
+rubygems_version: 3.3.27
+signing_key:
 specification_version: 4
 summary: A basic Sass converter for Jekyll.
 test_files: []