sass-embedded 1.54.6-x64-mingw-ucrt

data/lib/sass/value/number.rb

@@ -0,0 +1,358 @@
+# frozen_string_literal: true
+
+require_relative 'number/unit'
+
+module Sass
+  module Value
+    # Sass's number type.
+    #
+    # @see https://sass-lang.com/documentation/js-api/classes/SassNumber
+    class Number
+      include Value
+
+      # @param value [Numeric]
+      # @param unit [::String, Hash]
+      # @option unit [Array<::String>] :numerator_units
+      # @option unit [Array<::String>] :denominator_units
+      def initialize(value, unit = nil)
+        case unit
+        when nil
+          numerator_units = []
+          denominator_units = []
+        when ::String
+          numerator_units = [unit]
+          denominator_units = []
+        when ::Hash
+          numerator_units = unit.fetch(:numerator_units, [])
+          raise error "invalid numerator_units #{numerator_units.inspect}" unless numerator_units.is_a? Array
+
+          denominator_units = unit.fetch(:denominator_units, [])
+          raise error "invalid denominator_units #{denominator_units.inspect}" unless denominator_units.is_a? Array
+        else
+          raise error "invalid unit #{unit.inspect}"
+        end
+
+        unless denominator_units.empty? && numerator_units.empty?
+          value = value.dup
+          numerator_units = numerator_units.dup
+          new_denominator_units = []
+
+          denominator_units.each do |denominator_unit|
+            index = numerator_units.find_index do |numerator_unit|
+              factor = Unit.conversion_factor(denominator_unit, numerator_unit)
+              if factor.nil?
+                false
+              else
+                value *= factor
+                true
+              end
+            end
+            if index.nil?
+              new_denominator_units.push(denominator_unit)
+            else
+              numerator_units.delete_at(index)
+            end
+          end
+
+          denominator_units = new_denominator_units
+        end
+
+        @value = value.freeze
+        @numerator_units = numerator_units.freeze
+        @denominator_units = denominator_units.freeze
+      end
+
+      # @return [Numeric]
+      attr_reader :value
+
+      # @return [Array<::String>]
+      attr_reader :numerator_units, :denominator_units
+
+      # @return [::Boolean]
+      def ==(other)
+        return false unless other.is_a? Sass::Value::Number
+
+        return false if numerator_units.length != other.numerator_units.length ||
+                        denominator_units.length != other.denominator_units.length
+
+        return FuzzyMath.equals(value, other.value) if unitless?
+
+        if Unit.canonicalize_units(numerator_units) != Unit.canonicalize_units(other.numerator_units) &&
+           Unit.canonicalize_units(denominator_units) != Unit.canonicalize_units(other.denominator_units)
+          return false
+        end
+
+        FuzzyMath.equals(
+          (value *
+          Unit.canonical_multiplier(numerator_units) /
+          Unit.canonical_multiplier(denominator_units)),
+          (other.value *
+          Unit.canonical_multiplier(other.numerator_units) /
+          Unit.canonical_multiplier(other.denominator_units))
+        )
+      end
+
+      # @return [Integer]
+      def hash
+        @hash ||= FuzzyMath.hash(canonical_units_value)
+      end
+
+      # @return [::Boolean]
+      def unitless?
+        numerator_units.empty? && denominator_units.empty?
+      end
+
+      # @return [Number]
+      # @raise [ScriptError]
+      def assert_unitless(name = nil)
+        raise error "Expected #{self} to have no units", name unless unitless?
+
+        self
+      end
+
+      # @return [::Boolean]
+      def units?
+        !unitless?
+      end
+
+      # @param unit [::String]
+      # @return [::Boolean]
+      def unit?(unit)
+        single_unit? && numerator_units.first == unit
+      end
+
+      # @param unit [::String]
+      # @return [Number]
+      # @raise [ScriptError]
+      def assert_unit(unit, name = nil)
+        raise error "Expected #{self} to have unit #{unit.inspect}", name unless unit?(unit)
+
+        self
+      end
+
+      # @return [::Boolean]
+      def integer?
+        FuzzyMath.integer?(value)
+      end
+
+      # @return [Integer]
+      # @raise [ScriptError]
+      def assert_integer(name = nil)
+        raise error "#{self} is not an integer", name unless integer?
+
+        to_i
+      end
+
+      # @return [Integer]
+      def to_i
+        FuzzyMath.to_i(value)
+      end
+
+      # @param min [Numeric]
+      # @param max [Numeric]
+      # @return [Numeric]
+      # @raise [ScriptError]
+      def assert_between(min, max, name = nil)
+        FuzzyMath.assert_between(value, min, max, name)
+      end
+
+      # @param unit [::String]
+      # @return [::Boolean]
+      def compatible_with_unit?(unit)
+        single_unit? && !Unit.conversion_factor(numerator_units.first, unit).nil?
+      end
+
+      # @param new_numerator_units [Array<::String>]
+      # @param new_denominator_units [Array<::String>]
+      # @return [Number]
+      def convert(new_numerator_units, new_denominator_units, name = nil)
+        Number.new(convert_value(new_numerator_units, new_denominator_units, name), {
+                     numerator_units: new_numerator_units,
+                     denominator_units: new_denominator_units
+                   })
+      end
+
+      # @param new_numerator_units [Array<::String>]
+      # @param new_denominator_units [Array<::String>]
+      # @return [Numeric]
+      def convert_value(new_numerator_units, new_denominator_units, name = nil)
+        coerce_or_convert_value(new_numerator_units, new_denominator_units,
+                                coerce_unitless: false,
+                                name: name)
+      end
+
+      # @param other [Number]
+      # @return [Number]
+      def convert_to_match(other, name = nil, other_name = nil)
+        Number.new(convert_value_to_match(other, name, other_name), {
+                     numerator_units: other.numerator_units,
+                     denominator_units: other.denominator_units
+                   })
+      end
+
+      # @param other [Number]
+      # @return [Numeric]
+      def convert_value_to_match(other, name = nil, other_name = nil)
+        coerce_or_convert_value(other.numerator_units, other.denominator_units,
+                                coerce_unitless: false,
+                                name: name,
+                                other: other,
+                                other_name: other_name)
+      end
+
+      # @param new_numerator_units [Array<::String>]
+      # @param new_denominator_units [Array<::String>]
+      # @return [Number]
+      def coerce(new_numerator_units, new_denominator_units, name = nil)
+        Number.new(coerce_value(new_numerator_units, new_denominator_units, name), {
+                     numerator_units: new_numerator_units,
+                     denominator_units: new_denominator_units
+                   })
+      end
+
+      # @param new_numerator_units [Array<::String>]
+      # @param new_denominator_units [Array<::String>]
+      # @return [Numeric]
+      def coerce_value(new_numerator_units, new_denominator_units, name = nil)
+        coerce_or_convert_value(new_numerator_units, new_denominator_units,
+                                coerce_unitless: true,
+                                name: name)
+      end
+
+      # @param unit [::String]
+      # @return [Numeric]
+      def coerce_value_to_unit(unit, name = nil)
+        coerce_value([unit], [], name)
+      end
+
+      # @param other [Number]
+      # @return [Number]
+      def coerce_to_match(other, name = nil, other_name = nil)
+        Number.new(coerce_value_to_match(other, name, other_name), {
+                     numerator_units: other.numerator_units,
+                     denominator_units: other.denominator_units
+                   })
+      end
+
+      # @param other [Number]
+      # @return [Numeric]
+      def coerce_value_to_match(other, name = nil, other_name = nil)
+        coerce_or_convert_value(other.numerator_units, other.denominator_units,
+                                coerce_unitless: true,
+                                name: name,
+                                other: other,
+                                other_name: other_name)
+      end
+
+      # @return [Number]
+      def assert_number(_name = nil)
+        self
+      end
+
+      protected
+
+      def single_unit?
+        numerator_units.length == 1 && denominator_units.empty?
+      end
+
+      def canonical_units_value
+        if unitless?
+          value
+        elsif single_unit?
+          value * Unit.canonical_multiplier_for_unit(numerator_units.first)
+        else
+          value * Unit.canonical_multiplier(numerator_units) / Unit.canonical_multiplier(denominator_units)
+        end
+      end
+
+      def coerce_or_convert_value(new_numerator_units, new_denominator_units,
+                                  coerce_unitless:,
+                                  name: nil,
+                                  other: nil,
+                                  other_name: nil)
+        if other && (other.numerator_units != new_denominator_units && other.denominator_units != new_denominator_units)
+          raise error "Expect #{other} to have units #{unit_string(new_numerator_units, new_denominator_units).inspect}"
+        end
+
+        return value if numerator_units == new_numerator_units && denominator_units == new_denominator_units
+
+        return value if numerator_units == new_numerator_units && denominator_units == new_denominator_units
+
+        other_unitless = new_numerator_units.empty? && new_denominator_units.empty?
+
+        return value if coerce_unitless && (unitless? || other_unitless)
+
+        compatibility_error = lambda {
+          unless other.nil?
+            message = +"#{self} and"
+            message << " $#{other_name}:" unless other_name.nil?
+            message << " #{other} have incompatible units"
+            message << " (one has units and the other doesn't)" if unitless? || other_unitless
+            return error message, name
+          end
+
+          return error "Expected #{self} to have no units", name unless other_unitless
+
+          if new_numerator_units.length == 1 && new_denominator_units.empty?
+            type = Unit::TYPES_BY_UNIT[new_numerator_units.first]
+            return error "Expected #{self} to have a #{type} unit (#{Unit::UNITS_BY_TYPE[type].join(', ')})", name
+          end
+
+          unit_length = new_numerator_units.length + new_denominator_units.length
+          units = unit_string(new_numerator_units, new_denominator_units)
+          error "Expected #{self} to have unit#{unit_length > 1 ? 's' : ''} #{units}", name
+        }
+
+        result = value
+
+        old_numerator_units = numerator_units.dup
+        new_numerator_units.each do |new_numerator_unit|
+          index = old_numerator_units.find_index do |old_numerator_unit|
+            factor = Unit.conversion_factor(new_numerator_unit, old_numerator_unit)
+            if factor.nil?
+              false
+            else
+              result *= factor
+              true
+            end
+          end
+          raise compatibility_error.call if index.nil?
+
+          old_numerator_units.delete_at(index)
+        end
+
+        old_denominator_units = denominator_units.dup
+        new_denominator_units.each do |new_denominator_unit|
+          index = old_denominator_units.find_index do |old_denominator_unit|
+            factor = Unit.conversion_factor(new_denominator_unit, old_denominator_unit)
+            if factor.nil?
+              false
+            else
+              result /= factor
+              true
+            end
+          end
+          raise compatibility_error.call if index.nil?
+
+          old_denominator_units.delete_at(index)
+        end
+
+        raise compatibility_error.call unless old_numerator_units.empty? && old_denominator_units.empty?
+
+        result
+      end
+
+      def unit_string(numerator_units, denominator_units)
+        if numerator_units.empty?
+          return 'no units' if denominator_units.empty?
+
+          return denominator_units.length == 1 ? "#{denominator_units.first}^-1" : "(#{denominator_units.join('*')})^-1"
+        end
+
+        return numerator_units.join('*') if denominator_units.empty?
+
+        "#{numerator_units.join('*')}/#{denominator_units.join('*')}"
+      end
+    end
+  end
+end

