Adds built-in clamp() and hypot()

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.25.0
+
+* Add functions to the built-in "sass:math" module.
+
 ## 1.24.0
 
 * Add an optional `with` clause to the `@forward` rule. This works like the

lib/src/functions/math.dart

@@ -12,6 +12,7 @@ import '../exception.dart';
 import '../module/built_in.dart';
 import '../util/number.dart';
 import '../value.dart';
+import '../warn.dart';
 
 /// A random number generator.
 final _random = math.Random();
@@ -21,14 +22,16 @@ final global = UnmodifiableListView([
   _round, _ceil, _floor, _abs, _max, _min, _randomFunction, _unit, //
   _percentage,
   _isUnitless.withName("unitless"),
-  _compatible.withName("comparable")
+  _compatible.withName("comparable"),
+  _div.withName("divide")
 ]);
 
 /// The Sass math module.
 final module = BuiltInModule("math", functions: [
   _round, _ceil, _floor, _abs, _max, _min, _randomFunction, _unit,
   _isUnitless, //
-  _percentage, _compatible
+  _percentage, _compatible,
+  _clamp, _div, _hypot
 ]);
 
 final _percentage = BuiltInCallable("percentage", r"$number", (arguments) {
@@ -98,3 +101,57 @@ BuiltInCallable _numberFunction(String name, num transform(num value)) {
         denominatorUnits: number.denominatorUnits);
   });
 }
+
+final _clamp = BuiltInCallable("clamp", r"$min, $preferred, $max", (arguments) {
+  var min = arguments[0].assertNumber("min");
+  var preferred = arguments[1].assertNumber("preferred");
+  var max = arguments[2].assertNumber("max");
+
+  if (min.hasUnits != preferred.hasUnits ||
+      preferred.hasUnits != max.hasUnits) {
+    throw SassScriptException(
+        "Mixing unitless arguments with arguments that have units is not allowed.");
+  }
+
+  if (min.greaterThanOrEquals(max).isTruthy) return min;
+  if (preferred.lessThanOrEquals(min).isTruthy) return min;
+  if (preferred.greaterThanOrEquals(max).isTruthy) return max;
+  return preferred;
+});
+
+final _div = BuiltInCallable("div", r"$dividend, $divisor", (arguments) {
+  var dividend = arguments[0];
+  var divisor = arguments[1];
+
+  if (dividend is SassString || divisor is SassString) {
+    warn("Passing a string is deprecated.");
+  }
+
+  return dividend.dividedBy(divisor);
+});
+
+final _hypot = BuiltInCallable("hypot", r"$numbers...", (arguments) {
+  var numbers =
+      arguments[0].asList.map((argument) => argument.assertNumber()).toList();
+
+  if (numbers.isEmpty) {
+    throw SassScriptException("At least one argument must be passed.");
+  }
+
+  var unitRequirement = numbers[0].hasUnits;
+  var numeratorUnits = numbers[0].numeratorUnits;
+  var denominatorUnits = numbers[0].denominatorUnits;
+  var subtotal = 0.0;
+
+  for (var number in numbers) {
+    if (number.hasUnits != unitRequirement) {
+      throw SassScriptException(
+          "Mixing unitless arguments with arguments that have units is not allowed.");
+    }
+    number = number.coerce(numeratorUnits, denominatorUnits);
+    subtotal += math.pow(number.value, 2);
+  }
+
+  return SassNumber.withUnits(math.sqrt(subtotal),
+      numeratorUnits: numeratorUnits, denominatorUnits: denominatorUnits);
+});

lib/src/parse/stylesheet.dart

@@ -2367,6 +2367,9 @@ relase. For details, see http://bit.ly/moz-document.
     number += _tryDecimal(allowTrailingDot: scanner.position != start.position);
     number *= _tryExponent();
 
+    // Preserve the sign of -0 by representing it as a double.
+    number = (sign.isNegative && number == 0) ? -0.0 : sign * number;
+
     String unit;
     if (scanner.scanChar($percent)) {
       unit = "%";
@@ -2376,7 +2379,7 @@ relase. For details, see http://bit.ly/moz-document.
       unit = identifier(unit: true);
     }
 
-    return NumberExpression(sign * number, scanner.spanFrom(start), unit: unit);
+    return NumberExpression(number, scanner.spanFrom(start), unit: unit);
   }
 
   /// Consumes the decimal component of a number and returns its value, or 0 if

pubspec.yaml

@@ -1,5 +1,5 @@
 name: sass
-version: 1.24.0
+version: 1.25.0-dev
 description: A Sass implementation in Dart.
 author: Sass Team
 homepage: https://github.com/sass/dart-sass