@angular/core 21.0.0-next.1 → 21.0.0-next.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/core",
-  "version": "21.0.0-next.1",
+  "version": "21.0.0-next.10",
   "description": "Angular - the core framework",
   "author": "angular",
   "license": "MIT",
@@ -18,27 +18,27 @@
       "default": "./package.json"
     },
     ".": {
-      "types": "./index.d.ts",
+      "types": "./types/core.d.ts",
       "default": "./fesm2022/core.mjs"
     },
     "./primitives/di": {
-      "types": "./primitives/di/index.d.ts",
-      "default": "./fesm2022/primitives/di.mjs"
+      "types": "./types/primitives-di.d.ts",
+      "default": "./fesm2022/primitives-di.mjs"
     },
     "./primitives/event-dispatch": {
-      "types": "./primitives/event-dispatch/index.d.ts",
-      "default": "./fesm2022/primitives/event-dispatch.mjs"
+      "types": "./types/primitives-event-dispatch.d.ts",
+      "default": "./fesm2022/primitives-event-dispatch.mjs"
     },
     "./primitives/signals": {
-      "types": "./primitives/signals/index.d.ts",
-      "default": "./fesm2022/primitives/signals.mjs"
+      "types": "./types/primitives-signals.d.ts",
+      "default": "./fesm2022/primitives-signals.mjs"
     },
     "./rxjs-interop": {
-      "types": "./rxjs-interop/index.d.ts",
+      "types": "./types/rxjs-interop.d.ts",
       "default": "./fesm2022/rxjs-interop.mjs"
     },
     "./testing": {
-      "types": "./testing/index.d.ts",
+      "types": "./types/testing.d.ts",
       "default": "./fesm2022/testing.mjs"
     }
   },
@@ -46,7 +46,7 @@
     "tslib": "^2.3.0"
   },
   "peerDependencies": {
-    "@angular/compiler": "21.0.0-next.1",
+    "@angular/compiler": "21.0.0-next.10",
     "rxjs": "^6.5.3 || ^7.4.0",
     "zone.js": "~0.15.0"
   },
@@ -84,9 +84,15 @@
       "@angular/service-worker"
     ]
   },
+  "angular": {
+    "bestPractices": {
+      "format": "markdown",
+      "path": "./resources/best-practices.md"
+    }
+  },
   "schematics": "./schematics/collection.json",
   "sideEffects": false,
   "module": "./fesm2022/core.mjs",
-  "typings": "./index.d.ts",
+  "typings": "./types/core.d.ts",
   "type": "module"
 }

package/resources/best-practices.md

@@ -0,0 +1,56 @@
+You are an expert in TypeScript, Angular, and scalable web application development. You write functional, maintainable, performant, and accessible code following Angular and TypeScript best practices.
+
+## TypeScript Best Practices
+
+- Use strict type checking
+- Prefer type inference when the type is obvious
+- Avoid the `any` type; use `unknown` when type is uncertain
+
+## Angular Best Practices
+
+- Always use standalone components over NgModules
+- Must NOT set `standalone: true` inside Angular decorators. It's the default in Angular v20+.
+- Use signals for state management
+- Implement lazy loading for feature routes
+- Do NOT use the `@HostBinding` and `@HostListener` decorators. Put host bindings inside the `host` object of the `@Component` or `@Directive` decorator instead
+- Use `NgOptimizedImage` for all static images.
+  - `NgOptimizedImage` does not work for inline base64 images.
+
+## Accessibility Requirements
+
+- It MUST pass all AXE checks.
+- It MUST follow all WCAG AA minimums, including focus management, color contrast, and ARIA attributes.
+
+### Components
+
+- Keep components small and focused on a single responsibility
+- Use `input()` and `output()` functions instead of decorators
+- Use `computed()` for derived state
+- Set `changeDetection: ChangeDetectionStrategy.OnPush` in `@Component` decorator
+- Prefer inline templates for small components
+- Prefer Reactive forms instead of Template-driven ones
+- Do NOT use `ngClass`, use `class` bindings instead
+- Do NOT use `ngStyle`, use `style` bindings instead
+- When using external templates/styles, use paths relative to the component TS file.
+
+## State Management
+
+- Use signals for local component state
+- Use `computed()` for derived state
+- Keep state transformations pure and predictable
+- Do NOT use `mutate` on signals, use `update` or `set` instead
+
+## Templates
+
+- Keep templates simple and avoid complex logic
+- Use native control flow (`@if`, `@for`, `@switch`) instead of `*ngIf`, `*ngFor`, `*ngSwitch`
+- 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
+
+- Design services around a single responsibility
+- Use the `providedIn: 'root'` option for singleton services
+- Use the `inject()` function instead of constructor injection

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

