@depup/angular__build 21.2.2-depup.0

package/src/tools/esbuild/wasm-plugin.js

@@ -0,0 +1,211 @@
+"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.dev/license
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWasmPlugin = createWasmPlugin;
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const error_1 = require("../../utils/error");
+const load_result_cache_1 = require("./load-result-cache");
+const WASM_INIT_NAMESPACE = 'angular:wasm:init';
+const WASM_CONTENTS_NAMESPACE = 'angular:wasm:contents';
+const WASM_RESOLVE_SYMBOL = Symbol('WASM_RESOLVE_SYMBOL');
+// See: https://github.com/tc39/proposal-regexp-unicode-property-escapes/blob/fe6d07fad74cd0192d154966baa1e95e7cda78a1/README.md#other-examples
+const ecmaIdentifierNameRegExp = /^(?:[$_\p{ID_Start}])(?:[$_\u200C\u200D\p{ID_Continue}])*$/u;
+/**
+ * Creates an esbuild plugin to use WASM files with import statements and expressions.
+ * The default behavior follows the WebAssembly/ES mode integration proposal found at
+ * https://github.com/WebAssembly/esm-integration/tree/main/proposals/esm-integration.
+ * This behavior requires top-level await support which is only available in zoneless
+ * Angular applications.
+ * @returns An esbuild plugin.
+ */
+function createWasmPlugin(options) {
+    const { allowAsync = false, cache } = options;
+    return {
+        name: 'angular-wasm',
+        setup(build) {
+            build.onResolve({ filter: /\.wasm$/ }, async (args) => {
+                // Skip if already resolving the WASM file to avoid infinite resolution
+                if (args.pluginData?.[WASM_RESOLVE_SYMBOL]) {
+                    return;
+                }
+                // Skip if not an import statement or expression
+                if (args.kind !== 'import-statement' && args.kind !== 'dynamic-import') {
+                    return;
+                }
+                // When in the initialization namespace, the content has already been resolved
+                // and only needs to be loaded for use with the initialization code.
+                if (args.namespace === WASM_INIT_NAMESPACE) {
+                    return {
+                        namespace: WASM_CONTENTS_NAMESPACE,
+                        path: (0, node_path_1.join)(args.resolveDir, args.path),
+                        pluginData: args.pluginData,
+                    };
+                }
+                // Skip if a custom loader is defined
+                if (build.initialOptions.loader?.['.wasm'] || args.with['loader']) {
+                    return;
+                }
+                // Attempt full resolution of the WASM file
+                const resolveOptions = {
+                    ...args,
+                    pluginData: { [WASM_RESOLVE_SYMBOL]: true },
+                };
+                // The "path" property will cause an error if used in the resolve call
+                delete resolveOptions.path;
+                const result = await build.resolve(args.path, resolveOptions);
+                // Skip if there are errors, is external, or another plugin resolves to a custom namespace
+                if (result.errors.length > 0 || result.external || result.namespace !== 'file') {
+                    // Reuse already resolved result
+                    return result;
+                }
+                return {
+                    ...result,
+                    namespace: WASM_INIT_NAMESPACE,
+                };
+            });
+            build.onLoad({ filter: /\.wasm$/, namespace: WASM_INIT_NAMESPACE }, (0, load_result_cache_1.createCachedLoad)(cache, async (args) => {
+                // Ensure async mode is supported
+                if (!allowAsync) {
+                    return {
+                        errors: [
+                            {
+                                text: 'WASM/ES module integration imports are not supported with Zone.js applications',
+                                notes: [
+                                    {
+                                        text: 'Information about zoneless Angular applications can be found here: https://angular.dev/guide/experimental/zoneless',
+                                    },
+                                ],
+                            },
+                        ],
+                    };
+                }
+                const wasmContents = await (0, promises_1.readFile)(args.path);
+                // Inline WASM code less than 10kB
+                const inlineWasm = wasmContents.byteLength < 10_000;
+                // Add import of WASM contents
+                let initContents = `import ${inlineWasm ? 'wasmData' : 'wasmPath'} from ${JSON.stringify((0, node_path_1.basename)(args.path))}`;
+                initContents += inlineWasm ? ' with { loader: "binary" };' : ';\n\n';
+                // Read from the file system when on Node.js (SSR) and not inline
+                if (!inlineWasm && build.initialOptions.platform === 'node') {
+                    initContents += 'import { readFile } from "node:fs/promises";\n';
+                    initContents +=
+                        'const wasmData = await readFile(new URL(wasmPath, import.meta.url));\n';
+                }
+                // Create initialization function
+                initContents += generateInitHelper(!inlineWasm && build.initialOptions.platform !== 'node', wasmContents);
+                // Analyze WASM for imports and exports
+                let importModuleNames, exportNames;
+                try {
+                    const wasm = await WebAssembly.compile(wasmContents);
+                    importModuleNames = new Set(WebAssembly.Module.imports(wasm).map((value) => value.module));
+                    exportNames = WebAssembly.Module.exports(wasm).map((value) => value.name);
+                }
+                catch (error) {
+                    (0, error_1.assertIsError)(error);
+                    return {
+                        errors: [{ text: 'Unable to analyze WASM file', notes: [{ text: error.message }] }],
+                    };
+                }
+                // Ensure export names are valid JavaScript identifiers
+                const invalidExportNames = exportNames.filter((name) => !ecmaIdentifierNameRegExp.test(name));
+                if (invalidExportNames.length > 0) {
+                    return {
+                        errors: invalidExportNames.map((name) => ({
+                            text: 'WASM export names must be valid JavaScript identifiers',
+                            notes: [
+                                {
+                                    text: `The export "${name}" is not valid. The WASM file should be updated to remove this error.`,
+                                },
+                            ],
+                        })),
+                    };
+                }
+                // Add import statements and setup import object
+                initContents += 'const importObject = Object.create(null);\n';
+                let importIndex = 0;
+                for (const moduleName of importModuleNames) {
+                    // Add a namespace import for each module name
+                    initContents += `import * as wasm_import_${++importIndex} from ${JSON.stringify(moduleName)};\n`;
+                    // Add the namespace object to the import object
+                    initContents += `importObject[${JSON.stringify(moduleName)}] = wasm_import_${importIndex};\n`;
+                }
+                // Instantiate the module
+                initContents += 'const instance = await init(importObject);\n';
+                // Add exports
+                const exportNameList = exportNames.join(', ');
+                initContents += `const { ${exportNameList} } = instance.exports;\n`;
+                initContents += `export { ${exportNameList} }\n`;
+                return {
+                    contents: initContents,
+                    loader: 'js',
+                    resolveDir: (0, node_path_1.dirname)(args.path),
+                    pluginData: { wasmContents },
+                    watchFiles: [args.path],
+                };
+            }));
+            build.onLoad({ filter: /\.wasm$/, namespace: WASM_CONTENTS_NAMESPACE }, async (args) => {
+                const contents = args.pluginData.wasmContents ?? (await (0, promises_1.readFile)(args.path));
+                let loader = 'file';
+                if (args.with.loader) {
+                    (0, node_assert_1.default)(args.with.loader === 'binary' || args.with.loader === 'file', 'WASM loader type should only be binary or file.');
+                    loader = args.with.loader;
+                }
+                return {
+                    contents,
+                    loader,
+                    watchFiles: [args.path],
+                };
+            });
+        },
+    };
+}
+/**
+ * Generates the string content of the WASM initialization helper function.
+ * This function supports both file fetching and inline byte data depending on
+ * the preferred option for the WASM file. When fetching, an integrity hash is
+ * also generated and used with the fetch action.
+ *
+ * @param streaming Uses fetch and WebAssembly.instantiateStreaming.
+ * @param wasmContents The binary contents to generate an integrity hash.
+ * @returns A string containing the initialization function.
+ */
+function generateInitHelper(streaming, wasmContents) {
+    let resultContents;
+    if (streaming) {
+        const fetchOptions = {
+            integrity: 'sha256-' + (0, node_crypto_1.createHash)('sha256').update(wasmContents).digest('base64'),
+        };
+        const fetchContents = `fetch(new URL(wasmPath, import.meta.url), ${JSON.stringify(fetchOptions)})`;
+        resultContents = `await WebAssembly.instantiateStreaming(${fetchContents}, imports)`;
+    }
+    else {
+        resultContents = 'await WebAssembly.instantiate(wasmData, imports)';
+    }
+    const contents = `
+let mod;
+async function init(imports) {
+  if (mod) {
+    return await WebAssembly.instantiate(mod, imports);
+  }
+
+  const result = ${resultContents};
+  mod = result.module;
+
+  return result.instance;
+}
+`;
+    return contents;
+}
+//# sourceMappingURL=wasm-plugin.js.map

