@angular/core 19.0.0-next.8 → 19.0.0-rc.0

package/schematics/bundles/signals.js

@@ -0,0 +1,54 @@
+'use strict';
+/**
+ * @license Angular v19.0.0-rc.0
+ * (c) 2010-2024 Google LLC. https://angular.io/
+ * License: MIT
+ */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var schematics = require('@angular-devkit/schematics');
+var signalQueriesMigration = require('./signal-queries-migration.js');
+var signalInputMigration = require('./signal-input-migration.js');
+var outputMigration = require('./output-migration.js');
+require('./project_tsconfig_paths-6c9cde78.js');
+require('@angular-devkit/core');
+require('./combine_units-c52492ab.js');
+require('node:path/posix');
+require('os');
+require('typescript');
+require('./checker-2451e7c5.js');
+require('fs');
+require('module');
+require('path');
+require('url');
+require('./program-58424797.js');
+require('assert');
+require('./migrate_ts_type_references-ab18a7c3.js');
+require('./leading_space-6e7a8ec6.js');
+
+function migrate(options) {
+    // The migrations are independent so we can run them in any order, but we sort them here
+    // alphabetically so we get a consistent execution order in case of issue reports.
+    const migrations = options.migrations.slice().sort();
+    const rules = [];
+    for (const migration of migrations) {
+        switch (migration) {
+            case "inputs" /* SupportedMigrations.inputs */:
+                rules.push(signalInputMigration.migrate(options));
+                break;
+            case "outputs" /* SupportedMigrations.outputs */:
+                rules.push(outputMigration.migrate(options));
+                break;
+            case "queries" /* SupportedMigrations.queries */:
+                rules.push(signalQueriesMigration.migrate(options));
+                break;
+            default:
+                throw new schematics.SchematicsException(`Unsupported migration "${migration}"`);
+        }
+    }
+    return schematics.chain(rules);
+}
+
+exports.migrate = migrate;

package/schematics/bundles/standalone-migration.js

@@ -1,6 +1,6 @@
 'use strict';
 /**
- * @license Angular v19.0.0-next.8
+ * @license Angular v19.0.0-rc.0
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -11,14 +11,15 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var schematics = require('@angular-devkit/schematics');
 require('os');
 var ts = require('typescript');
-var checker = require('./checker-e68dd7ce.js');
+var checker = require('./checker-2451e7c5.js');
+var program = require('./program-58424797.js');
 var p = require('path');
-var program = require('./program-105283c5.js');
 var fs = require('fs');
-var compiler_host = require('./compiler_host-9a4d0c2b.js');
-var project_tsconfig_paths = require('./project_tsconfig_paths-e9ccccbf.js');
-var nodes = require('./nodes-0e7d45ca.js');
-var imports = require('./imports-4ac08251.js');
+var compiler_host = require('./compiler_host-f54f8309.js');
+var project_tsconfig_paths = require('./project_tsconfig_paths-6c9cde78.js');
+var ng_decorators = require('./ng_decorators-3ad437d2.js');
+var nodes = require('./nodes-ffdce442.js');
+var imports = require('./imports-44987700.js');
 require('module');
 require('url');
 require('@angular-devkit/core');
@@ -32,7 +33,7 @@ var ts__default = /*#__PURE__*/_interopDefaultLegacy(ts);
  * @description
  * Entry point for all public APIs of the compiler-cli package.
  */