@@ -0,0 +1,117 @@
+'use strict';
+/**
+ * @license Angular v21.0.0-next.10
+ * (c) 2010-2025 Google LLC. https://angular.io/
+ * License: MIT
+ */
+'use strict';
+
+require('@angular-devkit/core');
+require('node:path/posix');
+var project_paths = require('./project_paths-DvD50ouC.cjs');
+var migrations = require('@angular/compiler-cli/private/migrations');
+var ts = require('typescript');
+var apply_import_manager = require('./apply_import_manager-1Zs_gpB6.cjs');
+require('@angular/compiler-cli');
+require('node:path');
+require('@angular-devkit/schematics');
+require('./project_tsconfig_paths-CDVxT6Ov.cjs');
+
+function findArrowFunction(node) {
+    let current = node;
+    while (current) {
+        if (ts.isArrowFunction(current)) {
+            return current;
+        }
+        current = current.parent;
+    }
+    return undefined;
+}
+class AddBootstrapContextToServerMainMigration extends project_paths.TsurgeFunnelMigration {
+    async analyze(info) {
+        const replacements = [];
+        let importManager = null;
+        for (const sourceFile of info.sourceFiles) {
+            if (!sourceFile.fileName.endsWith('main.server.ts')) {
+                continue;
+            }
+            const bootstrapAppCalls = [];
+            ts.forEachChild(sourceFile, function findCalls(node) {
+                if (ts.isCallExpression(node) &&
+                    ts.isIdentifier(node.expression) &&
+                    node.expression.text === 'bootstrapApplication' &&
+                    node.arguments.length < 3) {
+                    bootstrapAppCalls.push(node);
+                }
+                ts.forEachChild(node, findCalls);
+            });
+            if (bootstrapAppCalls.length === 0) {
+                continue;
+            }
+            for (const node of bootstrapAppCalls) {
+                const end = node.arguments[node.arguments.length - 1].getEnd();
+                replacements.push(new project_paths.Replacement(project_paths.projectFile(sourceFile, info), new project_paths.TextUpdate({
+                    position: end,
+                    end: end,
+                    toInsert: ', context',
+                })));
+                const arrowFunction = findArrowFunction(node);
+                if (arrowFunction && arrowFunction.parameters.length === 0) {
+                    replacements.push(new project_paths.Replacement(project_paths.projectFile(sourceFile, info), new project_paths.TextUpdate({
+                        position: arrowFunction.parameters.end,
+                        end: arrowFunction.parameters.end,
+                        toInsert: 'context: BootstrapContext',
+                    })));
+                }
+            }
+            importManager ??= new migrations.ImportManager({
+                generateUniqueIdentifier: () => null,
+                shouldUseSingleQuotes: () => true,
+            });
+            importManager.addImport({
+                exportSymbolName: 'BootstrapContext',
+                exportModuleSpecifier: '@angular/platform-browser',
+                requestedFile: sourceFile,
+            });
+        }
+        if (importManager !== null) {
+            apply_import_manager.applyImportManagerChanges(importManager, replacements, info.sourceFiles, info);
+        }
+        return project_paths.confirmAsSerializable({ replacements });
+    }
+    async migrate(globalData) {
+        return project_paths.confirmAsSerializable(globalData);
+    }
+    async combine(unitA, unitB) {
+        const seen = new Set();
+        const combined = [];
+        [unitA.replacements, unitB.replacements].forEach((replacements) => {
+            replacements.forEach((current) => {
+                const { position, end, toInsert } = current.update.data;
+                const key = current.projectFile.id + '/' + position + '/' + end + '/' + toInsert;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    combined.push(current);
+                }
+            });
+        });
+        return project_paths.confirmAsSerializable({ replacements: combined });
+    }
+    async globalMeta(combinedData) {
+        return project_paths.confirmAsSerializable(combinedData);
+    }
+    async stats() {
+        return project_paths.confirmAsSerializable({});
+    }
+}
+
+function migrate() {
+    return async (tree) => {
+        await project_paths.runMigrationInDevkit({
+            tree,
+            getMigration: () => new AddBootstrapContextToServerMainMigration(),
+        });
+    };
+}
+
+exports.migrate = migrate;

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

