@angular/compiler-cli 15.2.0 → 16.0.0-next.0

package/ngcc/src/writing/cleaning/cleaning_strategies.d.ts

@@ -1,44 +0,0 @@
-/**
- * @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.io/license
- */
-import { AbsoluteFsPath, FileSystem, PathSegment } from '../../../../src/ngtsc/file_system';
-/**
- * Implement this interface to extend the cleaning strategies of the `PackageCleaner`.
- */
-export interface CleaningStrategy {
-    canClean(path: AbsoluteFsPath, basename: PathSegment): boolean;
-    clean(path: AbsoluteFsPath, basename: PathSegment): void;
-}
-/**
- * A CleaningStrategy that reverts changes to package.json files by removing the build marker and
- * other properties.
- */
-export declare class PackageJsonCleaner implements CleaningStrategy {
-    private fs;
-    constructor(fs: FileSystem);
-    canClean(_path: AbsoluteFsPath, basename: PathSegment): boolean;
-    clean(path: AbsoluteFsPath, _basename: PathSegment): void;
-}
-/**
- * A CleaningStrategy that removes the extra directory containing generated entry-point formats.
- */
-export declare class NgccDirectoryCleaner implements CleaningStrategy {
-    private fs;
-    constructor(fs: FileSystem);
-    canClean(path: AbsoluteFsPath, basename: PathSegment): boolean;
-    clean(path: AbsoluteFsPath, _basename: PathSegment): void;
-}
-/**
- * A CleaningStrategy that reverts files that were overwritten and removes the backup files that
- * ngcc created.
- */
-export declare class BackupFileCleaner implements CleaningStrategy {
-    private fs;
-    constructor(fs: FileSystem);
-    canClean(path: AbsoluteFsPath, basename: PathSegment): boolean;
-    clean(path: AbsoluteFsPath, _basename: PathSegment): void;
-}

package/ngcc/src/writing/cleaning/package_cleaner.d.ts

@@ -1,38 +0,0 @@
-/**
- * @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.io/license
- */
-import { AbsoluteFsPath, FileSystem, ReadonlyFileSystem } from '../../../../src/ngtsc/file_system';
-import { EntryPoint } from '../../packages/entry_point';
-import { CleaningStrategy } from './cleaning_strategies';
-/**
- * A class that can clean ngcc artifacts from a directory.
- */
-export declare class PackageCleaner {
-    private fs;
-    private cleaners;
-    constructor(fs: ReadonlyFileSystem, cleaners: CleaningStrategy[]);
-    /**
-     * Recurse through the file-system cleaning files and directories as determined by the configured
-     * cleaning-strategies.
-     *
-     * @param directory the current directory to clean
-     */
-    clean(directory: AbsoluteFsPath): void;
-}
-/**
- * Iterate through the given `entryPoints` identifying the package for each that has at least one
- * outdated processed format, then cleaning those packages.
- *
- * Note that we have to clean entire packages because there is no clear file-system boundary
- * between entry-points within a package. So if one entry-point is outdated we have to clean
- * everything within that package.
- *
- * @param fileSystem the current file-system
- * @param entryPoints the entry-points that have been collected for this run of ngcc
- * @returns true if packages needed to be cleaned.
- */
-export declare function cleanOutdatedPackages(fileSystem: FileSystem, entryPoints: EntryPoint[]): boolean;

package/ngcc/src/writing/cleaning/utils.d.ts

@@ -1,15 +0,0 @@
-/**
- * @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.io/license
- */
-import { AbsoluteFsPath, ReadonlyFileSystem } from '../../../../src/ngtsc/file_system';
-/**
- * Returns true if the given `path` is a directory (not a symlink) and actually exists.
- *
- * @param fs the current filesystem
- * @param path the path to check
- */
-export declare function isLocalDirectory(fs: ReadonlyFileSystem, path: AbsoluteFsPath): boolean;

package/ngcc/src/writing/file_writer.d.ts

