@kato-lee/cdk 14.2.7 → 20.2.14

package/schematics/ng-update/typescript/literal.js

@@ -0,0 +1,32 @@
+"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.findAllSubstringIndices = findAllSubstringIndices;
+exports.isStringLiteralLike = isStringLiteralLike;
+const ts = require("typescript");
+/** Finds all start indices of the given search string in the input string. */
+function findAllSubstringIndices(input, search) {
+    const result = [];
+    let i = -1;
+    while ((i = input.indexOf(search, i + 1)) !== -1) {
+        result.push(i);
+    }
+    return result;
+}
+/**
+ * Checks whether the given node is either a string literal or a no-substitution template
+ * literal. Note that we cannot use `ts.isStringLiteralLike()` because if developers update
+ * an outdated project, their TypeScript version is not automatically being updated
+ * and therefore could throw because the function is not available yet.
+ * https://github.com/Microsoft/TypeScript/commit/8518343dc8762475a5e92c9f80b5c5725bd81796
+ */
+function isStringLiteralLike(node) {
+    return ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node);
+}
+//# sourceMappingURL=literal.js.map

package/schematics/ng-update/typescript/literal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"literal.js","sourceRoot":"","sources":["literal.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAKH,0DAOC;AASD,kDAIC;AAvBD,iCAAiC;AAEjC,8EAA8E;AAC9E,SAAgB,uBAAuB,CAAC,KAAa,EAAE,MAAc;IACnE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACX,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,IAAa;IAEb,OAAO,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC"}

package/schematics/ng-update/typescript/module-specifiers.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
+ */
+import * as ts from 'typescript';
+/** Name of the Angular Material module specifier. */
+export declare const materialModuleSpecifier = "@kato-lee/material";
+/** Name of the Angular CDK module specifier. */
+export declare const cdkModuleSpecifier = "@kato-lee/cdk";
+/** Whether the specified node is part of an Angular Material or CDK import declaration. */
+export declare function isMaterialImportDeclaration(node: ts.Node): boolean;
+/** Whether the specified node is part of an Angular Material or CDK import declaration. */
+export declare function isMaterialExportDeclaration(node: ts.Node): boolean;

package/schematics/ng-update/typescript/module-specifiers.js

@@ -0,0 +1,35 @@
+"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.cdkModuleSpecifier = exports.materialModuleSpecifier = void 0;
+exports.isMaterialImportDeclaration = isMaterialImportDeclaration;
+exports.isMaterialExportDeclaration = isMaterialExportDeclaration;
+const imports_1 = require("../typescript/imports");
+/** Name of the Angular Material module specifier. */
+exports.materialModuleSpecifier = '@kato-lee/material';
+/** Name of the Angular CDK module specifier. */
+exports.cdkModuleSpecifier = '@kato-lee/cdk';
+/** Whether the specified node is part of an Angular Material or CDK import declaration. */
+function isMaterialImportDeclaration(node) {
+    return isMaterialDeclaration((0, imports_1.getImportDeclaration)(node));
+}
+/** Whether the specified node is part of an Angular Material or CDK import declaration. */
+function isMaterialExportDeclaration(node) {
+    return isMaterialDeclaration((0, imports_1.getExportDeclaration)(node));
+}
+/** Whether the declaration is part of Angular Material. */
+function isMaterialDeclaration(declaration) {
+    if (!declaration.moduleSpecifier) {
+        return false;
+    }
+    const moduleSpecifier = declaration.moduleSpecifier.getText();
+    return (moduleSpecifier.indexOf(exports.materialModuleSpecifier) !== -1 ||
+        moduleSpecifier.indexOf(exports.cdkModuleSpecifier) !== -1);
+}
+//# sourceMappingURL=module-specifiers.js.map

