sass 1.45.1 → 1.48.0

package/package.json

@@ -1 +1 @@
-{"name":"sass","description":"A pure JavaScript implementation of Sass.","license":"MIT","bugs":"https://github.com/sass/dart-sass/issues","homepage":"https://github.com/sass/dart-sass","repository":{"type":"git","url":"https://github.com/sass/dart-sass"},"author":{"name":"Natalie Weizenbaum","email":"nweiz@google.com","url":"https://github.com/nex3"},"engines":{"node":">=8.9.0"},"dependencies":{"chokidar":">=3.0.0 <4.0.0","immutable":"^4.0.0","source-map-js":">=0.6.2 <2.0.0"},"keywords":["style","scss","sass","preprocessor","css"],"types":"types/index.d.ts","version":"1.45.1","bin":{"sass":"sass.js"},"main":"sass.default.dart.js","exports":{"default":"./sass.default.dart.js"}}
+{"name":"sass","description":"A pure JavaScript implementation of Sass.","license":"MIT","bugs":"https://github.com/sass/dart-sass/issues","homepage":"https://github.com/sass/dart-sass","repository":{"type":"git","url":"https://github.com/sass/dart-sass"},"author":{"name":"Natalie Weizenbaum","email":"nweiz@google.com","url":"https://github.com/nex3"},"engines":{"node":">=8.9.0"},"dependencies":{"chokidar":">=3.0.0 <4.0.0","immutable":"^4.0.0","source-map-js":">=0.6.2 <2.0.0"},"keywords":["style","scss","sass","preprocessor","css"],"types":"types/index.d.ts","version":"1.48.0","bin":{"sass":"sass.js"},"main":"sass.default.dart.js","exports":{"default":"./sass.default.dart.js"}}

package/sass.dart.js

@@ -20032,10 +20032,11 @@ self.readline = _cli_pkg_requires.readline;
       }
     },
     _newRenderResult(options, result, start) {
-      var t3, sourceMapOption, sourceMapPath, t4, sourceMapDir, outFile, t5, file, sourceMapDirUrl, i, source, t6, t7, sourceMapBytes, buffer, indices, url, t8, t9, _null = null,
+      var t3, sourceMapOption, sourceMapPath, t4, sourceMapDir, outFile, t5, file, sourceMapDirUrl, i, source, t6, t7, buffer, indices, url, t8, t9, _null = null,
         t1 = Date.now(),
         t2 = result._compile_result$_serialize,
-        css = t2.css;
+        css = t2.css,
+        sourceMapBytes = type$.Null._as(self.undefined);
       if (A._enableSourceMaps(options)) {
         t3 = J.getInterceptor$x(options);
         sourceMapOption = t3.get$sourceMap(options);
@@ -20101,8 +20102,7 @@ self.readline = _cli_pkg_requires.readline;
           }
           css += "\n\n/*# sourceMappingURL=" + url.toString$0(0) + " */";
         }
-      } else
-        sourceMapBytes = _null;
+      }
       t2 = self.Buffer.from(css, "utf8");
       t3 = J.get$file$x(options);
       if (t3 == null)
@@ -20773,7 +20773,7 @@ self.readline = _cli_pkg_requires.readline;
       J.set$sassFalse$x(self.exports, B.SassBoolean_false0);
       J.set$Exception$x(self.exports, $.$get$exceptionClass());
       J.set$Logger$x(self.exports, {silent: {warn: A.allowInteropNamed("sass.Logger.silent.warn", new A.main_closure0()), debug: A.allowInteropNamed("sass.Logger.silent.debug", new A.main_closure1())}});
-      J.set$info$x(self.exports, "dart-sass\t1.45.1\t(Sass Compiler)\t[Dart]\ndart2js\t2.15.1\t(Dart Compiler)\t[Dart]");
+      J.set$info$x(self.exports, "dart-sass\t1.48.0\t(Sass Compiler)\t[Dart]\ndart2js\t2.15.1\t(Dart Compiler)\t[Dart]");
       A.updateSourceSpanPrototype();
       J.set$render$x(self.exports, A.allowInteropNamed("sass.render", A.legacy__render$closure()));
       J.set$renderSync$x(self.exports, A.allowInteropNamed("sass.renderSync", A.legacy__renderSync$closure()));
