sass 1.62.0 → 1.63.0

package/sass.default.cjs

@@ -0,0 +1,8 @@
+require('./sass.dart.js');
+const library = globalThis._cliPkgExports.pop();
+if (globalThis._cliPkgExports.length === 0) delete globalThis._cliPkgExports;
+library.load({
+  immutable: require("immutable"),
+});
+
+module.exports = library;

package/sass.default.js

@@ -1,8 +1,32 @@
-const library = require('./sass.dart.js');
-library.load({
-  util: require("util"),
-  immutable: require("immutable"),
-  fs: require("fs"),
-});
+import * as immutable from "immutable"
+import "./sass.dart.js";
 
-module.exports = library;
+const _cliPkgLibrary = globalThis._cliPkgExports.pop();
+if (globalThis._cliPkgExports.length === 0) delete globalThis._cliPkgExports;
+const _cliPkgExports = {};
+_cliPkgLibrary.load({immutable}, _cliPkgExports);
+
+export const compile = _cliPkgExports.compile;
+export const compileAsync = _cliPkgExports.compileAsync;
+export const compileString = _cliPkgExports.compileString;
+export const compileStringAsync = _cliPkgExports.compileStringAsync;
+export const Logger = _cliPkgExports.Logger;
+export const SassArgumentList = _cliPkgExports.SassArgumentList;
+export const SassBoolean = _cliPkgExports.SassBoolean;
+export const SassColor = _cliPkgExports.SassColor;
+export const SassFunction = _cliPkgExports.SassFunction;
+export const SassList = _cliPkgExports.SassList;
+export const SassMap = _cliPkgExports.SassMap;
+export const SassNumber = _cliPkgExports.SassNumber;
+export const SassString = _cliPkgExports.SassString;
+export const Value = _cliPkgExports.Value;
+export const CustomFunction = _cliPkgExports.CustomFunction;
+export const ListSeparator = _cliPkgExports.ListSeparator;
+export const sassFalse = _cliPkgExports.sassFalse;
+export const sassNull = _cliPkgExports.sassNull;
+export const sassTrue = _cliPkgExports.sassTrue;
+export const Exception = _cliPkgExports.Exception;
+export const PromiseOr = _cliPkgExports.PromiseOr;
+export const info = _cliPkgExports.info;
+export const render = _cliPkgExports.render;
+export const renderSync = _cliPkgExports.renderSync;

package/sass.js

@@ -1,12 +1,16 @@
 #!/usr/bin/env node
 
-var library = require('./sass.dart.js');
+require('./sass.dart.js');
+var library = globalThis._cliPkgExports.pop();
+if (globalThis._cliPkgExports.length === 0) delete globalThis._cliPkgExports;
+
 library.load({
   readline: require("readline"),
   chokidar: require("chokidar"),
   util: require("util"),
-  immutable: require("immutable"),
+  stream: require("stream"),
   fs: require("fs"),
+  immutable: require("immutable"),
 });
 
 library.cli_pkg_main_0_(process.argv.slice(2));

package/sass.node.cjs

@@ -0,0 +1,11 @@
+require('./sass.dart.js');
+const library = globalThis._cliPkgExports.pop();
+if (globalThis._cliPkgExports.length === 0) delete globalThis._cliPkgExports;
+library.load({
+  util: require("util"),
+  stream: require("stream"),
+  fs: require("fs"),
+  immutable: require("immutable"),
+});
+
+module.exports = library;

package/sass.node.js