package/schematics/ng-update/typescript/module-specifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-specifiers.js","sourceRoot":"","sources":["module-specifiers.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAYH,kEAEC;AAGD,kEAEC;AAhBD,mDAAiF;AAEjF,qDAAqD;AACxC,QAAA,uBAAuB,GAAG,mBAAmB,CAAC;AAE3D,gDAAgD;AACnC,QAAA,kBAAkB,GAAG,cAAc,CAAC;AAEjD,2FAA2F;AAC3F,SAAgB,2BAA2B,CAAC,IAAa;IACvD,OAAO,qBAAqB,CAAC,IAAA,8BAAoB,EAAC,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,2FAA2F;AAC3F,SAAgB,2BAA2B,CAAC,IAAa;IACvD,OAAO,qBAAqB,CAAC,IAAA,8BAAoB,EAAC,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,2DAA2D;AAC3D,SAAS,qBAAqB,CAAC,WAAwD;IACrF,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;IAC9D,OAAO,CACL,eAAe,CAAC,OAAO,CAAC,+BAAuB,CAAC,KAAK,CAAC,CAAC;QACvD,eAAe,CAAC,OAAO,CAAC,0BAAkB,CAAC,KAAK,CAAC,CAAC,CACnD,CAAC;AACJ,CAAC"}

package/schematics/ng-update/upgrade-data.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @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 { Migration } from '../update-tool/migration';
+import { ValueOfChanges, VersionChanges } from '../update-tool/version-changes';
+import { AttributeSelectorUpgradeData, ClassNameUpgradeData, ConstructorChecksUpgradeData, CssSelectorUpgradeData, ElementSelectorUpgradeData, InputNameUpgradeData, MethodCallUpgradeData, OutputNameUpgradeData, PropertyNameUpgradeData, SymbolRemovalUpgradeData, CssTokenUpgradeData } from './data';
+/** Upgrade data for the Angular CDK. */
+export declare const cdkUpgradeData: UpgradeData;
+/**
+ * Interface that describes the upgrade data that needs to be defined when using the CDK
+ * upgrade rules.
+ */
+export interface UpgradeData {
+    attributeSelectors: VersionChanges<AttributeSelectorUpgradeData>;
+    classNames: VersionChanges<ClassNameUpgradeData>;
+    constructorChecks: VersionChanges<ConstructorChecksUpgradeData>;
+    cssSelectors: VersionChanges<CssSelectorUpgradeData>;
+    cssTokens: VersionChanges<CssTokenUpgradeData>;
+    elementSelectors: VersionChanges<ElementSelectorUpgradeData>;
+    inputNames: VersionChanges<InputNameUpgradeData>;
+    methodCallChecks: VersionChanges<MethodCallUpgradeData>;
+    outputNames: VersionChanges<OutputNameUpgradeData>;
+    propertyNames: VersionChanges<PropertyNameUpgradeData>;
+    symbolRemoval: VersionChanges<SymbolRemovalUpgradeData>;
+}
+/**
+ * Gets the reduced upgrade data for the specified data key. The function reads out the
+ * target version and upgrade data object from the migration and resolves the specified
+ * data portion that is specifically tied to the target version.
+ */
+export declare function getVersionUpgradeData<T extends keyof UpgradeData, U = ValueOfChanges<UpgradeData[T]>>(migration: Migration<UpgradeData>, dataName: T): U[];

package/schematics/ng-update/upgrade-data.js

@@ -0,0 +1,40 @@
+"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.cdkUpgradeData = void 0;
+exports.getVersionUpgradeData = getVersionUpgradeData;
+const version_changes_1 = require("../update-tool/version-changes");
+const data_1 = require("./data");
+/** Upgrade data for the Angular CDK. */
+exports.cdkUpgradeData = {
+    attributeSelectors: data_1.attributeSelectors,
+    classNames: data_1.classNames,
+    constructorChecks: data_1.constructorChecks,
+    cssSelectors: data_1.cssSelectors,
+    cssTokens: data_1.cssTokens,
+    elementSelectors: data_1.elementSelectors,
+    inputNames: data_1.inputNames,
+    methodCallChecks: data_1.methodCallChecks,
+    outputNames: data_1.outputNames,
+    propertyNames: data_1.propertyNames,
+    symbolRemoval: data_1.symbolRemoval,
+};
+/**
+ * Gets the reduced upgrade data for the specified data key. The function reads out the
+ * target version and upgrade data object from the migration and resolves the specified
+ * data portion that is specifically tied to the target version.
+ */
+function getVersionUpgradeData(migration, dataName) {
+    if (migration.targetVersion === null) {
+        return [];
+    }
+    // Note that below we need to cast to `unknown` first TS doesn't infer the type of T correctly.
+    return (0, version_changes_1.getChangesForTarget)(migration.targetVersion, migration.upgradeData[dataName]);
+}
+//# sourceMappingURL=upgrade-data.js.map

