Add charset option to js-api (#1732)

Author: ntkme

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ### JS API
 
+* Add a `charset` option that controls whether or not Sass emits a
+  `@charset`/BOM for non-ASCII stylesheets.
 * Fix Sass npm package types for TS 4.7+ Node16 and NodeNext module resolution.
 
 ## 1.53.0

lib/sass.dart

@@ -230,7 +230,8 @@ Future<CompileResult> compileToResultAsync(String path,
         OutputStyle? style,
         bool quietDeps = false,
         bool verbose = false,
-        bool sourceMap = false}) =>
+        bool sourceMap = false,
+        bool charset = true}) =>
     c.compileAsync(path,
         logger: logger,
         importCache: AsyncImportCache(
@@ -242,7 +243,8 @@ Future<CompileResult> compileToResultAsync(String path,
         style: style,
         quietDeps: quietDeps,
         verbose: verbose,
-        sourceMap: sourceMap);
+        sourceMap: sourceMap,
+        charset: charset);
 
 /// Like [compileStringToResult], except it runs asynchronously.
 ///

lib/src/node/compile.dart

@@ -42,6 +42,7 @@ NodeCompileResult compile(String path, [CompileOptions? options]) {
         quietDeps: options?.quietDeps ?? false,
         style: _parseOutputStyle(options?.style),
         verbose: options?.verbose ?? false,
+        charset: options?.charset ?? true,
         sourceMap: options?.sourceMap ?? false,
         logger: NodeToDartLogger(options?.logger, Logger.stderr(color: color),
             ascii: ascii),
@@ -70,6 +71,7 @@ NodeCompileResult compileString(String text, [CompileStringOptions? options]) {
         quietDeps: options?.quietDeps ?? false,
         style: _parseOutputStyle(options?.style),
         verbose: options?.verbose ?? false,
+        charset: options?.charset ?? true,
         sourceMap: options?.sourceMap ?? false,
         logger: NodeToDartLogger(options?.logger, Logger.stderr(color: color),
             ascii: ascii),
@@ -98,6 +100,7 @@ Promise compileAsync(String path, [CompileOptions? options]) {
         quietDeps: options?.quietDeps ?? false,
         style: _parseOutputStyle(options?.style),
         verbose: options?.verbose ?? false,
+        charset: options?.charset ?? true,
         sourceMap: options?.sourceMap ?? false,
         logger: NodeToDartLogger(options?.logger, Logger.stderr(color: color),
             ascii: ascii),
@@ -125,6 +128,7 @@ Promise compileStringAsync(String text, [CompileStringOptions? options]) {
         quietDeps: options?.quietDeps ?? false,
         style: _parseOutputStyle(options?.style),
         verbose: options?.verbose ?? false,
+        charset: options?.charset ?? true,
         sourceMap: options?.sourceMap ?? false,
         logger: NodeToDartLogger(options?.logger, Logger.stderr(color: color),
             ascii: ascii),

lib/src/node/compile_options.dart

@@ -17,6 +17,7 @@ class CompileOptions {
   external bool? get quietDeps;
   external String? get style;
   external bool? get verbose;
+  external bool? get charset;
   external bool? get sourceMap;
   external bool? get sourceMapIncludeSources;
   external NodeLogger? get logger;