angular · atscott · Apr 3, 2026 · Apr 1, 2026 · Apr 1, 2026 · Apr 1, 2026
diff --git a/goldens/public-api/compiler-cli/error_code.api.md b/goldens/public-api/compiler-cli/error_code.api.md
@@ -28,6 +28,7 @@ export enum ErrorCode {
     CONFIG_FLAT_MODULE_NO_INDEX = 4001,
     // (undocumented)
     CONFIG_STRICT_TEMPLATES_IMPLIES_FULL_TEMPLATE_TYPECHECK = 4002,
+    CONFLICTING_HOST_DIRECTIVE_BINDING = 8024,
     CONFLICTING_INPUT_TRANSFORM = 2020,
     CONFLICTING_LET_DECLARATION = 8017,
     CONTROL_FLOW_PREVENTING_CONTENT_PROJECTION = 8011,

diff --git a/packages/compiler-cli/private/hybrid_analysis.ts b/packages/compiler-cli/private/hybrid_analysis.ts
@@ -28,7 +28,6 @@ export {TcbGenericContextBehavior} from '../src/ngtsc/typecheck/src/ops/context'
 export {ImportManager} from '../src/ngtsc/translator';
 export type {ReferenceEmitter} from '../src/ngtsc/imports';
 export type {ReflectionHost, ClassDeclaration} from '../src/ngtsc/reflection';
-export {ClassPropertyMapping} from '../src/ngtsc/metadata/src/property_mapping';
 export type {TypeCheckSourceResolver} from '../src/ngtsc/typecheck/src/tcb_util';
 export {
   createHostElement,

diff --git a/packages/compiler-cli/src/ngtsc/annotations/common/src/diagnostics.ts b/packages/compiler-cli/src/ngtsc/annotations/common/src/diagnostics.ts
@@ -6,6 +6,7 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
+import {ClassPropertyName} from '@angular/compiler';
 import ts from 'typescript';
 
 import {
@@ -16,7 +17,6 @@ import {
 } from '../../../diagnostics';
 import {Reference} from '../../../imports';
 import {
-  ClassPropertyName,
   DirectiveMeta,
   flattenInheritedDirectiveMetadata,
   HostDirectiveMeta,

diff --git a/packages/compiler-cli/src/ngtsc/annotations/common/src/input_transforms.ts b/packages/compiler-cli/src/ngtsc/annotations/common/src/input_transforms.ts
@@ -6,9 +6,9 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
-import {outputAst} from '@angular/compiler';
+import {ClassPropertyMapping, outputAst} from '@angular/compiler';
 
-import {ClassPropertyMapping, InputMapping} from '../../../metadata';
+import {InputMapping} from '../../../metadata';
 import {CompileResult} from '../../../transform';
 
 /** Generates additional fields to be added to a class that has inputs with transform functions. */

diff --git a/packages/compiler-cli/src/ngtsc/annotations/component/src/handler.ts b/packages/compiler-cli/src/ngtsc/annotations/component/src/handler.ts
@@ -42,6 +42,7 @@ import {
   ViewEncapsulation,
   DirectiveMatcher,
   SelectorlessMatcher,
+  MatchSource,
 } from '@angular/compiler';
 import ts from 'typescript';
 
@@ -73,7 +74,6 @@ import {
   DirectiveMeta,
   extractDirectiveTypeCheckMeta,
   HostDirectivesResolver,
-  MatchSource,
   MetadataReader,
   MetadataRegistry,
   MetaKind,

diff --git a/packages/compiler-cli/src/ngtsc/annotations/component/src/metadata.ts b/packages/compiler-cli/src/ngtsc/annotations/component/src/metadata.ts
@@ -18,12 +18,12 @@ import {
   R3TemplateDependencyMetadata,
   SchemaMetadata,
   TmplAstDeferredBlock,
+  ClassPropertyMapping,
 } from '@angular/compiler';
 import ts from 'typescript';
 
 import {Reference} from '../../../imports';
 import {
-  ClassPropertyMapping,
   DirectiveResources,
   DirectiveTypeCheckMeta,
   HostDirectiveMeta,

diff --git a/packages/compiler-cli/src/ngtsc/annotations/directive/src/handler.ts b/packages/compiler-cli/src/ngtsc/annotations/directive/src/handler.ts
@@ -7,13 +7,15 @@
  */
 
 import {
+  ClassPropertyMapping,
   compileClassMetadata,
   compileDeclareClassMetadata,
   compileDeclareDirectiveFromMetadata,
   compileDirectiveFromMetadata,
   ConstantPool,
   FactoryTarget,
   makeBindingParser,
+  MatchSource,
   R3ClassMetadata,
   R3DirectiveMetadata,
   R3TargetBinder,
@@ -27,13 +29,11 @@ import {
   SemanticDepGraphUpdater,
 } from '../../../incremental/semantic_graph';
 import {
-  ClassPropertyMapping,
   DirectiveResources,
   DirectiveTypeCheckMeta,
   extractDirectiveTypeCheckMeta,
   HostDirectiveMeta,
   InputMapping,
-  MatchSource,
   MetadataReader,
   MetadataRegistry,
   MetaKind,

diff --git a/packages/compiler-cli/src/ngtsc/annotations/directive/src/output_function.ts b/packages/compiler-cli/src/ngtsc/annotations/directive/src/output_function.ts
@@ -6,11 +6,11 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
+import {InputOrOutput} from '@angular/compiler';
 import ts from 'typescript';
 
 import {ErrorCode, FatalDiagnosticError} from '../../../diagnostics';
 import {ImportedSymbolsTracker} from '../../../imports';
-import {InputOrOutput} from '../../../metadata';
 import {ClassMember, ClassMemberAccessLevel, ReflectionHost} from '../../../reflection';
 
 import {validateAccessOfInitializerApiMember} from './initializer_function_access';

diff --git a/packages/compiler-cli/src/ngtsc/annotations/directive/src/shared.ts b/packages/compiler-cli/src/ngtsc/annotations/directive/src/shared.ts
@@ -30,6 +30,8 @@ import {
   ArrowFunctionExpr,
   WrappedNodeExpr,
   literal,
+  ClassPropertyMapping,
+  InputOrOutput,
 } from '@angular/compiler';
 import ts from 'typescript';
 
@@ -42,11 +44,9 @@ import {
   ReferenceEmitter,
 } from '../../../imports';
 import {
-  ClassPropertyMapping,
   DecoratorInputTransform,
   HostDirectiveMeta,
   InputMapping,
-  InputOrOutput,
   isHostDirectiveMetaForGlobalMode,
   Resource,
 } from '../../../metadata';

diff --git a/packages/compiler-cli/src/ngtsc/annotations/directive/src/symbol.ts b/packages/compiler-cli/src/ngtsc/annotations/directive/src/symbol.ts
@@ -6,6 +6,7 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
+import {ClassPropertyMapping, InputOrOutput} from '@angular/compiler';
 import {
   areTypeParametersEqual,
   isArrayEqual,
@@ -14,13 +15,7 @@ import {
   SemanticSymbol,
   SemanticTypeParameter,
 } from '../../../incremental/semantic_graph';
-import {
-  ClassPropertyMapping,
-  DirectiveTypeCheckMeta,
-  InputMapping,
-  InputOrOutput,
-  TemplateGuardMeta,
-} from '../../../metadata';
+import {DirectiveTypeCheckMeta, InputMapping, TemplateGuardMeta} from '../../../metadata';
 import {ClassDeclaration} from '../../../reflection';
 
 /**

diff --git a/packages/compiler-cli/src/ngtsc/annotations/directive/test/directive_spec.ts b/packages/compiler-cli/src/ngtsc/annotations/directive/test/directive_spec.ts
@@ -12,6 +12,7 @@ import {
   R3TargetBinder,
   SelectorMatcher,
   TmplAstElement,
+  MatchSource,
 } from '@angular/compiler';
 import ts from 'typescript';
 
@@ -127,6 +128,9 @@ runInEachFileSystem(() => {
       const analysis = analyzeDirective(program, 'TestDir');
       const matcher = new SelectorMatcher<T2DirectiveMeta[]>();
       const dirMeta: T2DirectiveMeta = {
+        ref: {
+          key: 'TestDir',
+        },
         exportAs: null,
         inputs: analysis.inputs,
         outputs: analysis.outputs,
@@ -137,6 +141,7 @@ runInEachFileSystem(() => {
         animationTriggerNames: null,
         ngContentSelectors: null,
         preserveWhitespaces: false,
+        matchSource: MatchSource.Selector,
       };
       matcher.addSelectables(CssSelector.parse('[dir]'), [dirMeta]);
 

diff --git a/packages/compiler-cli/src/ngtsc/diagnostics/src/error_code.ts b/packages/compiler-cli/src/ngtsc/diagnostics/src/error_code.ts
@@ -449,6 +449,11 @@ export enum ErrorCode {
    */
   MULTIPLE_MATCHING_COMPONENTS = 8023,
 
+  /**
+   * Raised when a host directive input/output is exposed multiple times under the same name.
+   */
+  CONFLICTING_HOST_DIRECTIVE_BINDING = 8024,
+
   /**
    * A two way binding in a template has an incorrect syntax,
    * parentheses outside brackets. For example:

diff --git a/packages/compiler-cli/src/ngtsc/docs/src/class_extractor.ts b/packages/compiler-cli/src/ngtsc/docs/src/class_extractor.ts
@@ -6,17 +6,11 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
+import {InputOrOutput} from '@angular/compiler';
 import ts from 'typescript';
 
 import {Reference} from '../../imports';
-import {
-  DirectiveMeta,
-  InputMapping,
-  InputOrOutput,
-  MetadataReader,
-  NgModuleMeta,
-  PipeMeta,
-} from '../../metadata';
+import {DirectiveMeta, InputMapping, MetadataReader, PipeMeta} from '../../metadata';
 
 import {
   ClassEntry,

diff --git a/packages/compiler-cli/src/ngtsc/imports/src/references.ts b/packages/compiler-cli/src/ngtsc/imports/src/references.ts
@@ -10,7 +10,7 @@ import {Expression} from '@angular/compiler';
 import ts from 'typescript';
 
 import {AmbientImport} from '../../reflection';
-import {identifierOfNode} from '../../util/src/typescript';
+import {getSourceFile, identifierOfNode} from '../../util/src/typescript';
 
 export interface OwningModule {
   specifier: string;
@@ -57,6 +57,8 @@ export class Reference<T extends ts.Node = ts.Node> {
 
   readonly isAmbient: boolean;
 
+  readonly key: string;
+
   constructor(
     readonly node: T,
     bestGuessOwningModule: OwningModule | AmbientImport | null = null,
@@ -70,9 +72,20 @@ export class Reference<T extends ts.Node = ts.Node> {
     }
 
     const id = identifierOfNode(node);
+    const sourceFile = getSourceFile(node);
+
     if (id !== null) {
       this.identifiers.push(id);
     }
+
+    // The source file might not be defined for synthetic nodes.
+    if (sourceFile) {
+      this.key = `${sourceFile.fileName}#${node.getStart()}`;
+    } else {
+      // `getStart` will throw if there's no source file.
+      const position = id && id.getSourceFile() ? id.getStart() : null;
+      this.key = `${this.bestGuessOwningModule?.specifier}#${id?.text}#${position}`;
+    }
   }
 
   /**

diff --git a/packages/compiler-cli/src/ngtsc/indexer/test/util.ts b/packages/compiler-cli/src/ngtsc/indexer/test/util.ts
@@ -8,8 +8,10 @@
 
 import {
   BoundTarget,
+  ClassPropertyMapping,
   CssSelector,
   DirectiveMatcher,
+  MatchSource,
   parseTemplate,
   ParseTemplateOptions,
   R3TargetBinder,
@@ -20,7 +22,6 @@ import ts from 'typescript';
 
 import {absoluteFrom, AbsoluteFsPath} from '../../file_system';
 import {Reference} from '../../imports';
-import {ClassPropertyMapping} from '../../metadata';
 import {ClassDeclaration} from '../../reflection';
 import {getDeclaration, makeProgram} from '../../testing';
 import {ComponentMeta} from '../src/context';
@@ -69,6 +70,7 @@ export function getBoundTemplate(
     animationTriggerNames: null,
     ngContentSelectors: null,
     preserveWhitespaces: false,
+    matchSource: MatchSource.Selector,
   }));
 
   let matcher: DirectiveMatcher<ComponentMeta>;

diff --git a/packages/compiler-cli/src/ngtsc/metadata/index.ts b/packages/compiler-cli/src/ngtsc/metadata/index.ts
@@ -23,11 +23,5 @@ export {
   CompoundMetadataReader,
   isHostDirectiveMetaForGlobalMode,
 } from './src/util';
-export {
-  BindingPropertyName,
-  ClassPropertyMapping,
-  ClassPropertyName,
-  InputOrOutput,
-} from './src/property_mapping';
 export {ExportedProviderStatusResolver} from './src/providers';
 export {HostDirectivesResolver} from './src/host_directives_resolver';
diff --git a/packages/compiler-cli/src/ngtsc/metadata/src/api.ts b/packages/compiler-cli/src/ngtsc/metadata/src/api.ts
@@ -11,14 +11,16 @@ import {
   Expression,
   SchemaMetadata,
   ExternalReference,
+  MatchSource,
+  ClassPropertyName,
+  InputOrOutput,
+  ClassPropertyMapping,
 } from '@angular/compiler';
 import ts from 'typescript';
 
 import {Reference} from '../../imports';
 import {ClassDeclaration} from '../../reflection';
 
-import {ClassPropertyMapping, ClassPropertyName, InputOrOutput} from './property_mapping';
-
 /**
  * Metadata collected for an `NgModule`.
  */
@@ -134,17 +136,6 @@ export enum MetaKind {
   NgModule,
 }
 
-/**
- * Possible ways that a directive can be matched.
- */
-export enum MatchSource {
-  /** The directive was matched by its selector. */
-  Selector,
-
-  /** The directive was applied as a host directive. */
-  HostDirective,
-}
-
 /** Metadata for a single input mapping. */
 export type InputMapping = InputOrOutput & {
   required: boolean;

diff --git a/packages/compiler-cli/src/ngtsc/metadata/src/dts.ts b/packages/compiler-cli/src/ngtsc/metadata/src/dts.ts
@@ -6,6 +6,7 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
+import {ClassPropertyMapping, MatchSource} from '@angular/compiler';
 import ts from 'typescript';
 
 import {OwningModule, Reference} from '../../imports';
@@ -21,13 +22,11 @@ import {
   DirectiveMeta,
   HostDirectiveMeta,
   InputMapping,
-  MatchSource,
   MetadataReader,
   MetaKind,
   NgModuleMeta,
   PipeMeta,
 } from './api';
-import {ClassPropertyMapping} from './property_mapping';
 import {
   extractDirectiveTypeCheckMeta,
   extractReferencesFromType,

diff --git a/packages/compiler-cli/src/ngtsc/metadata/src/host_directives_resolver.ts b/packages/compiler-cli/src/ngtsc/metadata/src/host_directives_resolver.ts
@@ -6,9 +6,9 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
-import {DirectiveMeta, InputMapping, MatchSource, MetadataReader} from '../../metadata/src/api';
+import {ClassPropertyMapping, InputOrOutput, MatchSource} from '@angular/compiler';
+import {DirectiveMeta, InputMapping, MetadataReader} from '../../metadata/src/api';
 import {ClassDeclaration} from '../../reflection';
-import {ClassPropertyMapping, InputOrOutput} from '../src/property_mapping';
 
 import {flattenInheritedDirectiveMetadata} from './inheritance';
 import {isHostDirectiveMetaForGlobalMode} from './util';

diff --git a/packages/compiler-cli/src/ngtsc/metadata/src/inheritance.ts b/packages/compiler-cli/src/ngtsc/metadata/src/inheritance.ts
@@ -6,11 +6,11 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
+import {ClassPropertyMapping, ClassPropertyName} from '@angular/compiler';
 import {Reference} from '../../imports';
 import {ClassDeclaration} from '../../reflection';
 
 import {DirectiveMeta, HostDirectiveMeta, InputMapping, MetadataReader} from './api';
-import {ClassPropertyMapping, ClassPropertyName} from './property_mapping';
 
 /**
  * Given a reference to a directive, return a flattened version of its `DirectiveMeta` metadata

diff --git a/packages/compiler-cli/src/ngtsc/metadata/src/util.ts b/packages/compiler-cli/src/ngtsc/metadata/src/util.ts
@@ -31,8 +31,8 @@ import {
   PipeMeta,
   TemplateGuardMeta,
 } from './api';
-import {ClassPropertyMapping, ClassPropertyName} from './property_mapping';
 import {TypeEntityToDeclarationError} from '../../reflection/src/typescript';
+import {ClassPropertyMapping, ClassPropertyName} from '@angular/compiler';
 
 export function extractReferencesFromType(
   checker: ts.TypeChecker,