@angular/compiler-cli 21.0.0-next.9 → 21.0.0-rc.1

package/bundles/src/bin/ng_xi18n.js

@@ -6,12 +6,12 @@
 import {
   main,
   readCommandLineAndConfiguration
-} from "../../chunk-IE2YQNTQ.js";
+} from "../../chunk-YVYYMXOI.js";
 import {
   EmitFlags
-} from "../../chunk-SIOKS4LN.js";
-import "../../chunk-HRLHX4UA.js";
-import "../../chunk-3UF7UI6H.js";
+} from "../../chunk-DBAV4W4V.js";
+import "../../chunk-5UJIUEKT.js";
+import "../../chunk-VBBJY6IR.js";
 import "../../chunk-LS5RJ5CS.js";
 import {
   setFileSystem

package/bundles/src/bin/ngc.js

@@ -5,10 +5,10 @@
     
 import {
   main
-} from "../../chunk-IE2YQNTQ.js";
-import "../../chunk-SIOKS4LN.js";
-import "../../chunk-HRLHX4UA.js";
-import "../../chunk-3UF7UI6H.js";
+} from "../../chunk-YVYYMXOI.js";
+import "../../chunk-DBAV4W4V.js";
+import "../../chunk-5UJIUEKT.js";
+import "../../chunk-VBBJY6IR.js";
 import "../../chunk-LS5RJ5CS.js";
 import {
   setFileSystem

package/index.d.ts

@@ -11,6 +11,6 @@ export { NgTscPlugin, PluginCompilerHost } from './src/ngtsc/tsc_plugin';
 export { NgtscProgram } from './src/ngtsc/program';
 export { OptimizeFor } from './src/ngtsc/typecheck/api';
 export { ConsoleLogger, Logger, LogLevel } from './src/ngtsc/logging';
-export { NodeJSFileSystem, absoluteFrom, FileSystem, AbsoluteFsPath } from './src/ngtsc/file_system';
+export { NodeJSFileSystem, absoluteFrom, FileSystem, AbsoluteFsPath, NgtscCompilerHost, getFileSystem, setFileSystem, isLocalRelativePath, } from './src/ngtsc/file_system';
 export * from './src/ngtsc/docs';
 export { isLocalCompilationDiagnostics, ErrorCode, ngErrorCode } from './src/ngtsc/diagnostics';

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 = "21.0.0-next.9";
+export declare const PLACEHOLDER_VERSION = "21.0.0-rc.1";
 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": "21.0.0-next.9",
+  "version": "21.0.0-rc.1",
   "description": "Angular - the compiler CLI for Node.js",
   "typings": "index.d.ts",
   "bin": {
@@ -24,17 +24,9 @@
       "types": "./linker/babel/index.d.ts",
       "default": "./bundles/linker/babel/index.js"
     },
-    "./private/localize": {
-      "types": "./private/localize.d.ts",
-      "default": "./bundles/private/localize.js"
-    },
-    "./private/migrations": {
-      "types": "./private/migrations.d.ts",
-      "default": "./bundles/private/migrations.js"
-    },
-    "./private/tooling": {
-      "types": "./private/tooling.d.ts",
-      "default": "./bundles/private/tooling.js"
+    "./private/*": {
+      "types": "./private/*.d.ts",
+      "default": "./bundles/private/*.js"
     }
   },
   "dependencies": {
@@ -48,7 +40,7 @@
     "yargs": "^18.0.0"
   },
   "peerDependencies": {
-    "@angular/compiler": "21.0.0-next.9",
+    "@angular/compiler": "21.0.0-rc.1",
     "typescript": ">=5.9 <6.0"
   },
   "peerDependenciesMeta": {

package/private/migrations.d.ts

@@ -9,10 +9,16 @@
  * @fileoverview The API from compiler-cli that the `@angular/core`
  * package requires for migration schematics.
  */
-export { createForwardRefResolver } from '../src/ngtsc/annotations';
-export { AbsoluteFsPath } from '../src/ngtsc/file_system';
-export { Reference } from '../src/ngtsc/imports';
+export { createForwardRefResolver, ExternalTemplateDeclaration, extractDecoratorQueryMetadata, extractTemplate, findAngularDecorator, getAngularDecorators, InlineTemplateDeclaration, queryDecoratorNames, QueryFunctionName, ResourceLoader, unwrapExpression, parseDecoratorInputTransformFunction, } from '../src/ngtsc/annotations';
+export { AbsoluteFsPath, FileSystem, getFileSystem, isLocalRelativePath, NodeJSFileSystem, } from '../src/ngtsc/file_system';
+export { CompilationMode } from '../src/ngtsc/transform';
+export { DiagnosticCategoryLabel, NgCompiler, NgCompilerOptions, UnifiedModulesHost, } from '../src/ngtsc/core';
+export { Reference, ReferenceEmitter, ReferenceEmitKind } from '../src/ngtsc/imports';
+export { DecoratorInputTransform, DtsMetadataReader, MetadataReader, DirectiveMeta, InputMapping, } from '../src/ngtsc/metadata';
 export { DynamicValue, PartialEvaluator, ResolvedValue, ResolvedValueMap, StaticInterpreter, } from '../src/ngtsc/partial_evaluator';
-export { reflectObjectLiteral, TypeScriptReflectionHost } from '../src/ngtsc/reflection';
-export { PotentialImport, PotentialImportKind, PotentialImportMode, TemplateTypeChecker, } from '../src/ngtsc/typecheck/api';
+export { ClassDeclaration, Decorator, ReflectionHost, reflectObjectLiteral, TypeScriptReflectionHost, } from '../src/ngtsc/reflection';
+export { PotentialImport, PotentialImportKind, PotentialImportMode, SymbolKind, TemplateTypeChecker, } from '../src/ngtsc/typecheck/api';
+export { getRootDirs } from '../src/ngtsc/util/src/typescript';
+export { FatalDiagnosticError } from '../src/ngtsc/diagnostics';
+export { isShim } from '../src/ngtsc/shims';
 export { ImportManager } from '../src/ngtsc/translator';

package/private/testing.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
+ */
+export { ImportedSymbolsTracker } from '../src/ngtsc/imports';
+export { TypeScriptReflectionHost } from '../src/ngtsc/reflection';
+export { getInitializerApiJitTransform } from '../src/ngtsc/transform/jit';
+export { initMockFileSystem, MockFileSystem } from '../src/ngtsc/file_system/testing';

package/src/ngtsc/annotations/index.d.ts

@@ -5,9 +5,10 @@
  * 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 { createForwardRefResolver, findAngularDecorator, getAngularDecorators, isAngularDecorator, NoopReferencesRegistry, ReferencesRegistry, ResourceLoader, ResourceLoaderContext, JitDeclarationRegistry, } from './common';
+export { createForwardRefResolver, findAngularDecorator, getAngularDecorators, isAngularDecorator, NoopReferencesRegistry, ReferencesRegistry, ResourceLoader, ResourceLoaderContext, JitDeclarationRegistry, unwrapExpression, } from './common';
 export { ComponentDecoratorHandler } from './component';
-export { DirectiveDecoratorHandler, InitializerApiFunction, INPUT_INITIALIZER_FN, MODEL_INITIALIZER_FN, OUTPUT_INITIALIZER_FNS, QUERY_INITIALIZER_FNS, queryDecoratorNames, QueryFunctionName, tryParseInitializerApi, tryParseInitializerBasedOutput, tryParseSignalInputMapping, tryParseSignalModelMapping, tryParseSignalQueryFromInitializer, } from './directive';
+export { extractTemplate, ExternalTemplateDeclaration, InlineTemplateDeclaration, } from './component/src/resources';
+export { DirectiveDecoratorHandler, InitializerApiFunction, INPUT_INITIALIZER_FN, MODEL_INITIALIZER_FN, OUTPUT_INITIALIZER_FNS, QUERY_INITIALIZER_FNS, queryDecoratorNames, QueryFunctionName, tryParseInitializerApi, tryParseInitializerBasedOutput, tryParseSignalInputMapping, tryParseSignalModelMapping, tryParseSignalQueryFromInitializer, extractDecoratorQueryMetadata, parseDecoratorInputTransformFunction, } from './directive';
 export { NgModuleDecoratorHandler } from './ng_module';
 export { InjectableDecoratorHandler } from './src/injectable';
 export { PipeDecoratorHandler } from './src/pipe';

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

@@ -7,3 +7,4 @@
  */
 export * from './src/compiler';
 export { NgCompilerHost } from './src/host';
+export { UnifiedModulesHost, NgCompilerOptions, DiagnosticCategoryLabel } from './api';

package/src/ngtsc/diagnostics/src/error_code.d.ts

@@ -365,6 +365,8 @@ export declare enum ErrorCode {
      * prefetch timer delay that is not earlier than the main timer, or an identical prefetch
      */
     DEFER_TRIGGER_MISCONFIGURATION = 8021,
+    /** Raised when the user has an unsupported binding on a `Field` directive. */
+    FORM_FIELD_UNSUPPORTED_BINDING = 8022,
     /**
      * A two way binding in a template has an incorrect syntax,
      * parentheses outside brackets. For example:

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

@@ -29,7 +29,8 @@ export declare enum EntryType {
     Pipe = "pipe",
     TypeAlias = "type_alias",
     UndecoratedClass = "undecorated_class",
-    InitializerApiFunction = "initializer_api_function"
+    InitializerApiFunction = "initializer_api_function",
+    Namespace = "namespace"
 }
 /** Types of class members */
 export declare enum MemberType {
@@ -89,6 +90,7 @@ export interface ConstantEntry extends DocEntry {
 /** Documentation entity for a type alias. */
 export interface TypeAliasEntry extends ConstantEntry {
     generics: GenericEntry[];
+    members?: DocEntry[];
 }
 /** Documentation entity for a TypeScript class. */
 export interface ClassEntry extends DocEntry {
@@ -176,6 +178,10 @@ export interface FunctionDefinitionEntry {
     signatures: FunctionSignatureMetadata[];
     implementation: FunctionSignatureMetadata | null;
 }
+/** Documentation entity for a TypeScript namespace. */
+export interface NamespaceEntry extends DocEntry {
+    members: DocEntry[];
+}
 /**
  * Docs entry describing an initializer API function.
  *

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

@@ -26,6 +26,12 @@ export declare class DocsExtractor {
         entries: DocEntry[];
         symbols: Map<string, string>;
     };
+    /**
+     * Extracts a documentation entry for a given set of declarations that are all exported under
+     * the same name. This is used to combine entries, e.g. for a type and a namespace that are
+     * exported under the same name.
+     */
+    private extractDeclarations;
     /** Extract the doc entry for a single declaration. */
     private extractDeclaration;
     /** Gets the list of exported declarations for doc extraction. */

package/src/ngtsc/docs/src/namespace_extractor.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
+ */
+import ts from 'typescript';
+import { NamespaceEntry } from './entities';
+/**
+ * Extracts documentation entry for a TypeScript namespace.
+ * @param node The TypeScript AST node for the namespace.
+ * @param typeChecker The TypeScript type checker.
+ */
+export declare function extractNamespace(node: ts.ModuleDeclaration, typeChecker: ts.TypeChecker): NamespaceEntry;

package/src/ngtsc/docs/src/variable_extractor.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 ts from 'typescript';
+import { DocEntry } from './entities';
+/**
+ * Extracts documentation entries from a variable statement. A variable statement can have
+ * multiple declarations, so this function extracts a doc entry for each declaration.
+ * @param statement The TypeScript AST node for the variable statement.
+ * @param typeChecker The TypeScript type checker.
+ */
+export declare function extractFromVariableStatement(statement: ts.VariableStatement, typeChecker: ts.TypeChecker): DocEntry[];

package/src/ngtsc/file_system/testing/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @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 { Folder, MockFileSystem } from './src/mock_file_system';
+export { MockFileSystemNative } from './src/mock_file_system_native';
+export { MockFileSystemPosix } from './src/mock_file_system_posix';
+export { MockFileSystemWindows } from './src/mock_file_system_windows';
+export { initMockFileSystem, runInEachFileSystem, TestFile } from './src/test_helper';

package/src/ngtsc/file_system/testing/src/mock_file_system.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @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 { AbsoluteFsPath, FileStats, FileSystem, PathSegment, PathString } from '../../src/types';
+/**
+ * An in-memory file system that can be used in unit tests.
+ */
+export declare abstract class MockFileSystem implements FileSystem {
+    private _isCaseSensitive;
+    private _fileTree;
+    private _cwd;
+    constructor(_isCaseSensitive?: boolean, cwd?: AbsoluteFsPath);
+    isCaseSensitive(): boolean;
+    exists(path: AbsoluteFsPath): boolean;
+    readFile(path: AbsoluteFsPath): string;
+    readFileBuffer(path: AbsoluteFsPath): Uint8Array;
+    writeFile(path: AbsoluteFsPath, data: string | Uint8Array, exclusive?: boolean): void;
+    removeFile(path: AbsoluteFsPath): void;
+    symlink(target: AbsoluteFsPath, path: AbsoluteFsPath): void;
+    readdir(path: AbsoluteFsPath): PathSegment[];
+    lstat(path: AbsoluteFsPath): FileStats;
+    stat(path: AbsoluteFsPath): FileStats;
+    copyFile(from: AbsoluteFsPath, to: AbsoluteFsPath): void;
+    moveFile(from: AbsoluteFsPath, to: AbsoluteFsPath): void;
+    ensureDir(path: AbsoluteFsPath): Folder;
+    removeDeep(path: AbsoluteFsPath): void;
+    isRoot(path: AbsoluteFsPath): boolean;
+    extname(path: AbsoluteFsPath | PathSegment): string;
+    realpath(filePath: AbsoluteFsPath): AbsoluteFsPath;
+    pwd(): AbsoluteFsPath;
+    chdir(path: AbsoluteFsPath): void;
+    getDefaultLibLocation(): AbsoluteFsPath;
+    abstract resolve(...paths: string[]): AbsoluteFsPath;
+    abstract dirname<T extends string>(file: T): T;
+    abstract join<T extends string>(basePath: T, ...paths: string[]): T;
+    abstract relative<T extends PathString>(from: T, to: T): PathSegment | AbsoluteFsPath;
+    abstract basename(filePath: string, extension?: string): PathSegment;
+    abstract isRooted(path: string): boolean;
+    abstract normalize<T extends PathString>(path: T): T;
+    protected abstract splitPath<T extends PathString>(path: T): string[];
+    dump(): Folder;
+    init(folder: Folder): void;
+    mount(path: AbsoluteFsPath, folder: Folder): void;
+    private cloneFolder;
+    private copyInto;
+    protected findFromPath(path: AbsoluteFsPath, options?: {
+        followSymLinks: boolean;
+    }): FindResult;
+    protected splitIntoFolderAndFile(path: AbsoluteFsPath): [AbsoluteFsPath, string];
+    protected getCanonicalPath<T extends string>(p: T): T;
+}
+export interface FindResult {
+    path: AbsoluteFsPath;
+    entity: Entity | null;
+}
+export type Entity = Folder | File | SymLink;
+export interface Folder {
+    [pathSegments: string]: Entity;
+}
+export type File = string | Uint8Array;
+export declare class SymLink {
+    path: AbsoluteFsPath;
+    constructor(path: AbsoluteFsPath);
+}
+export declare function isFile(item: Entity | null): item is File;
+export declare function isSymLink(item: Entity | null): item is SymLink;
+export declare function isFolder(item: Entity | null): item is Folder;

package/src/ngtsc/file_system/testing/src/mock_file_system_native.d.ts

@@ -0,0 +1,15 @@
+import { AbsoluteFsPath, PathSegment, PathString } from '../../src/types';
+import { MockFileSystem } from './mock_file_system';
+export declare class MockFileSystemNative extends MockFileSystem {
+    constructor(cwd?: AbsoluteFsPath);
+    resolve(...paths: string[]): AbsoluteFsPath;
+    dirname<T extends string>(file: T): T;
+    join<T extends string>(basePath: T, ...paths: string[]): T;
+    relative<T extends PathString>(from: T, to: T): PathSegment | AbsoluteFsPath;
+    basename(filePath: string, extension?: string): PathSegment;
+    isCaseSensitive(): boolean;
+    isRooted(path: string): boolean;
+    isRoot(path: AbsoluteFsPath): boolean;
+    normalize<T extends PathString>(path: T): T;
+    protected splitPath<T>(path: string): string[];
+}

package/src/ngtsc/file_system/testing/src/mock_file_system_posix.d.ts

@@ -0,0 +1,12 @@
+import { AbsoluteFsPath, PathSegment, PathString } from '../../src/types';
+import { MockFileSystem } from './mock_file_system';
+export declare class MockFileSystemPosix extends MockFileSystem {
+    resolve(...paths: string[]): AbsoluteFsPath;
+    dirname<T extends string>(file: T): T;
+    join<T extends string>(basePath: T, ...paths: string[]): T;
+    relative<T extends PathString>(from: T, to: T): PathSegment | AbsoluteFsPath;
+    basename(filePath: string, extension?: string): PathSegment;
+    isRooted(path: string): boolean;
+    protected splitPath<T extends PathString>(path: T): string[];
+    normalize<T extends PathString>(path: T): T;
+}

package/src/ngtsc/file_system/testing/src/mock_file_system_windows.d.ts

@@ -0,0 +1,12 @@
+import { AbsoluteFsPath, PathSegment, PathString } from '../../src/types';
+import { MockFileSystem } from './mock_file_system';
+export declare class MockFileSystemWindows extends MockFileSystem {
+    resolve(...paths: string[]): AbsoluteFsPath;
+    dirname<T extends string>(path: T): T;
+    join<T extends string>(basePath: T, ...paths: string[]): T;
+    relative<T extends PathString>(from: T, to: T): PathSegment | AbsoluteFsPath;
+    basename(filePath: string, extension?: string): PathSegment;
+    isRooted(path: string): boolean;
+    protected splitPath<T extends PathString>(path: T): string[];
+    normalize<T extends PathString>(path: T): T;
+}

package/src/ngtsc/file_system/testing/src/test_helper.d.ts

@@ -0,0 +1,16 @@
+import { AbsoluteFsPath } from '../../src/types';
+import { MockFileSystem } from './mock_file_system';
+export interface TestFile {
+    name: AbsoluteFsPath;
+    contents: string;
+    isRoot?: boolean | undefined;
+}
+export interface RunInEachFileSystemFn {
+    (callback: (os: string) => void): void;
+    windows(callback: (os: string) => void): void;
+    unix(callback: (os: string) => void): void;
+    native(callback: (os: string) => void): void;
+    osX(callback: (os: string) => void): void;
+}
+export declare const runInEachFileSystem: RunInEachFileSystemFn;
+export declare function initMockFileSystem(os: string, cwd?: AbsoluteFsPath): MockFileSystem;

package/src/ngtsc/translator/src/translator.d.ts

@@ -35,7 +35,7 @@ export declare class ExpressionTranslatorVisitor<TFile, TStatement, TExpression>
     visitTemplateLiteralExpr(ast: o.TemplateLiteralExpr, context: Context): TExpression;
     visitInstantiateExpr(ast: o.InstantiateExpr, context: Context): TExpression;
     visitLiteralExpr(ast: o.LiteralExpr, _context: Context): TExpression;
-    visitRegularExpressionLiteral(ast: o.outputAst.RegularExpressionLiteral, context: any): TExpression;
+    visitRegularExpressionLiteral(ast: o.RegularExpressionLiteralExpr, context: any): TExpression;
     visitLocalizedString(ast: o.LocalizedString, context: Context): TExpression;
     private createTaggedTemplateExpression;
     /**

package/src/ngtsc/typecheck/src/oob.d.ts

@@ -129,6 +129,10 @@ export interface OutOfBandDiagnosticRecorder {
      * correctly (e.g. more than one root node).
      */
     deferImplicitTriggerInvalidPlaceholder(id: TypeCheckId, trigger: TmplAstHoverDeferredTrigger | TmplAstInteractionDeferredTrigger | TmplAstViewportDeferredTrigger): void;
+    /**
+     * Reports an unsupported binding on a form `Field` node.
+     */
+    formFieldUnsupportedBinding(id: TypeCheckId, node: TmplAstBoundAttribute | TmplAstTextAttribute): void;
 }
 export declare class OutOfBandDiagnosticRecorderImpl implements OutOfBandDiagnosticRecorder {
     private resolver;
@@ -163,4 +167,5 @@ export declare class OutOfBandDiagnosticRecorderImpl implements OutOfBandDiagnos
     unclaimedDirectiveBinding(id: TypeCheckId, directive: TmplAstDirective, node: TmplAstBoundAttribute | TmplAstTextAttribute | TmplAstBoundEvent): void;
     deferImplicitTriggerMissingPlaceholder(id: TypeCheckId, trigger: TmplAstHoverDeferredTrigger | TmplAstInteractionDeferredTrigger | TmplAstViewportDeferredTrigger): void;
     deferImplicitTriggerInvalidPlaceholder(id: TypeCheckId, trigger: TmplAstHoverDeferredTrigger | TmplAstInteractionDeferredTrigger | TmplAstViewportDeferredTrigger): void;
+    formFieldUnsupportedBinding(id: TypeCheckId, node: TmplAstBoundAttribute | TmplAstTextAttribute): void;
 }