@kato-lee/cdk 14.2.7 → 20.2.14

package/schematics/update-tool/index.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateProject = void 0;
+const ts = require("typescript");
+const component_resource_collector_1 = require("./component-resource-collector");
+const logger_1 = require("./logger");
+const parse_tsconfig_1 = require("./utils/parse-tsconfig");
+const virtual_host_1 = require("./utils/virtual-host");
+/**
+ * An update project that can be run against individual migrations. An update project
+ * accepts a TypeScript program and a context that is provided to all migrations. The
+ * context is usually not used by migrations, but in some cases migrations rely on
+ * specifics from the tool that performs the update (e.g. the Angular CLI). In those cases,
+ * the context can provide the necessary specifics to the migrations in a type-safe way.
+ */
+class UpdateProject {
+    constructor(
+    /** Context provided to all migrations. */
+    _context, 
+    /** TypeScript program using workspace paths. */
+    _program, 
+    /** File system used for reading, writing and editing files. */
+    _fileSystem, 
+    /**
+     * Set of analyzed files. Used for avoiding multiple migration runs if
+     * files overlap between targets.
+     */
+    _analyzedFiles = new Set(), 
+    /** Logger used for printing messages. */
+    _logger = logger_1.defaultLogger) {
+        this._context = _context;
+        this._program = _program;
+        this._fileSystem = _fileSystem;
+        this._analyzedFiles = _analyzedFiles;
+        this._logger = _logger;
+        this._typeChecker = this._program.getTypeChecker();
+    }
+    /**
+     * Migrates the project to the specified target version.
+     * @param migrationTypes Migrations that should be run.
+     * @param target Version the project should be updated to. Can be `null` if the set of
+     *   specified migrations runs regardless of a target version.
+     * @param data Upgrade data that is passed to all migration rules.
+     * @param additionalStylesheetPaths Additional stylesheets that should be migrated, if not
+     *   referenced in an Angular component. This is helpful for global stylesheets in a project.
+     * @param limitToDirectory If specified, changes will be limited to the given directory.
+     */
+    migrate(migrationTypes, target, data, additionalStylesheetPaths, limitToDirectory) {
+        limitToDirectory && (limitToDirectory = this._fileSystem.resolve(limitToDirectory));
+        // Create instances of the specified migrations.
+        const migrations = this._createMigrations(migrationTypes, target, data);
+        // Creates the component resource collector. The collector can visit arbitrary
+        // TypeScript nodes and will find Angular component resources. Resources include
+        // templates and stylesheets. It also captures inline stylesheets and templates.
+        const resourceCollector = new component_resource_collector_1.ComponentResourceCollector(this._typeChecker, this._fileSystem);
+        // Collect all of the TypeScript source files we want to migrate. We don't
+        // migrate type definition files, or source files from external libraries.
+        const sourceFiles = this._program.getSourceFiles().filter(f => {
+            return (!f.isDeclarationFile &&
+                (limitToDirectory == null ||
+                    this._fileSystem.resolve(f.fileName).startsWith(limitToDirectory)) &&
+                !this._program.isSourceFileFromExternalLibrary(f));
+        });
+        // Helper function that visits a given TypeScript node and collects all referenced
+        // component resources (i.e. stylesheets or templates). Additionally, the helper
+        // visits the node in each instantiated migration.
+        const visitNodeAndCollectResources = (node) => {
+            migrations.forEach(r => r.visitNode(node));
+            ts.forEachChild(node, visitNodeAndCollectResources);
+            resourceCollector.visitNode(node);
+        };
+        // Walk through all source file, if it has not been visited before, and
+        // visit found nodes while collecting potential resources.
+        sourceFiles.forEach(sourceFile => {
+            const resolvedPath = this._fileSystem.resolve(sourceFile.fileName);
+            // Do not visit source files which have been checked as part of a
+            // previously migrated TypeScript project.
+            if (!this._analyzedFiles.has(resolvedPath)) {
+                visitNodeAndCollectResources(sourceFile);
+                this._analyzedFiles.add(resolvedPath);
+            }
+        });
+        // Walk through all resolved templates and visit them in each instantiated
+        // migration. Note that this can only happen after source files have been
+        // visited because we find templates through the TypeScript source files.
+        resourceCollector.resolvedTemplates.forEach(template => {
+            // Do not visit the template if it has been checked before. Inline
+            // templates cannot be referenced multiple times.
+            if (template.inline || !this._analyzedFiles.has(template.filePath)) {
+                migrations.forEach(m => m.visitTemplate(template));
+                this._analyzedFiles.add(template.filePath);
+            }
+        });
+        // Walk through all resolved stylesheets and visit them in each instantiated
+        // migration. Note that this can only happen after source files have been
+        // visited because we find stylesheets through the TypeScript source files.
+        resourceCollector.resolvedStylesheets.forEach(stylesheet => {
+            // Do not visit the stylesheet if it has been checked before. Inline
+            // stylesheets cannot be referenced multiple times.
+            if (stylesheet.inline || !this._analyzedFiles.has(stylesheet.filePath)) {
+                migrations.forEach(r => r.visitStylesheet(stylesheet));
+                this._analyzedFiles.add(stylesheet.filePath);
+            }
+        });
+        // In some applications, developers will have global stylesheets which are not
+        // specified in any Angular component. Therefore we allow for additional stylesheets
+        // being specified. We visit them in each migration unless they have been already
+        // discovered before as actual component resource.
+        if (additionalStylesheetPaths) {
+            additionalStylesheetPaths.forEach(filePath => {
+                const resolvedPath = this._fileSystem.resolve(filePath);
+                if (limitToDirectory == null || resolvedPath.startsWith(limitToDirectory)) {
+                    const stylesheet = resourceCollector.resolveExternalStylesheet(resolvedPath, null);
+                    // Do not visit stylesheets which have been referenced from a component.
+                    if (!this._analyzedFiles.has(resolvedPath) && stylesheet) {
+                        migrations.forEach(r => r.visitStylesheet(stylesheet));
+                        this._analyzedFiles.add(resolvedPath);
+                    }
+                }
+            });
+        }
+        // Call the "postAnalysis" method for each migration.
+        migrations.forEach(r => r.postAnalysis());
+        // Collect all failures reported by individual migrations.
+        const failures = migrations.reduce((res, m) => res.concat(m.failures), []);
+        // In case there are failures, print these to the CLI logger as warnings.
+        if (failures.length) {
+            failures.forEach(({ filePath, message, position }) => {
+                const lineAndCharacter = position ? `@${position.line + 1}:${position.character + 1}` : '';
+                this._logger.warn(`${filePath}${lineAndCharacter} - ${message}`);
+            });
+        }
+        return {
+            hasFailures: !!failures.length,
+        };
+    }
+    /**
+     * Creates instances of the given migrations with the specified target
+     * version and data.
+     */
+    _createMigrations(types, target, data) {
+        const result = [];
+        for (const ctor of types) {
+            const instance = new ctor(this._program, this._typeChecker, target, this._context, data, this._fileSystem, this._logger);
+            instance.init();
+            if (instance.enabled) {
+                result.push(instance);
+            }
+        }
+        return result;
+    }
+    /**
+     * Creates a program from the specified tsconfig and patches the host
+     * to read files and directories through the given file system.
+     *
+     * @throws {TsconfigParseError} If the tsconfig could not be parsed.
+     */
+    static createProgramFromTsconfig(tsconfigPath, fs) {
+        const parsed = (0, parse_tsconfig_1.parseTsconfigFile)(fs.resolve(tsconfigPath), fs);
+        const host = (0, virtual_host_1.createFileSystemCompilerHost)(parsed.options, fs);
+        return ts.createProgram(parsed.fileNames, parsed.options, host);
+    }
+}
+exports.UpdateProject = UpdateProject;
+//# sourceMappingURL=index.js.map

