@angular/core 21.0.0 → 21.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "21.0.0",
+  "version": "21.0.2",
   "description": "Angular - the core framework",
   "author": "angular",
   "license": "MIT",
@@ -46,9 +46,9 @@
     "tslib": "^2.3.0"
   },
   "peerDependencies": {
-    "@angular/compiler": "21.0.0",
+    "@angular/compiler": "21.0.2",
     "rxjs": "^6.5.3 || ^7.4.0",
-    "zone.js": "~0.15.0"
+    "zone.js": "~0.15.0 || ~0.16.0"
   },
   "peerDependenciesMeta": {
     "@angular/compiler": {

package/resources/best-practices.md

@@ -47,7 +47,6 @@ You are an expert in TypeScript, Angular, and scalable web application developme
 - Use the async pipe to handle observables
 - Do not assume globals like (`new Date()`) are available.
 - Do not write arrow functions in templates (they are not supported).
-- Do not write Regular expressions in templates (they are not supported).
 
 ## Services
 

package/schematics/bundles/add-bootstrap-context-to-server-main.cjs

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

package/schematics/bundles/application-config-core.cjs

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

package/schematics/bundles/apply_import_manager-1Zs_gpB6.cjs

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

package/schematics/bundles/bootstrap-options-migration.cjs

@@ -1,6 +1,6 @@
 'use strict';
 /**
- * @license Angular v21.0.0
+ * @license Angular v21.0.2
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -118,13 +118,11 @@ class BootstrapOptionsMigration extends project_paths.TsurgeFunnelMigration {
                 optionLiteral = optionsNode;
                 addProvidersToBootstrapOption(optionProjectFile, optionLiteral, providerFn, replacements);
             }
+            else if (this.isServerConfigZoneless(optionsNode, typeChecker)) {
+                // Nothing to migrate for the SSR bootstrap
+                return;
+            }
             else if (ts.isIdentifier(optionsNode)) {
-                // This case handled both `bootstrapApplication(App, appConfig)` and the server () => bootstrapApplication(App, appConfig)
-                // where appConfig is the result of a `mergeApplicationConfig` call.
-                // This is tricky case to handle, in G3 we're might not be able to resolve the identifier's value
-                // Our best alternative is to assume there is not CD providers set and add the ZoneChangeDetection provider
-                // In the cases where it is, we'll just override the zone provider we just set by re-used inthe appConfig providers
-                // TODO: Should we insert a TODO to clean this up ?
                 const text = `{...${optionsNode.getText()}, providers: [${providerFn}, ...${optionsNode.getText()}.providers]}`;
                 replacements.push(new project_paths.Replacement(currentProjectFile, new project_paths.TextUpdate({
                     position: optionsNode.getStart(),
@@ -148,6 +146,53 @@ class BootstrapOptionsMigration extends project_paths.TsurgeFunnelMigration {
             requestedFile: sourceFile,
         });
     }
+    /**
+     * The optionsNode can be a appConfig built with mergeApplicationConfig
+     * In this case we need to analyze if the base config uses provideZonelessChangeDetection
+     */
+    isServerConfigZoneless(optionsNode, typeChecker) {
+        // Check if optionsNode is a result of mergeApplicationConfig
+        let symbol = typeChecker.getSymbolAtLocation(optionsNode);
+        if (symbol && (symbol.flags & ts.SymbolFlags.Alias) !== 0) {
+            symbol = typeChecker.getAliasedSymbol(symbol);
+        }
+        const optionDeclaration = symbol?.getDeclarations()?.[0];
+        if (!optionDeclaration) {
+            return false;
+        }
+        if (!ts.isVariableDeclaration(optionDeclaration) ||
+            !optionDeclaration.initializer ||
+            !ts.isCallExpression(optionDeclaration.initializer) ||
+            !ts.isIdentifier(optionDeclaration.initializer.expression) ||
+            optionDeclaration.initializer.expression.text !== 'mergeApplicationConfig') {
+            // We didn't find a mergeApplicationConfig call, this isn't a server config
+            return false;
+        }
+        let maybeAppConfig = optionDeclaration.initializer.arguments[0];
+        if (ts.isIdentifier(maybeAppConfig)) {
+            const resolved = getObjectLiteralFromIdentifier(maybeAppConfig, typeChecker);
+            if (resolved) {
+                maybeAppConfig = resolved;
+            }
+        }
+        if (maybeAppConfig && ts.isObjectLiteralExpression(maybeAppConfig)) {
+            for (const prop of maybeAppConfig.properties) {
+                if (ts.isPropertyAssignment(prop) &&
+                    ts.isIdentifier(prop.name) &&
+                    prop.name.text === 'providers' &&
+                    ts.isArrayLiteralExpression(prop.initializer)) {
+                    for (const el of prop.initializer.elements) {
+                        if (ts.isCallExpression(el) &&
+                            ts.isIdentifier(el.expression) &&
+                            el.expression.text === 'provideZonelessChangeDetection') {
+                            return true;
+                        }
+                    }
+                }
+            }
+        }
+        return false;
+    }
     analyzeCreateApplication(node, sourceFile, info, typeChecker, importManager, replacements) {
         const hasExistingChangeDetectionProvider = hasChangeDetectionProvider(node, typeChecker);
         if (hasExistingChangeDetectionProvider)
@@ -533,6 +578,7 @@ function getSpecifiers(sourceFile) {
     if (!createApplicationSpecifier &&
         !bootstrapAppSpecifier &&
         !platformBrowserSpecifier &&
+        !platformBrowserDynamicSpecifier &&
         !testBedSpecifier &&
         !ngModuleSpecifier &&
         !getTestBedSpecifier) {

package/schematics/bundles/cleanup-unused-imports.cjs

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

package/schematics/bundles/common-to-standalone-migration.cjs

@@ -1,6 +1,6 @@
 'use strict';
 /**
- * @license Angular v21.0.0
+ * @license Angular v21.0.2
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -39,8 +39,10 @@ const PATTERN_IMPORTS = [
     { pattern: /\[ngStyle\]/g, imports: ['NgStyle'] },
     // Match ngSwitch as property binding [ngSwitch] or attribute ngSwitch="value"
     { pattern: /(\[ngSwitch\]|\s+ngSwitch\s*=)/g, imports: ['NgSwitch'] },
-    { pattern: /\[ngTemplateOutlet\]/g, imports: ['NgTemplateOutlet'] },
-    { pattern: /\[ngComponentOutlet\]/g, imports: ['NgComponentOutlet'] },
+    // Match ngTemplateOutlet as structural (*ngTemplateOutlet) or property binding [ngTemplateOutlet]
+    { pattern: /(\*ngTemplateOutlet\b|\[ngTemplateOutlet\])/g, imports: ['NgTemplateOutlet'] },
+    // Match ngComponentOutlet as structural (*ngComponentOutlet) or property binding [ngComponentOutlet]
+    { pattern: /(\*ngComponentOutlet\b|\[ngComponentOutlet\])/g, imports: ['NgComponentOutlet'] },
     // Common pipes
     { pattern: /\|\s*async\b/g, imports: ['AsyncPipe'] },
     { pattern: /\|\s*json\b/g, imports: ['JsonPipe'] },

package/schematics/bundles/compiler_host-DBwYMlTo.cjs

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

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

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

package/schematics/bundles/imports-DP72APSx.cjs

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

package/schematics/bundles/index-B7I9sIUx.cjs

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

package/schematics/bundles/inject-migration.cjs

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

package/schematics/bundles/leading_space-D9nQ8UQC.cjs

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

package/schematics/bundles/migrate_ts_type_references-UGIUl7En.cjs

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

package/schematics/bundles/ng_component_template-Dsuq1Lw7.cjs

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

package/schematics/bundles/ng_decorators-DSFlWYQY.cjs

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

package/schematics/bundles/ngclass-to-class-migration.cjs

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

package/schematics/bundles/ngstyle-to-style-migration.cjs

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

package/schematics/bundles/nodes-B16H9JUd.cjs

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

package/schematics/bundles/output-migration.cjs

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

package/schematics/bundles/parse_html-8VLCL37B.cjs

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

package/schematics/bundles/project_paths-DvD50ouC.cjs

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

package/schematics/bundles/project_tsconfig_paths-CDVxT6Ov.cjs

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

package/schematics/bundles/property_name-BBwFuqMe.cjs

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

package/schematics/bundles/route-lazy-loading.cjs

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

package/schematics/bundles/router-current-navigation.cjs

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

package/schematics/bundles/router-last-successful-navigation.cjs

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

package/schematics/bundles/router-testing-module-migration.cjs

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

package/schematics/bundles/self-closing-tags-migration.cjs

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

package/schematics/bundles/signal-input-migration.cjs

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

package/schematics/bundles/signal-queries-migration.cjs

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

package/schematics/bundles/signals.cjs

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

package/schematics/bundles/standalone-migration.cjs

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

package/schematics/bundles/symbol-BObKoqes.cjs

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

package/types/_api-chunk.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0
+ * @license Angular v21.0.2
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -278,7 +278,12 @@ interface StreamingResourceOptions<T, R> extends BaseResourceOptions<T, R> {
 /**
  * @experimental
  */
-type ResourceOptions<T, R> = PromiseResourceOptions<T, R> | StreamingResourceOptions<T, R>;
+type ResourceOptions<T, R> = (PromiseResourceOptions<T, R> | StreamingResourceOptions<T, R>) & {
+    /**
+     * A debug name for the reactive node. Used in Angular DevTools to identify the node.
+     */
+    debugName?: string;
+};
 /**
  * @experimental
  */

package/types/_chrome_dev_tools_performance-chunk.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0
+ * @license Angular v21.0.2
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -66,6 +66,8 @@ declare function signal<T>(initialValue: T, options?: CreateSignalOptions<T>): W
  *
  * Ordinary values can be turned into `Signal`s with the `signal` function.
  *
+ * @see [What are signals?](guide/signals#what-are-signals)
+ *
  * @publicApi 17.0
  */
 type Signal<T> = (() => T) & {
@@ -74,18 +76,24 @@ type Signal<T> = (() => T) & {
 /**
  * Checks if the given `value` is a reactive `Signal`.
  *
+ * @see [Type checking signals](guide/signals#type-checking-signals)
+ *
  * @publicApi 17.0
  */
 declare function isSignal(value: unknown): value is Signal<unknown>;
 /**
  * A comparison function which can determine if two values are equal.
  *
+ * @see [Signal equality functions](guide/signals#signal-equality-functions)
+ *
  * @publicApi 17.0
  */
 type ValueEqualityFn<T> = (a: T, b: T) => boolean;
 /**
  * Checks if the given `value` is a writeable signal.
  *
+ * @see [Type checking signals](guide/signals#type-checking-signals)
+ *
  * @publicApi 21.1
  */
 declare function isWritableSignal(value: unknown): value is WritableSignal<unknown>;

package/types/_discovery-chunk.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0
+ * @license Angular v21.0.2
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */
@@ -1165,49 +1165,42 @@ declare const enum TNodeFlags {
      */
     isInControlFlow = 512,
     /**
-     * Bit #11 - This bit is set if the node represents a form control.
-     *
-     * True when the node has an input binding to a `ɵControl` directive (but not also to a custom
-     * component).
-     */
-    isFormControl = 1024,
-    /**
-     * Bit #12 - This bit is set if the node hosts a custom control component.
+     * Bit #11 - This bit is set if the node hosts a custom control component.
      *
      * A custom control component's model property is named `value`.
      */
-    isFormValueControl = 2048,
+    isFormValueControl = 1024,
     /**
-     * Bit #13 - This bit is set if the node hosts a custom checkbox component.
+     * Bit #12 - This bit is set if the node hosts a custom checkbox component.
      *
      * A custom checkbox component's model property is named `checked`.
      */
-    isFormCheckboxControl = 4096,
+    isFormCheckboxControl = 2048,
     /**
-     * Bit #14 - This bit is set if the node hosts an interoperable control implementation.
+     * Bit #13 - This bit is set if the node hosts an interoperable control implementation.
      *
      * This is used to bind to a `ControlValueAccessor` from `@angular/forms`.
      */
-    isInteropControl = 8192,
+    isInteropControl = 4096,
     /**
-     * Bit #15 - This bit is set if the node is a native control.
+     * Bit #14 - This bit is set if the node is a native control.
      *
      * This is used to determine whether we can bind common control properties to the host element of
      * a custom control when it doesn't define a corresponding input.
      */
-    isNativeControl = 16384,
+    isNativeControl = 8192,
     /**
-     * Bit #16 - This bit is set if the node is a native control with a numeric type.
+     * Bit #15 - This bit is set if the node is a native control with a numeric type.
      *
      * This is used to determine whether the control supports the `min` and `max` properties.
      */
-    isNativeNumericControl = 32768,
+    isNativeNumericControl = 16384,
     /**
-     * Bit #17 - This bit is set if the node is a native text control.
+     * Bit #16 - This bit is set if the node is a native text control.
      *
      * This is used to determine whether control supports the `minLength` and `maxLength` properties.
      */
-    isNativeTextControl = 65536
+    isNativeTextControl = 32768
 }
 /**
  * Corresponds to the TNode.providerIndexes property.
@@ -1354,6 +1347,16 @@ interface TNode {
      * `directiveStart + componentOffset`.
      */
     componentOffset: number;
+    /**
+     * Index at which the signal forms field directive is stored.
+     * Value is set to -1 if there are no field directives.
+     */
+    fieldIndex: number;
+    /**
+     * Index at which the custom control directive is stored.
+     * Value is set to -1 if there is no custom control directive.
+     */
+    customControlIndex: number;
     /**
      * Stores the last directive which had a styling instruction.
      *
@@ -2987,6 +2990,8 @@ declare enum SecurityContext {
 /**
  * Sanitizer is used by the views to sanitize potentially dangerous values.
  *
+ * @see [Sanitization and security contexts](best-practices/security#sanitization-and-security-contexts)
+ *
  * @publicApi
  */
 declare abstract class Sanitizer {
@@ -3236,7 +3241,7 @@ interface EffectNode extends BaseEffectNode, SchedulableEffect {
     cleanupFns: EffectCleanupFn[] | undefined;
     injector: Injector;
     notifier: ChangeDetectionScheduler;
-    onDestroyFn: () => void;
+    onDestroyFns: (() => void)[] | null;
 }
 interface ViewEffectNode extends EffectNode {
     view: LView;
@@ -6067,6 +6072,8 @@ declare abstract class EmbeddedViewRef<C> extends ViewRef {
  * Provides access to the component instance and related objects,
  * and provides the means of destroying the instance.
  *
+ * @see [Programmatically rendering components](guide/components/programmatic-rendering)
+ *
  * @publicApi
  */
 declare abstract class ComponentRef<C> {

package/types/_effect-chunk.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0
+ * @license Angular v21.0.2
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */

package/types/_event_dispatcher-chunk.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0
+ * @license Angular v21.0.2
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */

package/types/_formatter-chunk.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0
+ * @license Angular v21.0.2
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */

package/types/_weak_ref-chunk.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v21.0.0
+ * @license Angular v21.0.2
  * (c) 2010-2025 Google LLC. https://angular.dev/
  * License: MIT
  */