@@ -0,0 +1,35 @@
+import * as util from "util"
+import * as stream from "stream"
+import * as fs from "fs"
+import * as immutable from "immutable"
+import "./sass.dart.js";
+
+const _cliPkgLibrary = globalThis._cliPkgExports.pop();
+if (globalThis._cliPkgExports.length === 0) delete globalThis._cliPkgExports;
+const _cliPkgExports = {};
+_cliPkgLibrary.load({util, stream, fs, immutable}, _cliPkgExports);
+
+export const compile = _cliPkgExports.compile;
+export const compileAsync = _cliPkgExports.compileAsync;
+export const compileString = _cliPkgExports.compileString;
+export const compileStringAsync = _cliPkgExports.compileStringAsync;
+export const Logger = _cliPkgExports.Logger;
+export const SassArgumentList = _cliPkgExports.SassArgumentList;
+export const SassBoolean = _cliPkgExports.SassBoolean;
+export const SassColor = _cliPkgExports.SassColor;
+export const SassFunction = _cliPkgExports.SassFunction;
+export const SassList = _cliPkgExports.SassList;
+export const SassMap = _cliPkgExports.SassMap;
+export const SassNumber = _cliPkgExports.SassNumber;
+export const SassString = _cliPkgExports.SassString;
+export const Value = _cliPkgExports.Value;
+export const CustomFunction = _cliPkgExports.CustomFunction;
+export const ListSeparator = _cliPkgExports.ListSeparator;
+export const sassFalse = _cliPkgExports.sassFalse;
+export const sassNull = _cliPkgExports.sassNull;
+export const sassTrue = _cliPkgExports.sassTrue;
+export const Exception = _cliPkgExports.Exception;
+export const PromiseOr = _cliPkgExports.PromiseOr;
+export const info = _cliPkgExports.info;
+export const render = _cliPkgExports.render;
+export const renderSync = _cliPkgExports.renderSync;

package/types/compile.d.ts

@@ -3,8 +3,8 @@ import {RawSourceMap} from 'source-map-js';
 import {Options, StringOptions} from './options';
 
 /**
- * The result of compiling Sass to CSS. Returned by [[compile]],
- * [[compileAsync]], [[compileString]], and [[compileStringAsync]].
+ * The result of compiling Sass to CSS. Returned by {@link compile}, {@link
+ * compileAsync}, {@link compileString}, and {@link compileStringAsync}.
  *
  * @category Compile
  */
