@angular/core 21.0.0-next.3 → 21.0.0-next.5

package/schematics/bundles/control-flow-migration.cjs

@@ -1,6 +1,6 @@
 'use strict';
 /**
- * @license Angular v21.0.0-next.3
+ * @license Angular v21.0.0-next.5
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -8,10 +8,10 @@
 
 var schematics = require('@angular-devkit/schematics');
 var p = require('path');
-var compiler_host = require('./compiler_host-Df7s6Riz.cjs');
-var project_tsconfig_paths = require('./project_tsconfig_paths-bRwOJEk9.cjs');
+var compiler_host = require('./compiler_host-Aouk-n4F.cjs');
+var project_tsconfig_paths = require('./project_tsconfig_paths-DX9KHLn9.cjs');
 var ts = require('typescript');
-var parse_html = require('./parse_html-CLFKoiOK.cjs');
+var parse_html = require('./parse_html-7Wl_HDnw.cjs');
 require('os');
 require('fs');
 require('module');
@@ -410,6 +410,7 @@ const endMarkerRegex = new RegExp(endMarker, 'gm');
 const startI18nMarkerRegex = new RegExp(startI18nMarker, 'gm');
 const endI18nMarkerRegex = new RegExp(endI18nMarker, 'gm');
 const replaceMarkerRegex = new RegExp(`${startMarker}|${endMarker}`, 'gm');
+const PRIORITY_WEIGHT_TEMPLATE_REFERENCE_BY_OUTLET = 2;
 /**
  * Analyzes a source file to find file that need to be migrated and the text ranges within them.
  * @param sourceFile File to be analyzed.
@@ -689,34 +690,6 @@ function getTemplates(template) {
     }
     return new Map();
 }
-function countTemplateUsage(nodes, templateName) {
-    let count = 0;
-    let isReferencedInTemplateOutlet = false;
-    for (const node of nodes) {
-        if (node.attrs) {
-            for (const attr of node.attrs) {
-                if (attr.name === '*ngTemplateOutlet' && attr.value === templateName.slice(1)) {
-                    isReferencedInTemplateOutlet = true;
-                    break;
-                }
-                if (attr.name.trim() === templateName) {
-                    count++;
-                }
-            }
-        }
-        if (node.children) {
-            if (node.name === 'for') {
-                for (const child of node.children) {
-                    if (child.value?.includes(templateName.slice(1))) {
-                        count++;
-                    }
-                }
-            }
-            count += countTemplateUsage(node.children, templateName);
-        }
-    }
-    return isReferencedInTemplateOutlet ? count + 2 : count;
-}
 function updateTemplates(template, templates) {
     const updatedTemplates = getTemplates(template);
     for (let [key, tmpl] of updatedTemplates) {
@@ -740,9 +713,10 @@ function processNgTemplates(template, sourceFile) {
     try {
         const templates = getTemplates(template);
         // swap placeholders and remove
-        for (const [name, t] of templates) {
-            const replaceRegex = new RegExp(getPlaceholder(name.slice(1)), 'g');
-            const forRegex = new RegExp(getPlaceholder(name.slice(1), PlaceholderKind.Alternate), 'g');
+        for (const [nameWithHash, t] of templates) {
+            const name = nameWithHash.slice(1);
+            const replaceRegex = new RegExp(getPlaceholder(name), 'g');
+            const forRegex = new RegExp(getPlaceholder(nameWithHash.slice(1), PlaceholderKind.Alternate), 'g');
             const forMatches = [...template.matchAll(forRegex)];
             const matches = [...forMatches, ...template.matchAll(replaceRegex)];
             let safeToRemove = true;
@@ -767,7 +741,12 @@ function processNgTemplates(template, sourceFile) {
                     template = template.replace(replaceRegex, t.children);
                 }
                 const dist = matches.filter((obj, index, self) => index === self.findIndex((t) => t.input === obj.input));
-                if ((t.count === dist.length || t.count - matches.length === 1) && safeToRemove) {
+                // Check if template is used by ngTemplateOutlet in addition to control flow
+                const hasTemplateOutletUsage = checkForTemplateOutletUsage(template, nameWithHash.slice(1));
+                // Only remove template if it's safe to do so AND not used by ngTemplateOutlet
+                if ((t.count === dist.length || t.count - matches.length === 1) &&
+                    safeToRemove &&
+                    !hasTemplateOutletUsage) {
                     const refsInComponentFile = getViewChildOrViewChildrenNames(sourceFile);
                     if (refsInComponentFile?.length > 0) {
                         const templateRefs = getTemplateReferences(template);
@@ -797,6 +776,59 @@ function processNgTemplates(template, sourceFile) {
         return { migrated: template, err: err };
     }
 }
+function analyzeTemplateUsage(nodes, templateName) {
+    let count = 0;
+    let isReferencedInTemplateOutlet = false;
+    const templateNameWithHash = `#${templateName}`;
+    function traverseNodes(nodeList) {
+        for (const node of nodeList) {
+            if (node.attrs) {
+                for (const attr of node.attrs) {
+                    if ((attr.name === '*ngTemplateOutlet' || attr.name === '[ngTemplateOutlet]') &&
+                        attr.value === templateName) {
+                        isReferencedInTemplateOutlet = true;
+                    }
+                    if (attr.name.trim() === templateNameWithHash) {
+                        count++;
+                    }
+                }
+            }
+            if (node.children) {
+                if (node.name === 'for') {
+                    for (const child of node.children) {
+                        if (child.value?.includes(templateName)) {
+                            count++;
+                        }
+                    }
+                }
+                traverseNodes(node.children);
+            }
+        }
+    }
+    traverseNodes(nodes);
+    return {
+        isReferencedInTemplateOutlet,
+        totalCount: isReferencedInTemplateOutlet
+            ? count + PRIORITY_WEIGHT_TEMPLATE_REFERENCE_BY_OUTLET
+            : count,
+    };
+}
+/**
+ * Checks if a template is used by ngTemplateOutlet directive
+ */
+function checkForTemplateOutletUsage(template, templateName) {
+    const parsed = parse_html.parseTemplate(template);
+    if (parsed.tree === undefined) {
+        return false;
+    }
+    const result = analyzeTemplateUsage(parsed.tree.rootNodes, templateName);
+    return result.isReferencedInTemplateOutlet;
+}
+function countTemplateUsage(nodes, templateNameWithHash) {
+    const templateName = templateNameWithHash.slice(1);
+    const result = analyzeTemplateUsage(nodes, templateName);
+    return result.totalCount;
+}
 function getViewChildOrViewChildrenNames(sourceFile) {
     const names = [];
     function visit(node) {
@@ -821,11 +853,11 @@ function getTemplateReferences(template) {
     if (parsed.tree === undefined) {
         return [];
     }
-    const references = [];
+    const templateNameRefWithoutHash = [];
     function visitNodes(nodes) {
         for (const node of nodes) {
             if (node?.name === 'ng-template') {
-                references.push(...node.attrs?.map((ref) => ref?.name?.slice(1)));
+                templateNameRefWithoutHash.push(...node.attrs?.map((ref) => ref?.name?.slice(1)));
             }
             if (node.children) {
                 visitNodes(node.children);
@@ -833,7 +865,7 @@ function getTemplateReferences(template) {
         }
     }
     visitNodes(parsed.tree.rootNodes);
-    return references;
+    return templateNameRefWithoutHash;
 }
 function replaceRemainingPlaceholders(template) {
     const pattern = '.*';

package/schematics/bundles/{imports-26VeX8i-.cjs → imports-DwPXlGFl.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 /**
- * @license Angular v21.0.0-next.3
+ * @license Angular v21.0.0-next.5
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -49,6 +49,10 @@ function getImportOfIdentifier(typeChecker, node) {
 function getImportSpecifier(sourceFile, moduleName, specifierName) {
     return getImportSpecifiers(sourceFile, moduleName, specifierName)[0] ?? null;
 }
+/**
+ * Note: returns only matching imports specifiers,
+ * Unmatched imports will be ignored (you won't get undefined), but a shorter array.
+ */
 function getImportSpecifiers(sourceFile, moduleName, specifierOrSpecifiers) {
     const matches = [];
     for (const node of sourceFile.statements) {
@@ -99,8 +103,30 @@ function findImportSpecifier(nodes, specifierName) {
         return propertyName ? propertyName.text === specifierName : name.text === specifierName;
     });
 }
+/**
+ * Gets the relative path between two files.
+ * @param from Path of the file that is importing from another file.
+ * @param to Path of the file that is being imported.
+ */
+function getRelativePath(from, to) {
+    const fromParts = from.split('/').slice(0, -1);
+    const toParts = to.split('/');
+    while (fromParts.length > 0 && toParts.length > 0 && fromParts[0] === toParts[0]) {
+        fromParts.shift();
+        toParts.shift();
+    }
+    let relativePath = fromParts.map(() => '..').join('/') + (fromParts.length > 0 ? '/' : '') + toParts.join('/');
+    if (relativePath.endsWith('.ts')) {
+        relativePath = relativePath.slice(0, -3);
+    }
+    if (!relativePath.startsWith('.')) {
+        relativePath = './' + relativePath;
+    }
+    return relativePath;
+}
 
 exports.getImportOfIdentifier = getImportOfIdentifier;
 exports.getImportSpecifier = getImportSpecifier;
 exports.getImportSpecifiers = getImportSpecifiers;
 exports.getNamedImports = getNamedImports;
+exports.getRelativePath = getRelativePath;

package/schematics/bundles/{index-Clvp4COX.cjs → index-BZQb51Qf.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 /**
- * @license Angular v21.0.0-next.3
+ * @license Angular v21.0.0-next.5
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -8,11 +8,11 @@
 
 var ts = require('typescript');
 require('os');
-var project_tsconfig_paths = require('./project_tsconfig_paths-bRwOJEk9.cjs');
-var index = require('./index-CBaykQBv.cjs');
+var project_tsconfig_paths = require('./project_tsconfig_paths-DX9KHLn9.cjs');
+var index = require('./index-Bb6iejCd.cjs');
 require('path');
 require('node:path');
-var project_paths = require('./project_paths-BJTqcWvC.cjs');
+var project_paths = require('./project_paths-Dr2s3Pq3.cjs');
 
 function getMemberName(member) {
     if (member.name === undefined) {

package/schematics/bundles/{index-CBaykQBv.cjs → index-Bb6iejCd.cjs}

@@ -1,12 +1,12 @@
 'use strict';
 /**
- * @license Angular v21.0.0-next.3
+ * @license Angular v21.0.0-next.5
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
 'use strict';
 
-var project_tsconfig_paths = require('./project_tsconfig_paths-bRwOJEk9.cjs');
+var project_tsconfig_paths = require('./project_tsconfig_paths-DX9KHLn9.cjs');
 var ts = require('typescript');
 var p = require('path');
 require('os');
@@ -891,7 +891,7 @@ const MINIMUM_PARTIAL_LINKER_DEFER_SUPPORT_VERSION = '18.0.0';
 function compileDeclareClassMetadata(metadata) {
     const definitionMap = new project_tsconfig_paths.DefinitionMap();
     definitionMap.set('minVersion', project_tsconfig_paths.literal(MINIMUM_PARTIAL_LINKER_VERSION$5));
-    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.3'));
+    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.5'));
     definitionMap.set('ngImport', project_tsconfig_paths.importExpr(project_tsconfig_paths.Identifiers.core));
     definitionMap.set('type', metadata.type);
     definitionMap.set('decorators', metadata.decorators);
@@ -909,7 +909,7 @@ function compileComponentDeclareClassMetadata(metadata, dependencies) {
     callbackReturnDefinitionMap.set('ctorParameters', metadata.ctorParameters ?? project_tsconfig_paths.literal(null));
     callbackReturnDefinitionMap.set('propDecorators', metadata.propDecorators ?? project_tsconfig_paths.literal(null));
     definitionMap.set('minVersion', project_tsconfig_paths.literal(MINIMUM_PARTIAL_LINKER_DEFER_SUPPORT_VERSION));
-    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.3'));
+    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.5'));
     definitionMap.set('ngImport', project_tsconfig_paths.importExpr(project_tsconfig_paths.Identifiers.core));
     definitionMap.set('type', metadata.type);
     definitionMap.set('resolveDeferredDeps', compileComponentMetadataAsyncResolver(dependencies));
@@ -1004,7 +1004,7 @@ function createDirectiveDefinitionMap(meta) {
     const definitionMap = new project_tsconfig_paths.DefinitionMap();
     const minVersion = getMinimumVersionForPartialOutput(meta);
     definitionMap.set('minVersion', project_tsconfig_paths.literal(minVersion));
-    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.3'));
+    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.5'));
     // e.g. `type: MyDirective`
     definitionMap.set('type', meta.type.value);
     if (meta.isStandalone !== undefined) {
@@ -1420,7 +1420,7 @@ const MINIMUM_PARTIAL_LINKER_VERSION$4 = '12.0.0';
 function compileDeclareFactoryFunction(meta) {
     const definitionMap = new project_tsconfig_paths.DefinitionMap();
     definitionMap.set('minVersion', project_tsconfig_paths.literal(MINIMUM_PARTIAL_LINKER_VERSION$4));
-    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.3'));
+    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.5'));
     definitionMap.set('ngImport', project_tsconfig_paths.importExpr(project_tsconfig_paths.Identifiers.core));
     definitionMap.set('type', meta.type.value);
     definitionMap.set('deps', compileDependencies(meta.deps));
@@ -1455,7 +1455,7 @@ function compileDeclareInjectableFromMetadata(meta) {
 function createInjectableDefinitionMap(meta) {
     const definitionMap = new project_tsconfig_paths.DefinitionMap();
     definitionMap.set('minVersion', project_tsconfig_paths.literal(MINIMUM_PARTIAL_LINKER_VERSION$3));
-    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.3'));
+    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.5'));
     definitionMap.set('ngImport', project_tsconfig_paths.importExpr(project_tsconfig_paths.Identifiers.core));
     definitionMap.set('type', meta.type.value);
     // Only generate providedIn property if it has a non-null value
@@ -1506,7 +1506,7 @@ function compileDeclareInjectorFromMetadata(meta) {
 function createInjectorDefinitionMap(meta) {
     const definitionMap = new project_tsconfig_paths.DefinitionMap();
     definitionMap.set('minVersion', project_tsconfig_paths.literal(MINIMUM_PARTIAL_LINKER_VERSION$2));
-    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.3'));
+    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.5'));
     definitionMap.set('ngImport', project_tsconfig_paths.importExpr(project_tsconfig_paths.Identifiers.core));
     definitionMap.set('type', meta.type.value);
     definitionMap.set('providers', meta.providers);
@@ -1539,7 +1539,7 @@ function createNgModuleDefinitionMap(meta) {
         throw new Error('Invalid path! Local compilation mode should not get into the partial compilation path');
     }
     definitionMap.set('minVersion', project_tsconfig_paths.literal(MINIMUM_PARTIAL_LINKER_VERSION$1));
-    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.3'));
+    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.5'));
     definitionMap.set('ngImport', project_tsconfig_paths.importExpr(project_tsconfig_paths.Identifiers.core));
     definitionMap.set('type', meta.type.value);
     // We only generate the keys in the metadata if the arrays contain values.
@@ -1590,7 +1590,7 @@ function compileDeclarePipeFromMetadata(meta) {
 function createPipeDefinitionMap(meta) {
     const definitionMap = new project_tsconfig_paths.DefinitionMap();
     definitionMap.set('minVersion', project_tsconfig_paths.literal(MINIMUM_PARTIAL_LINKER_VERSION));
-    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.3'));
+    definitionMap.set('version', project_tsconfig_paths.literal('21.0.0-next.5'));
     definitionMap.set('ngImport', project_tsconfig_paths.importExpr(project_tsconfig_paths.Identifiers.core));
     // e.g. `type: MyPipe`
     definitionMap.set('type', meta.type.value);
@@ -1741,15 +1741,6 @@ function compileHmrUpdateCallback(definitions, constantStatements, meta) {
     return new project_tsconfig_paths.DeclareFunctionStmt(`${meta.className}_UpdateMetadata`, params, body, null, project_tsconfig_paths.StmtModifier.Final);
 }
 
-/**
- * Base URL for the error details page.
- *
- * Keep the files below in full sync:
- *  - packages/compiler-cli/src/ngtsc/diagnostics/src/error_details_base_url.ts
- *  - packages/core/src/error_details_base_url.ts
- */
-const ERROR_DETAILS_PAGE_BASE_URL = 'https://angular.dev/errors';
-
 // Escape anything that isn't alphanumeric, '/' or '_'.
 const CHARS_TO_ESCAPE = /[^a-zA-Z0-9/_]/g;
 /**
@@ -11534,11 +11525,12 @@ class ComponentDecoratorHandler {
         for (const [_, deps] of resolution.deferPerBlockDependencies) {
             for (const deferBlockDep of deps) {
                 const node = deferBlockDep.declaration.node;
-                const importDecl = resolution.deferrableDeclToImportDecl.get(node) ?? null;
-                if (importDecl !== null && this.deferredSymbolTracker.canDefer(importDecl)) {
+                const importInfo = resolution.deferrableDeclToImportDecl.get(node) ?? null;
+                if (importInfo !== null && this.deferredSymbolTracker.canDefer(importInfo.node)) {
                     deferBlockDep.isDeferrable = true;
-                    deferBlockDep.importPath = importDecl.moduleSpecifier.text;
-                    deferBlockDep.isDefaultImport = isDefaultImport(importDecl);
+                    deferBlockDep.symbolName = importInfo.name;
+                    deferBlockDep.importPath = importInfo.from;
+                    deferBlockDep.isDefaultImport = isDefaultImport(importInfo.node);
                     // The same dependency may be used across multiple deferred blocks. De-duplicate it
                     // because it can throw off other logic further down the compilation pipeline.
                     // Note that the logic above needs to run even if the dependency is seen before,
@@ -11711,9 +11703,10 @@ class ComponentDecoratorHandler {
             // This is not a directive or a pipe.
             return;
         }
-        // Keep track of how this class made it into the current source file
-        // (which ts.ImportDeclaration was used for this symbol).
-        resolutionData.deferrableDeclToImportDecl.set(decl.node, imp.node);
+        // Keep track of how this class made it into the current source file.
+        // Store the full `Import` info so that callers can correctly determine the
+        // exported name (handling aliasing) and the module specifier.
+        resolutionData.deferrableDeclToImportDecl.set(decl.node, imp);
         this.deferredSymbolTracker.markAsDeferrableCandidate(node, imp.node, componentClassDecl, isDeferredImport);
     }
     compileDeferBlocks(resolution) {
@@ -12332,7 +12325,7 @@ class PipeDecoratorHandler {
  * @description
  * Entry point for all public APIs of the compiler-cli package.
  */
-new project_tsconfig_paths.Version('21.0.0-next.3');
+new project_tsconfig_paths.Version('21.0.0-next.5');
 
 /**
  * Whether a given decorator should be treated as an Angular decorator.
@@ -16455,10 +16448,10 @@ class InterpolatedSignalCheck extends TemplateCheckWithVisitor {
         }
         // bound properties like `[prop]="mySignal"`
         else if (node instanceof project_tsconfig_paths.BoundAttribute) {
-            // we skip the check if the node is an input binding
-            const usedDirectives = ctx.templateTypeChecker.getUsedDirectives(component);
-            if (usedDirectives !== null &&
-                usedDirectives.some((dir) => dir.inputs.getByBindingPropertyName(node.name) !== null)) {
+            const symbol = ctx.templateTypeChecker.getSymbolOfNode(node, component);
+            if (symbol?.kind === project_tsconfig_paths.SymbolKind.Input &&
+                symbol.bindings.length > 0 &&
+                symbol.bindings.some((binding) => binding.target.kind === project_tsconfig_paths.SymbolKind.Directive)) {
                 return [];
             }
             // otherwise, we check if the node is
@@ -16788,13 +16781,24 @@ const factory$9 = {
  * otherwise it would produce inaccurate results.
  */
 class OptionalChainNotNullableCheck extends TemplateCheckWithVisitor {
+    noUncheckedIndexedAccess;
     canVisitStructuralAttributes = false;
     code = project_tsconfig_paths.ErrorCode.OPTIONAL_CHAIN_NOT_NULLABLE;
+    constructor(noUncheckedIndexedAccess) {
+        super();
+        this.noUncheckedIndexedAccess = noUncheckedIndexedAccess;
+    }
     visitNode(ctx, component, node) {
         if (!(node instanceof project_tsconfig_paths.SafeCall) &&
             !(node instanceof project_tsconfig_paths.SafePropertyRead) &&
-            !(node instanceof project_tsconfig_paths.SafeKeyedRead))
+            !(node instanceof project_tsconfig_paths.SafeKeyedRead)) {
+            return [];
+        }
+        // When `noUncheckedIndexedAccess` is disabled, an indexed access is not checked
+        // and may result in `undefined`.
+        if (node.receiver instanceof project_tsconfig_paths.KeyedRead && !this.noUncheckedIndexedAccess) {
             return [];
+        }
         const symbolLeft = ctx.templateTypeChecker.getSymbolOfNode(node.receiver, component);
         if (symbolLeft === null || symbolLeft.kind !== project_tsconfig_paths.SymbolKind.Expression) {
             return [];
@@ -16834,7 +16838,8 @@ const factory$8 = {
         if (!strictNullChecks) {
             return null;
         }
-        return new OptionalChainNotNullableCheck();
+        const noUncheckedIndexedAccess = !!options.noUncheckedIndexedAccess;
+        return new OptionalChainNotNullableCheck(noUncheckedIndexedAccess);
     },
 };
 
@@ -17369,7 +17374,7 @@ function unwrapAstWithSource(ast) {
  * found in the LICENSE file at https://angular.dev/license
  */
 /** APIs whose usages should be checked by the rule. */
-const APIS_TO_CHECK = [
+const APIS_TO_CHECK$1 = [
     project_tsconfig_paths.INPUT_INITIALIZER_FN,
     project_tsconfig_paths.MODEL_INITIALIZER_FN,
     ...project_tsconfig_paths.OUTPUT_INITIALIZER_FNS,
@@ -17387,7 +17392,7 @@ class InitializerApiUsageRule {
     }
     shouldCheck(sourceFile) {
         // Skip the traversal if there are no imports of the initializer APIs.
-        return APIS_TO_CHECK.some(({ functionName, owningModule }) => {
+        return APIS_TO_CHECK$1.some(({ functionName, owningModule }) => {
             return (this.importedSymbolsTracker.hasNamedImport(sourceFile, functionName, owningModule) ||
                 this.importedSymbolsTracker.hasNamespaceImport(sourceFile, owningModule));
         });
@@ -17405,7 +17410,7 @@ class InitializerApiUsageRule {
         if (!node.parent || !ts.isCallExpression(node)) {
             return null;
         }
-        const identifiedInitializer = project_tsconfig_paths.tryParseInitializerApi(APIS_TO_CHECK, node, this.reflector, this.importedSymbolsTracker);
+        const identifiedInitializer = project_tsconfig_paths.tryParseInitializerApi(APIS_TO_CHECK$1, node, this.reflector, this.importedSymbolsTracker);
         if (identifiedInitializer === null) {
             return null;
         }
@@ -17567,6 +17572,86 @@ function closestNode(start, predicate) {
     return null;
 }
 
+/*!
+ * @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
+ */
+/** APIs whose usages should be checked by the rule. */
+const APIS_TO_CHECK = [
+    project_tsconfig_paths.INPUT_INITIALIZER_FN,
+    project_tsconfig_paths.MODEL_INITIALIZER_FN,
+    ...project_tsconfig_paths.QUERY_INITIALIZER_FNS,
+];
+/**
+ * Rule that flags forbidden invocations of required initializers in property initializers and constructors.
+ */
+class ForbiddenRequiredInitializersInvocationRule {
+    reflector;
+    importedSymbolsTracker;
+    constructor(reflector, importedSymbolsTracker) {
+        this.reflector = reflector;
+        this.importedSymbolsTracker = importedSymbolsTracker;
+    }
+    shouldCheck(sourceFile) {
+        // Skip the traversal if there are no imports of the initializer APIs.
+        return APIS_TO_CHECK.some(({ functionName, owningModule }) => {
+            return (this.importedSymbolsTracker.hasNamedImport(sourceFile, functionName, owningModule) ||
+                this.importedSymbolsTracker.hasNamespaceImport(sourceFile, owningModule));
+        });
+    }
+    checkNode(node) {
+        if (!ts.isClassDeclaration(node))
+            return null;
+        const requiredInitializerDeclarations = node.members.filter((m) => ts.isPropertyDeclaration(m) && this.isPropDeclarationARequiredInitializer(m));
+        const diagnostics = [];
+        // Handling of the usages in props initializations
+        for (let decl of node.members) {
+            if (!ts.isPropertyDeclaration(decl))
+                continue;
+            const initiallizerExpr = decl.initializer;
+            if (!initiallizerExpr)
+                continue;
+            checkForbiddenInvocation(initiallizerExpr);
+        }
+        function checkForbiddenInvocation(node) {
+            if (ts.isArrowFunction(node) || ts.isFunctionExpression(node))
+                return;
+            if (ts.isPropertyAccessExpression(node) &&
+                node.expression.kind === ts.SyntaxKind.ThisKeyword &&
+                // With the following we make sure we only flag invoked required initializers
+                ts.isCallExpression(node.parent) &&
+                node.parent.expression === node) {
+                const requiredProp = requiredInitializerDeclarations.find((prop) => prop.name.getText() === node.name.getText());
+                if (requiredProp) {
+                    const initializerFn = requiredProp.initializer.expression.expression.getText();
+                    diagnostics.push(project_tsconfig_paths.makeDiagnostic(project_tsconfig_paths.ErrorCode.FORBIDDEN_REQUIRED_INITIALIZER_INVOCATION, node, `\`${node.name.getText()}\` is a required \`${initializerFn}\` and does not have a value in this context.`));
+                }
+            }
+            return node.forEachChild(checkForbiddenInvocation);
+        }
+        const ctor = getConstructorFromClass(node);
+        if (ctor) {
+            checkForbiddenInvocation(ctor);
+        }
+        return diagnostics;
+    }
+    isPropDeclarationARequiredInitializer(node) {
+        if (!node.initializer)
+            return false;
+        const identifiedInitializer = project_tsconfig_paths.tryParseInitializerApi(APIS_TO_CHECK, node.initializer, this.reflector, this.importedSymbolsTracker);
+        if (identifiedInitializer === null || !identifiedInitializer.isRequired)
+            return false;
+        return true;
+    }
+}
+function getConstructorFromClass(node) {
+    // We also check for a constructor body to avoid picking up parent constructors.
+    return node.members.find((m) => ts.isConstructorDeclaration(m) && m.body !== undefined);
+}
+
 /*!
  * @license
  * Copyright Google LLC All Rights Reserved.
@@ -17582,6 +17667,7 @@ class SourceFileValidator {
     constructor(reflector, importedSymbolsTracker, templateTypeChecker, typeCheckingConfig) {
         this.rules = [new InitializerApiUsageRule(reflector, importedSymbolsTracker)];
         this.rules.push(new UnusedStandaloneImportsRule(templateTypeChecker, typeCheckingConfig, importedSymbolsTracker));
+        this.rules.push(new ForbiddenRequiredInitializersInvocationRule(reflector, importedSymbolsTracker));
     }
     /**
      * Gets the diagnostics for a specific file, or null if the file is valid.
@@ -20343,7 +20429,7 @@ var semver = /*@__PURE__*/getDefaultExportFromCjs(semverExports);
  * @param minVersion Minimum required version for the feature.
  */
 function coreVersionSupportsFeature(coreVersion, minVersion) {
-    // A version of `21.0.0-next.3` usually means that core is at head so it supports
+    // A version of `21.0.0-next.5` usually means that core is at head so it supports
     // all features. Use string interpolation prevent the placeholder from being replaced
     // with the current version during build time.
     if (coreVersion === `0.0.0-${'PLACEHOLDER'}`) {
@@ -20501,9 +20587,12 @@ class NgCompiler {
         this.usePoisonedData = usePoisonedData || !!options._compilePoisonedComponents;
         this.enableTemplateTypeChecker =
             enableTemplateTypeChecker || !!options._enableTemplateTypeChecker;
-        // TODO(crisbeto): remove this flag and base `enableBlockSyntax` on the `angularCoreVersion`.
-        this.enableBlockSyntax = options['_enableBlockSyntax'] ?? true;
-        this.enableLetSyntax = options['_enableLetSyntax'] ?? true;
+        this.enableBlockSyntax =
+            this.angularCoreVersion === null ||
+                coreVersionSupportsFeature(this.angularCoreVersion, '>= 17.0.0');
+        this.enableLetSyntax =
+            this.angularCoreVersion === null ||
+                coreVersionSupportsFeature(this.angularCoreVersion, '>= 18.1.0');
         this.enableSelectorless = options['_enableSelectorless'] ?? false;
         this.emitDeclarationOnly =
             !!options.emitDeclarationOnly && !!options._experimentalAllowEmitDeclarationOnly;
@@ -20669,7 +20758,7 @@ class NgCompiler {
                 return {
                     ...diag,
                     messageText: diag.messageText +
-                        `. Find more at ${ERROR_DETAILS_PAGE_BASE_URL}/NG${project_tsconfig_paths.ngErrorCode(diag.code)}`,
+                        `. Find more at ${project_tsconfig_paths.ERROR_DETAILS_PAGE_BASE_URL}/NG${project_tsconfig_paths.ngErrorCode(diag.code)}`,
                 };
             }
             return diag;

package/schematics/bundles/inject-migration.cjs

@@ -1,6 +1,6 @@
 'use strict';
 /**
- * @license Angular v21.0.0-next.3
+ * @license Angular v21.0.0-next.5
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -8,13 +8,13 @@
 
 var schematics = require('@angular-devkit/schematics');
 var p = require('path');
-var compiler_host = require('./compiler_host-Df7s6Riz.cjs');
+var compiler_host = require('./compiler_host-Aouk-n4F.cjs');
 var ts = require('typescript');
-var ng_decorators = require('./ng_decorators-CtYwz9Lw.cjs');
-var imports = require('./imports-26VeX8i-.cjs');
+var ng_decorators = require('./ng_decorators-BI0uV7KI.cjs');
+var imports = require('./imports-DwPXlGFl.cjs');
 var nodes = require('./nodes-B16H9JUd.cjs');
 var leading_space = require('./leading_space-D9nQ8UQC.cjs');
-var project_tsconfig_paths = require('./project_tsconfig_paths-bRwOJEk9.cjs');
+var project_tsconfig_paths = require('./project_tsconfig_paths-DX9KHLn9.cjs');
 require('os');
 require('fs');
 require('module');

package/schematics/bundles/leading_space-D9nQ8UQC.cjs

@@ -1,6 +1,6 @@
 'use strict';
 /**
- * @license Angular v21.0.0-next.3
+ * @license Angular v21.0.0-next.5
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */

package/schematics/bundles/{migrate_ts_type_references-C_gTvDtH.cjs → migrate_ts_type_references-By2ZtKls.cjs}

@@ -1,19 +1,19 @@
 'use strict';
 /**
- * @license Angular v21.0.0-next.3
+ * @license Angular v21.0.0-next.5
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
 'use strict';
 
-var project_tsconfig_paths = require('./project_tsconfig_paths-bRwOJEk9.cjs');
+var project_tsconfig_paths = require('./project_tsconfig_paths-DX9KHLn9.cjs');
 var ts = require('typescript');
 require('os');
 var assert = require('assert');
-var index = require('./index-Clvp4COX.cjs');
-var project_paths = require('./project_paths-BJTqcWvC.cjs');
+var index = require('./index-BZQb51Qf.cjs');
+var project_paths = require('./project_paths-Dr2s3Pq3.cjs');
 var leading_space = require('./leading_space-D9nQ8UQC.cjs');
-require('./index-CBaykQBv.cjs');
+require('./index-Bb6iejCd.cjs');
 require('path');
 require('node:path');