From 831746eff1e7442bfc96bfa739f54091b26a7997 Mon Sep 17 00:00:00 2001
From: Matthieu Riegler <kyro38@gmail.com>
Date: Thu, 19 Mar 2026 01:10:26 +0100
Subject: [PATCH] docs: Add callout about the Component interface.

(cherry picked from commit e01573fbca2b9b7ca60e4a7e4b9c70a1d9f24d01)
---
 packages/core/src/metadata/directives.ts | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/core/src/metadata/directives.ts b/packages/core/src/metadata/directives.ts
index f768d9fbd70..1cf31283944 100644
--- a/packages/core/src/metadata/directives.ts
+++ b/packages/core/src/metadata/directives.ts
@@ -404,6 +404,9 @@ export interface ComponentDecorator {
    * life-cycle hooks. For more information, see the
    * [Lifecycle Hooks](guide/components/lifecycle) guide.
    *
+   * HELPFUL: You may not use this interface to describe a class that is a component. Decorators do not affect the typing of the decorated classes.
+   * Use `Type<unknown>` instead of `Type<Component>`.
+   *
    * @usageNotes
    *
    * ### Setting component inputs