@angular/compiler-cli 18.2.1 → 18.2.3

package/linker/src/file_linker/partial_linkers/util.d.ts

@@ -7,7 +7,7 @@
  */
 import { MaybeForwardRefExpression, outputAst as o, R3DeclareDependencyMetadata, R3DependencyMetadata, R3Reference } from '@angular/compiler';
 import { AstObject, AstValue } from '../../ast/ast_value';
-export declare const PLACEHOLDER_VERSION = "18.2.1";
+export declare const PLACEHOLDER_VERSION = "18.2.3";
 export declare function wrapReference<TExpression>(wrapped: o.WrappedNodeExpr<TExpression>): R3Reference;
 /**
  * Parses the value of an enum from the AST value's symbol name.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/compiler-cli",
-  "version": "18.2.1",
+  "version": "18.2.3",
   "description": "Angular - the compiler CLI for Node.js",
   "typings": "index.d.ts",
   "bin": {
@@ -53,7 +53,7 @@
     "yargs": "^17.2.1"
   },
   "peerDependencies": {
-    "@angular/compiler": "18.2.1",
+    "@angular/compiler": "18.2.3",
     "typescript": ">=5.4 <5.6"
   },
   "repository": {

package/src/ngtsc/annotations/component/src/handler.d.ts

@@ -68,7 +68,8 @@ export declare class ComponentDecoratorHandler implements DecoratorHandler<Decor
     private readonly enableLetSyntax;
     private readonly localCompilationExtraImportsTracker;
     private readonly jitDeclarationRegistry;
-    constructor(reflector: ReflectionHost, evaluator: PartialEvaluator, metaRegistry: MetadataRegistry, metaReader: MetadataReader, scopeReader: ComponentScopeReader, dtsScopeReader: DtsModuleScopeResolver, scopeRegistry: LocalModuleScopeRegistry, typeCheckScopeRegistry: TypeCheckScopeRegistry, resourceRegistry: ResourceRegistry, isCore: boolean, strictCtorDeps: boolean, resourceLoader: ResourceLoader, rootDirs: ReadonlyArray<string>, defaultPreserveWhitespaces: boolean, i18nUseExternalIds: boolean, enableI18nLegacyMessageIdFormat: boolean, usePoisonedData: boolean, i18nNormalizeLineEndingsInICUs: boolean, moduleResolver: ModuleResolver, cycleAnalyzer: CycleAnalyzer, cycleHandlingStrategy: CycleHandlingStrategy, refEmitter: ReferenceEmitter, referencesRegistry: ReferencesRegistry, depTracker: DependencyTracker | null, injectableRegistry: InjectableClassRegistry, semanticDepGraphUpdater: SemanticDepGraphUpdater | null, annotateForClosureCompiler: boolean, perf: PerfRecorder, hostDirectivesResolver: HostDirectivesResolver, importTracker: ImportedSymbolsTracker, includeClassMetadata: boolean, compilationMode: CompilationMode, deferredSymbolTracker: DeferredSymbolTracker, forbidOrphanRendering: boolean, enableBlockSyntax: boolean, enableLetSyntax: boolean, localCompilationExtraImportsTracker: LocalCompilationExtraImportsTracker | null, jitDeclarationRegistry: JitDeclarationRegistry);
+    private readonly i18nPreserveSignificantWhitespace;
+    constructor(reflector: ReflectionHost, evaluator: PartialEvaluator, metaRegistry: MetadataRegistry, metaReader: MetadataReader, scopeReader: ComponentScopeReader, dtsScopeReader: DtsModuleScopeResolver, scopeRegistry: LocalModuleScopeRegistry, typeCheckScopeRegistry: TypeCheckScopeRegistry, resourceRegistry: ResourceRegistry, isCore: boolean, strictCtorDeps: boolean, resourceLoader: ResourceLoader, rootDirs: ReadonlyArray<string>, defaultPreserveWhitespaces: boolean, i18nUseExternalIds: boolean, enableI18nLegacyMessageIdFormat: boolean, usePoisonedData: boolean, i18nNormalizeLineEndingsInICUs: boolean, moduleResolver: ModuleResolver, cycleAnalyzer: CycleAnalyzer, cycleHandlingStrategy: CycleHandlingStrategy, refEmitter: ReferenceEmitter, referencesRegistry: ReferencesRegistry, depTracker: DependencyTracker | null, injectableRegistry: InjectableClassRegistry, semanticDepGraphUpdater: SemanticDepGraphUpdater | null, annotateForClosureCompiler: boolean, perf: PerfRecorder, hostDirectivesResolver: HostDirectivesResolver, importTracker: ImportedSymbolsTracker, includeClassMetadata: boolean, compilationMode: CompilationMode, deferredSymbolTracker: DeferredSymbolTracker, forbidOrphanRendering: boolean, enableBlockSyntax: boolean, enableLetSyntax: boolean, localCompilationExtraImportsTracker: LocalCompilationExtraImportsTracker | null, jitDeclarationRegistry: JitDeclarationRegistry, i18nPreserveSignificantWhitespace: boolean);
     private literalCache;
     private elementSchemaRegistry;
     /**

package/src/ngtsc/annotations/component/src/resources.d.ts

@@ -101,6 +101,7 @@ export interface ExtractTemplateOptions {
     i18nNormalizeLineEndingsInICUs: boolean;
     enableBlockSyntax: boolean;
     enableLetSyntax: boolean;
+    preserveSignificantWhitespace?: boolean;
 }
 export declare function extractTemplate(node: ClassDeclaration, template: TemplateDeclaration, evaluator: PartialEvaluator, depTracker: DependencyTracker | null, resourceLoader: ResourceLoader, options: ExtractTemplateOptions, compilationMode: CompilationMode): ParsedTemplateWithSource;
 export declare function parseTemplateDeclaration(node: ClassDeclaration, decorator: Decorator, component: Map<string, ts.Expression>, containingFile: string, evaluator: PartialEvaluator, depTracker: DependencyTracker | null, resourceLoader: ResourceLoader, defaultPreserveWhitespaces: boolean): TemplateDeclaration;

package/src/ngtsc/core/api/src/public_options.d.ts

@@ -357,6 +357,13 @@ export interface I18nOptions {
      * The default is `false`, but this will be switched in a future major release.
      */
     i18nNormalizeLineEndingsInICUs?: boolean;