data/lib/sass/value/string.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Sass
+  module Value
+    # Sass's string type.
+    #
+    # @see https://sass-lang.com/documentation/js-api/classes/SassString
+    class String
+      include Value
+
+      # @param text [::String]
+      # @param quoted [::Boolean]
+      def initialize(text = '', quoted: true)
+        @text = text.freeze
+        @quoted = quoted
+      end
+
+      # @return [::String]
+      attr_reader :text
+
+      # @return [::Boolean]
+      def quoted?
+        @quoted
+      end
+
+      # @return [::Boolean]
+      def ==(other)
+        other.is_a?(Sass::Value::String) && other.text == text
+      end
+
+      # @return [Integer]
+      def hash
+        @hash ||= text.hash
+      end
+
+      # @return [String]
+      def assert_string(_name = nil)
+        self
+      end
+
+      # @param sass_index [Number]
+      # @return [Integer]
+      def sass_index_to_string_index(sass_index, name = nil)
+        index = sass_index.assert_number(name).assert_integer(name)
+        raise error('String index may not be 0', name) if index.zero?
+
+        if index.abs > text.length
+          raise error("Invalid index #{sass_index} for a string with #{text.length} characters", name)
+        end
+
+        index.negative? ? text.length + index : index - 1
+      end
+    end
+  end
+end

