@angular-devkit/build-angular 12.0.0 → 12.0.4

package/package.json

@@ -1,25 +1,25 @@
 {
   "name": "@angular-devkit/build-angular",
-  "version": "12.0.0",
+  "version": "12.0.4",
   "description": "Angular Webpack Build Facade",
   "main": "src/index.js",
   "typings": "src/index.d.ts",
   "builders": "builders.json",
   "dependencies": {
-    "@angular-devkit/architect": "0.1200.0",
-    "@angular-devkit/build-optimizer": "0.1200.0",
-    "@angular-devkit/build-webpack": "0.1200.0",
-    "@angular-devkit/core": "12.0.0",
-    "@babel/core": "7.14.0",
-    "@babel/generator": "7.14.1",
+    "@angular-devkit/architect": "0.1200.4",
+    "@angular-devkit/build-optimizer": "0.1200.4",
+    "@angular-devkit/build-webpack": "0.1200.4",
+    "@angular-devkit/core": "12.0.4",
+    "@babel/core": "7.14.3",
+    "@babel/generator": "7.14.3",
     "@babel/plugin-transform-async-to-generator": "7.13.0",
-    "@babel/plugin-transform-runtime": "7.13.15",
-    "@babel/preset-env": "7.14.1",
+    "@babel/plugin-transform-runtime": "7.14.3",
+    "@babel/preset-env": "7.14.2",
     "@babel/runtime": "7.14.0",
     "@babel/template": "7.12.13",
     "@discoveryjs/json-ext": "0.5.2",
     "@jsdevtools/coverage-istanbul-loader": "3.0.5",
-    "@ngtools/webpack": "12.0.0",
+    "@ngtools/webpack": "12.0.4",
     "ansi-colors": "4.1.1",
     "babel-loader": "8.2.2",
     "browserslist": "^4.9.1",
@@ -30,7 +30,7 @@
     "core-js": "3.12.0",
     "critters": "0.0.10",
     "css-loader": "5.2.4",
-    "cssnano": "5.0.2",
+    "css-minimizer-webpack-plugin": "3.0.0",
     "find-cache-dir": "3.3.1",
     "glob": "7.1.7",
     "https-proxy-agent": "5.0.0",
@@ -39,14 +39,14 @@
     "karma-source-map-support": "1.4.0",
     "less": "4.1.1",
     "less-loader": "8.1.1",
-    "license-webpack-plugin": "2.3.17",
+    "license-webpack-plugin": "2.3.19",
     "loader-utils": "2.0.0",
     "mini-css-extract-plugin": "1.5.1",
     "minimatch": "3.0.4",
-    "open": "8.0.7",
+    "open": "8.0.2",
     "ora": "5.4.0",
     "parse5-html-rewriting-stream": "6.0.1",
-    "postcss": "8.2.14",
+    "postcss": "8.3.0",
     "postcss-import": "14.0.1",
     "postcss-loader": "5.2.0",
     "postcss-preset-env": "6.7.0",
@@ -65,21 +65,21 @@
     "stylus": "0.54.8",
     "stylus-loader": "5.0.0",
     "terser": "5.7.0",
-    "terser-webpack-plugin": "4.2.3",
+    "terser-webpack-plugin": "5.1.2",
     "text-table": "0.2.0",
     "tree-kill": "1.2.2",
-    "webpack": "5.36.2",
+    "webpack": "5.38.1",
     "webpack-dev-middleware": "4.1.0",
     "webpack-dev-server": "3.11.2",
     "webpack-merge": "5.7.3",
     "webpack-subresource-integrity": "1.5.2"
   },
   "peerDependencies": {
-    "@angular/compiler-cli": "^12.0.0-next",
-    "@angular/localize": "^12.0.0-next",
-    "@angular/service-worker": "^12.0.0-next",
+    "@angular/compiler-cli": "^12.0.0",
+    "@angular/localize": "^12.0.0",
+    "@angular/service-worker": "^12.0.0",
     "karma": "^6.3.0",
-    "ng-packagr": "^12.0.0-next",
+    "ng-packagr": "^12.0.0",
     "protractor": "^7.0.0",
     "tailwindcss": "^2.0.0",
     "tslint": "^6.1.0",
@@ -120,7 +120,7 @@
     "url": "https://github.com/angular/angular-cli.git"
   },
   "engines": {
-    "node": "^12.14.1 || ^14.0.0",
+    "node": "^12.14.1 || >=14.0.0",
     "npm": "^6.11.0 || ^7.5.6",
     "yarn": ">= 1.13.0"
   },

package/src/browser/index.js

@@ -69,7 +69,7 @@ async function initialize(options, context, differentialLoadingNeeded, webpackCo
     const originalOutputPath = options.outputPath;
     // Assets are processed directly by the builder except when watching
     const adjustedOptions = options.watch ? options : { ...options, assets: [] };
-    const { config, projectRoot, projectSourceRoot, i18n, } = await webpack_browser_config_1.generateI18nBrowserWebpackConfigFromContext(adjustedOptions, context, (wco) => [
+    const { config, projectRoot, projectSourceRoot, i18n } = await webpack_browser_config_1.generateI18nBrowserWebpackConfigFromContext(adjustedOptions, context, (wco) => [
         configs_1.getCommonConfig(wco),
         configs_1.getBrowserConfig(wco),
         configs_1.getStylesConfig(wco),
@@ -544,12 +544,10 @@ function assertNever(input) {
     throw new Error(`Unexpected call to assertNever() with input: ${JSON.stringify(input, null /* replacer */, 4 /* tabSize */)}`);
 }
 function generateBundleInfoStats(bundle, chunk, chunkType) {
-    var _a;
     return stats_1.generateBundleStats({
         size: bundle.size,
         files: bundle.map ? [bundle.filename, bundle.map.filename] : [bundle.filename],
         names: chunk === null || chunk === void 0 ? void 0 : chunk.names,
-        entry: !!((_a = chunk === null || chunk === void 0 ? void 0 : chunk.names) === null || _a === void 0 ? void 0 : _a.includes('runtime')),
         initial: !!(chunk === null || chunk === void 0 ? void 0 : chunk.initial),
         rendered: true,
         chunkType,

package/src/browser/schema.d.ts

@@ -407,7 +407,7 @@ export interface SourceMapClass {
  */
 export interface StylePreprocessorOptions {
     /**
-     * Paths to include. Paths will be resolved to project root.
+     * Paths to include. Paths will be resolved to workspace root.
      */
     includePaths?: string[];
 }

package/src/browser/schema.json

@@ -51,7 +51,7 @@
       "type": "object",
       "properties": {
         "includePaths": {
-          "description": "Paths to include. Paths will be resolved to project root.",
+          "description": "Paths to include. Paths will be resolved to workspace root.",
           "type": "array",
           "items": {
             "type": "string"

package/src/dev-server/index.js

@@ -84,11 +84,47 @@ function serveWebpackBrowser(options, context, transforms = {}) {
             overrides.outputHashing = schema_1.OutputHashing.None;
             logger.warn(`Warning: 'outputHashing' option is disabled when using the dev-server.`);
         }
+        if (options.hmr) {
+            logger.warn(core_1.tags.stripIndents `NOTICE: Hot Module Replacement (HMR) is enabled for the dev server.
+      See https://webpack.js.org/guides/hot-module-replacement for information on working with HMR for Webpack.`);
+        }
+        if (!options.disableHostCheck &&
+            options.host &&
+            !/^127\.\d+\.\d+\.\d+/g.test(options.host) &&
+            options.host !== 'localhost') {
+            logger.warn(core_1.tags.stripIndent `
+        Warning: This is a simple server for use in testing or debugging Angular applications
+        locally. It hasn't been reviewed for security issues.
+
+        Binding this server to an open connection can result in compromising your application or
+        computer. Using a different host than the one passed to the "--host" flag might result in
+        websocket connection issues. You might need to use "--disableHostCheck" if that's the
+        case.
+      `);
+        }
+        if (options.disableHostCheck) {
+            logger.warn(core_1.tags.oneLine `
+        Warning: Running a server with --disable-host-check is a security risk.
+        See https://medium.com/webpack/webpack-dev-server-middleware-security-issues-1489d950874a
+        for more information.
+      `);
+        }
         // Webpack's live reload functionality adds the `strip-ansi` package which is commonJS
         (_b = rawBrowserOptions.allowedCommonJsDependencies) !== null && _b !== void 0 ? _b : (rawBrowserOptions.allowedCommonJsDependencies = []);
         rawBrowserOptions.allowedCommonJsDependencies.push('strip-ansi');
         const browserName = await context.getBuilderNameForTarget(browserTarget);
         const browserOptions = (await context.validateOptions({ ...rawBrowserOptions, ...overrides }, browserName));
+        const { styles, scripts } = utils_1.normalizeOptimization(browserOptions.optimization);
+        if (scripts || styles.minify) {
+            logger.error(core_1.tags.stripIndents `
+        ****************************************************************************************
+        This is a simple server for use in testing or debugging Angular applications locally.
+        It hasn't been reviewed for security issues.
+
+        DON'T USE IT FOR PRODUCTION!
+        ****************************************************************************************
+      `);
+        }
         const { config, projectRoot, i18n } = await webpack_browser_config_1.generateI18nBrowserWebpackConfigFromContext(browserOptions, context, (wco) => [
             configs_1.getDevServerConfig(wco),
             configs_1.getCommonConfig(wco),
@@ -129,30 +165,6 @@ function serveWebpackBrowser(options, context, transforms = {}) {
                 }
             }
         }
-        if (options.hmr) {
-            logger.warn(core_1.tags.stripIndents `NOTICE: Hot Module Replacement (HMR) is enabled for the dev server.
-      See https://webpack.js.org/guides/hot-module-replacement for information on working with HMR for Webpack.`);
-        }
-        if (options.host &&
-            !/^127\.\d+\.\d+\.\d+/g.test(options.host) &&
-            options.host !== 'localhost') {
-            logger.warn(core_1.tags.stripIndent `
-        Warning: This is a simple server for use in testing or debugging Angular applications
-        locally. It hasn't been reviewed for security issues.
-
-        Binding this server to an open connection can result in compromising your application or
-        computer. Using a different host than the one passed to the "--host" flag might result in
-        websocket connection issues. You might need to use "--disableHostCheck" if that's the
-        case.
-      `);
-        }
-        if (options.disableHostCheck) {
-            logger.warn(core_1.tags.oneLine `
-        Warning: Running a server with --disable-host-check is a security risk.
-        See https://medium.com/webpack/webpack-dev-server-middleware-security-issues-1489d950874a
-        for more information.
-      `);
-        }
         let locale;
         if (i18n.shouldInline) {
             // Dev-server only supports one locale
@@ -185,7 +197,6 @@ function serveWebpackBrowser(options, context, transforms = {}) {
         };
     }
     return rxjs_1.from(setup()).pipe(operators_1.switchMap(({ browserOptions, webpackConfig, projectRoot, locale }) => {
-        const normalizedOptimization = utils_1.normalizeOptimization(browserOptions.optimization);
         if (browserOptions.index) {
             const { scripts = [], styles = [], baseHref, tsConfig } = browserOptions;
             const { options: compilerOptions } = read_tsconfig_1.readTsconfig(tsConfig, workspaceRoot);
@@ -206,24 +217,14 @@ function serveWebpackBrowser(options, context, transforms = {}) {
                 deployUrl: browserOptions.deployUrl,
                 sri: browserOptions.subresourceIntegrity,
                 postTransform: transforms.indexHtml,
-                optimization: normalizedOptimization,
+                optimization: utils_1.normalizeOptimization(browserOptions.optimization),
                 WOFFSupportNeeded: !buildBrowserFeatures.isFeatureSupported('woff2'),
                 crossOrigin: browserOptions.crossOrigin,
                 lang: locale,
             }));
         }
-        if (normalizedOptimization.scripts || normalizedOptimization.styles.minify) {
-            logger.error(core_1.tags.stripIndents `
-          ****************************************************************************************
-          This is a simple server for use in testing or debugging Angular applications locally.
-          It hasn't been reviewed for security issues.
-
-          DON'T USE IT FOR PRODUCTION!
-          ****************************************************************************************
-        `);
-        }
         return build_webpack_1.runWebpackDevServer(webpackConfig, context, {
-            logging: transforms.logging || stats_1.createWebpackLoggingCallback(!!options.verbose, logger),
+            logging: transforms.logging || stats_1.createWebpackLoggingCallback(browserOptions, logger),
             webpackFactory: require('webpack'),
             webpackDevServerFactory: require('webpack-dev-server'),
         }).pipe(operators_1.concatMap(async (buildEvent, index) => {

package/src/dev-server/schema.d.ts

@@ -84,7 +84,8 @@ export interface Schema {
      */
     progress?: boolean;
     /**
-     * Proxy configuration file.
+     * Proxy configuration file. For more information, see
+     * https://angular.io/guide/build#proxying-to-a-backend-server.
      */
     proxyConfig?: string;
     /**

package/src/dev-server/schema.json

@@ -21,7 +21,7 @@
     },
     "proxyConfig": {
       "type": "string",
-      "description": "Proxy configuration file."
+      "description": "Proxy configuration file. For more information, see https://angular.io/guide/build#proxying-to-a-backend-server."
     },
     "ssl": {
       "type": "boolean",

package/src/extract-i18n/index.js

@@ -118,7 +118,7 @@ async function execute(options, context, transforms) {
     const i18n = i18n_options_1.createI18nOptions(metadata);
     let useLegacyIds = true;
     const ivyMessages = [];
-    const { config, projectRoot } = await webpack_browser_config_1.generateBrowserWebpackConfigFromContext({
+    const builderOptions = {
         ...browserOptions,
         optimization: false,
         sourceMap: {
@@ -138,7 +138,8 @@ async function execute(options, context, transforms) {
         subresourceIntegrity: false,
         outputHashing: schema_1.OutputHashing.None,
         namedChunks: true,
-    }, context, (wco) => {
+    };
+    const { config, projectRoot } = await webpack_browser_config_1.generateBrowserWebpackConfigFromContext(builderOptions, context, (wco) => {
         var _a;
         if (wco.tsConfig.options.enableIvy === false) {
             context.logger.warn('Ivy extraction enabled but application is not Ivy enabled. Extraction may fail.');
@@ -150,6 +151,7 @@ async function execute(options, context, transforms) {
             configs_1.getCommonConfig(wco),
             configs_1.getBrowserConfig(wco),
             configs_1.getTypeScriptConfig(wco),
+            configs_1.getWorkerConfig(wco),
             configs_1.getStatsConfig(wco),
         ];
         // Add Ivy application file extractor support
@@ -170,6 +172,7 @@ async function execute(options, context, transforms) {
         partials.push({
             plugins: [
                 new webpack.NormalModuleReplacementPlugin(/\.(css|scss|sass|styl|less)$/, path.join(__dirname, 'empty-export-default.js')),
+                new webpack.NormalModuleReplacementPlugin(/^angular-resource:style,/, path.join(__dirname, 'empty-export-default.js')),
             ],
         });
         return partials;
@@ -185,7 +188,7 @@ async function execute(options, context, transforms) {
         };
     }
     const webpackResult = await build_webpack_1.runWebpack((await ((_a = transforms === null || transforms === void 0 ? void 0 : transforms.webpackConfiguration) === null || _a === void 0 ? void 0 : _a.call(transforms, config))) || config, context, {
-        logging: stats_1.createWebpackLoggingCallback(false, context.logger),
+        logging: stats_1.createWebpackLoggingCallback(builderOptions, context.logger),
         webpackFactory: webpack,
     }).toPromise();
     // Set the outputPath to the extraction output location for downstream consumers

package/src/karma/index.js

@@ -40,6 +40,7 @@ async function initialize(options, context, webpackConfigurationTransformer) {
         // https://github.com/webpack/webpack-dev-middleware/blob/698c9ae5e9bb9a013985add6189ff21c1a1ec185/src/index.js#L65
         // https://github.com/webpack/webpack/blob/cde1b73e12eb8a77eb9ba42e7920c9ec5d29c2c9/lib/Compiler.js#L379-L388
         watch: true,
+        extractCss: true,
     }, context, (wco) => [
         configs_1.getCommonConfig(wco),
         configs_1.getStylesConfig(wco),

package/src/karma/schema.d.ts

@@ -167,7 +167,7 @@ export interface SourceMapClass {
  */
 export interface StylePreprocessorOptions {
     /**
-     * Paths to include. Paths will be resolved to project root.
+     * Paths to include. Paths will be resolved to workspace root.
      */
     includePaths?: string[];
 }

package/src/karma/schema.json

@@ -55,7 +55,7 @@
       "type": "object",
       "properties": {
         "includePaths": {
-          "description": "Paths to include. Paths will be resolved to project root.",
+          "description": "Paths to include. Paths will be resolved to workspace root.",
           "type": "array",
           "items": {
             "type": "string"

package/src/karma/tests/setup.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+import { Schema } from '../schema';
+export { describeBuilder } from '../../testing';
+export declare const KARMA_BUILDER_INFO: Readonly<{
+    name: string;
+    schemaPath: string;
+}>;
+/**
+ * Contains all required karma builder fields.
+ * Also disables progress reporting to minimize logging output.
+ */
+export declare const BASE_OPTIONS: Readonly<Schema>;

package/src/karma/tests/setup.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_OPTIONS = exports.KARMA_BUILDER_INFO = exports.describeBuilder = void 0;
+var testing_1 = require("../../testing");
+Object.defineProperty(exports, "describeBuilder", { enumerable: true, get: function () { return testing_1.describeBuilder; } });
+exports.KARMA_BUILDER_INFO = Object.freeze({
+    name: '@angular-devkit/build-angular:karma',
+    schemaPath: __dirname + '/../schema.json',
+});
+/**
+ * Contains all required karma builder fields.
+ * Also disables progress reporting to minimize logging output.
+ */
+exports.BASE_OPTIONS = Object.freeze({
+    main: 'src/test.ts',
+    polyfills: 'src/polyfills.ts',
+    tsConfig: 'src/tsconfig.spec.json',
+    karmaConfig: 'karma.conf.js',
+    browsers: 'ChromeHeadlessCI',
+    progress: false,
+    watch: false,
+});

package/src/sass/sass-service.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+import { Options, Result, SassException } from 'sass';
+/**
+ * The callback type for the `dart-sass` asynchronous render function.
+ */
+declare type RenderCallback = (error?: SassException, result?: Result) => void;
+/**
+ * A Sass renderer implementation that provides an interface that can be used by Webpack's
+ * `sass-loader`. The implementation uses a Worker thread to perform the Sass rendering
+ * with the `dart-sass` package.  The `dart-sass` synchronous render function is used within
+ * the worker which can be up to two times faster than the asynchronous variant.
+ */
+export declare class SassWorkerImplementation {
+    private readonly workers;
+    private readonly availableWorkers;
+    private readonly requests;
+    private idCounter;
+    private nextWorkerIndex;
+    /**
+     * Provides information about the Sass implementation.
+     * This mimics enough of the `dart-sass` value to be used with the `sass-loader`.
+     */
+    get info(): string;
+    /**
+     * The synchronous render function is not used by the `sass-loader`.
+     */
+    renderSync(): never;
+    /**
+     * Asynchronously request a Sass stylesheet to be renderered.
+     *
+     * @param options The `dart-sass` options to use when rendering the stylesheet.
+     * @param callback The function to execute when the rendering is complete.
+     */
+    render(options: Options, callback: RenderCallback): void;
+    /**
+     * Shutdown the Sass render worker.
+     * Executing this method will stop any pending render requests.
+     */
+    close(): void;
+    private createWorker;
+    private processImporters;
+    private createRequest;
+}
+export {};

package/src/sass/sass-service.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SassWorkerImplementation = void 0;
+const worker_threads_1 = require("worker_threads");
+const environment_options_1 = require("../utils/environment-options");
+/**
+ * The maximum number of Workers that will be created to execute render requests.
+ */
+const MAX_RENDER_WORKERS = environment_options_1.maxWorkers;
+/**
+ * Workaround required for lack of new Worker transfer list support in Node.js prior to 12.17
+ */
+let transferListWorkaround = false;
+const version = process.versions.node.split('.').map((part) => Number(part));
+if (version[0] === 12 && version[1] < 17) {
+    transferListWorkaround = true;
+}
+/**
+ * A Sass renderer implementation that provides an interface that can be used by Webpack's
+ * `sass-loader`. The implementation uses a Worker thread to perform the Sass rendering
+ * with the `dart-sass` package.  The `dart-sass` synchronous render function is used within
+ * the worker which can be up to two times faster than the asynchronous variant.
+ */
+class SassWorkerImplementation {
+    constructor() {
+        this.workers = [];
+        this.availableWorkers = [];
+        this.requests = new Map();
+        this.idCounter = 1;
+        this.nextWorkerIndex = 0;
+    }
+    /**
+     * Provides information about the Sass implementation.
+     * This mimics enough of the `dart-sass` value to be used with the `sass-loader`.
+     */
+    get info() {
+        return 'dart-sass\tworker';
+    }
+    /**
+     * The synchronous render function is not used by the `sass-loader`.
+     */
+    renderSync() {
+        throw new Error('Sass renderSync is not supported.');
+    }
+    /**
+     * Asynchronously request a Sass stylesheet to be renderered.
+     *
+     * @param options The `dart-sass` options to use when rendering the stylesheet.
+     * @param callback The function to execute when the rendering is complete.
+     */
+    render(options, callback) {
+        // The `functions` and `importer` options are JavaScript functions that cannot be transferred.
+        // If any additional function options are added in the future, they must be excluded as well.
+        const { functions, importer, ...serializableOptions } = options;
+        // The CLI's configuration does not use or expose the ability to defined custom Sass functions
+        if (functions && Object.keys(functions).length > 0) {
+            throw new Error('Sass custom functions are not supported.');
+        }
+        let workerIndex = this.availableWorkers.pop();
+        if (workerIndex === undefined) {
+            if (this.workers.length < MAX_RENDER_WORKERS) {
+                workerIndex = this.workers.length;
+                this.workers.push(this.createWorker());
+            }
+            else {
+                workerIndex = this.nextWorkerIndex++;
+                if (this.nextWorkerIndex >= this.workers.length) {
+                    this.nextWorkerIndex = 0;
+                }
+            }
+        }
+        const request = this.createRequest(workerIndex, callback, importer);
+        this.requests.set(request.id, request);
+        this.workers[workerIndex].postMessage({
+            id: request.id,
+            hasImporter: !!importer,
+            options: serializableOptions,
+        });
+    }
+    /**
+     * Shutdown the Sass render worker.
+     * Executing this method will stop any pending render requests.
+     */
+    close() {
+        for (const worker of this.workers) {
+            try {
+                void worker.terminate();
+            }
+            catch { }
+        }
+        this.requests.clear();
+    }
+    createWorker() {
+        const { port1: mainImporterPort, port2: workerImporterPort } = new worker_threads_1.MessageChannel();
+        const importerSignal = new Int32Array(new SharedArrayBuffer(4));
+        const workerPath = require.resolve('./worker');
+        const worker = new worker_threads_1.Worker(workerPath, {
+            workerData: transferListWorkaround ? undefined : { workerImporterPort, importerSignal },
+            transferList: transferListWorkaround ? undefined : [workerImporterPort],
+        });
+        if (transferListWorkaround) {
+            worker.postMessage({ init: true, workerImporterPort, importerSignal }, [workerImporterPort]);
+        }
+        worker.on('message', (response) => {
+            const request = this.requests.get(response.id);
+            if (!request) {
+                return;
+            }
+            this.requests.delete(response.id);
+            this.availableWorkers.push(request.workerIndex);
+            if (response.result) {
+                // The results are expected to be Node.js `Buffer` objects but will each be transferred as
+                // a Uint8Array that does not have the expected `toString` behavior of a `Buffer`.
+                const { css, map, stats } = response.result;
+                const result = {
+                    // This `Buffer.from` override will use the memory directly and avoid making a copy
+                    css: Buffer.from(css.buffer, css.byteOffset, css.byteLength),
+                    stats,
+                };
+                if (map) {
+                    // This `Buffer.from` override will use the memory directly and avoid making a copy
+                    result.map = Buffer.from(map.buffer, map.byteOffset, map.byteLength);
+                }
+                request.callback(undefined, result);
+            }
+            else {
+                request.callback(response.error);
+            }
+        });
+        mainImporterPort.on('message', ({ id, url, prev }) => {
+            const request = this.requests.get(id);
+            if (!(request === null || request === void 0 ? void 0 : request.importers)) {
+                mainImporterPort.postMessage(null);
+                Atomics.store(importerSignal, 0, 1);
+                Atomics.notify(importerSignal, 0);
+                return;
+            }
+            this.processImporters(request.importers, url, prev)
+                .then((result) => {
+                mainImporterPort.postMessage(result);
+            })
+                .catch((error) => {
+                mainImporterPort.postMessage(error);
+            })
+                .finally(() => {
+                Atomics.store(importerSignal, 0, 1);
+                Atomics.notify(importerSignal, 0);
+            });
+        });
+        mainImporterPort.unref();
+        return worker;
+    }
+    async processImporters(importers, url, prev) {
+        let result = null;
+        for (const importer of importers) {
+            result = await new Promise((resolve) => {
+                // Importers can be both sync and async
+                const innerResult = importer(url, prev, resolve);
+                if (innerResult !== undefined) {
+                    resolve(innerResult);
+                }
+            });
+            if (result) {
+                break;
+            }
+        }
+        return result;
+    }
+    createRequest(workerIndex, callback, importer) {
+        return {
+            id: this.idCounter++,
+            workerIndex,
+            callback,
+            importers: !importer || Array.isArray(importer) ? importer : [importer],
+        };
+    }
+}
+exports.SassWorkerImplementation = SassWorkerImplementation;

package/src/sass/worker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+export {};