@@ -29,19 +29,20 @@ export interface CompileResult {
    * generated CSS back to locations in the Sass source code.
    *
    * This typically uses absolute `file:` URLs to refer to Sass files, although
-   * this can be controlled by having a custom [[Importer]] return
-   * [[ImporterResult.sourceMapUrl]].
+   * this can be controlled by having a custom {@link Importer} return {@link
+   * ImporterResult.sourceMapUrl}.
    *
-   * This is set if and only if [[Options.sourceMap]] is `true`.
+   * This is set if and only if {@link Options.sourceMap} is `true`.
    */
   sourceMap?: RawSourceMap;
 }
 
 /**
  * Synchronously compiles the Sass file at `path` to CSS. If it succeeds it
- * returns a [[CompileResult]], and if it fails it throws an [[Exception]].
+ * returns a {@link CompileResult}, and if it fails it throws an {@link
+ * Exception}.
  *
- * This only allows synchronous [[Importer]]s and [[CustomFunction]]s.
+ * This only allows synchronous {@link Importer}s and {@link CustomFunction}s.
  *
  * @example
  *
@@ -59,15 +60,15 @@ export function compile(path: string, options?: Options<'sync'>): CompileResult;
 
 /**
  * Asynchronously compiles the Sass file at `path` to CSS. Returns a promise
- * that resolves with a [[CompileResult]] if it succeeds and rejects with an
- * [[Exception]] if it fails.
+ * that resolves with a {@link CompileResult} if it succeeds and rejects with an
+ * {@link Exception} if it fails.
  *
- * This only allows synchronous or asynchronous [[Importer]]s and
- * [[CustomFunction]]s.
+ * This only allows synchronous or asynchronous {@link Importer}s and
+ * {@link CustomFunction}s.
  *
- * **Heads up!** When using Dart Sass, **[[compile]] is almost twice as fast as
- * [[compileAsync]]**, due to the overhead of making the entire evaluation
- * process asynchronous.
+ * **Heads up!** When using Dart Sass, **{@link compile} is almost twice as fast
+ * as {@link compileAsync}**, due to the overhead of making the entire
+ * evaluation process asynchronous.
  *
  * @example
  *
@@ -88,10 +89,10 @@ export function compileAsync(
 
 /**
  * Synchronously compiles a stylesheet whose contents is `source` to CSS. If it
- * succeeds it returns a [[CompileResult]], and if it fails it throws an
- * [[Exception]].
+ * succeeds it returns a {@link CompileResult}, and if it fails it throws an
+ * {@link Exception}.
  *
- * This only allows synchronous [[Importer]]s and [[CustomFunction]]s.
+ * This only allows synchronous {@link Importer}s and {@link CustomFunction}s.
  *
  * @example
  *
@@ -118,15 +119,15 @@ export function compileString(
 
 /**
  * Asynchronously compiles a stylesheet whose contents is `source` to CSS.
- * Returns a promise that resolves with a [[CompileResult]] if it succeeds and
- * rejects with an [[Exception]] if it fails.
+ * Returns a promise that resolves with a {@link CompileResult} if it succeeds
+ * and rejects with an {@link Exception} if it fails.
  *
- * This only allows synchronous or asynchronous [[Importer]]s and
- * [[CustomFunction]]s.
+ * This only allows synchronous or asynchronous {@link Importer}s and {@link
+ * CustomFunction}s.
  *
- * **Heads up!** When using Dart Sass, **[[compile]] is almost twice as fast as
- * [[compileAsync]]**, due to the overhead of making the entire evaluation
- * process asynchronous.
+ * **Heads up!** When using Dart Sass, **{@link compile} is almost twice as fast
+ * as {@link compileAsync}**, due to the overhead of making the entire
+ * evaluation process asynchronous.
  *
  * @example
  *

package/types/exception.d.ts

@@ -12,18 +12,18 @@ export class Exception extends Error {
    * A human-friendly representation of the exception.
    *
    * Because many tools simply print `Error.message` directly, this includes not
-   * only the textual description of what went wrong (the [[sassMessage]]) but
-   * also an indication of where in the Sass stylesheet the error occurred (the
-   * [[span]]) and the Sass stack trace at the point of error (the
-   * [[sassStack]]).
+   * only the textual description of what went wrong (the {@link sassMessage})
+   * but also an indication of where in the Sass stylesheet the error occurred
+   * (the {@link span}) and the Sass stack trace at the point of error (the
+   * {@link sassStack}).
    */
   message: string;
 
   /**
    * A textual description of what went wrong.
    *
-   * Unlike [[message]], this does *not* include representations of [[span]] or
-   * [[sassStack]].
+   * Unlike {@link message}, this does *not* include representations of {@link
+   * span} or {@link sassStack}.
    */
   readonly sassMessage: string;
 
@@ -36,6 +36,6 @@ export class Exception extends Error {
   /** The location the error occurred in the Sass file that triggered it. */
   readonly span: SourceSpan;
 
-  /** Returns the same string as [[message]]. */
+  /** Returns the same string as {@link message}. */
   toString(): string;
 }

package/types/importer.d.ts

