fix: added types for elementRef (#DS-4221)

[artembelik]

No description provided.

[Copilot]

Pull Request Overview

This PR applies the kbqInjectElementRef() utility function across the codebase to replace direct usage of inject(ElementRef). The change improves type safety by ensuring consistent ElementRef<HTMLElement> typing throughout the components.

Key changes:

• Replaces inject(ElementRef) with kbqInjectElementRef() for proper HTMLElement typing
• Updates public API signatures to reflect more specific return types
• Includes complementary use of kbqInjectNativeElement() for direct native element access

Reviewed Changes

Copilot reviewed 56 out of 56 changed files in this pull request and generated 3 comments.

File	Description
tools/public_api_guard/components/*.api.md	Updates public API signatures to reflect proper HTMLElement typing for ElementRef properties
packages/components/*/**.ts	Replaces ElementRef injection with kbqInjectElementRef() utility function
packages/docs-examples/components/*/**.ts	Applies the same ElementRef utility replacement in example code
apps/docs/src/app/components/*/**.ts	Updates documentation components to use the new utility function

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[github-actions]

Visit the preview URL for this PR (updated for commit 8ef9208):

https://koobiq-next--prs-1028-c9le72t3.web.app

_{(expires Wed, 01 Oct 2025 10:53:42 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: c9e37e518febda70d0317d07e8ceb35ac43c534c}

[lskramarov]

Это лишняя обертка.

Там где вылезли ошибки с типами нужно добавить типы. Из-за одного места делать подобные вещи не стоит.

[artembelik]

Это лишняя обертка.

я так не считаю, во первых эта запись читабельней

// before
readonly elementRef = inject<ElementRef<HTMLElement>>(ElementRef<HTMLElement>);
//after
readonly elementRef = kbqInjectElementRef();

во вторых она уже выявила несколько мест с потенциальными рантайм ошибками

---

подобный подход не редкость - пример

[lskramarov]

Это лишняя обертка.

я так не считаю, во первых эта запись читабельней

// before
readonly elementRef = inject<ElementRef<HTMLElement>>(ElementRef<HTMLElement>);
//after
readonly elementRef = kbqInjectElementRef();

во вторых она уже выявила несколько мест с потенциальными рантайм ошибками

подобный подход не редкость - пример

Я уже об этом говорил на примере оберток с провайдерами...

1. Ты обернул и спрятал дженерики внутри kbqInjectElementRef и что бы понять что он делает, нужно смотреть реализацию и все те же типы.
2. Ты добавляешь еще одну сущность вместо того что бы просто использовать имеющиеся типы.
3. В приведенном примере обертка сделана что бы получать nativeElement из ElementRef (это не обертка ради типов).
4. В аргументе дженерик не нужен, достаточно: inject<ElementRef<HTMLElement>>(ElementRef);
5. Если следовать такому принципу то любое множество/сочетание типов можно обернуть в функции, тем самым породив еще большее количество сущностей с теми же типами

[Copilot]

Pull Request Overview

Copilot reviewed 90 out of 90 changed files in this pull request and generated 4 comments.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}