sass-embedded 1.0.0-beta.4 → 1.0.0-rc.1

package/dist/package.json

@@ -1,14 +1,14 @@
 {
     "name": "sass-embedded",
-    "version": "1.0.0-beta.4",
-    "protocol-version": "1.0.0-beta.11",
-    "compiler-version": "1.0.0-beta.9",
+    "version": "1.0.0-rc.1",
+    "protocol-version": "1.0.0-beta.16",
+    "compiler-version": "1.0.0-beta.16",
     "description": "Node.js library that communicates with Embedded Dart Sass using the Embedded Sass protocol",
     "repository": "sass/embedded-host-node",
     "author": "Google Inc.",
     "license": "MIT",
     "main": "dist/lib/index.js",
-    "types": "dist/lib/index.d.ts",
+    "types": "dist/types/index.d.ts",
     "files": [
         "dist/**/*",
         "download-compiler-for-end-user.js"
@@ -24,37 +24,40 @@
         "fix": "gts fix",
         "postinstall": "node ./download-compiler-for-end-user.js",
         "prepublishOnly": "npm run clean && ts-node ./tool/prepare-release.ts",
-        "test": "ts-node ./node_modules/jasmine/bin/jasmine"
+        "test": "jest"
     },
     "dependencies": {
         "buffer-builder": "^0.2.0",
         "extract-zip": "^2.0.1",
         "google-protobuf": "^3.11.4",
-        "immutable": "^4.0.0-rc.12",
+        "immutable": "^4.0.0",
         "node-fetch": "^2.6.0",
-        "rxjs": "^6.5.5",
-        "semver": "^5.7.1",
+        "rxjs": "^7.4.0",
+        "semver": "^7.3.5",
         "shelljs": "^0.8.4",
+        "supports-color": "^8.1.1",
         "tar": "^6.0.5"
     },
     "devDependencies": {
         "@types/buffer-builder": "^0.2.0",
         "@types/google-protobuf": "^3.7.2",
-        "@types/jasmine": "^3.5.11",
-        "@types/node": "^12.18.2",
+        "@types/jest": "^27.0.2",
+        "@types/node": "^16.10.3",
         "@types/node-fetch": "^2.5.7",
         "@types/semver": "^7.3.4",
         "@types/shelljs": "^0.8.8",
-        "@types/tar": "^4.0.3",
-        "@types/yargs": "^15.0.12",
-        "gts": "^2.0.2",
-        "jasmine": "^3.5.0",
-        "jasmine-spec-reporter": "^5.0.2",
+        "@types/supports-color": "^8.1.1",
+        "@types/tar": "^6.1.0",
+        "@types/yargs": "^17.0.4",
+        "del": "^6.0.0",
+        "gts": "^3.1.0",
+        "jest": "^27.2.5",
         "protoc": "^1.0.4",
-        "source-map": "^0.6.1",
-        "ts-node": "^8.10.2",
-        "ts-protoc-gen": "^0.12.0",
-        "typescript": "~3.8.0",
-        "yargs": "^16.2.0"
+        "source-map-js": "^0.6.1",
+        "ts-jest": "^27.0.5",
+        "ts-node": "^10.2.1",
+        "ts-protoc-gen": "^0.15.0",
+        "typescript": "^4.4.3",
+        "yargs": "^17.2.1"
     }
 }

package/dist/tool/utils.js

@@ -3,6 +3,7 @@
 // MIT-style license that can be found in the LICENSE file or at
 // https://opensource.org/licenses/MIT.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getJSApi = exports.getDartSassEmbedded = exports.getEmbeddedProtocol = void 0;
 const extractZip = require("extract-zip");
 const fs_1 = require("fs");
 const node_fetch_1 = require("node-fetch");