package/src/tools/esbuild/wasm-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-plugin.js","sourceRoot":"","sources":["wasm-plugin.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;AAqCH,4CA8KC;AAhND,8DAAiC;AACjC,6CAAyC;AACzC,+CAA4C;AAC5C,yCAAoD;AACpD,6CAAkD;AAClD,2DAAwE;AAcxE,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAChD,MAAM,uBAAuB,GAAG,uBAAuB,CAAC;AACxD,MAAM,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAE1D,+IAA+I;AAC/I,MAAM,wBAAwB,GAAG,6DAA6D,CAAC;AAE/F;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAAC,OAA0B;IACzD,MAAM,EAAE,UAAU,GAAG,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAE9C,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,KAAK,CAAC,KAAK;YACT,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACpD,uEAAuE;gBACvE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC;oBAC3C,OAAO;gBACT,CAAC;gBACD,gDAAgD;gBAChD,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;oBACvE,OAAO;gBACT,CAAC;gBAED,8EAA8E;gBAC9E,oEAAoE;gBACpE,IAAI,IAAI,CAAC,SAAS,KAAK,mBAAmB,EAAE,CAAC;oBAC3C,OAAO;wBACL,SAAS,EAAE,uBAAuB;wBAClC,IAAI,EAAE,IAAA,gBAAI,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC;wBACtC,UAAU,EAAE,IAAI,CAAC,UAAU;qBAC5B,CAAC;gBACJ,CAAC;gBAED,qCAAqC;gBACrC,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAClE,OAAO;gBACT,CAAC;gBAED,2CAA2C;gBAC3C,MAAM,cAAc,GAAuC;oBACzD,GAAG,IAAI;oBACP,UAAU,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE;iBAC5C,CAAC;gBACF,sEAAsE;gBACtE,OAAO,cAAc,CAAC,IAAI,CAAC;gBAE3B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;gBAE9D,0FAA0F;gBAC1F,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;oBAC/E,gCAAgC;oBAChC,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAED,OAAO;oBACL,GAAG,MAAM;oBACT,SAAS,EAAE,mBAAmB;iBAC/B,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,CACV,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,EACrD,IAAA,oCAAgB,EAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACrC,iCAAiC;gBACjC,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,OAAO;wBACL,MAAM,EAAE;4BACN;gCACE,IAAI,EAAE,gFAAgF;gCACtF,KAAK,EAAE;oCACL;wCACE,IAAI,EAAE,oHAAoH;qCAC3H;iCACF;6BACF;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAED,MAAM,YAAY,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC/C,kCAAkC;gBAClC,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,GAAG,MAAM,CAAC;gBAEpD,8BAA8B;gBAC9B,IAAI,YAAY,GAAG,UAAU,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,SAAS,IAAI,CAAC,SAAS,CAAC,IAAA,oBAAQ,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBAChH,YAAY,IAAI,UAAU,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,OAAO,CAAC;gBAErE,iEAAiE;gBACjE,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,cAAc,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;oBAC5D,YAAY,IAAI,gDAAgD,CAAC;oBACjE,YAAY;wBACV,wEAAwE,CAAC;gBAC7E,CAAC;gBAED,iCAAiC;gBACjC,YAAY,IAAI,kBAAkB,CAChC,CAAC,UAAU,IAAI,KAAK,CAAC,cAAc,CAAC,QAAQ,KAAK,MAAM,EACvD,YAAY,CACb,CAAC;gBAEF,uCAAuC;gBACvC,IAAI,iBAAiB,EAAE,WAAW,CAAC;gBACnC,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;oBACrD,iBAAiB,GAAG,IAAI,GAAG,CACzB,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAC9D,CAAC;oBACF,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAA,qBAAa,EAAC,KAAK,CAAC,CAAC;oBAErB,OAAO;wBACL,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,6BAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;qBACpF,CAAC;gBACJ,CAAC;gBAED,uDAAuD;gBACvD,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAC3C,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAC/C,CAAC;gBACF,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAClC,OAAO;wBACL,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;4BACxC,IAAI,EAAE,wDAAwD;4BAC9D,KAAK,EAAE;gCACL;oCACE,IAAI,EAAE,eAAe,IAAI,uEAAuE;iCACjG;6BACF;yBACF,CAAC,CAAC;qBACJ,CAAC;gBACJ,CAAC;gBAED,gDAAgD;gBAChD,YAAY,IAAI,6CAA6C,CAAC;gBAC9D,IAAI,WAAW,GAAG,CAAC,CAAC;gBACpB,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;oBAC3C,8CAA8C;oBAC9C,YAAY,IAAI,2BAA2B,EAAE,WAAW,SAAS,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC;oBACjG,gDAAgD;oBAChD,YAAY,IAAI,gBAAgB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,mBAAmB,WAAW,KAAK,CAAC;gBAChG,CAAC;gBAED,yBAAyB;gBACzB,YAAY,IAAI,8CAA8C,CAAC;gBAE/D,cAAc;gBACd,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9C,YAAY,IAAI,WAAW,cAAc,0BAA0B,CAAC;gBACpE,YAAY,IAAI,YAAY,cAAc,MAAM,CAAC;gBAEjD,OAAO;oBACL,QAAQ,EAAE,YAAY;oBACtB,MAAM,EAAE,IAAI;oBACZ,UAAU,EAAE,IAAA,mBAAO,EAAC,IAAI,CAAC,IAAI,CAAC;oBAC9B,UAAU,EAAE,EAAE,YAAY,EAAE;oBAC5B,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;iBACxB,CAAC;YACJ,CAAC,CAAC,CACH,CAAC;YAEF,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,uBAAuB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,IAAI,CAAC,MAAM,IAAA,mBAAQ,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBAE7E,IAAI,MAAM,GAAsB,MAAM,CAAC;gBACvC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACrB,IAAA,qBAAM,EACJ,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,EAC5D,iDAAiD,CAClD,CAAC;oBACF,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC5B,CAAC;gBAED,OAAO;oBACL,QAAQ;oBACR,MAAM;oBACN,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;iBACxB,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,SAAkB,EAAE,YAAwB;IACtE,IAAI,cAAc,CAAC;IACnB,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,YAAY,GAAG;YACnB,SAAS,EAAE,SAAS,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;SAClF,CAAC;QACF,MAAM,aAAa,GAAG,6CAA6C,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC;QACnG,cAAc,GAAG,0CAA0C,aAAa,YAAY,CAAC;IACvF,CAAC;SAAM,CAAC;QACN,cAAc,GAAG,kDAAkD,CAAC;IACtE,CAAC;IAED,MAAM,QAAQ,GAAG;;;;;;;mBAOA,cAAc;;;;;CAKhC,CAAC;IAEA,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/src/tools/esbuild/wasm.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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.dev/license
+ */
+
+/** @fileoverview
+ * TypeScript does not provide a separate lib for WASM types and the Node.js
+ * types (`@types/node`) does not contain them either. This type definition
+ * file provides type information for the subset of functionality required
+ * by the Angular build process. Ideally this can be removed when the WASM
+ * type situation has improved.
+ */
+
+declare namespace WebAssembly {
+  class Module {
+    constructor(data: Uint8Array);
+
+    static imports(mod: Module): { module: string; name: string }[];
+    static exports(mode: Module): { name: string }[];
+  }
+  function compile(data: Uint8Array): Promise<Module>;
+}

