@seniorsistemas/angular-components 19.10.0 → 19.10.1-feat-142334-c5bd06f3

package/README.md

@@ -64,7 +64,7 @@ import { DynamicFormComponent } from '@seniorsistemas/angular-components/dynamic
 export class MeuComponent {}
 ```
 
-Os componentes são standalone. Os `*Module` (ex.: `ButtonModule`) estão depreciados e serão removidos na v20; para migrar o seu código automaticamente, use `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`.
+Os componentes são standalone. Os `*Module` (ex.: `ButtonModule`) foram removidos na v20; para migrar o seu código automaticamente, use `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`.
 
 Para a configuração global da aplicação (`app.config.ts`), use as funções `provide*` no lugar dos `forRoot()` dos módulos:
 
@@ -95,7 +95,7 @@ Migrations disponíveis (por versão em que passam a ser aplicadas):
 | `19.6.0` | `migration-v19-6-0-p-editor`               | Migra `p-editor` (PrimeNG/Quill) para `s-editor`: renomeia tag e eventos, remove atributos sem equivalente, limpa configs legadas do `DynamicForm` e atualiza dependências do `package.json`                                                |
 | `19.6.2` | `migration-v19-6-2-s-chips-outputs`        | Renomeia outputs legados do `s-chips`: `onAdd`→`added`, `onRemove`→`removed`, `onChipClick`→`chipClicked`, `onFocus`→`focused`, `onBlur`→`focusLost`                                                                                        |
 | `19.9.3` | `migration-v19-9-3-fieldset-body-template` | Envolve o conteúdo projetado do `s-fieldset` em `<ng-template sTemplate="body">`, mantendo templates de slot como `sTemplate="header"` fora do body, e garante o `TemplateDirective` no escopo do componente (standalone ou via `NgModule`) |
-| `20.0.0` | `migration-v20-0-0-migrate-v20` | Prepara o projeto para a v20, executando automaticamente seletores, pacotes alias, APIs depreciadas, `dynamic-form`, datepicker e módulos → standalone (ver [Preparar para a v20](#preparar-para-a-v20)) |
+| `20.0.0` | `migration-v20-0-0-migrate-v20` | Prepara o projeto para a v20, executando automaticamente seletores, pacotes alias, wrappers do PrimeNG → `legacy-prime`, APIs depreciadas, `dynamic-form`, módulos → standalone e a remoção do PrimeNG quando o app não o usa mais (ver [Preparar para a v20](#preparar-para-a-v20)) |
 
 A lista completa, com a `version` que dispara cada migration e a `factory` correspondente, fica em [`projects/angular-components/schematics/migrations.json`](projects/angular-components/schematics/migrations.json).
 
@@ -114,10 +114,13 @@ Rodando pelo `ng generate`, ele pergunta o que migrar, com um checkbox por item
  ◉ Marcar todos
  ◉ Seletores depreciados (s-sidebar → s-drawer, s-steps → s-stepper, ...)
  ◉ Pacotes e símbolos alias (sidebar → drawer, steps → stepper, ...)
+ ◉ Wrappers do PrimeNG → legacy-prime (table antiga de /table e /table-header, diretivas de /shared, /autocomplete, /editable-overlay e /calendar-mask)
  ◉ Inputs, outputs e APIs depreciadas (onCodeChange, scale, pipes localized*, ...)
  ◉ Dynamic-form (fields → configs, integer → number, textAreaIA, ...)
- ◉ Datepicker (remove sCalendarMask e sDatepickerNoPeriodTab)
+ ◉ angular2-hotkeys → hotkeys da biblioteca (HotkeyModule.forRoot → provideHotkeys, [hotkeys] → [sHotkeys], <hotkeys-cheatsheet> → <s-hotkeys-cheatsheet>)
+ ◉ Classes do primeng-theme → Tailwind (sds-*, form-group, input-label, ...)
  ◉ Módulos → standalone (ButtonModule, LocaleModule.forRoot(), ...)
+ ◉ Tirar o PrimeNG do package.json e do angular.json quando o app não usa mais nada dele
 ```
 
 No final ele mostra um resumo por item e a lista de **pendências manuais** (com arquivo e linha) que a migração automática não conseguiu resolver. Recomendamos commitar antes de rodar, para revisar o diff. Use `--dry-run` para ver o que seria alterado sem gravar.
@@ -131,24 +134,47 @@ Para usar sem terminal interativo (CI) ou migrar só uma parte:
 | Opção               | O que faz                                                                                                                              |
 | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
 | `--all`             | Executa todos os itens, sem perguntar                                                                                                  |
-| `--items=a,b`       | Executa só os itens informados: `selectors`, `imports`, `apis`, `dynamic-form`, `datepicker`, `modules`, `app-standalone`             |
+| `--items=a,b`       | Executa só os itens informados: `selectors`, `imports`, `legacy-prime`, `apis`, `dynamic-form`, `angular2-hotkeys`, `theme-classes`, `modules`, `remove-primeng`, `p-table`, `app-standalone` |
 | `--skip=a,b`        | Pula os itens informados                                                                                                               |
 | `--path=src/app`    | Limita a migração a uma pasta                                                                                                          |
 | `--project=meu-app` | Limita a migração ao projeto do `angular.json`                                                                                         |
 