package/schematics/ng-update/upgrade-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-data.js","sourceRoot":"","sources":["upgrade-data.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAmEH,sDAaC;AA7ED,oEAAmG;AACnG,iCAuBgB;AAEhB,wCAAwC;AAC3B,QAAA,cAAc,GAAgB;IACzC,kBAAkB,EAAlB,yBAAkB;IAClB,UAAU,EAAV,iBAAU;IACV,iBAAiB,EAAjB,wBAAiB;IACjB,YAAY,EAAZ,mBAAY;IACZ,SAAS,EAAT,gBAAS;IACT,gBAAgB,EAAhB,uBAAgB;IAChB,UAAU,EAAV,iBAAU;IACV,gBAAgB,EAAhB,uBAAgB;IAChB,WAAW,EAAX,kBAAW;IACX,aAAa,EAAb,oBAAa;IACb,aAAa,EAAb,oBAAa;CACd,CAAC;AAoBF;;;;GAIG;AACH,SAAgB,qBAAqB,CAGnC,SAAiC,EAAE,QAAW;IAC9C,IAAI,SAAS,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,+FAA+F;IAC/F,OAAO,IAAA,qCAAmB,EACxB,SAAS,CAAC,aAAa,EACvB,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAiC,CAChE,CAAC;AACJ,CAAC"}

package/schematics/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/schematics/paths.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
+ */
+/** Path to the schematic collection for non-migration schematics. */
+export declare const COLLECTION_PATH: string;
+/** Path to the schematic collection that includes the migrations. */
+export declare const MIGRATION_PATH: string;

package/schematics/paths.js

@@ -0,0 +1,16 @@
+"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_PATH = exports.COLLECTION_PATH = void 0;
+const path_1 = require("path");
+/** Path to the schematic collection for non-migration schematics. */
+exports.COLLECTION_PATH = (0, path_1.join)(__dirname, 'collection.json');
+/** Path to the schematic collection that includes the migrations. */
+exports.MIGRATION_PATH = (0, path_1.join)(__dirname, 'migration.json');
+//# sourceMappingURL=paths.js.map

package/schematics/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["paths.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,+BAA0B;AAE1B,qEAAqE;AACxD,QAAA,eAAe,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAElE,qEAAqE;AACxD,QAAA,cAAc,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC"}

package/schematics/update-tool/component-resource-collector.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @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, WorkspacePath } from './file-system';
+import { LineAndCharacter } from './utils/line-mappings';
+export interface ResolvedResource {
+    /** Class declaration that contains this resource. */
+    container: ts.ClassDeclaration | null;
+    /** File content of the given template. */
+    content: string;
+    /** Start offset of the resource content (e.g. in the inline source file) */
+    start: number;
+    /** Whether the given resource is inline or not. */
+    inline: boolean;
+    /** Path to the file that contains this resource. */
+    filePath: WorkspacePath;
+    /**
+     * Gets the character and line of a given position index in the resource.
+     * If the resource is declared inline within a TypeScript source file, the line and
+     * character are based on the full source file content.
+     */
+    getCharacterAndLineOfPosition: (pos: number) => LineAndCharacter;
+}
+/**
+ * Collector that can be used to find Angular templates and stylesheets referenced within
+ * given TypeScript source files (inline or external referenced files)
+ */
+export declare class ComponentResourceCollector {
+    typeChecker: ts.TypeChecker;
+    private _fileSystem;
+    resolvedTemplates: ResolvedResource[];
+    resolvedStylesheets: ResolvedResource[];
+    constructor(typeChecker: ts.TypeChecker, _fileSystem: FileSystem);
+    visitNode(node: ts.Node): void;
+    private _visitClassDeclaration;
+    /** Resolves an external stylesheet by reading its content and computing line mappings. */
+    resolveExternalStylesheet(filePath: WorkspacePath, container: ts.ClassDeclaration | null): ResolvedResource | null;
+    private _trackExternalStylesheet;
+}

