@telcomdev/ui 0.0.7 → 0.0.9

package/README.md

@@ -301,6 +301,40 @@ Iconos incluidos: `home`, `dashboard`, `folder`, `settings`, `people`, `person`,
 `TdInput`, `TdSelect`, `TdAutocompleteSelect` y `TdDatePicker` implementan
 `FormValueControl` y conservan soporte para `ngModel` y Reactive Forms.
 
+Cuando existe `[formField]`, el field pasa a ser la fuente principal del valor y
+del estado. Los controles reciben automáticamente `errors`, `invalid`,
+`required`, `readonly`, `disabled`, `min`, `max`, `minLength`, `maxLength` y
+`pattern` cuando corresponda. Las propiedades tradicionales (`value`,
+`valueChange`, `error`, `disabled`, etc.) continúan disponibles para no exigir
+una migración completa.
+
+`TdInput` acepta fields `string`, `number` y sus variantes anulables. Un valor
+`null` se presenta como un input vacío. Con `type="number"` y Signal Forms, el
+control entrega `number | null`, evitando números almacenados como texto.
+
+La política de vaciado se resuelve automáticamente y puede fijarse cuando sea
+necesario:
+
+```html
+<td-input type="number" [formField]="fields.cantidad" />
+<td-input [formField]="fields.correo" emptyValue="null" />
+```
+
+`emptyValue` acepta `auto` (predeterminado), `null` y `empty-string`. En modo
+tradicional se conserva el comportamiento histórico: `type="number"` continúa
+emitiendo texto mediante CVA para no romper formularios existentes.
+
+Cuando el control recibe `maxlength` —de forma directa o mediante la metadata
+`maxLength` de Signal Forms— muestra automáticamente un contador `actual/max`.
+Puede ocultarse sin quitar la validación:
+
+```html
+<td-input [maxlength]="100" [(ngModel)]="nombre" />
+<td-input [formField]="fields.descripcion" [showCounter]="false" />
+```
+
+`minlength`, `min`, `max` y `pattern` no activan el contador.
+
 ```ts
 import { signal } from '@angular/core';
 import { form, FormField } from '@angular/forms/signals';
@@ -312,11 +346,22 @@ readonly model = signal({
 readonly fields = form(this.model);
 ```
 
+Agrega `FormField` a los imports del componente. La librería no registra un
+segundo selector `[formField]`, evitando conflictos con la directiva oficial y
+con la transformación especial del compilador de Angular.
+
 ```html
 <td-input [formField]="fields.nombre" />
 <td-date-picker mode="rango" [formField]="fields.periodo" />
 ```
 
+El uso clásico sigue siendo válido:
+
+```html
+<td-input [(ngModel)]="nombre" />
+<td-select [formControl]="form.controls.estado" [options]="estados" />
+```
+
 ## Date Picker
 
 ```html