@@ -3,22 +3,23 @@ import {PromiseOr} from './util/promise_or';
 
 /**
  * A special type of importer that redirects all loads to existing files on
- * disk. Although this is less powerful than a full [[Importer]], it
+ * disk. Although this is less powerful than a full {@link Importer}, it
  * automatically takes care of Sass features like resolving partials and file
  * extensions and of loading the file from disk.
  *
  * Like all importers, this implements custom Sass loading logic for [`@use`
  * rules](https://sass-lang.com/documentation/at-rules/use) and [`@import`
  * rules](https://sass-lang.com/documentation/at-rules/import). It can be passed
- * to [[Options.importers]] or [[StringOptionsWithImporter.importer]].
+ * to {@link Options.importers} or {@link StringOptionsWithImporter.importer}.
  *
- * @typeParam sync - A `FileImporter<'sync'>`'s [[findFileUrl]] must return
- * synchronously, but in return it can be passed to [[compile]] and
- * [[compileString]] in addition to [[compileAsync]] and [[compileStringAsync]].
+ * @typeParam sync - A `FileImporter<'sync'>`'s {@link findFileUrl} must return
+ * synchronously, but in return it can be passed to {@link compile} and {@link
+ * compileString} in addition to {@link compileAsync} and {@link
+ * compileStringAsync}.
  *
- * A `FileImporter<'async'>`'s [[findFileUrl]] may either return synchronously
- * or asynchronously, but it can only be used with [[compileAsync]] and
- * [[compileStringAsync]].
+ * A `FileImporter<'async'>`'s {@link findFileUrl} may either return
+ * synchronously or asynchronously, but it can only be used with {@link
+ * compileAsync} and {@link compileStringAsync}.
  *
  * @example
  *
@@ -48,12 +49,12 @@ export interface FileImporter<
    * [`@import`](https://sass-lang.com/documentation/at-rules/import)) to a file
    * on disk.
    *
-   * Unlike an [[Importer]], the compiler will automatically handle relative
-   * loads for a [[FileImporter]]. See [[Options.importers]] for more details on
-   * the way loads are resolved.
+   * Unlike an {@link Importer}, the compiler will automatically handle relative
+   * loads for a {@link FileImporter}. See {@link Options.importers} for more
+   * details on the way loads are resolved.
    *
    * @param url - The loaded URL. Since this might be relative, it's represented
-   * as a string rather than a [[URL]] object.
+   * as a string rather than a {@link URL} object.
    *
    * @param options.fromImport - Whether this is being invoked because of a Sass
    * `@import` rule, as opposed to a `@use` or `@forward` rule.
@@ -73,8 +74,8 @@ export interface FileImporter<
    * handle it.
    *
    * This may also return a `Promise`, but if it does the importer may only be
-   * passed to [[compileAsync]] and [[compileStringAsync]], not [[compile]] or
-   * [[compileString]].
+   * passed to {@link compileAsync} and {@link compileStringAsync}, not {@link
+   * compile} or {@link compileString}.
    *
    * @throws any - If this importer recognizes `url` but determines that it's
    * invalid, it may throw an exception that will be wrapped by Sass. If the
@@ -95,35 +96,38 @@ export interface FileImporter<
  * An object that implements custom Sass loading logic for [`@use`
  * rules](https://sass-lang.com/documentation/at-rules/use) and [`@import`
  * rules](https://sass-lang.com/documentation/at-rules/import). It can be passed
- * to [[Options.importers]] or [[StringOptionsWithImporter.importer]].
+ * to {@link Options.importers} or {@link StringOptionsWithImporter.importer}.
  *
  * Importers that simply redirect to files on disk are encouraged to use the
- * [[FileImporter]] interface instead.
+ * {@link FileImporter} interface instead.
  *
- * See [[Options.importers]] for more details on the way loads are resolved.
- *
- * @typeParam sync - An `Importer<'sync'>`'s [[canonicalize]] and [[load]] must
- * return synchronously, but in return it can be passed to [[compile]] and
- * [[compileString]] in addition to [[compileAsync]] and [[compileStringAsync]].
- *
- * An `Importer<'async'>`'s [[canonicalize]] and [[load]] may either return
- * synchronously or asynchronously, but it can only be used with
- * [[compileAsync]] and [[compileStringAsync]].
- *
- * @example Resolving a Load
+ * ### Resolving a Load
  *
  * This is the process of resolving a load using a custom importer:
  *
  * - The compiler encounters `@use "db:foo/bar/baz"`.
- * - It calls [[canonicalize]] with `"db:foo/bar/baz"`.
- * - [[canonicalize]] returns `new URL("db:foo/bar/baz/_index.scss")`.
+ * - It calls {@link canonicalize} with `"db:foo/bar/baz"`.
+ * - {@link canonicalize} returns `new URL("db:foo/bar/baz/_index.scss")`.
  * - If the compiler has already loaded a stylesheet with this canonical URL, it
  *   re-uses the existing module.
- * - Otherwise, it calls [[load]] with `new URL("db:foo/bar/baz/_index.scss")`.
- * - [[load]] returns an [[ImporterResult]] that the compiler uses as the
- *   contents of the module.
+ * - Otherwise, it calls {@link load} with `new
+ *   URL("db:foo/bar/baz/_index.scss")`.
+ * - {@link load} returns an {@link ImporterResult} that the compiler uses as
+ *   the contents of the module.
+ *
+ * See {@link Options.importers} for more details on the way loads are resolved
+ * using multiple importers and load paths.
  *
- * @example Code Sample
+ * @typeParam sync - An `Importer<'sync'>`'s {@link canonicalize} and {@link
+ * load} must return synchronously, but in return it can be passed to {@link
+ * compile} and {@link compileString} in addition to {@link compileAsync} and
+ * {@link compileStringAsync}.
+ *
+ * An `Importer<'async'>`'s {@link canonicalize} and {@link load} may either
+ * return synchronously or asynchronously, but it can only be used with {@link
+ * compileAsync} and {@link compileStringAsync}.
+ *
+ * @example
  *
  * ```js
  * sass.compile('style.scss', {
@@ -192,29 +196,29 @@ export interface Importer<sync extends 'sync' | 'async' = 'sync' | 'async'> {
    *
    * If no stylesheets are found, the importer should return `null`.
    *
-   * Calling [[canonicalize]] multiple times with the same URL must return the
-   * same result. Calling [[canonicalize]] with a URL returned by a previous
-   * call to [[canonicalize]] must return that URL.
+   * Calling {@link canonicalize} multiple times with the same URL must return
+   * the same result. Calling {@link canonicalize} with a URL returned by a
+   * previous call to {@link canonicalize} must return that URL.
    *
    * Relative loads in stylesheets loaded from an importer are handled by
    * resolving the loaded URL relative to the canonical URL of the stylesheet
-   * that contains it, and passing that URL back to the importer's
-   * [[canonicalize]] method. For example, suppose the "Resolving a Load"
-   * example {@link Importer | above} returned a stylesheet that contained
-   * `@use "mixins"`:
+   * that contains it, and passing that URL back to the importer's {@link
+   * canonicalize} method. For example, suppose the "Resolving a Load" example
+   * {@link Importer | above} returned a stylesheet that contained `@use
+   * "mixins"`:
    *
    * - The compiler resolves the URL `mixins` relative to the current
    *   stylesheet's canonical URL `db:foo/bar/baz/_index.scss` to get
    *   `db:foo/bar/baz/mixins`.
-   * - It calls [[canonicalize]] with `"db:foo/bar/baz/mixins"`.
-   * - [[canonicalize]] returns `new URL("db:foo/bar/baz/_mixins.scss")`.
+   * - It calls {@link canonicalize} with `"db:foo/bar/baz/mixins"`.
+   * - {@link canonicalize} returns `new URL("db:foo/bar/baz/_mixins.scss")`.
    *
-   * Because of this, [[canonicalize]] must return a meaningful result when
-   * called with a URL relative to one returned by an earlier call to
-   * [[canonicalize]].
+   * Because of this, {@link canonicalize} must return a meaningful result when
+   * called with a URL relative to one returned by an earlier call to {@link
+   * canonicalize}.
    *
    * @param url - The loaded URL. Since this might be relative, it's represented
-   * as a string rather than a [[URL]] object.
+   * as a string rather than a {@link URL} object.
    *
    * @param options.fromImport - Whether this is being invoked because of a Sass
    * `@import` rule, as opposed to a `@use` or `@forward` rule.
@@ -227,8 +231,8 @@ export interface Importer<sync extends 'sync' | 'async' = 'sync' | 'async'> {
    * Options.loadPaths | load paths} may handle the load.
    *
    * This may also return a `Promise`, but if it does the importer may only be
-   * passed to [[compileAsync]] and [[compileStringAsync]], not [[compile]] or
-   * [[compileString]].
+   * passed to {@link compileAsync} and {@link compileStringAsync}, not {@link
+   * compile} or {@link compileString}.
    *
    * @throws any - If this importer recognizes `url` but determines that it's
    * invalid, it may throw an exception that will be wrapped by Sass. If the
@@ -246,15 +250,15 @@ export interface Importer<sync extends 'sync' | 'async' = 'sync' | 'async'> {
    * importer can't find the stylesheet it refers to.
    *
    * @param canonicalUrl - The canonical URL of the stylesheet to load. This is
-   * guaranteed to come from a call to [[canonicalize]], although not every call
-   * to [[canonicalize]] will result in a call to [[load]].
+   * guaranteed to come from a call to {@link canonicalize}, although not every
+   * call to {@link canonicalize} will result in a call to {@link load}.
    *
    * @returns The contents of the stylesheet at `canonicalUrl` if it can be
    * loaded, or `null` if it can't.
    *
    * This may also return a `Promise`, but if it does the importer may only be
-   * passed to [[compileAsync]] and [[compileStringAsync]], not [[compile]] or
-   * [[compileString]].
+   * passed to {@link compileAsync} and {@link compileStringAsync}, not {@link
+   * compile} or {@link compileString}.
    *
    * @throws any - If this importer finds a stylesheet at `url` but it fails to
    * load for some reason, or if `url` is uniquely associated with this importer
@@ -271,7 +275,7 @@ export interface Importer<sync extends 'sync' | 'async' = 'sync' | 'async'> {
 }
 
 /**
- * The result of successfully loading a stylesheet with an [[Importer]].
+ * The result of successfully loading a stylesheet with an {@link Importer}.
  *
  * @category Importer
  */
