@angular/compiler-cli 20.2.0-next.0 → 20.2.0-next.1

package/bundles/chunk-DWRM7PIK.js

@@ -0,0 +1,14 @@
+
+      import {createRequire as __cjsCompatRequire} from 'module';
+      const require = __cjsCompatRequire(import.meta.url);
+    
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+export {
+  __require
+};

package/bundles/{chunk-JXYBFWGA.js → chunk-F7QVREVY.js}

@@ -12,13 +12,13 @@ import {
   formatDiagnostics,
   performCompilation,
   readConfiguration
-} from "./chunk-YNE6T2TY.js";
+} from "./chunk-U3R42CLJ.js";
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/main.js
+// packages/compiler-cli/src/main.js
 import ts2 from "typescript";
 import yargs from "yargs";
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/perform_watch.js
+// packages/compiler-cli/src/perform_watch.js
 import * as chokidar from "chokidar";
 import * as path from "path";
 import ts from "typescript";
@@ -68,6 +68,8 @@ function createPerformWatchHost(configFileName, reportDiagnostics, existingOptio
         } };
       }
       const watcher = chokidar.watch(options.basePath, {
+        // ignore .dotfiles, .js and .map files.
+        // can't ignore other files as we e.g. want to recompile if an `.html` file changes as well.
         ignored: (path2) => /((^[\/\\])\..)|(\.js$)|(\.map$)|(\.metadata\.json|node_modules)/.test(path2),
         ignoreInitial: true,
         persistent: true
@@ -207,7 +209,10 @@ function performWatchCompilation(host) {
   }
   function watchedFileChanged(event, fileName) {
     const normalizedPath = path.normalize(fileName);
-    if (cachedOptions && event === FileChangeEvent.Change && normalizedPath === path.normalize(cachedOptions.project)) {
+    if (cachedOptions && event === FileChangeEvent.Change && // TODO(chuckj): validate that this is sufficient to skip files that were written.
+    // This assumes that the file path we write is the same file path we will receive in the
+    // change notification.
+    normalizedPath === path.normalize(cachedOptions.project)) {
       resetOptions();
     } else if (event === FileChangeEvent.CreateDelete || event === FileChangeEvent.CreateDeleteDir) {
       cachedOptions = void 0;
@@ -242,11 +247,16 @@ function performWatchCompilation(host) {
   }
 }
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/main.js
+// packages/compiler-cli/src/main.js
 function main(args, consoleError = console.error, config, customTransformers, programReuse, modifiedResourceFiles) {
   let { project, rootNames, options, errors: configErrors, watch: watch2, emitFlags } = config || readNgcCommandLineAndConfiguration(args);
   if (configErrors.length) {
-    return reportErrorsAndExit(configErrors, void 0, consoleError);
+    return reportErrorsAndExit(
+      configErrors,
+      /*options*/
+      void 0,
+      consoleError
+    );
   }
   if (watch2) {
     const result = watchMode(project, options, consoleError);
@@ -325,6 +335,9 @@ function getFormatDiagnosticsHost(options) {
   const basePath = options ? options.basePath : void 0;
   return {
     getCurrentDirectory: () => basePath || ts2.sys.getCurrentDirectory(),
+    // We need to normalize the path separators here because by default, TypeScript
+    // compiler hosts use posix canonical paths. In order to print consistent diagnostics,
+    // we also normalize the paths.
     getCanonicalFileName: (fileName) => fileName.replace(/\\/g, "/"),
     getNewLine: () => {
       if (options && options.newLine !== void 0) {
@@ -363,4 +376,3 @@ export {
  * 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
  */
-//# sourceMappingURL=chunk-JXYBFWGA.js.map

package/bundles/{chunk-TPEB2IXF.js → chunk-GWZQLAGK.js}

@@ -3,7 +3,7 @@
       const require = __cjsCompatRequire(import.meta.url);
     
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/file_system/src/invalid_file_system.js
+// packages/compiler-cli/src/ngtsc/file_system/src/invalid_file_system.js
 var InvalidFileSystem = class {
   exists(path) {
     throw makeError();
@@ -91,7 +91,7 @@ function makeError() {
   return new Error("FileSystem has not been configured. Please call `setFileSystem()` before calling this method.");
 }
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/file_system/src/util.js
+// packages/compiler-cli/src/ngtsc/file_system/src/util.js
 var TS_DTS_JS_EXTENSION = /(?:\.d)?\.ts$|\.js$/;
 function normalizeSeparators(path) {
   return path.replace(/\\/g, "/");
@@ -107,7 +107,7 @@ function getSourceFileOrError(program, fileName) {
   return sf;
 }
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/file_system/src/helpers.js
+// packages/compiler-cli/src/ngtsc/file_system/src/helpers.js
 var fs = new InvalidFileSystem();
 function getFileSystem() {
   return fs;
@@ -164,7 +164,7 @@ function toRelativeImport(relativePath) {
   return isLocalRelativePath(relativePath) ? `./${relativePath}` : relativePath;
 }
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/file_system/src/compiler_host.js
+// packages/compiler-cli/src/ngtsc/file_system/src/compiler_host.js
 import * as os from "os";
 import ts from "typescript";
 var NgtscCompilerHost = class {
@@ -224,8 +224,14 @@ var NgtscCompilerHost = class {
   }
 };
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/file_system/src/logical.js
+// packages/compiler-cli/src/ngtsc/file_system/src/logical.js
 var LogicalProjectPath = {
+  /**
+   * Get the relative path between two `LogicalProjectPath`s.
+   *
+   * This will return a `PathSegment` which would be a valid module specifier to use in `from` when
+   * importing from `to`.
+   */
   relativePathBetween: function(from, to) {
     const relativePath = relative(dirname(resolve(from)), resolve(to));
     return toRelativeImport(relativePath);
@@ -233,17 +239,40 @@ var LogicalProjectPath = {
 };
 var LogicalFileSystem = class {
   compilerHost;
+  /**
+   * The root directories of the project, sorted with the longest path first.
+   */
   rootDirs;
+  /**
+   * The same root directories as `rootDirs` but with each one converted to its
+   * canonical form for matching in case-insensitive file-systems.
+   */
   canonicalRootDirs;
+  /**
+   * A cache of file paths to project paths, because computation of these paths is slightly
+   * expensive.
+   */
   cache = /* @__PURE__ */ new Map();
   constructor(rootDirs, compilerHost) {
     this.compilerHost = compilerHost;
     this.rootDirs = rootDirs.concat([]).sort((a, b) => b.length - a.length);
     this.canonicalRootDirs = this.rootDirs.map((dir) => this.compilerHost.getCanonicalFileName(dir));
   }
+  /**
+   * Get the logical path in the project of a `ts.SourceFile`.
+   *
+   * This method is provided as a convenient alternative to calling
+   * `logicalPathOfFile(absoluteFromSourceFile(sf))`.
+   */
   logicalPathOfSf(sf) {
     return this.logicalPathOfFile(absoluteFromSourceFile(sf));
   }
+  /**
+   * Get the logical path in the project of a source file.
+   *
+   * @returns A `LogicalProjectPath` to the source file, or `null` if the source file is not in any
+   * of the TS project's root directories.
+   */
   logicalPathOfFile(physicalFile) {
     if (!this.cache.has(physicalFile)) {
       const canonicalFilePath = this.compilerHost.getCanonicalFileName(physicalFile);
@@ -273,7 +302,7 @@ function isWithinBasePath(base, path) {
   return isLocalRelativePath(relative(base, path));
 }
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/file_system/src/ts_read_directory.js
+// packages/compiler-cli/src/ngtsc/file_system/src/ts_read_directory.js
 import ts2 from "typescript";
 function createFileSystemTsReadDirectoryFn(fs2) {
   if (ts2.matchFiles === void 0) {
@@ -335,4 +364,3 @@ export {
  * 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
  */
-//# sourceMappingURL=chunk-TPEB2IXF.js.map

package/bundles/{chunk-PML5JK7B.js → chunk-HYJ2H3FU.js}

@@ -3,11 +3,11 @@
       const require = __cjsCompatRequire(import.meta.url);
     
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/sourcemaps/src/source_file.js
+// packages/compiler-cli/src/ngtsc/sourcemaps/src/source_file.js
 import { decode, encode } from "@jridgewell/sourcemap-codec";
 import mapHelpers from "convert-source-map";
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/sourcemaps/src/segment_marker.js
+// packages/compiler-cli/src/ngtsc/sourcemaps/src/segment_marker.js
 function compareSegments(a, b) {
   return a.position - b.position;
 }
@@ -27,7 +27,7 @@ function offsetSegment(startOfLinePositions, marker, offset) {
   return { line, column, position, next: void 0 };
 }
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/sourcemaps/src/source_file.js
+// packages/compiler-cli/src/ngtsc/sourcemaps/src/source_file.js
 function removeSourceMapComments(contents) {
   return mapHelpers.removeMapFileComments(mapHelpers.removeComments(contents)).replace(/\n\n$/, "\n");
 }
@@ -37,6 +37,13 @@ var SourceFile = class {
   rawMap;
   sources;
   fs;
+  /**
+   * The parsed mappings that have been flattened so that any intermediate source mappings have been
+   * flattened.
+   *
+   * The result is that any source file mentioned in the flattened mappings have no source map (are
+   * pure original source files).
+   */
   flattenedMappings;
   startOfLinePositions;
   constructor(sourcePath, contents, rawMap, sources, fs) {
@@ -49,6 +56,9 @@ var SourceFile = class {
     this.startOfLinePositions = computeStartOfLinePositions(this.contents);
     this.flattenedMappings = this.flattenMappings();
   }
+  /**
+   * Render the raw source map generated from the flattened mappings.
+   */
   renderFlattenedSourceMap() {
     const sources = new IndexedMap();
     const names = new IndexedSet();
@@ -83,6 +93,14 @@ var SourceFile = class {
     };
     return sourceMap;
   }
+  /**
+   * Find the original mapped location for the given `line` and `column` in the generated file.
+   *
+   * First we search for a mapping whose generated segment is at or directly before the given
+   * location. Then we compute the offset between the given location and the matching generated
+   * segment. Finally we apply this offset to the original source segment to get the desired
+   * original location.
+   */
   getOriginalLocation(line, column) {
     if (this.flattenedMappings.length === 0) {
       return null;
@@ -107,6 +125,10 @@ var SourceFile = class {
       column: offsetOriginalSegment.column
     };
   }
+  /**
+   * Flatten the parsed mappings for this source file, so that all the mappings are to pure original
+   * source files with no transitive source maps.
+   */
   flattenMappings() {
     const mappings = parseMappings(this.rawMap && this.rawMap.map, this.sources, this.startOfLinePositions);
     ensureOriginalSegmentLinks(mappings);
@@ -244,8 +266,30 @@ function computeLineLengths(str) {
 }
 var IndexedMap = class {
   map = /* @__PURE__ */ new Map();
+  /**
+   * An array of keys added to this map.
+   *
+   * This array is guaranteed to be in the order of the first time the key was added to the map.
+   */
   keys = [];
+  /**
+   * An array of values added to this map.
+   *
+   * This array is guaranteed to be in the order of the first time the associated key was added to
+   * the map.
+   */
   values = [];
+  /**
+   * Associate the `value` with the `key` and return the index of the key in the collection.
+   *
+   * If the `key` already exists then the `value` is not set and the index of that `key` is
+   * returned; otherwise the `key` and `value` are stored and the index of the new `key` is
+   * returned.
+   *
+   * @param key the key to associated with the `value`.
+   * @param value the value to associated with the `key`.
+   * @returns the index of the `key` in the `keys` array.
+   */
   set(key, value) {
     if (this.map.has(key)) {
       return this.map.get(key);
@@ -258,7 +302,21 @@ var IndexedMap = class {
 };
 var IndexedSet = class {
   map = /* @__PURE__ */ new Map();
+  /**
+   * An array of values added to this set.
+   * This array is guaranteed to be in the order of the first time the value was added to the set.
+   */
   values = [];
+  /**
+   * Add the `value` to the `values` array, if it doesn't already exist; returning the index of the
+   * `value` in the `values` array.
+   *
+   * If the `value` already exists then the index of that `value` is returned, otherwise the new
+   * `value` is stored and the new index returned.
+   *
+   * @param value the value to add to the set.
+   * @returns the index of the `value` in the `values` array.
+   */
   add(value) {
     if (this.map.has(value)) {
       return this.map.get(value);
@@ -282,10 +340,10 @@ var Cache = class {
   }
 };
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/sourcemaps/src/source_file_loader.js
+// packages/compiler-cli/src/ngtsc/sourcemaps/src/source_file_loader.js
 import mapHelpers2 from "convert-source-map";
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/sourcemaps/src/content_origin.js
+// packages/compiler-cli/src/ngtsc/sourcemaps/src/content_origin.js
 var ContentOrigin;
 (function(ContentOrigin2) {
   ContentOrigin2[ContentOrigin2["Provided"] = 0] = "Provided";
@@ -293,7 +351,7 @@ var ContentOrigin;
   ContentOrigin2[ContentOrigin2["FileSystem"] = 2] = "FileSystem";
 })(ContentOrigin || (ContentOrigin = {}));
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/sourcemaps/src/source_file_loader.js
+// packages/compiler-cli/src/ngtsc/sourcemaps/src/source_file_loader.js
 var SCHEME_MATCHER = /^([a-z][a-z0-9.-]*):\/\//i;
 var SourceFileLoader = class {
   fs;
@@ -313,6 +371,22 @@ var SourceFileLoader = class {
     };
     return this.loadSourceFileInternal(sourcePath, contents, contentsOrigin, sourceMapInfo);
   }
+  /**
+   * The overload used internally to load source files referenced in a source-map.
+   *
+   * In this case there is no guarantee that it will return a non-null SourceMap.
+   *
+   * @param sourcePath The path to the source file to load.
+   * @param contents The contents of the source file to load, if provided inline. If `null`,
+   *     the contents will be read from the file at the `sourcePath`.
+   * @param sourceOrigin Describes where the source content came from.
+   * @param sourceMapInfo The raw contents and path of the source-map file. If `null` the
+   *     source-map will be computed from the contents of the source file, either inline or loaded
+   *     from the file-system.
+   *
+   * @returns a SourceFile if the content for one was provided or was able to be loaded from disk,
+   * `null` otherwise.
+   */
   loadSourceFileInternal(sourcePath, contents, sourceOrigin, sourceMapInfo) {
     const previousPaths = this.currentPaths.slice();
     try {
@@ -338,6 +412,19 @@ var SourceFileLoader = class {
       this.currentPaths = previousPaths;
     }
   }
+  /**
+   * Find the source map associated with the source file whose `sourcePath` and `contents` are
+   * provided.
+   *
+   * Source maps can be inline, as part of a base64 encoded comment, or external as a separate file
+   * whose path is indicated in a comment or implied from the name of the source file itself.
+   *
+   * @param sourcePath the path to the source file.
+   * @param sourceContents the contents of the source file.
+   * @param sourceOrigin where the content of the source file came from.
+   * @returns the parsed contents and path of the source-map, if loading was successful, null
+   *     otherwise.
+   */
   loadSourceMap(sourcePath, sourceContents, sourceOrigin) {
     const lastLine = this.getLastNonEmptyLine(sourceContents);
     const inline = mapHelpers2.commentRegex.exec(lastLine);
@@ -376,6 +463,10 @@ var SourceFileLoader = class {
     }
     return null;
   }
+  /**
+   * Iterate over each of the "sources" for this source file's source map, recursively loading each
+   * source file and its associated source map.
+   */
   processSources(basePath, { map, origin: sourceMapOrigin }) {
     const sourceRoot = this.fs.resolve(this.fs.dirname(basePath), this.replaceSchemeWithPath(map.sourceRoot || ""));
     return map.sources.map((source, index) => {
@@ -385,14 +476,29 @@ var SourceFileLoader = class {
       return this.loadSourceFileInternal(path, content, sourceOrigin, null);
     });
   }
+  /**
+   * Load the contents of the source file from disk.
+   *
+   * @param sourcePath The path to the source file.
+   */
   readSourceFile(sourcePath) {
     this.trackPath(sourcePath);
     return this.fs.readFile(sourcePath);
   }
+  /**
+   * Load the source map from the file at `mapPath`, parsing its JSON contents into a `RawSourceMap`
+   * object.
+   *
+   * @param mapPath The path to the source-map file.
+   */
   readRawSourceMap(mapPath) {
     this.trackPath(mapPath);
     return JSON.parse(this.fs.readFile(mapPath));
   }
+  /**
+   * Track source file paths if we have loaded them from disk so that we don't get into an infinite
+   * recursion.
+   */
   trackPath(path) {
     if (this.currentPaths.includes(path)) {
       throw new Error(`Circular source file mapping dependency: ${this.currentPaths.join(" -> ")} -> ${path}`);
@@ -410,6 +516,14 @@ var SourceFileLoader = class {
     }
     return contents.slice(lastRealLineIndex + 1);
   }
+  /**
+   * Replace any matched URL schemes with their corresponding path held in the schemeMap.
+   *
+   * Some build tools replace real file paths with scheme prefixed paths - e.g. `webpack://`.
+   * We use the `schemeMap` passed to this class to convert such paths to "real" file paths.
+   * In some cases, this is not possible, since the file was actually synthesized by the build tool.
+   * But the end result is better than prefixing the sourceRoot in front of the scheme.
+   */
   replaceSchemeWithPath(path) {
     return path.replace(SCHEME_MATCHER, (_, scheme) => this.schemeMap[scheme.toLowerCase()] || "");
   }
@@ -426,4 +540,3 @@ export {
  * 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
  */
-//# sourceMappingURL=chunk-PML5JK7B.js.map

package/bundles/{chunk-6ECVYRSU.js → chunk-I2BHWRAU.js}

@@ -3,21 +3,21 @@
       const require = __cjsCompatRequire(import.meta.url);
     
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/translator/src/context.js
-var Context = class {
+// packages/compiler-cli/src/ngtsc/translator/src/context.js
+var Context = class _Context {
   isStatement;
   constructor(isStatement) {
     this.isStatement = isStatement;
   }
   get withExpressionMode() {
-    return this.isStatement ? new Context(false) : this;
+    return this.isStatement ? new _Context(false) : this;
   }
   get withStatementMode() {
-    return !this.isStatement ? new Context(true) : this;
+    return !this.isStatement ? new _Context(true) : this;
   }
 };
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/translator/src/translator.js
+// packages/compiler-cli/src/ngtsc/translator/src/translator.js
 import * as o from "@angular/compiler";
 var UNARY_OPERATORS = /* @__PURE__ */ new Map([
   [o.UnaryOperator.Minus, "-"],
@@ -121,6 +121,10 @@ var ExpressionTranslatorVisitor = class {
   createTaggedTemplateExpression(tag, template) {
     return this.downlevelTaggedTemplates ? this.createES5TaggedTemplateFunctionCall(tag, template) : this.factory.createTaggedTemplate(tag, template);
   }
+  /**
+   * Translate the tagged template literal into a call that is compatible with ES5, using the
+   * imported `__makeTemplateObject` helper for ES5 formatted output.
+   */
   createES5TaggedTemplateFunctionCall(tagHandler, { elements, expressions }) {
     const __makeTemplateObjectHelper = this.imports.addImport({
       exportModuleSpecifier: "tslib",
@@ -136,11 +140,13 @@ var ExpressionTranslatorVisitor = class {
     const templateHelperCall = this.factory.createCallExpression(
       __makeTemplateObjectHelper,
       [this.factory.createArrayLiteral(cooked), this.factory.createArrayLiteral(raw)],
+      /* pure */
       false
     );
     return this.factory.createCallExpression(
       tagHandler,
       [templateHelperCall, ...expressions],
+      /* pure */
       false
     );
   }
@@ -293,4 +299,3 @@ export {
  * 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
  */
-//# sourceMappingURL=chunk-6ECVYRSU.js.map

package/bundles/{chunk-5TMRGUHP.js → chunk-PLUBZWSY.js}

@@ -16,9 +16,9 @@ import {
   tryParseSignalInputMapping,
   tryParseSignalModelMapping,
   tryParseSignalQueryFromInitializer
-} from "./chunk-UZOSFHTN.js";
+} from "./chunk-TMIC4MKN.js";
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/transform/jit/src/downlevel_decorators_transform.js
+// packages/compiler-cli/src/ngtsc/transform/jit/src/downlevel_decorators_transform.js
 import ts from "typescript";
 function isAngularDecorator2(decorator, isCore) {
   return isCore || decorator.import !== null && decorator.import.from === "@angular/core";
@@ -323,10 +323,10 @@ function cloneClassElementWithModifiers(node, modifiers) {
   return ts.setOriginalNode(clone, node);
 }
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/transform.js
+// packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/transform.js
 import ts4 from "typescript";
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/transform_api.js
+// packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/transform_api.js
 import ts2 from "typescript";
 function createSyntheticAngularCoreDecoratorAccess(factory, importManager, ngClassDecorator, sourceFile, decoratorName) {
   const classDecoratorIdentifier = ts2.isIdentifier(ngClassDecorator.identifier) ? ngClassDecorator.identifier : ngClassDecorator.identifier.expression;
@@ -336,6 +336,9 @@ function createSyntheticAngularCoreDecoratorAccess(factory, importManager, ngCla
       exportSymbolName: null,
       requestedFile: sourceFile
     }),
+    // The synthetic identifier may be checked later by the downlevel decorators
+    // transform to resolve to an Angular import using `getSymbolAtLocation`. We trick
+    // the transform to think it's not synthetic and comes from Angular core.
     ts2.setOriginalNode(factory.createIdentifier(decoratorName), classDecoratorIdentifier)
   );
 }
@@ -343,7 +346,7 @@ function castAsAny(factory, expr) {
   return factory.createAsExpression(expr, factory.createKeywordTypeNode(ts2.SyntaxKind.AnyKeyword));
 }
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/input_function.js
+// packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/input_function.js
 var signalInputsTransform = (member, sourceFile, host, factory, importTracker, importManager, classDecorator, isCore) => {
   if (host.getDecoratorsOfDeclaration(member.node)?.some((d) => isAngularDecorator(d, "Input", isCore))) {
     return member.node;
@@ -356,15 +359,21 @@ var signalInputsTransform = (member, sourceFile, host, factory, importTracker, i
     "isSignal": factory.createTrue(),
     "alias": factory.createStringLiteral(inputMapping.bindingPropertyName),
     "required": inputMapping.required ? factory.createTrue() : factory.createFalse(),
+    // For signal inputs, transforms are captured by the input signal. The runtime will
+    // determine whether a transform needs to be run via the input signal, so the `transform`
+    // option is always `undefined`.
     "transform": factory.createIdentifier("undefined")
   };
   const newDecorator = factory.createDecorator(factory.createCallExpression(createSyntheticAngularCoreDecoratorAccess(factory, importManager, classDecorator, sourceFile, "Input"), void 0, [
+    // Cast to `any` because `isSignal` will be private, and in case this
+    // transform is used directly as a pre-compilation step, the decorator should
+    // not fail. It is already validated now due to us parsing the input metadata.
     castAsAny(factory, factory.createObjectLiteralExpression(Object.entries(fields).map(([name, value]) => factory.createPropertyAssignment(name, value))))
   ]));
   return factory.updatePropertyDeclaration(member.node, [newDecorator, ...member.node.modifiers ?? []], member.name, member.node.questionToken, member.node.type, member.node.initializer);
 };
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/model_function.js
+// packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/model_function.js
 import ts3 from "typescript";
 var signalModelTransform = (member, sourceFile, host, factory, importTracker, importManager, classDecorator, isCore) => {
   if (host.getDecoratorsOfDeclaration(member.node)?.some((d) => {
@@ -383,6 +392,9 @@ var signalModelTransform = (member, sourceFile, host, factory, importTracker, im
   ]);
   const inputDecorator = createDecorator(
     "Input",
+    // Config is cast to `any` because `isSignal` will be private, and in case this
+    // transform is used directly as a pre-compilation step, the decorator should
+    // not fail. It is already validated now due to us parsing the input metadata.
     factory.createAsExpression(inputConfig, factory.createKeywordTypeNode(ts3.SyntaxKind.AnyKeyword)),
     classDecorator,
     factory,
@@ -397,7 +409,7 @@ function createDecorator(name, config, classDecorator, factory, sourceFile, impo
   return factory.createDecorator(factory.createCallExpression(callTarget, void 0, [config]));
 }
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/output_function.js
+// packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/output_function.js
 var initializerApiOutputTransform = (member, sourceFile, host, factory, importTracker, importManager, classDecorator, isCore) => {
   if (host.getDecoratorsOfDeclaration(member.node)?.some((d) => isAngularDecorator(d, "Output", isCore))) {
     return member.node;
@@ -410,7 +422,7 @@ var initializerApiOutputTransform = (member, sourceFile, host, factory, importTr
   return factory.updatePropertyDeclaration(member.node, [newDecorator, ...member.node.modifiers ?? []], member.node.name, member.node.questionToken, member.node.type, member.node.initializer);
 };
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/query_functions.js
+// packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/query_functions.js
 var queryFunctionToDecorator = {
   viewChild: "ViewChild",
   viewChildren: "ViewChildren",
@@ -431,8 +443,12 @@ var queryFunctionsTransforms = (member, sourceFile, host, factory, importTracker
   const newDecorator = factory.createDecorator(factory.createCallExpression(
     createSyntheticAngularCoreDecoratorAccess(factory, importManager, classDecorator, sourceFile, queryFunctionToDecorator[queryDefinition.name]),
     void 0,
+    // All positional arguments of the query functions can be mostly re-used as is
+    // for the decorator. i.e. predicate is always first argument. Options are second.
     [
       queryDefinition.call.arguments[0],
+      // Note: Casting as `any` because `isSignal` is not publicly exposed and this
+      // transform might pre-transform TS sources.
       castAsAny(factory, factory.createObjectLiteralExpression([
         ...callArgs.length > 1 ? [factory.createSpreadAssignment(callArgs[1])] : [],
         factory.createPropertyAssignment("isSignal", factory.createTrue())
@@ -442,7 +458,7 @@ var queryFunctionsTransforms = (member, sourceFile, host, factory, importTracker
   return factory.updatePropertyDeclaration(member.node, [newDecorator, ...member.node.modifiers ?? []], member.node.name, member.node.questionToken, member.node.type, member.node.initializer);
 };
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/transform.js
+// packages/compiler-cli/src/ngtsc/transform/jit/src/initializer_api_transforms/transform.js
 var decoratorsWithInputs = ["Directive", "Component"];
 var propertyTransforms = [
   signalInputsTransform,
@@ -494,7 +510,7 @@ function createTransformVisitor(ctx, host, importManager, importTracker, isCore,
   return visitor;
 }
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/transform/jit/src/index.js
+// packages/compiler-cli/src/ngtsc/transform/jit/src/index.js
 function angularJitApplicationTransform(program, isCore = false, shouldTransformClass) {
   const typeChecker = program.getTypeChecker();
   const reflectionHost = new TypeScriptReflectionHost(typeChecker);
@@ -504,6 +520,7 @@ function angularJitApplicationTransform(program, isCore = false, shouldTransform
     reflectionHost,
     [],
     isCore,
+    /* enableClosureCompiler */
     false,
     shouldTransformClass
   );
@@ -529,4 +546,3 @@ export {
  * 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
  */
-//# sourceMappingURL=chunk-5TMRGUHP.js.map

package/bundles/{chunk-5JF7HF3W.js → chunk-SZY7NM6F.js}

@@ -4,9 +4,9 @@
     
 import {
   __require
-} from "./chunk-KPQ72R34.js";
+} from "./chunk-DWRM7PIK.js";
 
-// bazel-out/k8-fastbuild/bin/packages/compiler-cli/src/ngtsc/file_system/src/node_js_file_system.js
+// packages/compiler-cli/src/ngtsc/file_system/src/node_js_file_system.js
 import fs from "fs";
 import { createRequire } from "module";
 import * as p from "path";
@@ -120,4 +120,3 @@ export {
  * 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
  */
-//# sourceMappingURL=chunk-5JF7HF3W.js.map