data/lib/sass/value.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+require_relative 'script_error'
+
+module Sass
+  # The abstract base class of Sass's value types.
+  #
+  # @see https://sass-lang.com/documentation/js-api/classes/Value
+  module Value
+    # @return [::String, nil]
+    def separator
+      nil
+    end
+
+    # @return [::Boolean]
+    def bracketed?
+      false
+    end
+
+    # @return [::Boolean]
+    def eql?(other)
+      self == other
+    end
+
+    # @param index [Numeric]
+    # @return [Value]
+    def [](index)
+      at(index)
+    end
+
+    # @param index [Numeric]
+    # @return [Value]
+    def at(index)
+      index < 1 && index >= -1 ? self : nil
+    end
+
+    # @return [Array<Value>]
+    def to_a
+      [self]
+    end
+
+    # @return [::Boolean]
+    def to_bool
+      true
+    end
+
+    # @return [Map, nil]
+    def to_map
+      nil
+    end
+
+    # @return [Value, nil]
+    def to_nil
+      self
+    end
+
+    # @return [Boolean]
+    # @raise [ScriptError]
+    def assert_boolean(name = nil)
+      raise error("#{self} is not a boolean", name)
+    end
+
+    # @raise [ScriptError]
+    def assert_calculation(name = nil)
+      raise error("#{self} is not a calculation", name)
+    end
+
+    # @return [Color]
+    # @raise [ScriptError]
+    def assert_color(name = nil)
+      raise error("#{self} is not a color", name)
+    end
+
+    # @return [Function]
+    # @raise [ScriptError]
+    def assert_function(name = nil)
+      raise error("#{self} is not a function", name)
+    end
+
+    # @return [Map]
+    # @raise [ScriptError]
+    def assert_map(name = nil)
+      raise error("#{self} is not a map", name)
+    end
+
+    # @return [Number]
+    # @raise [ScriptError]
+    def assert_number(name = nil)
+      raise error("#{self} is not a number", name)
+    end
+
+    # @return [String]
+    # @raise [ScriptError]
+    def assert_string(name = nil)
+      raise error("#{self} is not a string", name)
+    end
+
+    # @param sass_index [Number]
+    # @return [Integer]
+    def sass_index_to_array_index(sass_index, name = nil)
+      index = sass_index.assert_number(name).assert_integer(name)
+      raise error('List index may not be 0', name) if index.zero?
+
+      if index.abs > to_a_length
+        raise error("Invalid index #{sass_index} for a list with #{to_a_length} elements", name)
+      end
+
+      index.negative? ? to_a_length + index : index - 1
+    end
+
+    private
+
+    def to_a_length
+      1
+    end
+
+    def error(message, name = nil)
+      Sass::ScriptError.new name.nil? ? message : "$#{name}: #{message}"
+    end
+  end
+end
+
+require_relative 'value/list'
+require_relative 'value/argument_list'
+require_relative 'value/boolean'
+require_relative 'value/color'
+require_relative 'value/function'
+require_relative 'value/fuzzy_math'
+require_relative 'value/map'
+require_relative 'value/null'
+require_relative 'value/number'
+require_relative 'value/string'

data/lib/sass-embedded.rb

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative 'sass/embedded'