@@ -1,28 +0,0 @@
-/**
- * @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.io/license
- */
-import { AbsoluteFsPath } from '../../../src/ngtsc/file_system';
-import { EntryPoint, EntryPointJsonProperty } from '../packages/entry_point';
-import { EntryPointBundle } from '../packages/entry_point_bundle';
-import { FileToWrite } from '../rendering/utils';
-/**
- * Responsible for writing out the transformed files to disk.
- */
-export interface FileWriter {
-    writeBundle(bundle: EntryPointBundle, transformedFiles: FileToWrite[], formatProperties: EntryPointJsonProperty[]): void;
-    /**
-     * Revert the changes to an entry-point processed for the specified format-properties by the same
-     * `FileWriter` implementation.
-     *
-     * @param entryPoint The entry-point to revert.
-     * @param transformedFilePaths The original paths of the transformed files. (The transformed files
-     *     may be written at the same or a different location, depending on the `FileWriter`
-     *     implementation.)
-     * @param formatProperties The format-properties pointing to the entry-point.
-     */
-    revertBundle(entryPoint: EntryPoint, transformedFilePaths: AbsoluteFsPath[], formatProperties: EntryPointJsonProperty[]): void;
-}

package/ngcc/src/writing/in_place_file_writer.d.ts

@@ -1,28 +0,0 @@
-/**
- * @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.io/license
- */
-import { AbsoluteFsPath, FileSystem } from '../../../src/ngtsc/file_system';
-import { Logger } from '../../../src/ngtsc/logging';
-import { EntryPoint, EntryPointJsonProperty } from '../packages/entry_point';
-import { EntryPointBundle } from '../packages/entry_point_bundle';
-import { FileToWrite } from '../rendering/utils';
-import { FileWriter } from './file_writer';
-export declare const NGCC_BACKUP_EXTENSION = ".__ivy_ngcc_bak";
-/**
- * This FileWriter overwrites the transformed file, in-place, while creating
- * a back-up of the original file with an extra `.__ivy_ngcc_bak` extension.
- */
-export declare class InPlaceFileWriter implements FileWriter {
-    protected fs: FileSystem;
-    protected logger: Logger;
-    protected errorOnFailedEntryPoint: boolean;
-    constructor(fs: FileSystem, logger: Logger, errorOnFailedEntryPoint: boolean);
-    writeBundle(_bundle: EntryPointBundle, transformedFiles: FileToWrite[], _formatProperties?: EntryPointJsonProperty[]): void;
-    revertBundle(_entryPoint: EntryPoint, transformedFilePaths: AbsoluteFsPath[], _formatProperties: EntryPointJsonProperty[]): void;
-    protected writeFileAndBackup(file: FileToWrite): void;
-    protected revertFileAndBackup(filePath: AbsoluteFsPath): void;
-}

package/ngcc/src/writing/new_entry_point_file_writer.d.ts

