1 | /**
|
---|
2 | * @license
|
---|
3 | * Copyright Google LLC All Rights Reserved.
|
---|
4 | *
|
---|
5 | * Use of this source code is governed by an MIT-style license that can be
|
---|
6 | * found in the LICENSE file at https://angular.io/license
|
---|
7 | */
|
---|
8 | /// <amd-module name="@angular/core/schematics/utils/import_manager" />
|
---|
9 | import * as ts from 'typescript';
|
---|
10 | /** Update recorder for managing imports. */
|
---|
11 | export interface ImportManagerUpdateRecorder {
|
---|
12 | addNewImport(start: number, importText: string): void;
|
---|
13 | updateExistingImport(namedBindings: ts.NamedImports, newNamedBindings: string): void;
|
---|
14 | }
|
---|
15 | /**
|
---|
16 | * Import manager that can be used to add TypeScript imports to given source
|
---|
17 | * files. The manager ensures that multiple transformations are applied properly
|
---|
18 | * without shifted offsets and that similar existing import declarations are re-used.
|
---|
19 | */
|
---|
20 | export declare class ImportManager {
|
---|
21 | private getUpdateRecorder;
|
---|
22 | private printer;
|
---|
23 | /** Map of import declarations that need to be updated to include the given symbols. */
|
---|
24 | private updatedImports;
|
---|
25 | /** Map of source-files and their previously used identifier names. */
|
---|
26 | private usedIdentifierNames;
|
---|
27 | /**
|
---|
28 | * Array of previously resolved symbol imports. Cache can be re-used to return
|
---|
29 | * the same identifier without checking the source-file again.
|
---|
30 | */
|
---|
31 | private importCache;
|
---|
32 | constructor(getUpdateRecorder: (sf: ts.SourceFile) => ImportManagerUpdateRecorder, printer: ts.Printer);
|
---|
33 | /**
|
---|
34 | * Adds an import to the given source-file and returns the TypeScript
|
---|
35 | * identifier that can be used to access the newly imported symbol.
|
---|
36 | */
|
---|
37 | addImportToSourceFile(sourceFile: ts.SourceFile, symbolName: string | null, moduleName: string, typeImport?: boolean): ts.Expression;
|
---|
38 | /**
|
---|
39 | * Stores the collected import changes within the appropriate update recorders. The
|
---|
40 | * updated imports can only be updated *once* per source-file because previous updates
|
---|
41 | * could otherwise shift the source-file offsets.
|
---|
42 | */
|
---|
43 | recordChanges(): void;
|
---|
44 | /** Gets an unique identifier with a base name for the given source file. */
|
---|
45 | private _getUniqueIdentifier;
|
---|
46 | /**
|
---|
47 | * Checks whether the specified identifier name is used within the given
|
---|
48 | * source file.
|
---|
49 | */
|
---|
50 | private isUniqueIdentifierName;
|
---|
51 | private _recordUsedIdentifier;
|
---|
52 | /**
|
---|
53 | * Determines the full end of a given node. By default the end position of a node is
|
---|
54 | * before all trailing comments. This could mean that generated imports shift comments.
|
---|
55 | */
|
---|
56 | private _getEndPositionOfNode;
|
---|
57 | }
|
---|