package/schematics/update-tool/component-resource-collector.js

@@ -0,0 +1,164 @@
+"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.ComponentResourceCollector = void 0;
+const path_1 = require("path");
+const ts = require("typescript");
+const decorators_1 = require("./utils/decorators");
+const functions_1 = require("./utils/functions");
+const line_mappings_1 = require("./utils/line-mappings");
+const property_name_1 = require("./utils/property-name");
+/**
+ * Collector that can be used to find Angular templates and stylesheets referenced within
+ * given TypeScript source files (inline or external referenced files)
+ */
+class ComponentResourceCollector {
+    constructor(typeChecker, _fileSystem) {
+        this.typeChecker = typeChecker;
+        this._fileSystem = _fileSystem;
+        this.resolvedTemplates = [];
+        this.resolvedStylesheets = [];
+    }
+    visitNode(node) {
+        if (node.kind === ts.SyntaxKind.ClassDeclaration) {
+            this._visitClassDeclaration(node);
+        }
+    }
+    _visitClassDeclaration(node) {
+        const decorators = ts.getDecorators(node);
+        if (!decorators || !decorators.length) {
+            return;
+        }
+        const ngDecorators = (0, decorators_1.getAngularDecorators)(this.typeChecker, decorators);
+        const componentDecorator = ngDecorators.find(dec => dec.name === 'Component');
+        // In case no "@Component" decorator could be found on the current class, skip.
+        if (!componentDecorator) {
+            return;
+        }
+        const decoratorCall = componentDecorator.node.expression;
+        // In case the component decorator call is not valid, skip this class declaration.
+        if (decoratorCall.arguments.length !== 1) {
+            return;
+        }
+        const componentMetadata = (0, functions_1.unwrapExpression)(decoratorCall.arguments[0]);
+        // Ensure that the component metadata is an object literal expression.
+        if (!ts.isObjectLiteralExpression(componentMetadata)) {
+            return;
+        }
+        const sourceFile = node.getSourceFile();
+        const filePath = this._fileSystem.resolve(sourceFile.fileName);
+        const sourceFileDirPath = (0, path_1.dirname)(sourceFile.fileName);
+        // Walk through all component metadata properties and determine the referenced
+        // HTML templates (either external or inline)
+        componentMetadata.properties.forEach(property => {
+            if (!ts.isPropertyAssignment(property)) {
+                return;
+            }
+            const propertyName = (0, property_name_1.getPropertyNameText)(property.name);
+            if (propertyName === 'styles') {
+                const elements = ts.isArrayLiteralExpression(property.initializer)
+                    ? property.initializer.elements
+                    : [property.initializer];
+                elements.forEach(el => {
+                    if (ts.isStringLiteralLike(el)) {
+                        // Need to add an offset of one to the start because the template quotes are
+                        // not part of the template content.
+                        const templateStartIdx = el.getStart() + 1;
+                        const content = stripBom(el.text);
+                        this.resolvedStylesheets.push({
+                            filePath,
+                            container: node,
+                            content,
+                            inline: true,
+                            start: templateStartIdx,
+                            getCharacterAndLineOfPosition: pos => ts.getLineAndCharacterOfPosition(sourceFile, pos + templateStartIdx),
+                        });
+                    }
+                });
+            }
+            // In case there is an inline template specified, ensure that the value is statically
+            // analyzable by checking if the initializer is a string literal-like node.
+            if (propertyName === 'template' && ts.isStringLiteralLike(property.initializer)) {
+                // Need to add an offset of one to the start because the template quotes are
+                // not part of the template content.
+                const templateStartIdx = property.initializer.getStart() + 1;
+                this.resolvedTemplates.push({
+                    filePath,
+                    container: node,
+                    content: property.initializer.text,
+                    inline: true,
+                    start: templateStartIdx,
+                    getCharacterAndLineOfPosition: pos => ts.getLineAndCharacterOfPosition(sourceFile, pos + templateStartIdx),
+                });
+            }
+            if (propertyName === 'styleUrls' && ts.isArrayLiteralExpression(property.initializer)) {
+                property.initializer.elements.forEach(el => {
+                    if (ts.isStringLiteralLike(el)) {
+                        this._trackExternalStylesheet(sourceFileDirPath, el, node);
+                    }
+                });
+            }
+            if (propertyName === 'styleUrl' && ts.isStringLiteralLike(property.initializer)) {
+                this._trackExternalStylesheet(sourceFileDirPath, property.initializer, node);
+            }
+            if (propertyName === 'templateUrl' && ts.isStringLiteralLike(property.initializer)) {
+                const templateUrl = property.initializer.text;
+                const templatePath = this._fileSystem.resolve(sourceFileDirPath, templateUrl);
+                // In case the template does not exist in the file system, skip this
+                // external template.
+                if (!this._fileSystem.fileExists(templatePath)) {
+                    return;
+                }
+                const fileContent = stripBom(this._fileSystem.read(templatePath) || '');
+                if (fileContent) {
+                    const lineStartsMap = (0, line_mappings_1.computeLineStartsMap)(fileContent);
+                    this.resolvedTemplates.push({
+                        filePath: templatePath,
+                        container: node,
+                        content: fileContent,
+                        inline: false,
+                        start: 0,
+                        getCharacterAndLineOfPosition: p => (0, line_mappings_1.getLineAndCharacterFromPosition)(lineStartsMap, p),
+                    });
+                }
+            }
+        });
+    }
+    /** Resolves an external stylesheet by reading its content and computing line mappings. */
+    resolveExternalStylesheet(filePath, container) {
+        // Strip the BOM to avoid issues with the Sass compiler. See:
+        // https://github.com/angular/components/issues/24227#issuecomment-1200934258
+        const fileContent = stripBom(this._fileSystem.read(filePath) || '');
+        if (!fileContent) {
+            return null;
+        }
+        const lineStartsMap = (0, line_mappings_1.computeLineStartsMap)(fileContent);
+        return {
+            filePath: filePath,
+            container: container,
+            content: fileContent,
+            inline: false,
+            start: 0,
+            getCharacterAndLineOfPosition: pos => (0, line_mappings_1.getLineAndCharacterFromPosition)(lineStartsMap, pos),
+        };
+    }
+    _trackExternalStylesheet(sourceFileDirPath, node, container) {
+        const stylesheetPath = this._fileSystem.resolve(sourceFileDirPath, node.text);
+        const stylesheet = this.resolveExternalStylesheet(stylesheetPath, container);
+        if (stylesheet) {
+            this.resolvedStylesheets.push(stylesheet);
+        }
+    }
+}
+exports.ComponentResourceCollector = ComponentResourceCollector;
+/** Strips the BOM from a string. */
+function stripBom(content) {
+    return content.replace(/\uFEFF/g, '');
+}
+//# sourceMappingURL=component-resource-collector.js.map