package/schematics/update-tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,iCAAiC;AAEjC,iFAA0E;AAE1E,qCAAqD;AAGrD,2DAAyD;AACzD,uDAAkE;AAElE;;;;;;GAMG;AACH,MAAa,aAAa;IAGxB;IACE,0CAA0C;IAClC,QAAiB;IACzB,gDAAgD;IACxC,QAAoB;IAC5B,+DAA+D;IACvD,WAAuB;IAC/B;;;OAGG;IACK,iBAAqC,IAAI,GAAG,EAAE;IACtD,yCAAyC;IACjC,UAAwB,sBAAa;QAXrC,aAAQ,GAAR,QAAQ,CAAS;QAEjB,aAAQ,GAAR,QAAQ,CAAY;QAEpB,gBAAW,GAAX,WAAW,CAAY;QAKvB,mBAAc,GAAd,cAAc,CAAgC;QAE9C,YAAO,GAAP,OAAO,CAA8B;QAE7C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;IACrD,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CACL,cAA8C,EAC9C,MAA4B,EAC5B,IAAU,EACV,yBAAoC,EACpC,gBAAyB;QAEzB,gBAAgB,KAAhB,gBAAgB,GAAK,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAC;QAEhE,gDAAgD;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACxE,8EAA8E;QAC9E,gFAAgF;QAChF,gFAAgF;QAChF,MAAM,iBAAiB,GAAG,IAAI,yDAA0B,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9F,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC5D,OAAO,CACL,CAAC,CAAC,CAAC,iBAAiB;gBACpB,CAAC,gBAAgB,IAAI,IAAI;oBACvB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;gBACpE,CAAC,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAClD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,kFAAkF;QAClF,gFAAgF;QAChF,kDAAkD;QAClD,MAAM,4BAA4B,GAAG,CAAC,IAAa,EAAE,EAAE;YACrD,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3C,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAC;YACpD,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC;QAEF,uEAAuE;QACvE,0DAA0D;QAC1D,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;YAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACnE,iEAAiE;YACjE,0CAA0C;YAC1C,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC3C,4BAA4B,CAAC,UAAU,CAAC,CAAC;gBACzC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,0EAA0E;QAC1E,yEAAyE;QACzE,yEAAyE;QACzE,iBAAiB,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YACrD,kEAAkE;YAClE,iDAAiD;YACjD,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACnD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,4EAA4E;QAC5E,yEAAyE;QACzE,2EAA2E;QAC3E,iBAAiB,CAAC,mBAAmB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;YACzD,oEAAoE;YACpE,mDAAmD;YACnD,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;gBACvD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,8EAA8E;QAC9E,oFAAoF;QACpF,iFAAiF;QACjF,kDAAkD;QAClD,IAAI,yBAAyB,EAAE,CAAC;YAC9B,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACxD,IAAI,gBAAgB,IAAI,IAAI,IAAI,YAAY,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBAC1E,MAAM,UAAU,GAAG,iBAAiB,CAAC,yBAAyB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;oBACnF,wEAAwE;oBACxE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,UAAU,EAAE,CAAC;wBACzD,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;wBACvD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;oBACxC,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,qDAAqD;QACrD,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QAE1C,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAChC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAClC,EAAwB,CACzB,CAAC;QAEF,yEAAyE;QACzE,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAC,EAAE,EAAE;gBACjD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3F,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,GAAG,gBAAgB,MAAM,OAAO,EAAE,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM;SAC/B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,iBAAiB,CACvB,KAAqC,EACrC,MAA4B,EAC5B,IAAU;QAEV,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,IAAI,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,YAAY,EACjB,MAAM,EACN,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,OAAO,CACb,CAAC;YACF,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChB,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,yBAAyB,CAAC,YAA2B,EAAE,EAAc;QAC1E,MAAM,MAAM,GAAG,IAAA,kCAAiB,EAAC,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAA,2CAA4B,EAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9D,OAAO,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;CACF;AArLD,sCAqLC"}