@@ -58,10 +59,10 @@ const BUILD_PATH = 'build';
  * if an error occurs.
  */
 async function getEmbeddedProtocol(outPath, options) {
-    var _a;
     const repo = 'embedded-protocol';
-    if (!options || 'version' in options) {
-        const version = (_a = options === null || options === void 0 ? void 0 : options.version) !== null && _a !== void 0 ? _a : pkg['protocol-version'];
+    options !== null && options !== void 0 ? options : (options = defaultVersionOption('protocol-version'));
+    if ('version' in options) {
+        const version = options === null || options === void 0 ? void 0 : options.version;
         await downloadRelease({
             repo,
             assetUrl: `https://github.com/sass/${repo}/archive/${version}${ARCHIVE_EXTENSION}`,
@@ -78,7 +79,7 @@ async function getEmbeddedProtocol(outPath, options) {
     }
     const source = options && 'path' in options ? options.path : p.join(BUILD_PATH, repo);
     buildEmbeddedProtocol(source);
-    await linkBuiltFiles(source, p.join(outPath, repo));
+    await link(source, p.join(outPath, repo));
 }
 exports.getEmbeddedProtocol = getEmbeddedProtocol;
 /**
@@ -91,10 +92,10 @@ exports.getEmbeddedProtocol = getEmbeddedProtocol;
  * if an error occurs.
  */
 async function getDartSassEmbedded(outPath, options) {
-    var _a;
     const repo = 'dart-sass-embedded';
-    if (!options || 'version' in options) {
-        const version = (_a = options === null || options === void 0 ? void 0 : options.version) !== null && _a !== void 0 ? _a : pkg['compiler-version'];
+    options !== null && options !== void 0 ? options : (options = defaultVersionOption('compiler-version'));
+    if ('version' in options) {
+        const version = options === null || options === void 0 ? void 0 : options.version;
         await downloadRelease({
             repo,
             assetUrl: `https://github.com/sass/${repo}/releases/download/` +
@@ -114,14 +115,38 @@ async function getDartSassEmbedded(outPath, options) {
     }
     const source = 'path' in options ? options.path : p.join(BUILD_PATH, repo);
     buildDartSassEmbedded(source);
-    await linkBuiltFiles(p.join(source, 'build'), p.join(outPath, repo));
+    await link(p.join(source, 'build'), p.join(outPath, repo));
 }
 exports.getDartSassEmbedded = getDartSassEmbedded;
+/**
+ * Checks out JS API type defintions from the Sass language repo.
+ *
+ * Can check out a Git `ref`, or link to the source at `path`. By default,
+ * checks out the latest revision from GitHub.
+ */
+async function getJSApi(outPath, options) {
+    var _a;
+    const repo = 'sass';
+    let source;
+    if (!options || 'ref' in options) {
+        fetchRepo({
+            repo,
+            outPath: BUILD_PATH,
+            ref: (_a = options === null || options === void 0 ? void 0 : options.ref) !== null && _a !== void 0 ? _a : 'main',
+        });
+        source = p.join(BUILD_PATH, repo);
+    }
+    else {
+        source = options.path;
+    }
+    await link(p.join(source, 'js-api-doc'), p.join(outPath, repo));
+}
+exports.getJSApi = getJSApi;
 // Downloads the release for `repo` located at `assetUrl`, then unzips it into
 // `outPath`.
 async function downloadRelease(options) {
     console.log(`Downloading ${options.repo} release asset.`);
-    const response = await node_fetch_1.default(options.assetUrl, {
+    const response = await (0, node_fetch_1.default)(options.assetUrl, {
         redirect: 'follow',
     });
     if (!response.ok) {
@@ -138,7 +163,7 @@ async function downloadRelease(options) {
         });
     }
     else {
-        tar_1.extract({
+        (0, tar_1.extract)({
             file: zippedAssetPath,
             cwd: options.outPath,
             sync: true,
@@ -148,11 +173,11 @@ async function downloadRelease(options) {
 }
 // Clones `repo` into `outPath`, then checks out the given Git `ref`.
 function fetchRepo(options) {
-    if (!fs_1.existsSync(p.join(options.outPath, options.repo))) {
+    if (!(0, fs_1.existsSync)(p.join(options.outPath, options.repo))) {
         console.log(`Cloning ${options.repo} into ${options.outPath}.`);
         shell.exec(`git clone \
       --depth=1 \
-      git://github.com/sass/${options.repo} \
+      https://github.com/sass/${options.repo} \
       ${p.join(options.outPath, options.repo)}`, { silent: true });
     }
     const version = options.ref === 'main' ? 'latest update' : `commit ${options.ref}`;
@@ -191,16 +216,23 @@ function buildDartSassEmbedded(repoPath) {
         silent: true,
     });
 }
-// Links the built files at `builtPath` into `outPath`.
-async function linkBuiltFiles(builtPath, outPath) {
-    console.log(`Linking built files into ${outPath}.`);
-    await cleanDir(outPath);
+// Given the name of a field in `package.json`, returns the default version
+// option described by that field.
+function defaultVersionOption(pkgField) {
+    const version = pkg[pkgField];
+    return version.endsWith('-dev') ? { ref: 'main' } : { version };
+}
+// Links or copies the contents of `source` into `destination`.
+async function link(source, destination) {
+    await cleanDir(destination);
     if (OS === 'windows') {
-        shell.cp('-R', builtPath, outPath);
+        console.log(`Copying ${source} into ${destination}.`);
+        shell.cp('-R', source, destination);
     }
     else {
+        console.log(`Linking ${source} into ${destination}.`);
         // Symlinking doesn't play nice with Jasmine's test globbing on Windows.
-        fs_1.promises.symlink(p.resolve(builtPath), outPath);
+        fs_1.promises.symlink(p.resolve(source), destination);
     }
 }
 // Ensures that `dir` does not exist, but its parent directory does.

package/dist/tool/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../tool/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../tool/utils.ts"],"names":[],"mappings":"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"}

package/dist/types/compile.d.ts

@@ -0,0 +1,152 @@
+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]].
+ *
+ * @category Compile
+ */
+export interface CompileResult {
+  /**
+   * The generated CSS.
+   *
+   * Note that this *never* includes a `sourceMapUrl` comment—it's up to the
+   * caller to determine where to save the source map and how to link to it from
+   * the stylesheet.
+   */
+  css: string;
+
+  /**
+   * The canonical URLs of all the stylesheets that were loaded during the
+   * Sass compilation. The order of these URLs is not guaranteed.
+   */
+  loadedUrls: URL[];
+
+  /**
+   * The object representation of the source map that maps locations in the
+   * 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 is set if and only if [[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]].
+ *
+ * This only allows synchronous [[Importer]]s and [[CustomFunction]]s.
+ *
+ * @example
+ *
+ * ```js
+ * const sass = require('sass');
+ *
+ * const result = sass.compile("style.scss");
+ * console.log(result.css);
+ * ```
+ *
+ * @category Compile
+ * @compatibility dart: "1.45.0", node: false
+ */
+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.
+ *
+ * This only allows synchronous or asynchronous [[Importer]]s and
+ * [[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.
+ *
+ * @example
+ *
+ * ```js
+ * const sass = require('sass');
+ *
+ * const result = await sass.compileAsync("style.scss");
+ * console.log(result.css);
+ * ```
+ *
+ * @category Compile
+ * @compatibility dart: "1.45.0", node: false
+ */
+export function compileAsync(
+  path: string,
+  options?: Options<'async'>
+): Promise<CompileResult>;
+
+/**
+ * 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]].
+ *
+ * This only allows synchronous [[Importer]]s and [[CustomFunction]]s.
+ *
+ * @example
+ *
+ * ```js
+ * const sass = require('sass');
+ *
+ * const result = sass.compileString(`
+ * h1 {
+ *   font-size: 40px;
+ *   code {
+ *     font-face: Roboto Mono;
+ *   }
+ * }`);
+ * console.log(result.css);
+ * ```
+ *
+ * @category Compile
+ * @compatibility dart: "1.45.0", node: false
+ */
+export function compileString(
+  source: string,
+  options?: StringOptions<'sync'>
+): CompileResult;
+
+/**
+ * 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.
+ *
+ * This only allows synchronous or asynchronous [[Importer]]s and
+ * [[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.
+ *
+ * @example
+ *
+ * ```js
+ * const sass = require('sass');
+ *
+ * const result = await sass.compileStringAsync(`
+ * h1 {
+ *   font-size: 40px;
+ *   code {
+ *     font-face: Roboto Mono;
+ *   }
+ * }`);
+ * console.log(result.css);
+ * ```
+ *
+ * @category Compile
+ * @compatibility dart: "1.45.0", node: false
+ */
+export function compileStringAsync(
+  source: string,
+  options?: StringOptions<'async'>
+): Promise<CompileResult>;

package/dist/types/exception.d.ts

@@ -0,0 +1,41 @@
+import {SourceSpan} from './logger';
+
+/**
+ * An exception thrown because a Sass compilation failed.
+ *
+ * @category Other
+ */
+export class Exception extends Error {
+  private constructor();
+
+  /**
+   * 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]]).
+   */
+  message: string;
+
+  /**
+   * A textual description of what went wrong.
+   *
+   * Unlike [[message]], this does *not* include representations of [[span]] or
+   * [[sassStack]].
+   */
+  readonly sassMessage: string;
+
+  /**
+   * A human-friendly representation of the Sass stack trace at the point of
+   * error.
+   */
+  readonly sassStack: string;
+
+  /** The location the error occurred in the Sass file that triggered it. */
+  readonly span: SourceSpan;
+
+  /** Returns the same string as [[message]]. */
+  toString(): string;
+}