@@ -0,0 +1,84 @@
+'use strict';
+/**
+ * @license Angular v21.0.0-next.10
+ * (c) 2010-2025 Google LLC. https://angular.io/
+ * License: MIT
+ */
+'use strict';
+
+var migrations = require('@angular/compiler-cli/private/migrations');
+var apply_import_manager = require('./apply_import_manager-1Zs_gpB6.cjs');
+require('@angular/compiler-cli');
+require('typescript');
+require('node:path');
+var project_paths = require('./project_paths-DvD50ouC.cjs');
+var imports = require('./imports-DP72APSx.cjs');
+require('@angular-devkit/core');
+require('node:path/posix');
+require('@angular-devkit/schematics');
+require('./project_tsconfig_paths-CDVxT6Ov.cjs');
+
+/** Migration that moves the import of `ApplicationConfig` from `platform-browser` to `core`. */
+class ApplicationConfigCoreMigration extends project_paths.TsurgeFunnelMigration {
+    async analyze(info) {
+        const replacements = [];
+        let importManager = null;
+        for (const sourceFile of info.sourceFiles) {
+            const specifier = imports.getImportSpecifier(sourceFile, '@angular/platform-browser', 'ApplicationConfig');
+            if (!specifier) {
+                continue;
+            }
+            importManager ??= new migrations.ImportManager({
+                // Prevent the manager from trying to generate a non-conflicting import.
+                generateUniqueIdentifier: () => null,
+                shouldUseSingleQuotes: () => true,
+            });
+            importManager.removeImport(sourceFile, 'ApplicationConfig', '@angular/platform-browser');
+            importManager.addImport({
+                exportSymbolName: 'ApplicationConfig',
+                exportModuleSpecifier: '@angular/core',
+                requestedFile: sourceFile,
+                unsafeAliasOverride: specifier.propertyName ? specifier.name.text : undefined,
+            });
+        }
+        if (importManager !== null) {
+            apply_import_manager.applyImportManagerChanges(importManager, replacements, info.sourceFiles, info);
+        }
+        return project_paths.confirmAsSerializable({ replacements });
+    }
+    async migrate(globalData) {
+        return project_paths.confirmAsSerializable(globalData);
+    }
+    async combine(unitA, unitB) {
+        const seen = new Set();
+        const combined = [];
+        [unitA.replacements, unitB.replacements].forEach((replacements) => {
+            replacements.forEach((current) => {
+                const { position, end, toInsert } = current.update.data;
+                const key = current.projectFile.id + '/' + position + '/' + end + '/' + toInsert;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    combined.push(current);
+                }
+            });
+        });
+        return project_paths.confirmAsSerializable({ replacements: combined });
+    }
+    async globalMeta(combinedData) {
+        return project_paths.confirmAsSerializable(combinedData);
+    }
+    async stats() {
+        return project_paths.confirmAsSerializable({});
+    }
+}
+
+function migrate() {
+    return async (tree) => {
+        await project_paths.runMigrationInDevkit({
+            tree,
+            getMigration: () => new ApplicationConfigCoreMigration(),
+        });
+    };
+}
+
+exports.migrate = migrate;

package/schematics/bundles/{apply_import_manager-yycO3l8f.cjs → apply_import_manager-1Zs_gpB6.cjs}

@@ -1,15 +1,14 @@
 'use strict';
 /**
- * @license Angular v21.0.0-next.1
+ * @license Angular v21.0.0-next.10
  * (c) 2010-2025 Google LLC. https://angular.io/
  * License: MIT
  */
 'use strict';
 
 var ts = require('typescript');
-require('os');
-var project_tsconfig_paths = require('./project_tsconfig_paths-D7xzGqRi.cjs');
-var project_paths = require('./project_paths-T_M15e2g.cjs');
+var compilerCli = require('@angular/compiler-cli');
+var project_paths = require('./project_paths-DvD50ouC.cjs');
 
 /**
  * Applies import manager changes, and writes them as replacements the
@@ -23,7 +22,7 @@ function applyImportManagerChanges(importManager, replacements, sourceFiles, inf
     newImports.forEach((newImports, fileName) => {
         newImports.forEach((newImport) => {
             const printedImport = printer.printNode(ts.EmitHint.Unspecified, newImport, pathToFile.get(fileName));
-            replacements.push(new project_paths.Replacement(project_paths.projectFile(project_tsconfig_paths.absoluteFrom(fileName), info), new project_paths.TextUpdate({ position: 0, end: 0, toInsert: `${printedImport}\n` })));
+            replacements.push(new project_paths.Replacement(project_paths.projectFile(compilerCli.absoluteFrom(fileName), info), new project_paths.TextUpdate({ position: 0, end: 0, toInsert: `${printedImport}\n` })));
         });
     });
     // Capture updated imports