package/schematics/update-tool/component-resource-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-resource-collector.js","sourceRoot":"","sources":["component-resource-collector.ts"],"names":[],"mappings":"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"}

package/schematics/update-tool/file-system.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @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 { UpdateRecorder } from './update-recorder';
+/**
+ * A workspace path semantically is equivalent to the `Path` type provided by the
+ * Angular devkit. Paths denoted with such a type are guaranteed to be representing
+ * paths of a given virtual file system. This means that the root of a path can be
+ * different, and does not necessarily need to match the root in the real file system.
+ *
+ * For example: Consider we have a project in `/home/<..>/my-project`. Then a path
+ * like `/package.json` could actually refer to the `package.json` file in `my-project`.
+ * Note that in the real file system this would not match though.
+ *
+ * One might wonder why another type has been declared for such paths, when there
+ * already is the `Path` type provided by the devkit. We do this for a couple of reasons:
+ *
+ *   1. The update-tool cannot have a dependency on the Angular devkit as that one
+ *      is not synced into g3. We want to be able to run migrations in g3 if needed.
+ */
+export type WorkspacePath = string & {
+    __PRIVATE_DEVKIT_PATH: void;
+};
+/** Interface that describes a directory. */
+export interface DirectoryEntry {
+    /** List of directories inside the directory. */
+    directories: string[];
+    /** List of files inside the directory. */
+    files: string[];
+}
+/**
+ * Abstraction of the file system that migrations can use to record and apply
+ * changes. This is necessary to support virtual file systems as used in the CLI devkit.
+ */
+export declare abstract class FileSystem {
+    /** Checks whether the given file exists. */
+    abstract fileExists(path: WorkspacePath): boolean;
+    /** Checks whether the given directory exists. */
+    abstract directoryExists(path: WorkspacePath): boolean;
+    /** Gets the contents of the given file. */
+    abstract read(filePath: WorkspacePath): string | null;
+    /** Reads the given directory to retrieve children. */
+    abstract readDirectory(dirPath: WorkspacePath): DirectoryEntry;
+    /**
+     * Creates an update recorder for the given file. Edits can be recorded and
+     * committed in batches. Changes are not applied automatically because otherwise
+     * migrations would need to re-read files, or account for shifted file contents.
+     */
+    abstract edit(filePath: WorkspacePath): UpdateRecorder;
+    /** Applies all changes which have been recorded in update recorders. */
+    abstract commitEdits(): void;
+    /** Creates a new file with the given content. */
+    abstract create(filePath: WorkspacePath, content: string): void;
+    /** Overwrites an existing file with the given content. */
+    abstract overwrite(filePath: WorkspacePath, content: string): void;
+    /** Deletes the given file. */
+    abstract delete(filePath: WorkspacePath): void;
+    /**
+     * Resolves given paths to a resolved path in the file system. For example, the devkit
+     * tree considers the actual workspace directory as file system root.
+     *
+     * Follows the same semantics as the native path `resolve` method. i.e. segments
+     * are processed in reverse. The last segment is considered the target and the
+     * function will iterate from the target through other segments until it finds an
+     * absolute path segment.
+     */
+    abstract resolve(...segments: string[]): WorkspacePath;
+}