@@ -279,7 +283,7 @@ export interface ImporterResult {
   /** The contents of the stylesheet. */
   contents: string;
 
-  /** The syntax with which to parse [[contents]]. */
+  /** The syntax with which to parse {@link contents}. */
   syntax: Syntax;
 
   /**

package/types/legacy/exception.d.ts

@@ -1,11 +1,11 @@
 /**
- * The exception type thrown by [[renderSync]] and passed as the error to
- * [[render]]'s callback.
+ * The exception type thrown by {@link renderSync} and passed as the error to
+ * {@link render}'s callback.
  *
  * @category Legacy
- * @deprecated This is only thrown by the legacy [[render]] and [[renderSync]]
- * APIs. Use [[compile]], [[compileString]], [[compileAsync]], and
- * [[compileStringAsync]] instead.
+ * @deprecated This is only thrown by the legacy {@link render} and {@link
+ * renderSync} APIs. Use {@link compile}, {@link compileString}, {@link
+ * compileAsync}, and {@link compileStringAsync} instead.
  */
 export interface LegacyException extends Error {
   /**
@@ -17,8 +17,8 @@ export interface LegacyException extends Error {
 
   /**
    * The error message. For Dart Sass, this is the same as the result of calling
-   * [[toString]], which is itself the same as [[message]] but with the prefix
-   * "Error:".
+   * {@link toString}, which is itself the same as {@link message} but with the
+   * prefix "Error:".
    */
   formatted: string;
 
@@ -29,8 +29,9 @@ export interface LegacyException extends Error {
   line?: number;
 
   /**
-   * The (1-based) column number within [[line]] at which the error occurred, if
-   * this exception is associated with a specific Sass file location.
+   * The (1-based) column number within {@link line} at which the error
+   * occurred, if this exception is associated with a specific Sass file
+   * location.
    */
   column?: number;
 
@@ -46,9 +47,9 @@ export interface LegacyException extends Error {
    *
    * * If the Sass file was loaded from disk, this is the path to that file.
    * * If the Sass file was generated by an importer, this is its canonical URL.
-   * * If the Sass file was passed as [[LegacyStringOptions.data]] without a
-   *   corresponding [[LegacyStringOptions.file]], this is the special string
-   *   `"stdin"`.
+   * * If the Sass file was passed as {@link LegacyStringOptions.data} without a
+   *   corresponding {@link LegacyStringOptions.file}, this is the special
+   *   string `"stdin"`.
    */
   file?: string;
 }