-Sem terminal interativo e sem `--items`/`--all`, todos os itens são executados (a conversão do app para standalone só roda com `--items=app-standalone`).
+Sem terminal interativo e sem `--items`/`--all`, todos os itens são executados (a conversão do app para standalone só roda com `--items=app-standalone`, e a migração de `p-table` para `s-table` só com `--items=p-table`).
 
 Cada item também roda isolado, sem perguntas:
 
 ```bash
 ng generate @seniorsistemas/angular-components:migrate-deprecated-selectors
 ng generate @seniorsistemas/angular-components:migrate-deprecated-imports
+ng generate @seniorsistemas/angular-components:migrate-legacy-prime
 ng generate @seniorsistemas/angular-components:migrate-deprecated-apis
 ng generate @seniorsistemas/angular-components:migrate-deprecated-dynamic-form
-ng generate @seniorsistemas/angular-components:migrate-deprecated-datepicker
+ng generate @seniorsistemas/angular-components:migrate-angular2-hotkeys
+ng generate @seniorsistemas/angular-components:migrate-primeng-theme-classes
 ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone
+ng generate @seniorsistemas/angular-components:migrate-p-table
 ```
 
+**`angular2-hotkeys` e `ngx-cookie-service` (breaking change da v20).** A biblioteca não depende mais deles. Os atalhos do `s-lookup` usam o `HotkeysService` do novo entrypoint `@seniorsistemas/angular-components/hotkeys`, que tem a mesma API do `angular2-hotkeys` (`Hotkey`, `HotkeysService`, `HotkeyOptions`) e não precisa de provider. O item `angular2-hotkeys` do `migrate-v20` (também disponível como `migrate-angular2-hotkeys`) troca os imports, converte `HotkeyModule.forRoot(x)` em `provideHotkeys(x)`, `[hotkeys]` em `[sHotkeys]` e `<hotkeys-cheatsheet>` em `<s-hotkeys-cheatsheet>`, e tira o `angular2-hotkeys` do `package.json` quando não sobra uso. Com os atalhos do app no mesmo serviço, o lookup continua pausando os atalhos do app enquanto o diálogo de pesquisa está aberto. A leitura de cookies (`LocaleService`, `s-empty-state-go-back`) passou para o `CookieService` de `@seniorsistemas/angular-components/cookie`: testes que mockavam o `CookieService` do `ngx-cookie-service` precisam mockar o da biblioteca.
+
+**PrimeNG (breaking change da v20).** A v20 não depende mais do PrimeNG: `primeng` e `@seniorsistemas/primeng-theme` viraram `peerDependencies` opcionais. Tudo que só existia por causa dele foi para `@seniorsistemas/angular-components/legacy-prime`: a table antiga (o entrypoint `/table` agora é a nova `s-table`), todo o `/table-header`, `/editable-overlay` e `/calendar-mask`, as diretivas `sPaginatorAccessibility`, `sTableCheckboxAccessibility` e `sDatepickerNoPeriodTab` do `/shared` e o `sAutoCompleteMultipleFix` do `/autocomplete`. O `ng update` (e o `migrate-v20`) **move esses imports para o `legacy-prime`** e avisa isso antes de migrar e no resumo final. **O `legacy-prime` será removido na v21** e exige o `primeng` instalado.
+
+**`@seniorsistemas/primeng-theme` (breaking change da v20).** O que o tema fazia fora do PrimeNG passou para a biblioteca:
+
+- O `styles.css` da biblioteca (`node_modules/@seniorsistemas/angular-components/styles.css`) traz as regras globais que vinham do tema, com os mesmos valores: o `body` (Open Sans, 14px, #333, fundo #f2f2f2), o reset `* { margin: 0; padding: 0 }`, `a`, `label`, o asterisco de `.required > label`, `[data-hidden="true"]`, o placeholder dos inputs, a fonte Noto Sans Mono do `s-code-editor` (carregada do Google Fonts) e o espaço de 10px entre dois `s-button` vizinhos (`s-button + s-button`). Essas regras empatam em especificidade com o preflight do Tailwind, então o `styles.css` precisa ficar **na posição em que o tema estava** no array `styles` do `angular.json`.
+- O item `theme-classes` do `migrate-v20` (também disponível como `migrate-primeng-theme-classes`) troca as classes globais do tema pelos utilitários Tailwind equivalentes, com os tokens do `@seniorsistemas/tailwind-config`: `sds-container`, `sds-color-*`, `sds-text-color-*`, `sds-marca-*`, `sds-semantic-*`, `sds-basecolor-*`, `sds-page-title`, `sds-section-title`, `sds-readonly`, `sds-panel-title`, `sds-empty-value`, `sds-ribbon-*`, `sds-rounded`, `sds-circle`, `sds-button-aux`, `aux-primary`, `aux-secondary`, `sds-clearfix`, `sds-float-*`, `form-group`, `input-label` e `input-label-container`. Ele reescreve `class="..."`, `styleClass` e os literais de `[ngClass]`/`[class]`. O `sds-badge` e o `sds-badge-number` não viram utilitários: o elemento vira `<s-badge>` (por exemplo, `<span class="sds-badge sds-semantic-green">Ativo</span>` vira `<s-badge color="green" text="Ativo" />`, com o `BadgeComponent` acrescentado ao `imports` do componente ou do NgModule). Isso só acontece quando o conteúdo é texto ou interpolação e a cor é `sds-semantic-*` (sem cor vira `gray`); o visual passa a ser o do `s-badge`. Badge com elementos dentro, cor dinâmica, outra cor ou o `sds-badge-error` fica como pendência manual. Cores e medidas sem token exato usam o token mais próximo (#333 → `grayscale-90`, #999 → `grayscale-50`, #ccc → `grayscale-30`, 15px → `mb-4`). Ficam como pendência manual: `[class.sds-x]`, classes em strings de TypeScript, seletores dessas classes nas folhas de estilo do app, o grid `ui-g`/`ui-md-*` (use o grid do Tailwind) e as classes que estilizam o `p-table` (`sds-datalist`, `sds-expanded-row`, `sds-table-scrollable`, `sds-extended-paginator`).
+- Não vieram para a biblioteca: o grid `ui-g`, os ícones `pi pi-*` mapeados para o Font Awesome, os estilos do FullCalendar, o `.p-fluid` e o espaço entre `p-button`/`button` soltos. Use `s-button`.
+
+No fim da migração, o item `remove-primeng` olha o workspace inteiro: se não sobrou nenhum uso do PrimeNG (import de `primeng/*`, do tema ou do `legacy-prime`, tag `<p-…>`, diretiva como `pTooltip` ou `@import` em folha de estilo), ele tira `primeng`, `@seniorsistemas/primeng-theme` e `primeicons` do `package.json` e os CSS deles do `angular.json`, e põe o `styles.css` da biblioteca na posição em que estava o tema. O `primeicons` fica se o app usar ícones `pi pi-*`. Se só sobraram classes do tema (as pendências do item `theme-classes`), ele tira o `primeng` e mantém o tema, listando onde estão. Se sobrou algum uso do PrimeNG, nada é removido e o relatório lista onde estão. Para manter o PrimeNG mesmo assim, use `--skip=remove-primeng`.
+
+Para sair do legado, existe o schematic **opcional** `migrate-p-table`, que não roda no `ng update` nem no `--all`: ele migra o máximo possível de `<p-table>` (com `s-table-columns`/`s-table-paging` ou só com `pTemplate`) para `<s-table>`:
+
+```bash
+ng generate @seniorsistemas/angular-components:migrate-p-table
+```
+
+O que ele faz: troca a tag e os atributos (`[value]`→`[data]`, `[columns]`→`[headers]`, `(onLazyLoad)`→`(lazyLoad)`, `[(selection)]`→`[(selectedKeys)]`, `*sLoadingState`→`[loading]`), remove o que a `s-table` já faz sozinha (cabeçalho, paginação, `sPaginatorAccessibility`, ...), converte os arrays `Column[]` em `TableHeader[]` (`header`→`label`, `EnumColumnFieldType.X`→`'x'`, `style.width`→`width`, ...), transforma células personalizadas em `<ng-template sTemplate>`, converte `rowexpansion` em `rowDetail`, traduz `s-table-paging` (`exportFileName`, `loadAllRecords`, exportação) e ajusta os imports (`TableComponent`, `TemplateDirective`, `TableHeader`). Tudo que não dá para converter com segurança fica marcado com `<!-- TODO(migrate-p-table) -->` e entra nas pendências manuais. Tabelas com **edição inline** (`pEditableRow`/`p-cellEditor`) são mantidas como `p-table` (vão para o `legacy-prime`). Revise o diff: o estado de seleção passa a guardar chaves (`Set` pelo `dataKey`) e o evento `(lazyLoad)` mudou (`event.page` em vez de `first/rows`).
+
 **Migrações nativas do Angular (standalone).** O `migrate-v20` **não pergunta** sobre a conversão do seu app para standalone. Ao terminar, ele avisa que existe um schematic para isso e lista o que ele faz. Essas migrações são feitas **pelo Angular**: o `migrate-app-to-standalone` é só um wrapper que chama o schematic oficial [`@angular/core:standalone`](https://angular.dev/reference/migrations/standalone). Por isso o resultado e eventuais problemas dessa etapa vêm do schematic do Angular, e não do angular-components. O Angular a executa em 3 modos, nesta ordem:
 
 1. `convert-to-standalone`: converte componentes, diretivas e pipes para standalone (remove `standalone: false` e adiciona as dependências ao `imports` de cada um) e atualiza os NgModules que os declaravam, que passam a importá-los em vez de declará-los.

package/accordion/lib/accordion/accordion.component.d.ts

@@ -1,4 +1,4 @@
-import { AfterContentInit, OnChanges, QueryList, SimpleChanges, OnDestroy } from '@angular/core';
+import { AfterContentInit } from '@angular/core';
 import { AccordionPanelComponent } from './components/accordion-panel/accordion-panel.component';
 import * as i0 from "@angular/core";
 /**
@@ -16,31 +16,30 @@ import * as i0 from "@angular/core";
  *
  * @category Inputs
  */
-export declare class AccordionComponent implements AfterContentInit, OnChanges, OnDestroy {
+export declare class AccordionComponent implements AfterContentInit {
     /**
      * @description Índice (ou lista de índices) do(s) painel(is) que devem iniciar abertos.
      * Aceita um número para painel único ou um array de números para o modo múltiplo.
      */
-    activeIndex?: number | number[];
+    readonly activeIndex: import("@angular/core").InputSignal<number | number[] | undefined>;
     /**
      * @description Permite que múltiplos painéis estejam abertos ao mesmo tempo.
      * Quando `false`, abrir um painel fecha automaticamente o anterior.
      *
      * @default false
      */
-    multiple: boolean;
-    panelsComponents?: QueryList<AccordionPanelComponent>;
-    private readonly _unsubscribe$;
+    readonly multiple: import("@angular/core").InputSignal<boolean>;
+    readonly panelsComponents: import("@angular/core").Signal<readonly AccordionPanelComponent[]>;
+    private readonly _destroyRef;
     private _panels;
     private _openSubs;
+    constructor();
     ngAfterContentInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    ngOnDestroy(): void;
     private _setupTabs;
     private _closeOtherTabs;
     private _setBehavior;
     private _enableSinglePanelBehavior;
     private _enableMultiplePanelBehavior;
     static ɵfac: i0.ɵɵFactoryDeclaration<AccordionComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AccordionComponent, "s-accordion", never, { "activeIndex": { "alias": "activeIndex"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; }, {}, ["panelsComponents"], ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AccordionComponent, "s-accordion", never, { "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; }, {}, ["panelsComponents"], ["*"], true, never>;
 }

package/accordion/lib/accordion/components/accordion-panel/accordion-panel.component.d.ts

@@ -1,4 +1,4 @@
-import { AfterViewInit, EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { AfterViewInit, DoCheck } from '@angular/core';
 import { UntypedFormControl } from '@angular/forms';
 import { AccordionButtonSettings, ValidationMessageIconColor } from '../../models/accordion-button-settings';
 import { BadgeColors } from '@seniorsistemas/angular-components/badge';
@@ -21,74 +21,81 @@ import * as i0 from "@angular/core";
  *
  * @category Inputs
  */
-export declare class AccordionPanelComponent implements OnChanges, AfterViewInit {
+export declare class AccordionPanelComponent implements AfterViewInit, DoCheck {
     /**
      * @description Título exibido no cabeçalho do painel. Campo obrigatório.
      */
-    header: string;
+    readonly header: import("@angular/core").InputSignal<string>;
     /**
      * @description Cria um componente Badge ao lado dos botões de ação no cabeçalho do painel.
      * O objeto de configuração deve conter o texto e a cor do badge.
      */
-    badgeConfig?: {
+    readonly badgeConfig: import("@angular/core").InputSignal<{
         text: string;
         color: BadgeColors;
-    };
+    } | undefined>;
     /**
      * @description Lista de botões de ação exibidos no cabeçalho do painel,
      * à direita do título. Cada item define ícone, tooltip e callback de clique.
      */
-    buttons?: AccordionButtonSettings[];
+    readonly buttons: import("@angular/core").InputSignal<AccordionButtonSettings[] | undefined>;
     /**
      * @description Desabilita a interação do usuário com o painel, impedindo abertura e fechamento.
      *
      * @default false
      */
-    disabled: boolean;
+    readonly disabled: import("@angular/core").InputSignal<boolean>;
     /**
      * @description `FormControl` vinculado a um switch exibido no cabeçalho do painel.
      * Permite habilitar/desabilitar o conteúdo do painel via toggle.
      */
-    switchControl?: UntypedFormControl;
+    readonly switchControl: import("@angular/core").InputSignal<UntypedFormControl | undefined>;
     /**
      * @description Mensagem de validação exibida abaixo do cabeçalho, acompanhada de um ícone.
      * Útil para indicar erros ou alertas relacionados ao conteúdo do painel.
      */
-    validationMessage?: string;
+    readonly validationMessage: import("@angular/core").InputSignal<string | undefined>;
     /**
      * @description Mantém o conteúdo do painel no DOM mesmo quando fechado (modo cache).
      * Útil para preservar o estado de componentes internos ao reabrir o painel.
      *
      * @default false
      */
-    cache: boolean;
+    readonly cache: import("@angular/core").InputSignal<boolean>;
     /**
      * @description Classe do ícone exibido ao lado da mensagem de validação.
      *
      * @default 'fas fa-exclamation-circle'
      */
-    validationMessageIcon: string;
+    readonly validationMessageIcon: import("@angular/core").InputSignal<string>;
     /**
      * @description Cor do ícone da mensagem de validação.
      *
      * @default 'Red'
      */
-    validationMessageIconColor: ValidationMessageIconColor;
+    readonly validationMessageIconColor: import("@angular/core").InputSignal<ValidationMessageIconColor>;
     /**
      * @description Emitido quando o painel é aberto pelo usuário.
      */
-    panelOpened: EventEmitter<void>;
+    readonly panelOpened: import("@angular/core").OutputEmitterRef<void>;
     /**
      * @description Emitido quando o painel é fechado pelo usuário.
      */
-    panelClosed: EventEmitter<void>;
+    readonly panelClosed: import("@angular/core").OutputEmitterRef<void>;
+    private _destroyed;
+    private _applied?;
+    constructor();
+    /**
+     * Compara `disabled` e `switchControl` por identidade a cada ciclo (sem `effect`), para que um binding que
+     * devolve uma referência nova a cada detecção de mudanças não agende reexecuções infinitas.
+     */
+    ngDoCheck(): void;
     isAnimating: boolean;
     isContentAnimationDisabled: boolean;
     readonly panelId: number;
     private _isOpen;
     get isOpen(): boolean;
     set isOpen(isOpen: boolean);
-    ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
     onIconButtonsClick(event: Event, callback: VoidFunction): void;
     onTabClick(): void;
@@ -97,5 +104,5 @@ export declare class AccordionPanelComponent implements OnChanges, AfterViewInit
     onContentAnimationDone(): void;
     private _emitPanelEvent;
     static ɵfac: i0.ɵɵFactoryDeclaration<AccordionPanelComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AccordionPanelComponent, "s-accordion-panel", never, { "header": { "alias": "header"; "required": true; }; "badgeConfig": { "alias": "badgeConfig"; "required": false; }; "buttons": { "alias": "buttons"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "switchControl": { "alias": "switchControl"; "required": false; }; "validationMessage": { "alias": "validationMessage"; "required": false; }; "cache": { "alias": "cache"; "required": false; }; "validationMessageIcon": { "alias": "validationMessageIcon"; "required": false; }; "validationMessageIconColor": { "alias": "validationMessageIconColor"; "required": false; }; }, { "panelOpened": "panelOpened"; "panelClosed": "panelClosed"; }, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AccordionPanelComponent, "s-accordion-panel", never, { "header": { "alias": "header"; "required": true; "isSignal": true; }; "badgeConfig": { "alias": "badgeConfig"; "required": false; "isSignal": true; }; "buttons": { "alias": "buttons"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "switchControl": { "alias": "switchControl"; "required": false; "isSignal": true; }; "validationMessage": { "alias": "validationMessage"; "required": false; "isSignal": true; }; "cache": { "alias": "cache"; "required": false; "isSignal": true; }; "validationMessageIcon": { "alias": "validationMessageIcon"; "required": false; "isSignal": true; }; "validationMessageIconColor": { "alias": "validationMessageIconColor"; "required": false; "isSignal": true; }; }, { "panelOpened": "panelOpened"; "panelClosed": "panelClosed"; }, never, ["*"], true, never>;
 }

package/accordion/public-api.d.ts

@@ -1,3 +1,2 @@
 export { AccordionPanelComponent } from './lib/accordion/components/accordion-panel/accordion-panel.component';
 export { AccordionComponent } from './lib/accordion/accordion.component';
-export { AccordionModule } from './lib/accordion/accordion.module';

package/alert/lib/alert/alert.component.d.ts

@@ -1,4 +1,3 @@
-import { EventEmitter } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
  * @description Componente de alerta que exibe mensagens informativas, de sucesso, aviso ou erro.
@@ -26,22 +25,22 @@ export declare class AlertComponent {
      *
      * @default 'info'
      */
-    severity: 'info' | 'success' | 'warning' | 'error';
+    readonly severity: import("@angular/core").InputSignal<"info" | "success" | "warning" | "error">;
     /**
      * @description Título principal do alerta exibido em destaque. Campo obrigatório.
      */
-    summary: string;
+    readonly summary: import("@angular/core").InputSignal<string>;
     /**
      * @description Mensagem detalhada exibida abaixo do título do alerta. Campo obrigatório.
      */
-    detail: string;
+    readonly detail: import("@angular/core").InputSignal<string | undefined>;
     /**
      * @description Quando `true`, exibe o botão de fechar o alerta.
      * Quando `false`, o alerta não pode ser dispensado pelo usuário.
      *
      * @default true
      */
-    closable: boolean;
+    readonly closable: import("@angular/core").InputSignal<boolean>;
     /**
      * @description Quando `true`, o conteúdo do alerta é escapado para evitar a execução de HTML ou scripts.
      * Quando `false`, o conteúdo do alerta é renderizado como HTML, permitindo a inclusão de links, negrito, etc.
@@ -52,12 +51,12 @@ export declare class AlertComponent {
     /**
      * @description Emitido quando o usuário fecha o alerta clicando no botão de fechar.
      */
-    closed: EventEmitter<void>;
+    readonly closed: import("@angular/core").OutputEmitterRef<void>;
     get isOpen(): boolean;
     closeAlert(): void;
     showAlert(): void;
     onClose(): void;
     private _isOpen;
     static ɵfac: i0.ɵɵFactoryDeclaration<AlertComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AlertComponent, "s-alert", never, { "severity": { "alias": "severity"; "required": false; }; "summary": { "alias": "summary"; "required": true; }; "detail": { "alias": "detail"; "required": false; }; "closable": { "alias": "closable"; "required": false; }; "escape": { "alias": "escape"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AlertComponent, "s-alert", never, { "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": true; "isSignal": true; }; "detail": { "alias": "detail"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "escape": { "alias": "escape"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*"], true, never>;
 }

package/alert/public-api.d.ts

@@ -1,2 +1 @@
 export { AlertComponent } from './lib/alert/alert.component';
-export { AlertModule } from './lib/alert/alert.module';

package/autocomplete/README.md

@@ -46,8 +46,8 @@ export class MeuComponent {}
 |-------------|------|--------|:-----------:|-----------|
 | `suggestions` | `T[]` | `[]` | não | Lista estática de sugestões exibidas no dropdown |
 | `placeholder` | `string` | `undefined` | não | Texto de placeholder do campo |
-| `suggestionLabel` | `keyof T` | `undefined` | não | Chave do objeto usada como texto de exibição |
-| `suggestionValue` | `keyof T` | `undefined` | não | Chave do objeto cujo valor é emitido ao formulário |
+| `suggestionLabel` | `keyof T \| string` | `undefined` | não | Chave do objeto usada como texto de exibição (aceita caminho com ponto, ex.: `'pais.nome'`) |
+| `suggestionValue` | `keyof T \| string` | `undefined` | não | Chave do objeto cujo valor é emitido ao formulário (aceita caminho com ponto) |
 | `delay` | `number` | `300` | não | Debounce em ms antes de acionar a busca |
 | `minLengthToSearch` | `number` | `1` | não | Mínimo de caracteres para acionar a busca |
 | `forceSelection` | `boolean` | `false` | não | Exige que o valor seja uma das sugestões |
@@ -62,8 +62,12 @@ export class MeuComponent {}
 | `readonly` | `boolean` | `false` | não | Torna o campo somente leitura |
 | `invalid` | `boolean` | `false` | não | Exibe estado de erro visual |
 | `emptyMessage` | `string` | `undefined` | não | Mensagem quando nenhuma sugestão é encontrada |
-| `dataKey` | `keyof T` | `undefined` | não | Chave para comparação de identidade entre opções |
+| `dataKey` | `keyof T \| string` | `undefined` | não | Chave para comparação de identidade entre opções (aceita caminho com ponto) |
 | `inputClass` | `string` | `''` | não | Classe CSS adicional no `<input>` interno |
+| `inputId` | `string` | `undefined` | não | `id` do `<input>` interno, para vincular um `<label for>` |
+| `maxlength` | `number \| null` | `null` | não | Quantidade máxima de caracteres aceitos no `<input>` |
+| `autoHighlight` | `boolean` | `false` | não | Destaca a primeira sugestão sempre que a lista é atualizada (Enter ou Tab a selecionam) |
+| `showClear` | `boolean` | `true` | não | Exibe o botão de limpar o valor no modo simples |
 | `value` | `T \| null` | `undefined` | não | Valor selecionado (two-way binding, modo simples) |
 | `values` | `T[]` | `[]` | não | Valores selecionados (two-way binding, modo múltiplo) |
 | `disabled` | `boolean` | `false` | não | Estado desabilitado (two-way binding) |
@@ -73,13 +77,13 @@ export class MeuComponent {}
 | Evento | Tipo | Descrição |
 |--------|------|-----------|
 | `completeMethod` | `OutputEmitterRef<{ query: string }>` | Emitido ao digitar — use para filtrar sugestões localmente |
-| `lazyLoad` | `OutputEmitterRef<{ query: string; response: (data: T[]) => void }>` | Emitido no modo lazy — chame `response(data)` para fornecer os dados |
+| `lazyLoad` | `OutputEmitterRef<AutocompleteLazyLoadEvent<T>>` | Emitido no modo lazy — chame `response(data)` para fornecer os dados. Respostas de uma busca já substituída por outra são ignoradas |
 | `selected` | `OutputEmitterRef<T>` | Emitido ao selecionar uma sugestão |
 | `unselected` | `OutputEmitterRef<T>` | Emitido ao remover uma sugestão (modo múltiplo) |
 | `blurred` | `OutputEmitterRef<Event>` | Emitido quando o campo perde foco |
 | `focused` | `OutputEmitterRef<any>` | Emitido quando o campo recebe foco |
-| `cleared` | `OutputEmitterRef<void>` | Emitido quando o campo é limpo |
-| `keyUp` | `OutputEmitterRef<Event>` | Emitido a cada tecla pressionada |
+| `cleared` | `OutputEmitterRef<void>` | Emitido quando o campo é limpo (pelo botão ou apagando todo o texto no modo simples) |
+| `keyUp` | `OutputEmitterRef<KeyboardEvent>` | Emitido a cada tecla liberada |
 
 ## Exemplos
 
@@ -127,7 +131,6 @@ No modo múltiplo, cada item selecionado é exibido como um chip (`AutocompleteC
 ```html
 <s-autocomplete
   formControlName="pais"
-  [suggestions]="sugestoes"
   suggestionLabel="nome"
   [lazy]="true"
   placeholder="Buscar país..."
@@ -136,11 +139,15 @@ No modo múltiplo, cada item selecionado é exibido como um chip (`AutocompleteC
 ```
 
 ```typescript
-onLazyLoad(event: { query: string; response: (data: Pais[]) => void }) {
-  this.apiService.buscar(event.query).subscribe(data => event.response(data));
+import { AutocompleteLazyLoadEvent } from '@seniorsistemas/angular-components/autocomplete';
+
+onLazyLoad({ query, response }: AutocompleteLazyLoadEvent<Pais>) {
+  this.apiService.buscar(query).subscribe(response);
 }
 ```
 
+Cada busca recebe o próprio `response`. Se o usuário digitar de novo antes da resposta chegar, a busca anterior é descartada e a resposta dela, ignorada: uma requisição lenta nunca sobrescreve a lista mais recente.
+
 ### Com dropdown (lista sem digitar)
 
 ```html

package/autocomplete/lib/autocomplete/autocomplete.component.d.ts

@@ -1,6 +1,9 @@
 import { ElementRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
+import { AutocompleteLazyLoadEvent } from './models/autocomplete-lazy-load-event';
 import * as i0 from "@angular/core";
+/** Chave de `T` ou caminho com ponto (`'pais.nome'`). */
+type SuggestionKey<T> = keyof T | (string & {});
 /**
  * Representa um item de sugestão encapsulado, utilizado em componentes de autocomplete.
  * @template T Tipo dos dados associados à sugestão.
@@ -38,10 +41,10 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
     suggestions: import("@angular/core").InputSignal<T[]>;
     /** @description Texto exibido no input quando nenhum valor está selecionado. */
     placeholder: import("@angular/core").InputSignal<string | undefined>;
-    /** @description Chave do objeto de sugestão cujo valor será emitido ao formulário. */
-    suggestionValue: import("@angular/core").InputSignal<keyof T | undefined>;
-    /** @description Chave do objeto de sugestão usada como texto de exibição no dropdown. */
-    suggestionLabel: import("@angular/core").InputSignal<keyof T | undefined>;
+    /** @description Chave do objeto de sugestão cujo valor será emitido ao formulário. Aceita caminho com ponto (`'endereco.cep'`). */
+    suggestionValue: import("@angular/core").InputSignal<SuggestionKey<T> | undefined>;
+    /** @description Chave do objeto de sugestão usada como texto de exibição no dropdown. Aceita caminho com ponto (`'pais.nome'`). */
+    suggestionLabel: import("@angular/core").InputSignal<SuggestionKey<T> | undefined>;
     /** @description Torna o campo somente leitura, impedindo digitação e seleção. @default false */
     readonly: import("@angular/core").InputSignal<boolean>;
     /** @description Mensagem exibida no dropdown quando nenhuma sugestão é encontrada. */
@@ -74,8 +77,16 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
     minLengthToSearch: import("@angular/core").InputSignal<number>;
     /** @description Classe CSS adicional aplicada ao elemento `<input>` interno. @default '' */
     inputClass: import("@angular/core").InputSignal<string>;
-    /** @description Chave do objeto usada para comparação de identidade entre opções, evitando duplicatas na seleção múltipla. */
-    dataKey: import("@angular/core").InputSignal<keyof T | undefined>;
+    /** @description `id` do elemento `<input>` interno, para vincular um `<label for>`. */
+    inputId: import("@angular/core").InputSignal<string | undefined>;
+    /** @description Quantidade máxima de caracteres aceitos no `<input>`. Sem limite quando `null`. @default null */
+    maxlength: import("@angular/core").InputSignal<number | null>;
+    /** @description Destaca a primeira sugestão sempre que a lista é atualizada, para selecioná-la com Enter ou Tab. @default false */
+    autoHighlight: import("@angular/core").InputSignal<boolean>;
+    /** @description Exibe o botão de limpar o valor no modo simples. @default true */
+    showClear: import("@angular/core").InputSignal<boolean>;
+    /** @description Chave do objeto usada para comparação de identidade entre opções, evitando duplicatas na seleção múltipla. Aceita caminho com ponto. */
+    dataKey: import("@angular/core").InputSignal<SuggestionKey<T> | undefined>;
     /** @description Valor atualmente selecionado no modo simples, via two-way binding. */
     value: import("@angular/core").ModelSignal<T | null | undefined>;
     /** @description Lista de valores selecionados no modo múltiplo, via two-way binding. @default [] */
@@ -86,10 +97,7 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
      * @description Emitido no modo lazy quando o usuário digita e o componente está pronto para receber novas sugestões.
      * O evento contém `query` (texto digitado) e `response` (função callback para fornecer os dados).
      */
-    lazyLoad: import("@angular/core").OutputEmitterRef<{
-        query: string;
-        response: (data: T[]) => void;
-    }>;
+    lazyLoad: import("@angular/core").OutputEmitterRef<AutocompleteLazyLoadEvent<T>>;
     /** @description Emitido quando o usuário seleciona uma sugestão do dropdown. */
     selected: import("@angular/core").OutputEmitterRef<T>;
     /** @description Emitido quando o usuário remove uma sugestão selecionada (modo múltiplo). */
@@ -98,8 +106,8 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
     blurred: import("@angular/core").OutputEmitterRef<Event>;
     /** @description Emitido quando o campo é limpo pelo usuário. */
     cleared: import("@angular/core").OutputEmitterRef<void>;
-    /** @description Emitido a cada pressionamento de tecla no campo de input. */
-    keyUp: import("@angular/core").OutputEmitterRef<Event>;
+    /** @description Emitido quando uma tecla é liberada no campo de input. */
+    keyUp: import("@angular/core").OutputEmitterRef<KeyboardEvent>;
     /** @description Emitido quando o campo recebe foco. */
     focused: import("@angular/core").OutputEmitterRef<any>;
     /** @description Emitido quando o usuário digita no campo, fornecendo o texto atual para filtragem de sugestões. */
@@ -116,6 +124,7 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
     componentId: string;
     inputEl: import("@angular/core").Signal<ElementRef<any> | undefined>;
     private _inputSubject$;
+    /** Texto a buscar no modo lazy; `null` cancela a busca em andamento. */
     private _lazyLoadSubject$;
     private _destroyRef;
     private _onChange?;
@@ -129,7 +138,7 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
     /**
      * Retorna um conjunto (`Set`) com os IDs das sugestões selecionadas.
      */
-    selectedSuggestionIds: import("@angular/core").Signal<Set<string | undefined>>;
+    selectedSuggestionIds: import("@angular/core").Signal<Set<string>>;
     /**
      * Retorna uma lista de sugestões filtradas, enriquecidas com a propriedade `isSelected`.
      * Cada sugestão recebe um campo booleano `isSelected` indicando se ela está selecionada,
@@ -202,7 +211,7 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
      * Emite um evento quando uma tecla é liberada no componente.     *
      * @param event O evento de teclado associado à tecla liberada.
      */
-    onKeyUp(event: Event): void;
+    onKeyUp(event: KeyboardEvent): void;
     /**
      * Fecha o dropdown em eventos de redimensionamento de janela.
      */
@@ -284,6 +293,11 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
      * @private
      */
     private _setupLazyLoadDebounce;
+    /**
+     * Emite o `lazyLoad` de `query` e espera o `response` do consumidor (até 30s).
+     * @private
+     */
+    private _requestLazySuggestions;
     /**
      * Configura o debounce para o input do autocomplete.
      * Este método utiliza um Subject para escutar as mudanças no valor do input,
@@ -296,6 +310,29 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
      * @private
      */
     private _setupInputDebounce;
+    /**
+     * Atualiza a lista exibida e reposiciona o destaque: primeira opção com `autoHighlight`, nenhuma sem.
+     * @private
+     */
+    private _setFilteredSuggestions;
+    /**
+     * Lê `key` de `item`, aceitando caminho com ponto (`'pais.nome'`).
+     * @private
+     */
+    private _resolve;
+    /**
+     * Texto exibido para o item: `suggestionLabel` quando informado (aceita caminho com ponto), senão o próprio item.
+     * @param item Sugestão ou valor selecionado.
+     * @returns O texto exibido no input, no chip e na lista.
+     */
+    labelOf(item: T): string;
+    /**
+     * Identidade do item para comparar seleções: `dataKey`, depois `suggestionValue`, depois o objeto serializado.
+     * @private
+     */
+    private _identity;
+    /** @private */
+    private _sameValue;
     /**
      * Valida as entradas do componente de autocomplete.
      * @private
@@ -303,6 +340,6 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
      */
     private _validateInputs;
     static ɵfac: i0.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AutocompleteComponent<any>, "s-autocomplete", never, { "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "suggestionValue": { "alias": "suggestionValue"; "required": false; "isSignal": true; }; "suggestionLabel": { "alias": "suggestionLabel"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "delay": { "alias": "delay"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "dropdown": { "alias": "dropdown"; "required": false; "isSignal": true; }; "forceSelection": { "alias": "forceSelection"; "required": false; "isSignal": true; }; "checkmark": { "alias": "checkmark"; "required": false; "isSignal": true; }; "clearIconClass": { "alias": "clearIconClass"; "required": false; "isSignal": true; }; "checkIconClass": { "alias": "checkIconClass"; "required": false; "isSignal": true; }; "removeIconClass": { "alias": "removeIconClass"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "minLengthToSearch": { "alias": "minLengthToSearch"; "required": false; "isSignal": true; }; "inputClass": { "alias": "inputClass"; "required": false; "isSignal": true; }; "dataKey": { "alias": "dataKey"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "values": "valuesChange"; "disabled": "disabledChange"; "lazyLoad": "lazyLoad"; "selected": "selected"; "unselected": "unselected"; "blurred": "blurred"; "cleared": "cleared"; "keyUp": "keyUp"; "focused": "focused"; "completeMethod": "completeMethod"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AutocompleteComponent<any>, "s-autocomplete", never, { "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "suggestionValue": { "alias": "suggestionValue"; "required": false; "isSignal": true; }; "suggestionLabel": { "alias": "suggestionLabel"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "delay": { "alias": "delay"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "dropdown": { "alias": "dropdown"; "required": false; "isSignal": true; }; "forceSelection": { "alias": "forceSelection"; "required": false; "isSignal": true; }; "checkmark": { "alias": "checkmark"; "required": false; "isSignal": true; }; "clearIconClass": { "alias": "clearIconClass"; "required": false; "isSignal": true; }; "checkIconClass": { "alias": "checkIconClass"; "required": false; "isSignal": true; }; "removeIconClass": { "alias": "removeIconClass"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "minLengthToSearch": { "alias": "minLengthToSearch"; "required": false; "isSignal": true; }; "inputClass": { "alias": "inputClass"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "maxlength": { "alias": "maxlength"; "required": false; "isSignal": true; }; "autoHighlight": { "alias": "autoHighlight"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "dataKey": { "alias": "dataKey"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "values": "valuesChange"; "disabled": "disabledChange"; "lazyLoad": "lazyLoad"; "selected": "selected"; "unselected": "unselected"; "blurred": "blurred"; "cleared": "cleared"; "keyUp": "keyUp"; "focused": "focused"; "completeMethod": "completeMethod"; }, never, never, true, never>;
 }
 export {};

package/autocomplete/lib/autocomplete/components/autocomplete-chip/autocomplete-chip.component.d.ts

@@ -1,11 +1,12 @@
 import * as i0 from "@angular/core";
 export declare class AutocompleteChipComponent<T> {
     suggestion: import("@angular/core").InputSignal<T>;
-    suggestionLabel: import("@angular/core").InputSignal<keyof T | undefined>;
+    /** @description Texto exibido no chip. Sem valor, exibe o próprio `suggestion`. */
+    label: import("@angular/core").InputSignal<string | undefined>;
     /** @description Classe do ícone do botão de remover o chip. @default 'far fa-times' */
     removeIconClass: import("@angular/core").InputSignal<string>;
     suggestionRemoved: import("@angular/core").OutputEmitterRef<T>;
     removeSuggestion(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AutocompleteChipComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AutocompleteChipComponent<any>, "s-autocomplete-chip", never, { "suggestion": { "alias": "suggestion"; "required": true; "isSignal": true; }; "suggestionLabel": { "alias": "suggestionLabel"; "required": false; "isSignal": true; }; "removeIconClass": { "alias": "removeIconClass"; "required": false; "isSignal": true; }; }, { "suggestionRemoved": "suggestionRemoved"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AutocompleteChipComponent<any>, "s-autocomplete-chip", never, { "suggestion": { "alias": "suggestion"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "removeIconClass": { "alias": "removeIconClass"; "required": false; "isSignal": true; }; }, { "suggestionRemoved": "suggestionRemoved"; }, never, never, true, never>;
 }

package/autocomplete/lib/autocomplete/models/autocomplete-lazy-load-event.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @description Evento do output `lazyLoad` do `s-autocomplete`. O consumidor busca as sugestões de `query` e as
+ * devolve chamando `response(lista)`. Uma resposta de uma busca que já foi substituída por outra é ignorada, então
+ * respostas que chegam fora de ordem não sobrescrevem a lista mais recente.
+ *
+ * @example
+ * ```ts
+ * buscar({ query, response }: AutocompleteLazyLoadEvent<Pais>): void {
+ *     this.paisesService.listar(query).subscribe(response);
+ * }
+ * ```
+ */
+export interface AutocompleteLazyLoadEvent<T> {
+    /** Texto digitado pelo usuário (vazio ao abrir pelo botão de dropdown). */
+    query: string;
+    /** Entrega as sugestões encontradas para `query`. */
+    response: (data: T[]) => void;
+}

package/autocomplete/public-api.d.ts

@@ -1,2 +1,2 @@
 export { AutocompleteComponent } from './lib/autocomplete/autocomplete.component';
-export { AutoCompleteMultipleKeyboardFixDirective } from './lib/autocomplete/p-autocomplete-multiple-keyboard-fix.directive';
+export type { AutocompleteLazyLoadEvent } from './lib/autocomplete/models/autocomplete-lazy-load-event';