-new checker.Version('19.0.0-next.8');
+new checker.Version('19.0.0-rc.0');
 
 function createProgram({ rootNames, options, host, oldProgram, }) {
     return new program.NgtscProgram(rootNames, options, host, oldProgram);
@@ -365,7 +366,7 @@ function toStandalone(sourceFiles, program, printer, fileImportRemapper, compone
 function convertNgModuleDeclarationToStandalone(decl, allDeclarations, tracker, typeChecker, importRemapper) {
     const directiveMeta = typeChecker.getDirectiveMetadata(decl);
     if (directiveMeta && directiveMeta.decorator && !directiveMeta.isStandalone) {
-        let decorator = addStandaloneToDecorator(directiveMeta.decorator);
+        let decorator = markDecoratorAsStandalone(directiveMeta.decorator);
         if (directiveMeta.isComponent) {
             const importsToAdd = getComponentImportExpressions(decl, allDeclarations, tracker, typeChecker, importRemapper);
             if (importsToAdd.length > 0) {
@@ -381,7 +382,7 @@ function convertNgModuleDeclarationToStandalone(decl, allDeclarations, tracker,
     else {
         const pipeMeta = typeChecker.getPipeMetadata(decl);
         if (pipeMeta && pipeMeta.decorator && !pipeMeta.isStandalone) {
-            tracker.replaceNode(pipeMeta.decorator, addStandaloneToDecorator(pipeMeta.decorator));
+            tracker.replaceNode(pipeMeta.decorator, markDecoratorAsStandalone(pipeMeta.decorator));
         }
     }
 }
@@ -540,9 +541,26 @@ function moveDeclarationsToImports(literal, allDeclarations, typeChecker, templa
     }
     tracker.replaceNode(literal, ts__default["default"].factory.updateObjectLiteralExpression(literal, ts__default["default"].factory.createNodeArray(properties, literal.properties.hasTrailingComma)), ts__default["default"].EmitHint.Expression);
 }
-/** Adds `standalone: true` to a decorator node. */
-function addStandaloneToDecorator(node) {
-    return setPropertyOnAngularDecorator(node, 'standalone', ts__default["default"].factory.createToken(ts__default["default"].SyntaxKind.TrueKeyword));
+/** Sets a decorator node to be standalone. */
+function markDecoratorAsStandalone(node) {
+    const metadata = extractMetadataLiteral(node);
+    if (metadata === null || !ts__default["default"].isCallExpression(node.expression)) {
+        return node;
+    }
+    const standaloneProp = metadata.properties.find((prop) => {
+        return isNamedPropertyAssignment(prop) && prop.name.text === 'standalone';
+    });
+    // In v19 standalone is the default so don't do anything if there's no `standalone`
+    // property or it's initialized to anything other than `false`.
+    if (!standaloneProp || standaloneProp.initializer.kind !== ts__default["default"].SyntaxKind.FalseKeyword) {
+        return node;
+    }
+    const newProperties = metadata.properties.filter((element) => element !== standaloneProp);
+    // Use `createDecorator` instead of `updateDecorator`, because
+    // the latter ends up duplicating the node's leading comment.
+    return ts__default["default"].factory.createDecorator(ts__default["default"].factory.createCallExpression(node.expression.expression, node.expression.typeArguments, [
+        ts__default["default"].factory.createObjectLiteralExpression(ts__default["default"].factory.createNodeArray(newProperties, metadata.properties.hasTrailingComma), newProperties.length > 1),
+    ]));
 }
 /**
  * Sets a property on an Angular decorator node. If the property
@@ -635,7 +653,7 @@ function findNgModuleClassesToMigrate(sourceFile, typeChecker) {
     if (imports.getImportSpecifier(sourceFile, '@angular/core', 'NgModule')) {
         sourceFile.forEachChild(function walk(node) {
             if (ts__default["default"].isClassDeclaration(node)) {
-                const decorator = nodes.getAngularDecorators(typeChecker, ts__default["default"].getDecorators(node) || []).find((current) => current.name === 'NgModule');
+                const decorator = ng_decorators.getAngularDecorators(typeChecker, ts__default["default"].getDecorators(node) || []).find((current) => current.name === 'NgModule');
                 const metadata = decorator ? extractMetadataLiteral(decorator.node) : null;
                 if (metadata) {
                     const declarations = findLiteralProperty(metadata, 'declarations');
@@ -774,13 +792,13 @@ function migrateTestDeclarations(testObjects, declarationsOutsideOfTestFiles, tr
     for (const decorator of decorators) {
         const closestClass = nodes.closestNode(decorator.node, ts__default["default"].isClassDeclaration);
         if (decorator.name === 'Pipe' || decorator.name === 'Directive') {
-            tracker.replaceNode(decorator.node, addStandaloneToDecorator(decorator.node));
+            tracker.replaceNode(decorator.node, markDecoratorAsStandalone(decorator.node));
             if (closestClass) {
                 allDeclarations.add(closestClass);
             }
         }
         else if (decorator.name === 'Component') {
-            const newDecorator = addStandaloneToDecorator(decorator.node);
+            const newDecorator = markDecoratorAsStandalone(decorator.node);
             const importsToAdd = componentImports.get(decorator.node);
             if (closestClass) {
                 allDeclarations.add(closestClass);
@@ -832,7 +850,7 @@ function analyzeTestingModules(testObjects, typeChecker) {
             if (seenDeclarations.has(decl)) {
                 continue;
             }
-            const [decorator] = nodes.getAngularDecorators(typeChecker, ts__default["default"].getDecorators(decl) || []);
+            const [decorator] = ng_decorators.getAngularDecorators(typeChecker, ts__default["default"].getDecorators(decl) || []);
             if (decorator) {
                 seenDeclarations.add(decl);
                 decorators.push(decorator);
@@ -1306,7 +1324,7 @@ function addRemovalTodos(nodes, tracker) {
 }
 /** Finds the `NgModule` decorator in a class, if it exists. */
 function findNgModuleDecorator(node, typeChecker) {
-    const decorators = nodes.getAngularDecorators(typeChecker, ts__default["default"].getDecorators(node) || []);
+    const decorators = ng_decorators.getAngularDecorators(typeChecker, ts__default["default"].getDecorators(node) || []);
     return decorators.find((decorator) => decorator.name === 'NgModule') || null;
 }
 /**
@@ -1382,7 +1400,7 @@ function analyzeBootstrapCall(call, typeChecker, templateTypeChecker) {
     if (!declaration) {
         return null;
     }
-    const decorator = nodes.getAngularDecorators(typeChecker, ts__default["default"].getDecorators(declaration) || []).find((decorator) => decorator.name === 'NgModule');
+    const decorator = ng_decorators.getAngularDecorators(typeChecker, ts__default["default"].getDecorators(declaration) || []).find((decorator) => decorator.name === 'NgModule');
     if (!decorator ||
         decorator.node.expression.arguments.length === 0 ||
         !ts__default["default"].isObjectLiteralExpression(decorator.node.expression.arguments[0])) {
@@ -1571,7 +1589,7 @@ function migrateImportsForBootstrapCall(sourceFile, imports, nodeLookup, imports
             : element;
         const classDeclaration = findClassDeclaration(target, typeChecker);
         const decorators = classDeclaration
-            ? nodes.getAngularDecorators(typeChecker, ts__default["default"].getDecorators(classDeclaration) || [])
+            ? ng_decorators.getAngularDecorators(typeChecker, ts__default["default"].getDecorators(classDeclaration) || [])
             : undefined;
         if (!decorators ||
             decorators.length === 0 ||

package/schematics/collection.json

@@ -35,6 +35,17 @@
       "factory": "./bundles/signal-queries-migration#migrate",
       "schema": "./ng-generate/signal-queries-migration/schema.json",
       "aliases": ["signal-queries", "signal-query", "signal-query-migration"]
+    },
+    "output-migration": {
+      "description": "Updates @output declarations to the functional equivalent, while also migrating all relevant references.",
+      "factory": "./bundles/output-migration#migrate",
+      "schema": "./ng-generate/output-migration/schema.json",
+      "aliases": ["outputs"]
+    },
+    "signals": {
+      "description": "Combines all signals-related migrations into a single migration",
+      "factory": "./bundles/signals#migrate",
+      "schema": "./ng-generate/signals/schema.json"
     }
   }
 }

package/schematics/migrations.json

@@ -2,13 +2,19 @@
   "schematics": {
     "explicit-standalone-flag": {
       "version": "19.0.0",
-      "description": "Updates non-standalone Directives, Component and Pipes to standalone:false",
+      "description": "Updates non-standalone Directives, Component and Pipes to 'standalone:false' and removes 'standalone:true' from those who are standalone",
       "factory": "./bundles/explicit-standalone-flag#migrate"
     },
     "pending-tasks": {
       "version": "19.0.0",
       "description": "Updates ExperimentalPendingTasks to PendingTasks",
       "factory": "./bundles/pending-tasks#migrate"
+    },
+    "provide-initializer": {
+      "version": "19.0.0",
+      "description": "Replaces `APP_INITIALIZER`, 'ENVIRONMENT_INITIALIZER' & 'PLATFORM_INITIALIZER' respectively with `provideAppInitializer`, `provideEnvironmentInitializer` & `providePlatormInitializer`.",
+      "factory": "./bundles/provide-initializer#migrate",
+      "optional": true
     }
   }
 }

package/schematics/ng-generate/output-migration/schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "AngularOutputMigration",
+  "title": "Angular Output migration",
+  "type": "object",
+  "properties": {
+    "path": {
+      "type": "string",
+      "description": "Path to the directory where all outputs should be migrated.",
+      "x-prompt": "Which directory do you want to migrate?",
+      "default": "./"
+    },
+    "analysisDir": {
+      "type": "string",
+      "description": "Path to the directory that should be analyzed. References to migrated outputs are migrated based on this folder. Useful for larger projects if the analysis takes too long and the analysis scope can be narrowed.",
+      "default": "./"
+    }
+  }
+}

package/schematics/ng-generate/signal-queries-migration/schema.json

@@ -14,6 +14,17 @@
       "type": "string",
       "description": "Path to the directory that should be analyzed. References to migrated queries are migrated based on this folder. Useful for larger projects if the analysis takes too long and the analysis scope can be narrowed.",
       "default": "./"
+    },
+    "bestEffortMode": {
+      "type": "boolean",
+      "description": "Whether to eagerly migrate as much as possible, ignoring problematic patterns that would otherwise prevent migration.",
+      "x-prompt": "Do you want to migrate as much as possible, even if it may break your build?",
+      "default": false
+    },
+    "insertTodos": {
+      "type": "boolean",
+      "description": "Whether the migration should add TODOs for queries that could not be migrated",
+      "default": false
     }
   }
 }

package/schematics/ng-generate/signals/schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "AngularSignalMigration",
+  "title": "Angular Signals migration",
+  "type": "object",
+  "properties": {
+    "migrations": {
+      "type": "array",
+      "default": [
+        "inputs",
+        "queries"
+      ],
+      "items": {
+        "type": "string",
+        "enum": [
+          "inputs",
+          "outputs",
+          "queries"
+        ]
+      },
+      "description": "Signals-related migrations that should be run",
+      "x-prompt": {
+        "message": "Which migrations do you want to run?",
+        "type": "list",
+        "multiselect": true,
+        "items": [
+          {
+            "value": "inputs",
+            "label": "Convert `@Input` to the signal-based `input`"
+          },
+          {
+            "value": "outputs",
+            "label": "Convert `@Output` to the new `output` function"
+          },
+          {
+            "value": "queries",
+            "label": "Convert `@ViewChild`/`@ViewChildren` and `@ContentChild`/`@ContentChildren` to the signal-based `viewChild`/`viewChildren` and `contentChild`/`contentChildren`"
+          }
+        ]
+      }
+    },
+    "path": {
+      "type": "string",
+      "description": "Path to the directory that should be migrated.",
+      "x-prompt": "Which directory do you want to migrate?",
+      "default": "./"
+    },
+    "analysisDir": {
+      "type": "string",
+      "description": "Path to the directory that should be analyzed. Useful for larger projects if the analysis takes too long and the analysis scope can be narrowed.",
+      "default": "./"
+    },
+    "bestEffortMode": {
+      "type": "boolean",
+      "description": "Whether to eagerly migrate as much as possible, ignoring problematic patterns that would otherwise prevent migration.",
+      "x-prompt": "Do you want to migrate as much as possible, even if it may break your build?",
+      "default": false
+    },
+    "insertTodos": {
+      "type": "boolean",
+      "description": "Whether the migration should add TODOs for code that could not be migrated",
+      "default": false
+    }
+  }
+}

package/testing/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @license Angular v19.0.0-next.8
+ * @license Angular v19.0.0-rc.0
  * (c) 2010-2024 Google LLC. https://angular.io/
  * License: MIT
  */
@@ -89,6 +89,8 @@ export declare class ComponentFixture<T> {
      * Set whether the fixture should autodetect changes.
      *
      * Also runs detectChanges once so that any existing change is detected.
+     *
+     * @param autoDetect Whether to autodetect changes. By default, `true`.
      */
     autoDetectChanges(autoDetect?: boolean): void;
     /**