fix(textarea)!: errors following a full review of the component (#DS-5482)

docs/guides/migration.en.md

@@ -1035,7 +1035,7 @@ for each option it deselected and reporting the shortened value to the form cont
 
 ### 18. Component review (20.3.0)
 
-Ten components went through a full review in 20.3.0: notification-center, popover, search-expandable, select, split-button, title, toast, tooltip, tree and tree-select. Each review closed the members that were never part of the component's contract, moved inputs to signals where that was the point of it, and fixed the behavior it uncovered along the way. Only the changes that reach a consumer are listed here.
+Components went through a full review in 20.3.0, in two waves. The first covered notification-center, popover, search-expandable, select, split-button, title, toast, tooltip, tree and tree-select; the second is the one each subsection below belongs to. Each review closed the members that were never part of the component's contract, moved inputs to signals where that was the point of it, and fixed the behavior it uncovered along the way. Only the changes that reach a consumer are listed here.
 
 Every schematic named below runs automatically:
 
@@ -1113,6 +1113,28 @@ A `<kbq-split-button>` with no projected button no longer throws outside dev mod
 
 Reported by `split-button-optional-disabled`.
 
+#### Textarea
+
+`KbqTextarea` implements `KbqFormFieldControl`, which declares `value`, `id`, `placeholder`, `required`, `disabled`, `focused`, `empty` and `errorState` as plain members — that interface is how the form field reads them, so they stay plain accessors. What moved are the four inputs the textarea owns.
+
+`canGrow` was the odd one: its getter returned `!maxRowLimitReached && bound`, so it reported `false` once the textarea hit `maxRows` even though the consumer had asked for growth. The folded value drives the resize handle and is internal now; `canGrow()` reports what was bound.
+
+| Pattern                                                 | Manual migration                                                      |
+| ------------------------------------------------------- | --------------------------------------------------------------------- |
+| `.maxRows` / `.freeRowsHeight` / `.maxRowLimitReached`  | Read as calls — rewritten for you                                     |
+| `.canGrow`                                              | `canGrow()`, and expect what was bound — not `false` at the row limit |
+| `.canGrow = …` / `.maxRows = …` / `.freeRowsHeight = …` | Bind them in the template; the inputs are read-only                   |
+
+**`maxRows` and `freeRowsHeight` report `number | undefined`.** Both were declared non-nullable while an unbound textarea held `undefined`, and `maxRowLimitReached` compared against it — `rowsCount > undefined` is false, which is why unlimited growth worked at all.
+
+**`freeRowsHeight` no longer writes itself.** It defaulted to the measured line height by assigning its own input in `ngOnInit`; the fallback is a computed now, so binding it later actually takes effect instead of being overwritten on the next init.
+
+**The `kbq-textarea_max-row-limit-reached` class follows the row count directly.** It is derived from a signal written inside `runOutsideAngular`, so the class used to wait for an unrelated change detection pass to appear.
+
+**Generated ids changed shape**, from `kbq-textarea-1` to `kbq-textarea-a1`.
+
+Handled by `textarea-signals`: the value-safe reads are rewritten, the rest is reported.
+
 #### Title
 
 `kbq-title` measures its host and opens a tooltip when the text is truncated. The review kept that surface — the `kbq-title` input and the tooltip it opens — and closed the measurement machinery behind it.

docs/guides/migration.ru.md

@@ -1039,7 +1039,7 @@ ng g @koobiq/components:list-tree-multiple-input --project <your project>
 
 ### 18. Ревью компонентов (20.3.0)
 
-В 20.3.0 полное ревью прошли десять компонентов: notification-center, popover, search-expandable, select, split-button, title, toast, tooltip, tree и tree-select. Каждое ревью закрывало члены, которые никогда не были частью контракта компонента, переводило входы на сигналы там, где в этом и был его смысл, и попутно исправляло найденные ошибки поведения. Ниже перечислено только то, что доходит до потребителя.
+В 20.3.0 полное ревью прошло в две волны. В первую вошли notification-center, popover, search-expandable, select, split-button, title, toast, tooltip, tree и tree-select; ко второй относится каждый из подразделов ниже. Каждое ревью закрывало члены, которые никогда не были частью контракта компонента, переводило входы на сигналы там, где в этом и был его смысл, и попутно исправляло найденные ошибки поведения. Ниже перечислено только то, что доходит до потребителя.
 
 Все схематики, названные ниже, запускаются автоматически:
 
@@ -1117,6 +1117,28 @@ if (splitButton.disabled === false) {
 
 Сообщает `split-button-optional-disabled`.
 
+#### Textarea
+
+`KbqTextarea` реализует `KbqFormFieldControl`, который объявляет `value`, `id`, `placeholder`, `required`, `disabled`, `focused`, `empty` и `errorState` обычными членами — именно через этот интерфейс их читает form-field, поэтому они остались обычными геттерами и сеттерами. Переехали те четыре входа, которые принадлежат самому textarea.
+
+Особый случай — `canGrow`: его геттер возвращал `!maxRowLimitReached && привязанное значение`, поэтому он сообщал `false`, как только textarea упирался в `maxRows`, — хотя потребитель просил рост. Свёрнутое значение управляет ручкой изменения размера и стало внутренним; `canGrow()` возвращает то, что было привязано.
+
+| Что было                                                | Как мигрировать вручную                                                    |
+| ------------------------------------------------------- | -------------------------------------------------------------------------- |
+| `.maxRows` / `.freeRowsHeight` / `.maxRowLimitReached`  | Читать как вызовы — переписывается за вас                                  |
+| `.canGrow`                                              | `canGrow()`, и ожидать привязанное значение, а не `false` на пределе строк |
+| `.canGrow = …` / `.maxRows = …` / `.freeRowsHeight = …` | Привязать в шаблоне; входы доступны только на чтение                       |
+
+**`maxRows` и `freeRowsHeight` возвращают `number | undefined`.** Оба были объявлены ненулевыми, хотя textarea без привязки содержал `undefined`, и `maxRowLimitReached` сравнивался именно с ним: `rowsCount > undefined` ложно — благодаря этому неограниченный рост вообще работал.
+
+**`freeRowsHeight` больше не пишет сам в себя.** Он получал значение по умолчанию, присваивая собственный вход в `ngOnInit`; теперь запасное значение — это `computed`, поэтому привязка, сделанная позже, действительно применяется, а не затирается при следующей инициализации.
+
+**Класс `kbq-textarea_max-row-limit-reached` следует за числом строк напрямую.** Он выводится из сигнала, в который пишут внутри `runOutsideAngular`, поэтому раньше класс ждал постороннего цикла обнаружения изменений.
+
+**Формат генерируемых `id` изменился** с `kbq-textarea-1` на `kbq-textarea-a1`.
+
+Закрывается схематиком `textarea-signals`: безопасные по значению чтения переписываются, остальное сообщается в отчёте.
+
 #### Title
 
 `kbq-title` измеряет свой хост и открывает тултип, когда текст обрезан. Ревью сохранило эту поверхность — вход `kbq-title` и открываемый тултип — и закрыло стоящий за ней механизм измерения.

packages/components/textarea/textarea.component.spec.ts

@@ -308,6 +308,40 @@ describe('KbqTextarea', () => {
 
             expect(getTextareaElement(fixture).classList.contains('kbq-textarea_max-row-limit-reached')).toBe(false);
         });
+
+        it('should treat a valueless canGrow attribute as true', () => {
+            const fixture = createComponent(KbqTextareaValuelessCanGrow);
+
+            fixture.detectChanges();
+
+            const textarea = fixture.debugElement.query(By.directive(KbqTextarea)).injector.get(KbqTextarea);
+
+            expect(textarea.canGrow()).toBe(true);
+            expect(getTextareaElement(fixture).classList.contains('kbq-textarea-resizable')).toBe(false);
+        });
+
+        it('should report the bound canGrow rather than folding in the row limit', () => {
+            const fixture = createComponent(KbqTextareaGrowWithMaxRows);
+
+            fixture.detectChanges();
+
+            const textarea = fixture.debugElement.query(By.directive(KbqTextarea)).injector.get(KbqTextarea);
+
+            expect(textarea.canGrow()).toBe(true);
+            expect(textarea.maxRowLimitReached()).toBe(false);
+        });
+
+        it('should leave maxRows and freeRowsHeight undefined when unbound', () => {
+            const fixture = createComponent(KbqTextareaForBehaviors);
+
+            fixture.detectChanges();
+
+            const textarea = fixture.debugElement.query(By.directive(KbqTextarea)).injector.get(KbqTextarea);
+
+            expect(textarea.maxRows()).toBeUndefined();
+            expect(textarea.freeRowsHeight()).toBeUndefined();
+            expect(textarea.maxRowLimitReached()).toBe(false);
+        });
     });
 
     describe('grow behavior', () => {
@@ -547,3 +581,15 @@ describe('KbqTextarea', () => {
         }));
     });
 });
+
+@Component({
+    imports: [KbqTextareaModule, KbqFormFieldModule, FormsModule],
+    template: `
+        <kbq-form-field>
+            <textarea kbqTextarea canGrow [(ngModel)]="value"></textarea>
+        </kbq-form-field>
+    `
+})
+class KbqTextareaValuelessCanGrow {
+    value = '';
+}