@@ -1,48 +0,0 @@
-/**
- * @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.io/license
- */
-import { AbsoluteFsPath, FileSystem } from '../../../src/ngtsc/file_system';
-import { Logger } from '../../../src/ngtsc/logging';
-import { EntryPoint, EntryPointJsonProperty } from '../packages/entry_point';
-import { EntryPointBundle } from '../packages/entry_point_bundle';
-import { FileToWrite } from '../rendering/utils';
-import { InPlaceFileWriter } from './in_place_file_writer';
-import { PackageJsonUpdater } from './package_json_updater';
-export declare const NGCC_DIRECTORY = "__ivy_ngcc__";
-export declare const NGCC_PROPERTY_EXTENSION = "_ivy_ngcc";
-/**
- * This FileWriter creates a copy of the original entry-point, then writes the transformed
- * files onto the files in this copy, and finally updates the package.json with a new
- * entry-point format property that points to this new entry-point.
- *
- * If there are transformed typings files in this bundle, they are updated in-place (see the
- * `InPlaceFileWriter`).
- */
-export declare class NewEntryPointFileWriter extends InPlaceFileWriter {
-    private pkgJsonUpdater;
-    constructor(fs: FileSystem, logger: Logger, errorOnFailedEntryPoint: boolean, pkgJsonUpdater: PackageJsonUpdater);
-    writeBundle(bundle: EntryPointBundle, transformedFiles: FileToWrite[], formatProperties: EntryPointJsonProperty[]): void;
-    revertBundle(entryPoint: EntryPoint, transformedFilePaths: AbsoluteFsPath[], formatProperties: EntryPointJsonProperty[]): void;
-    protected copyBundle(bundle: EntryPointBundle, packagePath: AbsoluteFsPath, ngccFolder: AbsoluteFsPath, transformedFiles: FileToWrite[]): void;
-    /**
-     * If a source file has an associated source-map, then copy this, while updating its sourceRoot
-     * accordingly.
-     *
-     * For now don't try to parse the source for inline source-maps or external source-map links,
-     * since that is more complex and will slow ngcc down.
-     * Instead just check for a source-map file residing next to the source file, which is by far
-     * the most common case.
-     *
-     * @param originalSrcPath absolute path to the original source file being copied.
-     * @param newSrcPath absolute path to where the source will be written.
-     */
-    protected copyAndUpdateSourceMap(originalSrcPath: AbsoluteFsPath, newSrcPath: AbsoluteFsPath): void;
-    protected writeFile(file: FileToWrite, packagePath: AbsoluteFsPath, ngccFolder: AbsoluteFsPath): void;
-    protected revertFile(filePath: AbsoluteFsPath, packagePath: AbsoluteFsPath): void;
-    protected updatePackageJson(entryPoint: EntryPoint, formatProperties: EntryPointJsonProperty[], ngccFolder: AbsoluteFsPath): void;
-    protected revertPackageJson(entryPoint: EntryPoint, formatProperties: EntryPointJsonProperty[]): void;
-}

package/ngcc/src/writing/package_json_updater.d.ts

@@ -1,98 +0,0 @@
-/**
- * @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.io/license
- */
-import { AbsoluteFsPath, FileSystem } from '../../../src/ngtsc/file_system';
-import { JsonObject, JsonValue } from '../utils';
-export type PackageJsonChange = [string[], JsonValue, PackageJsonPropertyPositioning];
-export type PackageJsonPropertyPositioning = 'unimportant' | 'alphabetic' | {
-    before: string;
-};
-export type WritePackageJsonChangesFn = (changes: PackageJsonChange[], packageJsonPath: AbsoluteFsPath, parsedJson?: JsonObject) => void;
-/**
- * A utility object that can be used to safely update values in a `package.json` file.
- *
- * Example usage:
- * ```ts
- * const updatePackageJson = packageJsonUpdater
- *     .createUpdate()
- *     .addChange(['name'], 'package-foo')
- *     .addChange(['scripts', 'foo'], 'echo FOOOO...', 'unimportant')
- *     .addChange(['dependencies', 'baz'], '1.0.0', 'alphabetic')
- *     .addChange(['dependencies', 'bar'], '2.0.0', {before: 'baz'})
- *     .writeChanges('/foo/package.json');
- *     // or
- *     // .writeChanges('/foo/package.json', inMemoryParsedJson);
- * ```
- */
-export interface PackageJsonUpdater {
-    /**
-     * Create a `PackageJsonUpdate` object, which provides a fluent API for batching updates to a
-     * `package.json` file. (Batching the updates is useful, because it avoids unnecessary I/O
-     * operations.)
-     */
-    createUpdate(): PackageJsonUpdate;
-    /**
-     * Write a set of changes to the specified `package.json` file (and optionally a pre-existing,
-     * in-memory representation of it).
-     *
-     * @param changes The set of changes to apply.
-     * @param packageJsonPath The path to the `package.json` file that needs to be updated.
-     * @param parsedJson A pre-existing, in-memory representation of the `package.json` file that
-     *                   needs to be updated as well.
-     */
-    writeChanges(changes: PackageJsonChange[], packageJsonPath: AbsoluteFsPath, parsedJson?: JsonObject): void;
-}
-/**
- * A utility class providing a fluent API for recording multiple changes to a `package.json` file
- * (and optionally its in-memory parsed representation).
- *
- * NOTE: This class should generally not be instantiated directly; instances are implicitly created
- *       via `PackageJsonUpdater#createUpdate()`.
- */
-export declare class PackageJsonUpdate {
-    private writeChangesImpl;
-    private changes;
-    private applied;
-    constructor(writeChangesImpl: WritePackageJsonChangesFn);
-    /**
-     * Record a change to a `package.json` property.
-     *
-     * If the ancestor objects do not yet exist in the `package.json` file, they will be created. The
-     * positioning of the property can also be specified. (If the property already exists, it will be
-     * moved accordingly.)
-     *
-     * NOTE: Property positioning is only guaranteed to be respected in the serialized `package.json`
-     *       file. Positioning will not be taken into account when updating in-memory representations.
-     *
-     * NOTE 2: Property positioning only affects the last property in `propertyPath`. Ancestor
-     *         objects' positioning will not be affected.
-     *
-     * @param propertyPath The path of a (possibly nested) property to add/update.
-     * @param value The new value to set the property to.
-     * @param position The desired position for the added/updated property.
-     */
-    addChange(propertyPath: string[], value: JsonValue, positioning?: PackageJsonPropertyPositioning): this;
-    /**
-     * Write the recorded changes to the associated `package.json` file (and optionally a
-     * pre-existing, in-memory representation of it).
-     *
-     * @param packageJsonPath The path to the `package.json` file that needs to be updated.
-     * @param parsedJson A pre-existing, in-memory representation of the `package.json` file that
-     *                   needs to be updated as well.
-     */
-    writeChanges(packageJsonPath: AbsoluteFsPath, parsedJson?: JsonObject): void;
-    private ensureNotApplied;
-    private ensureNotSynthesized;
-}
-/** A `PackageJsonUpdater` that writes directly to the file-system. */
-export declare class DirectPackageJsonUpdater implements PackageJsonUpdater {
-    private fs;
-    constructor(fs: FileSystem);
-    createUpdate(): PackageJsonUpdate;
-    writeChanges(changes: PackageJsonChange[], packageJsonPath: AbsoluteFsPath, preExistingParsedJson?: JsonObject): void;
-}
-export declare function applyChange(ctx: JsonObject, propPath: string[], value: JsonValue, positioning: PackageJsonPropertyPositioning): void;