+    /**
+     * Whether or not to preserve whitespace when extracting messages with the legacy (View Engine)
+     * pipeline.
+     *
+     * Defaults to `true`.
+     */
+    i18nPreserveWhitespaceForLegacyExtraction?: boolean;
 }
 /**
  * Options that specify compilation target.

package/src/ngtsc/core/src/compiler.d.ts

@@ -240,8 +240,13 @@ export declare class NgCompiler {
      *
      * @param entryPoint Path to the entry point for the package for which API
      *     docs should be extracted.
+     *
+     * @returns A map of symbols with their associated module, eg: ApplicationRef => @angular/core
      */
-    getApiDocumentation(entryPoint: string): DocEntry[];
+    getApiDocumentation(entryPoint: string): {
+        entries: DocEntry[];
+        symbols: Map<string, string>;
+    };
     /**
      * Collect i18n messages into the `Xi18nContext`.
      */

package/src/ngtsc/docs/src/entities.d.ts

@@ -5,6 +5,13 @@
  * 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
  */
+/** The JSON data file format for extracted API reference info. */
+export interface EntryCollection {
+    moduleName: string;
+    normalizedModuleName: string;
+    moduleLabel: string;
+    entries: DocEntry[];
+}
 /** Type of top-level documentation entry. */
 export declare enum EntryType {
     Block = "block",
@@ -84,6 +91,8 @@ export interface ClassEntry extends DocEntry {
     isAbstract: boolean;
     members: MemberEntry[];
     generics: GenericEntry[];
+    extends?: string;
+    implements: string[];
 }
 /** Documentation entity for a TypeScript interface. */
 export type InterfaceEntry = ClassEntry;

package/src/ngtsc/docs/src/extractor.d.ts

@@ -22,7 +22,10 @@ export declare class DocsExtractor {
      *
      * @param sourceFile The file from which to extract documentable entries.
      */
-    extractAll(sourceFile: ts.SourceFile, rootDir: string): DocEntry[];
+    extractAll(sourceFile: ts.SourceFile, rootDir: string): {
+        entries: DocEntry[];
+        symbols: Map<string, string>;
+    };
     /** Extract the doc entry for a single declaration. */
     private extractDeclaration;
     /** Gets the list of exported declarations for doc extraction. */

package/src/ngtsc/docs/src/import_extractor.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.io/license
+ */
+import ts from 'typescript';
+/**
+ * For a given SourceFile, it extracts all imported symbols from other Angular packages.
+ *
+ * @returns a map Symbol => Package, eg: ApplicationRef => @angular/core
+ */
+export declare function getImportedSymbols(sourceFile: ts.SourceFile): Map<string, string>;

package/src/ngtsc/program.d.ts

@@ -55,6 +55,9 @@ export declare class NgtscProgram implements api.Program {
      * @param entryPoint Path to the entry point for the package for which API
      *     docs should be extracted.
      */
-    getApiDocumentation(entryPoint: string): DocEntry[];
+    getApiDocumentation(entryPoint: string): {
+        entries: DocEntry[];
+        symbols: Map<string, string>;
+    };
     getEmittedSourceFiles(): Map<string, ts.SourceFile>;
 }