sass 1.45.0-rc.2 → 1.46.0

package/LICENSE

@@ -247,8 +247,8 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 --------------------------------------------------------------------------------
 
-charcode, http_parser, oauth2, path, pool, shelf_web_socket, source_maps,
-source_span, stack_trace, string_scanner and yaml license:
+charcode, http_parser, oauth2, pool, shelf_web_socket, source_maps, source_span,
+stack_trace, string_scanner and yaml license:
 
 Copyright 2014, the Dart project authors. All rights reserved.
 Redistribution and use in source and binary forms, with or without
@@ -821,7 +821,8 @@ coverage and quiver license:
 
 --------------------------------------------------------------------------------
 
-dart_style, glob, http, matcher, pub_semver, shelf, test and watcher license:
+dart_style, glob, http, matcher, path, pub_semver, shelf, test and watcher
+license:
 
 Copyright 2014, the Dart project authors. 
 

package/README.md

@@ -25,7 +25,6 @@ executable and a Node.js API.
 [Dart Sass]: https://github.com/sass/dart-sass
 
 * [Usage](#usage)
-* [API](#api)
 * [See Also](#see-also)
 * [Behavioral Differences from Ruby Sass](#behavioral-differences-from-ruby-sass)
 
@@ -39,59 +38,65 @@ library:
 [npm]: https://www.npmjs.com/package/sass
 
 ```js
-var sass = require('sass');
+const sass = require('sass');
 
-sass.render({file: scss_filename}, function(err, result) { /* ... */ });
+const result = sass.compile(scssFilename);
 
 // OR
 
-var result = sass.renderSync({file: scss_filename});
+// Note that `compileAsync()` is substantially slower than `compile()`.
+const result = await sass.compileAsync(scssFilename);
 ```
 
-[See below](#api) for details on Dart Sass's JavaScript API.
+See [the Sass website][js api] for full API documentation.
 
-## API
+[js api]: https://sass-lang.com/documentation/js-api
+
+### Legacy API
 
-When installed via npm, Dart Sass supports a JavaScript API that's fully
-compatible with [Node Sass][] (with a few exceptions listed below), with support
-for both the `render()` and `renderSync()` functions. See [the Sass
-website][js api] for full API documentation!
+Dart Sass also supports an older JavaScript API that's fully compatible with
+[Node Sass] (with a few exceptions listed below), with support for both the
+[`render()`] and [`renderSync()`] functions. This API is considered deprecated
+and will be removed in Dart Sass 2.0.0, so it should be avoided in new projects.
 
 [Node Sass]: https://github.com/sass/node-sass
-[js api]: https://sass-lang.com/documentation/js-api
+[`render()`]: https://sass-lang.com/documentation/js-api/modules#render
+[`renderSync()`]: https://sass-lang.com/documentation/js-api/modules#renderSync
+
+Sass's support for the legacy JavaScript API has the following limitations:
 
-Note however that **`renderSync()` is more than twice as fast as `render()`**
-due to the overhead of asynchronous callbacks. Both `render()` and
-`renderSync()` support the following options:
-
-* [`data`](https://github.com/sass/node-sass#data)
-* [`file`](https://github.com/sass/node-sass#file)
-* [`functions`](https://github.com/sass/node-sass#functions--v300---experimental)
-* [`importer`](https://github.com/sass/node-sass#importer--v200---experimental)
-* [`includePaths`](https://github.com/sass/node-sass#includepaths)
-* [`indentType`](https://github.com/sass/node-sass#indenttype)
-* [`indentWidth`](https://github.com/sass/node-sass#indentwidth)
-* [`indentedSyntax`](https://github.com/sass/node-sass#indentedsyntax)
-* [`linefeed`](https://github.com/sass/node-sass#linefeed)
-* [`omitSourceMapUrl`](https://github.com/sass/node-sass#omitsourcemapurl)
-* [`outFile`](https://github.com/sass/node-sass#outfile)
-* [`sourceMapContents`](https://github.com/sass/node-sass#sourcemapcontents)
-* [`sourceMapEmbed`](https://github.com/sass/node-sass#sourcemapembed)
-* [`sourceMapRoot`](https://github.com/sass/node-sass#sourcemaproot)
-* [`sourceMap`](https://github.com/sass/node-sass#sourcemap)
-* Only the `"expanded"` and `"compressed"` values of
-  [`outputStyle`](https://github.com/sass/node-sass#outputstyle) are supported.
-* `charset` (`true`, the default, will prefix non-ASCII CSS with `U+FEFF` or
-  [`@charset "UTF-8";`](https://developer.mozilla.org/en-US/docs/Web/CSS/@charset))
-
-No support is intended for the following options:
-
-* [`precision`](https://github.com/sass/node-sass#precision). Dart Sass defaults
-  to a sufficiently high precision for all existing browsers, and making this
+* Only the `"expanded"` and `"compressed"` values of [`outputStyle`] are
+  supported.
+
+* Dart Sass doesn't support the [`precision`] option. Dart Sass defaults to a
+  sufficiently high precision for all existing browsers, and making this
   customizable would make the code substantially less efficient.
 
-* [`sourceComments`](https://github.com/sass/node-sass#sourcecomments). Source
-  maps are the recommended way of locating the origin of generated selectors.
+* Dart Sass doesn't support the [`sourceComments`] option. Source maps are the
+  recommended way of locating the origin of generated selectors.
+
+[`outputStyle`]: https://sass-lang.com/documentation/js-api/interfaces/LegacySharedOptions#outputStyle
+[`precision`]: https://github.com/sass/node-sass#precision
+[`sourceComments`]: https://github.com/sass/node-sass#sourcecomments
+
+### From Pub
+
+If you're a Dart user, you can install Dart Sass globally using `pub global
+activate sass`, which will provide a `sass` executable. You can also add it to
+your pubspec and use it as a library. We strongly recommend importing it with
+the prefix `sass`:
+
+```dart
+import 'package:sass/sass.dart' as sass;
+
+void main(List<String> args) {
+  print(sass.compile(args.first));
+}
+```
+
+See [the Dart API docs][api] for details.
+
+[api]: https://www.dartdocs.org/documentation/sass/latest/sass/sass-library.html
 
 ## See Also
 

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.0-rc.2","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.46.0","bin":{"sass":"sass.js"},"main":"sass.default.dart.js","exports":{"default":"./sass.default.dart.js"}}