package/schematics/update-tool/logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @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
+ */
+export interface UpdateLogger {
+    debug(message: string): void;
+    error(message: string): void;
+    fatal(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+}
+export declare const defaultLogger: UpdateLogger;

package/schematics/update-tool/logger.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultLogger = void 0;
+exports.defaultLogger = {
+    debug: m => console.debug(m),
+    error: m => console.error(m),
+    fatal: m => console.error(m),
+    info: m => console.info(m),
+    warn: m => console.warn(m),
+};
+//# sourceMappingURL=logger.js.map

package/schematics/update-tool/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["logger.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAUU,QAAA,aAAa,GAAiB;IACzC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;CAC3B,CAAC"}

package/schematics/update-tool/migration.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @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
+ */
+import * as ts from 'typescript';
+import { ResolvedResource } from './component-resource-collector';
+import { FileSystem, WorkspacePath } from './file-system';
+import { UpdateLogger } from './logger';
+import { TargetVersion } from './target-version';
+import { LineAndCharacter } from './utils/line-mappings';
+export interface MigrationFailure {
+    filePath: WorkspacePath;
+    message: string;
+    position?: LineAndCharacter;
+}
+export type PostMigrationAction = void | {
+    /** Whether the package manager should run upon migration completion. */
+    runPackageManager: boolean;
+};
+/** Creates a constructor type for the specified type. */
+export type Constructor<T> = new (...args: any[]) => T;
+/** Gets a constructor type for the passed migration data. */
+export type MigrationCtor<Data, Context = any> = Constructor<Migration<Data, Context>>;
+export declare abstract class Migration<Data, Context = any> {
+    /** TypeScript program for the migration. */
+    program: ts.Program;
+    /** TypeChecker instance for the analysis program. */
+    typeChecker: ts.TypeChecker;
+    /**
+     * Version for which the migration rule should run. Null if the migration
+     * is invoked manually.
+     */
+    targetVersion: TargetVersion | null;
+    /** Context data for the migration. */
+    context: Context;
+    /** Upgrade data passed to the migration. */
+    upgradeData: Data;
+    /** File system that can be used for modifying files. */
+    fileSystem: FileSystem;
+    /** Logger that can be used to print messages as part of the migration. */
+    logger: UpdateLogger;
+    /** List of migration failures that need to be reported. */
+    failures: MigrationFailure[];
+    /** Whether the migration is enabled or not. */
+    abstract enabled: boolean;
+    constructor(
+    /** TypeScript program for the migration. */
+    program: ts.Program, 
+    /** TypeChecker instance for the analysis program. */
+    typeChecker: ts.TypeChecker, 
+    /**
+     * Version for which the migration rule should run. Null if the migration
+     * is invoked manually.
+     */
+    targetVersion: TargetVersion | null, 
+    /** Context data for the migration. */
+    context: Context, 
+    /** Upgrade data passed to the migration. */
+    upgradeData: Data, 
+    /** File system that can be used for modifying files. */
+    fileSystem: FileSystem, 
+    /** Logger that can be used to print messages as part of the migration. */
+    logger: UpdateLogger);
+    /** Method can be used to perform global analysis of the program. */
+    init(): void;
+    /**
+     * Method that will be called once all nodes, templates and stylesheets
+     * have been visited.
+     */
+    postAnalysis(): void;
+    /**
+     * Method that will be called for each node in a given source file. Unlike tslint, this
+     * function will only retrieve TypeScript nodes that need to be casted manually. This
+     * allows us to only walk the program source files once per program and not per
+     * migration rule (significant performance boost).
+     */
+    visitNode(node: ts.Node): void;
+    /** Method that will be called for each Angular template in the program. */
+    visitTemplate(template: ResolvedResource): void;
+    /** Method that will be called for each stylesheet in the program. */
+    visitStylesheet(stylesheet: ResolvedResource): void;
+    /** Creates a failure with a specified message at the given node location. */
+    protected createFailureAtNode(node: ts.Node, message: string): void;
+}

package/schematics/update-tool/migration.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Migration = void 0;
+const ts = require("typescript");
+class Migration {
+    constructor(
+    /** TypeScript program for the migration. */
+    program, 
+    /** TypeChecker instance for the analysis program. */
+    typeChecker, 
+    /**
+     * Version for which the migration rule should run. Null if the migration
+     * is invoked manually.
+     */
+    targetVersion, 
+    /** Context data for the migration. */
+    context, 
+    /** Upgrade data passed to the migration. */
+    upgradeData, 
+    /** File system that can be used for modifying files. */
+    fileSystem, 
+    /** Logger that can be used to print messages as part of the migration. */
+    logger) {
+        this.program = program;
+        this.typeChecker = typeChecker;
+        this.targetVersion = targetVersion;
+        this.context = context;
+        this.upgradeData = upgradeData;
+        this.fileSystem = fileSystem;
+        this.logger = logger;
+        /** List of migration failures that need to be reported. */
+        this.failures = [];
+    }
+    /** Method can be used to perform global analysis of the program. */
+    init() { }
+    /**
+     * Method that will be called once all nodes, templates and stylesheets
+     * have been visited.
+     */
+    postAnalysis() { }
+    /**
+     * Method that will be called for each node in a given source file. Unlike tslint, this
+     * function will only retrieve TypeScript nodes that need to be casted manually. This
+     * allows us to only walk the program source files once per program and not per
+     * migration rule (significant performance boost).
+     */
+    visitNode(node) { }
+    /** Method that will be called for each Angular template in the program. */
+    visitTemplate(template) { }
+    /** Method that will be called for each stylesheet in the program. */
+    visitStylesheet(stylesheet) { }
+    /** Creates a failure with a specified message at the given node location. */
+    createFailureAtNode(node, message) {
+        const sourceFile = node.getSourceFile();
+        this.failures.push({
+            filePath: this.fileSystem.resolve(sourceFile.fileName),
+            position: ts.getLineAndCharacterOfPosition(sourceFile, node.getStart()),
+            message: message,
+        });
+    }
+}
+exports.Migration = Migration;
+//# sourceMappingURL=migration.js.map

package/schematics/update-tool/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["migration.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,iCAAiC;AAuBjC,MAAsB,SAAS;IAO7B;IACE,4CAA4C;IACrC,OAAmB;IAC1B,qDAAqD;IAC9C,WAA2B;IAClC;;;OAGG;IACI,aAAmC;IAC1C,sCAAsC;IAC/B,OAAgB;IACvB,4CAA4C;IACrC,WAAiB;IACxB,wDAAwD;IACjD,UAAsB;IAC7B,0EAA0E;IACnE,MAAoB;QAfpB,YAAO,GAAP,OAAO,CAAY;QAEnB,gBAAW,GAAX,WAAW,CAAgB;QAK3B,kBAAa,GAAb,aAAa,CAAsB;QAEnC,YAAO,GAAP,OAAO,CAAS;QAEhB,gBAAW,GAAX,WAAW,CAAM;QAEjB,eAAU,GAAV,UAAU,CAAY;QAEtB,WAAM,GAAN,MAAM,CAAc;QAvB7B,2DAA2D;QAC3D,aAAQ,GAAuB,EAAE,CAAC;IAuB/B,CAAC;IAEJ,oEAAoE;IACpE,IAAI,KAAU,CAAC;IAEf;;;OAGG;IACH,YAAY,KAAU,CAAC;IAEvB;;;;;OAKG;IACH,SAAS,CAAC,IAAa,IAAS,CAAC;IAEjC,2EAA2E;IAC3E,aAAa,CAAC,QAA0B,IAAS,CAAC;IAElD,qEAAqE;IACrE,eAAe,CAAC,UAA4B,IAAS,CAAC;IAEtD,6EAA6E;IACnE,mBAAmB,CAAC,IAAa,EAAE,OAAe;QAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjB,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;YACtD,QAAQ,EAAE,EAAE,CAAC,6BAA6B,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvE,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;IACL,CAAC;CACF;AA3DD,8BA2DC"}

package/schematics/update-tool/public-api.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @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
+ */
+export * from './component-resource-collector';
+export * from './file-system';
+export * from './index';
+export * from './migration';
+export * from './target-version';
+export * from './utils/decorators';
+export * from './utils/imports';
+export * from './utils/property-name';
+export * from './version-changes';

package/schematics/update-tool/public-api.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * @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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./component-resource-collector"), exports);
+__exportStar(require("./file-system"), exports);
+__exportStar(require("./index"), exports);
+__exportStar(require("./migration"), exports);
+__exportStar(require("./target-version"), exports);
+__exportStar(require("./utils/decorators"), exports);
+__exportStar(require("./utils/imports"), exports);
+__exportStar(require("./utils/property-name"), exports);
+__exportStar(require("./version-changes"), exports);
+//# sourceMappingURL=public-api.js.map

package/schematics/update-tool/public-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["public-api.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH,iEAA+C;AAC/C,gDAA8B;AAC9B,0CAAwB;AACxB,8CAA4B;AAC5B,mDAAiC;AACjC,qDAAmC;AACnC,kDAAgC;AAChC,wDAAsC;AACtC,oDAAkC"}

package/schematics/update-tool/target-version.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @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
+ */
+/** Possible versions that can be automatically migrated by `ng update`. */
+export declare enum TargetVersion {
+    V20 = "version 20"
+}
+/**
+ * Returns all versions that are supported by "ng update". The versions are determined
+ * based on the "TargetVersion" enum.
+ */
+export declare function getAllVersionNames(): string[];

package/schematics/update-tool/target-version.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TargetVersion = void 0;
+exports.getAllVersionNames = getAllVersionNames;
+/** Possible versions that can be automatically migrated by `ng update`. */
+// tslint:disable-next-line:prefer-const-enum
+var TargetVersion;
+(function (TargetVersion) {
+    TargetVersion["V20"] = "version 20";
+})(TargetVersion || (exports.TargetVersion = TargetVersion = {}));
+/**
+ * Returns all versions that are supported by "ng update". The versions are determined
+ * based on the "TargetVersion" enum.
+ */
+function getAllVersionNames() {
+    return Object.keys(TargetVersion).filter(enumValue => {
+        return typeof TargetVersion[enumValue] === 'string';
+    });
+}
+//# sourceMappingURL=target-version.js.map

package/schematics/update-tool/target-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-version.js","sourceRoot":"","sources":["target-version.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAaH,gDAIC;AAfD,2EAA2E;AAE3E,6CAA6C;AAC7C,IAAY,aAEX;AAFD,WAAY,aAAa;IACvB,mCAAkB,CAAA;AACpB,CAAC,EAFW,aAAa,6BAAb,aAAa,QAExB;AAED;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;QACnD,OAAO,OAAQ,aAAoD,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC;IAC9F,CAAC,CAAC,CAAC;AACL,CAAC"}

package/schematics/update-tool/update-recorder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @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
+ */
+/** Update recorder that can be used to apply changes to a source file. */
+export interface UpdateRecorder {
+    insertLeft(index: number, content: string): UpdateRecorder;
+    insertRight(index: number, content: string): UpdateRecorder;
+    remove(index: number, length: number): UpdateRecorder;
+}

package/schematics/update-tool/update-recorder.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=update-recorder.js.map

package/schematics/update-tool/update-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-recorder.js","sourceRoot":"","sources":["update-recorder.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/schematics/update-tool/utils/decorators.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @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
+ */
+import * as ts from 'typescript';
+import { Import } from './imports';
+export type CallExpressionDecorator = ts.Decorator & {
+    expression: ts.CallExpression;
+};
+export interface NgDecorator {
+    name: string;
+    node: CallExpressionDecorator;
+}
+/**
+ * Gets all decorators which are imported from an Angular package
+ * (e.g. "@angular/core") from a list of decorators.
+ */
+export declare function getAngularDecorators(typeChecker: ts.TypeChecker, decorators: readonly ts.Decorator[]): readonly NgDecorator[];
+export declare function getCallDecoratorImport(typeChecker: ts.TypeChecker, decorator: ts.Decorator): Import | null;

package/schematics/update-tool/utils/decorators.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAngularDecorators = getAngularDecorators;
+exports.getCallDecoratorImport = getCallDecoratorImport;
+const ts = require("typescript");
+const imports_1 = require("./imports");
+/**
+ * Gets all decorators which are imported from an Angular package
+ * (e.g. "@angular/core") from a list of decorators.
+ */
+function getAngularDecorators(typeChecker, decorators) {
+    return decorators
+        .map(node => ({ node, importData: getCallDecoratorImport(typeChecker, node) }))
+        .filter(({ importData }) => importData && importData.moduleName.startsWith('@angular/'))
+        .map(({ node, importData }) => ({
+        node: node,
+        name: importData.symbolName,
+    }));
+}
+function getCallDecoratorImport(typeChecker, decorator) {
+    if (!ts.isCallExpression(decorator.expression)) {
+        return null;
+    }
+    const valueExpr = decorator.expression.expression;
+    let identifier = null;
+    if (ts.isIdentifier(valueExpr)) {
+        identifier = valueExpr;
+    }
+    else if (ts.isPropertyAccessExpression(valueExpr) && ts.isIdentifier(valueExpr.name)) {
+        identifier = valueExpr.name;
+    }
+    return identifier ? (0, imports_1.getImportOfIdentifier)(identifier, typeChecker) : null;
+}
+//# sourceMappingURL=decorators.js.map

package/schematics/update-tool/utils/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["decorators.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAmBH,oDAWC;AAED,wDAeC;AA7CD,iCAAiC;AAEjC,uCAAwD;AAWxD;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,WAA2B,EAC3B,UAAmC;IAEnC,OAAO,UAAU;SACd,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAC,IAAI,EAAE,UAAU,EAAE,sBAAsB,CAAC,WAAW,EAAE,IAAI,CAAC,EAAC,CAAC,CAAC;SAC5E,MAAM,CAAC,CAAC,EAAC,UAAU,EAAC,EAAE,EAAE,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;SACrF,GAAG,CAAC,CAAC,EAAC,IAAI,EAAE,UAAU,EAAC,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,EAAE,IAA+B;QACrC,IAAI,EAAE,UAAW,CAAC,UAAU;KAC7B,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAgB,sBAAsB,CACpC,WAA2B,EAC3B,SAAuB;IAEvB,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC;IAClD,IAAI,UAAU,GAAyB,IAAI,CAAC;IAC5C,IAAI,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;SAAM,IAAI,EAAE,CAAC,0BAA0B,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACvF,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC;IAC9B,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,IAAA,+BAAqB,EAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC"}

package/schematics/update-tool/utils/diagnostics.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @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
+ */
+import * as ts from 'typescript';
+import { FileSystem } from '../file-system';
+/** Formats the specified diagnostics with respect to the given file system. */
+export declare function formatDiagnostics(diagnostics: ts.Diagnostic[], fileSystem: FileSystem): string;

package/schematics/update-tool/utils/diagnostics.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDiagnostics = formatDiagnostics;
+const ts = require("typescript");
+const virtual_host_1 = require("./virtual-host");
+/** Formats the specified diagnostics with respect to the given file system. */
+function formatDiagnostics(diagnostics, fileSystem) {
+    const formatHost = (0, virtual_host_1.createFormatDiagnosticHost)(fileSystem);
+    return ts.formatDiagnosticsWithColorAndContext(diagnostics, formatHost);
+}
+//# sourceMappingURL=diagnostics.js.map

package/schematics/update-tool/utils/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["diagnostics.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAOH,8CAGC;AARD,iCAAiC;AAEjC,iDAA0D;AAE1D,+EAA+E;AAC/E,SAAgB,iBAAiB,CAAC,WAA4B,EAAE,UAAsB;IACpF,MAAM,UAAU,GAAG,IAAA,yCAA0B,EAAC,UAAU,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,oCAAoC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC1E,CAAC"}

package/schematics/update-tool/utils/functions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @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
+ */
+import * as ts from 'typescript';
+/**
+ * Unwraps a given expression TypeScript node. Expressions can be wrapped within multiple
+ * parentheses. e.g. "(((({exp}))))()". The function should return the TypeScript node
+ * referring to the inner expression. e.g "exp".
+ */
+export declare function unwrapExpression(node: ts.Expression | ts.ParenthesizedExpression): ts.Expression;