package/src/ngtsc/shims/src/factory_generator.d.ts

@@ -1,24 +0,0 @@
-/**
- * @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.io/license
- */
-import ts from 'typescript';
-import { AbsoluteFsPath } from '../../file_system';
-import { ImportRewriter } from '../../imports';
-import { FactoryInfo, FactoryTracker, ModuleInfo, PerFileShimGenerator } from '../api';
-/**
- * Generates ts.SourceFiles which contain variable declarations for NgFactories for every exported
- * class of an input ts.SourceFile.
- */
-export declare class FactoryGenerator implements PerFileShimGenerator, FactoryTracker {
-    readonly sourceInfo: Map<string, FactoryInfo>;
-    private sourceToFactorySymbols;
-    readonly shouldEmit = true;
-    readonly extensionPrefix = "ngfactory";
-    generateShimForFile(sf: ts.SourceFile, genFilePath: AbsoluteFsPath): ts.SourceFile;
-    track(sf: ts.SourceFile, moduleInfo: ModuleInfo): void;
-}
-export declare function generatedFactoryTransform(factoryMap: Map<string, FactoryInfo>, importRewriter: ImportRewriter): ts.TransformerFactory<ts.SourceFile>;

package/src/ngtsc/shims/src/summary_generator.d.ts

@@ -1,15 +0,0 @@
-/**
- * @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.io/license
- */
-import ts from 'typescript';
-import { AbsoluteFsPath } from '../../file_system';
-import { PerFileShimGenerator } from '../api';
-export declare class SummaryGenerator implements PerFileShimGenerator {
-    readonly shouldEmit = true;
-    readonly extensionPrefix = "ngsummary";
-    generateShimForFile(sf: ts.SourceFile, genFilePath: AbsoluteFsPath): ts.SourceFile;
-}