package/src/tools/esbuild/watcher.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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.dev/license
+ */
+export declare class ChangedFiles {
+    readonly added: Set<string>;
+    readonly modified: Set<string>;
+    readonly removed: Set<string>;
+    get all(): string[];
+    toDebugString(): string;
+}
+export interface BuildWatcher extends AsyncIterableIterator<ChangedFiles> {
+    add(paths: string | readonly string[]): void;
+    remove(paths: string | readonly string[]): void;
+    close(): Promise<void>;
+}
+export declare function createWatcher(options?: {
+    polling?: boolean;
+    interval?: number;
+    ignored?: string[];
+    followSymlinks?: boolean;
+}): BuildWatcher;

package/src/tools/esbuild/watcher.js

@@ -0,0 +1,119 @@
+"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.dev/license
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChangedFiles = void 0;
+exports.createWatcher = createWatcher;
+const watchpack_1 = __importDefault(require("watchpack"));
+class ChangedFiles {
+    added = new Set();
+    modified = new Set();
+    removed = new Set();
+    get all() {
+        return [...this.added, ...this.modified, ...this.removed];
+    }
+    toDebugString() {
+        const content = {
+            added: Array.from(this.added),
+            modified: Array.from(this.modified),
+            removed: Array.from(this.removed),
+        };
+        return JSON.stringify(content, null, 2);
+    }
+}
+exports.ChangedFiles = ChangedFiles;
+function createWatcher(options) {
+    const watcher = new watchpack_1.default({
+        poll: options?.polling ? options?.interval ?? true : false,
+        ignored: options?.ignored,
+        followSymlinks: options?.followSymlinks,
+        aggregateTimeout: 250,
+    });
+    const watchedFiles = new Set();
+    const nextQueue = [];
+    let currentChangedFiles;
+    watcher.on('aggregated', (changes, removals) => {
+        const changedFiles = currentChangedFiles ?? new ChangedFiles();
+        for (const file of changes) {
+            changedFiles.modified.add(file);
+        }
+        for (const file of removals) {
+            changedFiles.removed.add(file);
+        }
+        const next = nextQueue.shift();
+        if (next) {
+            currentChangedFiles = undefined;
+            next(changedFiles);
+        }
+        else {
+            currentChangedFiles = changedFiles;
+        }
+    });
+    return {
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+        async next() {
+            if (currentChangedFiles && nextQueue.length === 0) {
+                const result = { value: currentChangedFiles };
+                currentChangedFiles = undefined;
+                return result;
+            }
+            return new Promise((resolve) => {
+                nextQueue.push((value) => resolve(value ? { value } : { done: true, value }));
+            });
+        },
+        add(paths) {
+            const previousSize = watchedFiles.size;
+            if (typeof paths === 'string') {
+                watchedFiles.add(paths);
+            }
+            else {
+                for (const file of paths) {
+                    watchedFiles.add(file);
+                }
+            }
+            if (previousSize !== watchedFiles.size) {
+                watcher.watch({
+                    files: watchedFiles,
+                });
+            }
+        },
+        remove(paths) {
+            const previousSize = watchedFiles.size;
+            if (typeof paths === 'string') {
+                watchedFiles.delete(paths);
+            }
+            else {
+                for (const file of paths) {
+                    watchedFiles.delete(file);
+                }
+            }
+            if (previousSize !== watchedFiles.size) {
+                watcher.watch({
+                    files: watchedFiles,
+                });
+            }
+        },
+        async close() {
+            try {
+                watcher.close();
+            }
+            finally {
+                let next;
+                while ((next = nextQueue.shift()) !== undefined) {
+                    next();
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=watcher.js.map

package/src/tools/esbuild/watcher.js.map

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

package/src/tools/sass/lexer.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.dev/license
+ */
+/**
+ * Scans a CSS or Sass file and locates all valid url function values as defined by the
+ * syntax specification.
+ * @param contents A string containing a CSS or Sass file to scan.
+ * @returns An iterable that yields each CSS url function value found.
+ */
+export declare function findUrls(contents: string): Iterable<{
+    start: number;
+    end: number;
+    value: string;
+}>;

package/src/tools/sass/lexer.js

@@ -0,0 +1,172 @@
+"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.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findUrls = findUrls;
+// TODO: Combine everything into a single pass lexer
+/**
+ * Determines if a unicode code point is a CSS whitespace character.
+ * @param code The unicode code point to test.
+ * @returns true, if the code point is CSS whitespace; false, otherwise.
+ */
+function isWhitespace(code) {
+    // Based on https://www.w3.org/TR/css-syntax-3/#whitespace
+    switch (code) {
+        case 0x0009: // tab
+        case 0x0020: // space
+        case 0x000a: // line feed
+        case 0x000c: // form feed
+        case 0x000d: // carriage return
+            return true;
+        default:
+            return false;
+    }
+}
+/**
+ * Scans a CSS or Sass file and locates all valid url function values as defined by the
+ * syntax specification.
+ * @param contents A string containing a CSS or Sass file to scan.
+ * @returns An iterable that yields each CSS url function value found.
+ */
+function* findUrls(contents) {
+    let pos = 0;
+    let width = 1;
+    let current = -1;
+    const next = () => {
+        pos += width;
+        current = contents.codePointAt(pos) ?? -1;
+        width = current > 0xffff ? 2 : 1;
+        return current;
+    };
+    // Based on https://www.w3.org/TR/css-syntax-3/#consume-ident-like-token
+    while ((pos = contents.indexOf('url(', pos)) !== -1) {
+        width = 1;
+        // Ensure whitespace, comma, or colon before `url(`
+        if (pos > 0) {
+            pos -= 2;
+            next();
+            if (!isWhitespace(current) && current !== 0x002c && current !== 0x003a) {
+                // Skip - not a url token
+                pos += 3;
+                continue;
+            }
+            pos += 1;
+        }
+        // Set to position of the (
+        pos += 3;
+        // Consume all leading whitespace
+        while (isWhitespace(next())) {
+            /* empty */
+        }
+        // Initialize URL state
+        const url = { start: pos, end: -1, value: '' };
+        let complete = false;
+        // If " or ', then consume the value as a string
+        if (current === 0x0022 || current === 0x0027) {
+            const ending = current;
+            // Based on https://www.w3.org/TR/css-syntax-3/#consume-string-token
+            while (!complete) {
+                switch (next()) {
+                    case -1: // EOF
+                        return;
+                    case 0x000a: // line feed
+                    case 0x000c: // form feed
+                    case 0x000d: // carriage return
+                        // Invalid
+                        complete = true;
+                        break;
+                    case 0x005c: // \ -- character escape
+                        // If not EOF or newline, add the character after the escape
+                        switch (next()) {
+                            case -1:
+                                return;
+                            case 0x000a: // line feed
+                            case 0x000c: // form feed
+                            case 0x000d: // carriage return
+                                // Skip when inside a string
+                                break;
+                            default:
+                                // TODO: Handle hex escape codes
+                                url.value += String.fromCodePoint(current);
+                                break;
+                        }
+                        break;
+                    case ending:
+                        // Full string position should include the quotes for replacement
+                        url.end = pos + 1;
+                        complete = true;
+                        yield url;
+                        break;
+                    default:
+                        url.value += String.fromCodePoint(current);
+                        break;
+                }
+            }
+            next();
+            continue;
+        }
+        // Based on https://www.w3.org/TR/css-syntax-3/#consume-url-token
+        while (!complete) {
+            switch (current) {
+                case -1: // EOF
+                    return;
+                case 0x0022: // "
+                case 0x0027: // '
+                case 0x0028: // (
+                    // Invalid
+                    complete = true;
+                    break;
+                case 0x0029: // )
+                    // URL is valid and complete
+                    url.end = pos;
+                    complete = true;
+                    break;
+                case 0x005c: // \ -- character escape
+                    // If not EOF or newline, add the character after the escape
+                    switch (next()) {
+                        case -1: // EOF
+                            return;
+                        case 0x000a: // line feed
+                        case 0x000c: // form feed
+                        case 0x000d: // carriage return
+                            // Invalid
+                            complete = true;
+                            break;
+                        default:
+                            // TODO: Handle hex escape codes
+                            url.value += String.fromCodePoint(current);
+                            break;
+                    }
+                    break;
+                default:
+                    if (isWhitespace(current)) {
+                        while (isWhitespace(next())) {
+                            /* empty */
+                        }
+                        // Unescaped whitespace is only valid before the closing )
+                        if (current === 0x0029) {
+                            // URL is valid
+                            url.end = pos;
+                        }
+                        complete = true;
+                    }
+                    else {
+                        // Add the character to the url value
+                        url.value += String.fromCodePoint(current);
+                    }
+                    break;
+            }
+            next();
+        }
+        // An end position indicates a URL was found
+        if (url.end !== -1) {
+            yield url;
+        }
+    }
+}
+//# sourceMappingURL=lexer.js.map

package/src/tools/sass/lexer.js.map

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