sass-embedded 1.0.0-beta.1 → 1.0.0-beta.7

package/dist/package.json

@@ -0,0 +1,63 @@
+{
+    "name": "sass-embedded",
+    "version": "1.0.0-beta.7",
+    "protocol-version": "1.0.0-beta.16",
+    "compiler-version": "1.0.0-beta.14",
+    "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/types/index.d.ts",
+    "files": [
+        "dist/**/*",
+        "download-compiler-for-end-user.js"
+    ],
+    "engines": {
+        "node": ">=14.0.0"
+    },
+    "scripts": {
+        "init": "ts-node ./tool/prepare-dev-environment.ts",
+        "check": "gts check",
+        "clean": "gts clean",
+        "compile": "tsc",
+        "fix": "gts fix",
+        "postinstall": "node ./download-compiler-for-end-user.js",
+        "prepublishOnly": "npm run clean && ts-node ./tool/prepare-release.ts",
+        "test": "jest"
+    },
+    "dependencies": {
+        "buffer-builder": "^0.2.0",
+        "extract-zip": "^2.0.1",
+        "google-protobuf": "^3.11.4",
+        "immutable": "^4.0.0",
+        "node-fetch": "^2.6.0",
+        "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/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/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-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,13 +3,14 @@
 // 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");
 const p = require("path");
-const semver_1 = require("semver");
 const shell = require("shelljs");
 const tar_1 = require("tar");
+const pkg = require("../package.json");
 shell.config.fatal = true;
 // The current platform's operating system. Throws if the operating system
 // is not supported by Dart Sass Embedded.
@@ -35,6 +36,11 @@ const ARCH = (() => {
             return 'ia32';
         case 'x64':
             return 'x64';
+        // TODO: This is blocked until Github Actions supports compiling Dart Sass
+        // for arm64. Until then, download the x64 binary for arm64 users.
+        // https://github.com/sass/dart-sass/issues/1125
+        case 'arm64':
+            return 'x64';
         default:
             throw Error(`Architecure ${process.arch} is not supported.`);
     }
@@ -44,117 +50,103 @@ const ARCHIVE_EXTENSION = OS === 'windows' ? '.zip' : '.tar.gz';
 // Directory that holds source files.
 const BUILD_PATH = 'build';
 /**
- * Gets the latest version of the Embedded Protocol. Throws if an error occurs.
+ * Gets the Embedded Protocol.
+ *
+ * Can download the release `version`, check out and build the source from a Git
+ * `ref`, or build from the source at `path`.
  *
- * @param version - The Git ref to check out and build. Defaults to `master`.
- * @param path - Build from this path instead of pulling from Github.
- * @param release - Download the latest release instead of building from source.
+ * By default, downloads the release version specified in package.json. Throws
+ * if an error occurs.
  */
-async function getEmbeddedProtocol(options) {
+async function getEmbeddedProtocol(outPath, options) {
     var _a;
     const repo = 'embedded-protocol';
-    if (options.release) {
-        const latestRelease = await getLatestReleaseInfo({
-            repo,
-            tag: true,
-        });
+    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'];
         await downloadRelease({
             repo,
-            assetUrl: `https://github.com/sass/${repo}/archive/` +
-                `${latestRelease.name.replace(' ', '-')}` +
-                ARCHIVE_EXTENSION,
+            assetUrl: `https://github.com/sass/${repo}/archive/${version}${ARCHIVE_EXTENSION}`,
             outPath: BUILD_PATH,
         });
-        fs_1.promises.rename(p.join(BUILD_PATH, `${repo}-${latestRelease.name.replace(' ', '-')}`), p.join(BUILD_PATH, repo));
+        fs_1.promises.rename(p.join(BUILD_PATH, `${repo}-${version}`), p.join(BUILD_PATH, repo));
     }
-    else if (!options.path) {
+    else if ('ref' in options) {
         fetchRepo({
             repo,
             outPath: BUILD_PATH,
-            ref: options.version,
+            ref: options.ref,
         });
     }
-    const repoPath = (_a = options.path) !== null && _a !== void 0 ? _a : p.join(BUILD_PATH, repo);
-    buildEmbeddedProtocol(repoPath);
-    await linkBuiltFiles(repoPath, p.join(options.outPath, repo));
+    const source = options && 'path' in options ? options.path : p.join(BUILD_PATH, repo);
+    buildEmbeddedProtocol(source);
+    await link(source, p.join(outPath, repo));
 }
 exports.getEmbeddedProtocol = getEmbeddedProtocol;
 /**
- * Gets the latest version of the Dart Sass wrapper for the Embedded Compiler.
- * Throws if an error occurs.
+ * Gets the Dart Sass wrapper for the Embedded Compiler.
  *
- * @param version - If `release` is true, the version of the released binary to
- *   download (defaults to the latest version). If it's false, the Git ref to
- *   check out and build (defaults to master).
- * @param path - Build from this path instead of pulling from Github.
- * @param release - Download the latest release instead of building from source.
+ * Can download the release `version`, check out and build the source from a Git
+ * `ref`, or build from the source at `path`.
+ *
+ * By default, downloads the release version specified in package.json. Throws
+ * if an error occurs.
  */
-async function getDartSassEmbedded(options) {
+async function getDartSassEmbedded(outPath, options) {
+    var _a;
     const repo = 'dart-sass-embedded';
-    if (options.release) {
-        const release = options.version
-            ? { tag_name: options.version, name: `sass_embedded ${options.version}` }
-            : await getLatestReleaseInfo({
-                repo,
-            });
+    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'];
         await downloadRelease({
             repo,
             assetUrl: `https://github.com/sass/${repo}/releases/download/` +
-                `${release.tag_name}/` +
-                `${release.name.replace(' ', '-')}-` +
-                `${OS}-${ARCH}` +
-                ARCHIVE_EXTENSION,
-            outPath: options.outPath,
+                `${version}/sass_embedded-${version}-` +
+                `${OS}-${ARCH}${ARCHIVE_EXTENSION}`,
+            outPath,
         });
-        fs_1.promises.rename(p.join(options.outPath, 'sass_embedded'), p.join(options.outPath, repo));
-    }
-    else if (options.path) {
-        buildDartSassEmbedded(options.path);
-        await linkBuiltFiles(p.join(options.path, 'build'), p.join(options.outPath, repo));
+        fs_1.promises.rename(p.join(outPath, 'sass_embedded'), p.join(outPath, repo));
+        return;
     }
-    else {
+    if ('ref' in options) {
         fetchRepo({
             repo,
             outPath: BUILD_PATH,
-            ref: options.version,
+            ref: options.ref,
         });
-        buildDartSassEmbedded(p.join(BUILD_PATH, repo));
-        await linkBuiltFiles(p.join(BUILD_PATH, repo, 'build'), p.join(options.outPath, repo));
     }
+    const source = 'path' in options ? options.path : p.join(BUILD_PATH, repo);
+    buildDartSassEmbedded(source);
+    await link(p.join(source, 'build'), p.join(outPath, repo));
 }
 exports.getDartSassEmbedded = getDartSassEmbedded;
-// Gets the ReleaseInfo of the latest release for `repo`. If `version` is given,
-// throws an error if the latest version is not semver-compatible with
-// `version`. If `tag` is true, gets the latest tag instead of release.
-async function getLatestReleaseInfo(options) {
-    console.log(`Getting version info for ${options.repo}.`);
-    const response = await node_fetch_1.default('https://api.github.com/repos/sass/' +
-        `${options.repo}/${options.tag ? 'tags' : 'releases'}`, {
-        redirect: 'follow',
-    });
-    if (!response.ok) {
-        throw Error(`Failed to get version info for ${options.repo}: ${response.statusText}`);
-    }
-    const latestRelease = JSON.parse(await response.text())[0];
-    const latestVersion = options.tag
-        ? latestRelease.name
-        : latestRelease.tag_name;
-    if (options.versionConstraint) {
-        try {
-            semver_1.satisfies(latestVersion, options.versionConstraint);
-        }
-        catch (_a) {
-            throw Error(`Latest release ${latestVersion} is not compatible with ${options.versionConstraint}.`);
-        }
-    }
-    console.log(`Latest release for ${options.repo} is ${latestVersion}.`);
-    return latestRelease;
+/**
+ * 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) {
@@ -171,7 +163,7 @@ async function downloadRelease(options) {
         });
     }
     else {
-        tar_1.extract({
+        (0, tar_1.extract)({
             file: zippedAssetPath,
             cwd: options.outPath,
             sync: true,
@@ -181,21 +173,16 @@ async function downloadRelease(options) {
 }
 // Clones `repo` into `outPath`, then checks out the given Git `ref`.
 function fetchRepo(options) {
-    var _a;
-    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} \
       ${p.join(options.outPath, options.repo)}`, { silent: true });
     }
-    const version = options.ref ? `commit ${options.ref}` : 'latest update';
+    const version = options.ref === 'main' ? 'latest update' : `commit ${options.ref}`;
     console.log(`Fetching ${version} for ${options.repo}.`);
-    shell.exec(`git fetch --depth=1 origin ${(_a = options.ref) !== null && _a !== void 0 ? _a : 'master'}`, {
-        silent: true,
-        cwd: p.join(options.outPath, options.repo),
-    });
-    shell.exec('git reset --hard FETCH_HEAD', {
+    shell.exec(`git fetch --depth=1 origin ${options.ref} && git reset --hard FETCH_HEAD`, {
         silent: true,
         cwd: p.join(options.outPath, options.repo),
     });
@@ -229,16 +216,17 @@ 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);
+// 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;
+}