@@ -21432,7 +21432,7 @@ self.readline = _cli_pkg_requires.readline;
           switch ($async$goto) {
             case 0:
               // Function start
-              $async$returnValue = "1.45.1 compiled with dart2js 2.15.1";
+              $async$returnValue = "1.48.0 compiled with dart2js 2.15.1";
               // goto return
               $async$goto = 1;
               break;
@@ -66802,12 +66802,12 @@ self.readline = _cli_pkg_requires.readline;
       return A.SassArgumentList$0(t1, t3.cast$2$0(0, type$.String, t2), A.jsToDartSeparator(separator));
     },
     call$3($self, contents, keywords) {
-      return this.call$4($self, contents, keywords, null);
+      return this.call$4($self, contents, keywords, ",");
     },
     "call*": "call$4",
     $requiredArgCount: 3,
     $defaultValues() {
-      return [null];
+      return [","];
     },
     $signature: 301
   };
@@ -86834,8 +86834,10 @@ self.readline = _cli_pkg_requires.readline;
         warn = t1 == null ? null : J.get$warn$x(t1);
       if (warn == null)
         this._withAscii$1(new A.NodeToDartLogger_warn_closure(this, message, span, trace, deprecation));
-      else
-        warn.call$2(message, {deprecation: deprecation, span: span, stack: J.toString$0$(trace)});
+      else {
+        t1 = span == null ? type$.nullable_SourceSpan._as(self.undefined) : span;
+        warn.call$2(message, {deprecation: deprecation, span: t1, stack: J.toString$0$(trace)});
+      }
     },
     warn$1($receiver, message) {
       return this.warn$4$deprecation$span$trace($receiver, message, false, null, null);
@@ -97963,6 +97965,7 @@ self.readline = _cli_pkg_requires.readline;
       nullable_List_ComplexSelector_2: findType("List<ComplexSelector0>?"),
       nullable_Object: findType("Object?"),
       nullable_SourceFile: findType("SourceFile?"),
+      nullable_SourceSpan: findType("SourceSpan?"),
       nullable_StreamSubscription_WatchEvent: findType("StreamSubscription<WatchEvent>?"),
       nullable_String: findType("String?"),
       nullable_Stylesheet: findType("Stylesheet?"),

package/types/index.d.ts

@@ -41,10 +41,14 @@ export {
 // Legacy APIs
 export {LegacyException} from './legacy/exception';
 export {
+  FALSE,
   LegacyAsyncFunction,
-  LegacySyncFunction,
+  LegacyAsyncFunctionDone,
   LegacyFunction,
+  LegacySyncFunction,
   LegacyValue,
+  NULL,
+  TRUE,
   types,
 } from './legacy/function';
 export {

package/types/legacy/function.d.ts

@@ -68,9 +68,10 @@ export type LegacySyncFunction = (
  * });
  * ```
  *
- * @param args - One argument for each argument that's declared in the signature
- * that's passed to [[LegacySharedOptions.functions]]. If the signature [takes
- * arbitrary arguments](https://sass-lang.com/documentation/at-rules/function#taking-arbitrary-arguments),
+ * This is passed one argument for each argument that's declared in the
+ * signature that's passed to [[LegacySharedOptions.functions]]. If the
+ * signature [takes arbitrary
+ * arguments](https://sass-lang.com/documentation/at-rules/function#taking-arbitrary-arguments),
  * they're passed as a single argument list in the last argument before the
  * callback.
  *
@@ -79,9 +80,73 @@ export type LegacySyncFunction = (
  * APIs. Use [[CustomFunction]] with [[compile]], [[compileString]],
  * [[compileAsync]], and [[compileStringAsync]] instead.
  */
-export type LegacyAsyncFunction = (
-  this: LegacyPluginThis,
-  ...args: [...LegacyValue[], (result: LegacyValue) => void]
+export type LegacyAsyncFunction =
+  | ((this: LegacyPluginThis, done: (result: LegacyValue) => void) => void)
+  | ((
+      this: LegacyPluginThis,
+      arg1: LegacyValue,
+      done: LegacyAsyncFunctionDone
+    ) => void)
+  | ((
+      this: LegacyPluginThis,
+      arg1: LegacyValue,
+      arg2: LegacyValue,
+      done: LegacyAsyncFunctionDone
+    ) => void)
+  | ((
+      this: LegacyPluginThis,
+      arg1: LegacyValue,
+      arg2: LegacyValue,
+      arg3: LegacyValue,
+      done: LegacyAsyncFunctionDone
+    ) => void)
+  | ((
+      this: LegacyPluginThis,
+      arg1: LegacyValue,
+      arg2: LegacyValue,
+      arg3: LegacyValue,
+      arg4: LegacyValue,
+      done: LegacyAsyncFunctionDone
+    ) => void)
+  | ((
+      this: LegacyPluginThis,
+      arg1: LegacyValue,
+      arg2: LegacyValue,
+      arg3: LegacyValue,
+      arg4: LegacyValue,
+      arg5: LegacyValue,
+      done: LegacyAsyncFunctionDone
+    ) => void)
+  | ((
+      this: LegacyPluginThis,
+      arg1: LegacyValue,
+      arg2: LegacyValue,
+      arg3: LegacyValue,
+      arg4: LegacyValue,
+      arg5: LegacyValue,
+      arg6: LegacyValue,
+      done: LegacyAsyncFunctionDone
+    ) => void)
+  | ((
+      this: LegacyPluginThis,
+      ...args: [...LegacyValue[], LegacyAsyncFunctionDone]
+    ) => void);
+
+/**
+ * The function called by a [[LegacyAsyncFunction]] to indicate that it's
+ * finished.
+ *
+ * @param result - If this is a [[LegacyValue]], that indicates that the
+ * function call completed successfully. If it's a [[types.Error]], that
+ * indicates that the function call failed.
+ *
+ * @category Legacy
+ * @deprecated This only works with the legacy [[render]] and [[renderSync]]
+ * APIs. Use [[CustomFunction]] with [[compile]], [[compileString]],
+ * [[compileAsync]], and [[compileStringAsync]] instead.
+ */
+export type LegacyAsyncFunctionDone = (
+  result: LegacyValue | types.Error
 ) => void;
 
 /**
@@ -119,6 +184,36 @@ export type LegacyValue =
   | types.List
   | types.Map;
 
+/**
+ * A shorthand for `sass.types.Boolean.TRUE`.
+ *
+ * @category Legacy
+ * @deprecated This only works with the legacy [[render]] and [[renderSync]]
+ * APIs. Use [[sassTrue]] with [[compile]], [[compileString]], [[compileAsync]],
+ * and [[compileStringAsync]] instead.
+ */
+export const TRUE: types.Boolean<true>;
+
+/**
+ * A shorthand for `sass.types.Boolean.FALSE`.
+ *
+ * @category Legacy
+ * @deprecated This only works with the legacy [[render]] and [[renderSync]]
+ * APIs. Use [[sassFalse]] with [[compile]], [[compileString]], [[compileAsync]],
+ * and [[compileStringAsync]] instead.
+ */
+export const FALSE: types.Boolean<false>;
+
+/**
+ * A shorthand for `sass.types.Null.NULL`.
+ *
+ * @category Legacy
+ * @deprecated This only works with the legacy [[render]] and [[renderSync]]
+ * APIs. Use [[sassNull]] with [[compile]], [[compileString]], [[compileAsync]],
+ * and [[compileStringAsync]] instead.
+ */
+export const NULL: types.Null;
+
 /**
  * The namespace for value types used in the legacy function API.
  *
@@ -649,4 +744,13 @@ export namespace types {
      */
     getLength(): number;
   }
+
+  /**
+   * An error that can be returned from a Sass function to signal that it
+   * encountered an error. This is the only way to signal an error
+   * asynchronously from a [[LegacyAsyncFunction]].
+   */
+  export class Error {
+    constructor(message: string);
+  }
 }

package/types/legacy/plugin_this.d.ts

@@ -13,6 +13,9 @@ export interface LegacyPluginThis {
    * [[renderSync]].
    */
   options: {
+    /** The same [[LegacyPluginThis]] instance that contains this object. */
+    context: LegacyPluginThis;
+
     /**
      * The value passed to [[LegacyFileOptions.file]] or
      * [[LegacyStringOptions.file]].