package/schematics/update-tool/file-system.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.FileSystem = void 0;
+/**
+ * Abstraction of the file system that migrations can use to record and apply
+ * changes. This is necessary to support virtual file systems as used in the CLI devkit.
+ */
+class FileSystem {
+}
+exports.FileSystem = FileSystem;
+//# sourceMappingURL=file-system.js.map

package/schematics/update-tool/file-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.js","sourceRoot":"","sources":["file-system.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAkCH;;;GAGG;AACH,MAAsB,UAAU;CAiC/B;AAjCD,gCAiCC"}

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

@@ -0,0 +1,74 @@
+/**
+ * @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, WorkspacePath } from './file-system';
+import { UpdateLogger } from './logger';
+import { MigrationCtor } from './migration';
+import { TargetVersion } from './target-version';
+/**
+ * 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.
+ */
+export declare class UpdateProject<Context> {
+    /** Context provided to all migrations. */
+    private _context;
+    /** TypeScript program using workspace paths. */
+    private _program;
+    /** File system used for reading, writing and editing files. */
+    private _fileSystem;
+    /**
+     * Set of analyzed files. Used for avoiding multiple migration runs if
+     * files overlap between targets.
+     */
+    private _analyzedFiles;
+    /** Logger used for printing messages. */
+    private _logger;
+    private readonly _typeChecker;
+    constructor(
+    /** Context provided to all migrations. */
+    _context: Context, 
+    /** TypeScript program using workspace paths. */
+    _program: ts.Program, 
+    /** File system used for reading, writing and editing files. */
+    _fileSystem: FileSystem, 
+    /**
+     * Set of analyzed files. Used for avoiding multiple migration runs if
+     * files overlap between targets.
+     */
+    _analyzedFiles?: Set<WorkspacePath>, 
+    /** Logger used for printing messages. */
+    _logger?: UpdateLogger);
+    /**
+     * 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<Data>(migrationTypes: MigrationCtor<Data, Context>[], target: TargetVersion | null, data: Data, additionalStylesheetPaths?: string[], limitToDirectory?: string): {
+        hasFailures: boolean;
+    };
+    /**
+     * Creates instances of the given migrations with the specified target
+     * version and data.
+     */
+    private _createMigrations;
+    /**
+     * 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: WorkspacePath, fs: FileSystem): ts.Program;
+}