@seniorsistemas/angular-components 19.9.3 → 19.9.5

package/rating-scale/README.md

@@ -52,25 +52,30 @@ export class MeuModulo {}
 
 ```typescript
 interface RatingScaleNode {
-  id: string;      // Identificador único do nó (obrigatório)
-  title?: string;  // Texto exibido abaixo do ícone
-  icon?: string;   // Classe do ícone Font Awesome (ex: 'fa-smile')
+  id: string;             // Identificador único do nó (obrigatório)
+  title?: string;         // Texto exibido abaixo do ícone
+  /** @deprecated Use `selectedIcon` e `unselectedIcon`. */
+  icon?: string;           // Classe do ícone Font Awesome sem o glifo (ex: 'fa-smile') — sempre exibido com o glifo fixo `fas`
+  selectedIcon?: string;   // Classe completa (glifo + ícone, ex: 'fas fa-smile') exibida quando o nó está selecionado
+  unselectedIcon?: string; // Classe completa (glifo + ícone, ex: 'far fa-smile') exibida quando o nó não está selecionado
 }
 ```
 
 > O `FormControl` deve ser do tipo `RatingScaleNode`. O componente emite o objeto `RatingScaleNode` completo quando um nó é selecionado.
 
+> **`selectedIcon`/`unselectedIcon` devem ser informados juntos.** Se apenas um dos dois for informado, o componente emite um aviso no console e não exibe nenhum ícone para aquele nó. Se os dois forem informados, eles têm prioridade sobre `icon` (que é ignorado nesse caso).
+
 ## Exemplos
 
 ### Escala de humor com ícones
 
 ```typescript
 const nosHumor: RatingScaleNode[] = [
-  { id: 'very-happy', title: 'Muito feliz', icon: 'fa-laugh-wink' },
-  { id: 'happy', title: 'Feliz', icon: 'fa-smile' },
-  { id: 'normal', title: 'Normal', icon: 'fa-meh' },
-  { id: 'sad', title: 'Triste', icon: 'fa-sad-tear' },
-  { id: 'very-sad', title: 'Muito triste', icon: 'fa-sad-cry' },
+  { id: 'very-happy', title: 'Muito feliz', selectedIcon: 'fas fa-laugh-wink', unselectedIcon: 'far fa-laugh-wink' },
+  { id: 'happy', title: 'Feliz', selectedIcon: 'fas fa-smile', unselectedIcon: 'far fa-smile' },
+  { id: 'normal', title: 'Normal', selectedIcon: 'fas fa-meh', unselectedIcon: 'far fa-meh' },
+  { id: 'sad', title: 'Triste', selectedIcon: 'fas fa-sad-tear', unselectedIcon: 'far fa-sad-tear' },
+  { id: 'very-sad', title: 'Muito triste', selectedIcon: 'fas fa-sad-cry', unselectedIcon: 'far fa-sad-cry' },
 ];
 ```
 
@@ -128,11 +133,11 @@ this.form = new FormGroup({
 ```html
 <s-rating-scale
   [nodes]="[
-    { id: 'very-happy', icon: 'fa-laugh-wink' },
-    { id: 'happy', icon: 'fa-smile' },
-    { id: 'normal', icon: 'fa-meh' },
-    { id: 'sad', icon: 'fa-sad-tear' },
-    { id: 'very-sad', icon: 'fa-sad-cry' }
+    { id: 'very-happy', selectedIcon: 'fas fa-laugh-wink', unselectedIcon: 'far fa-laugh-wink' },
+    { id: 'happy', selectedIcon: 'fas fa-smile', unselectedIcon: 'far fa-smile' },
+    { id: 'normal', selectedIcon: 'fas fa-meh', unselectedIcon: 'far fa-meh' },
+    { id: 'sad', selectedIcon: 'fas fa-sad-tear', unselectedIcon: 'far fa-sad-tear' },
+    { id: 'very-sad', selectedIcon: 'fas fa-sad-cry', unselectedIcon: 'far fa-sad-cry' }
   ]"
   startLabel="Triste"
   endLabel="Feliz"
@@ -148,6 +153,26 @@ this.form = new FormGroup({
 - `startLabel` e `endLabel` contextualizam os extremos da escala para todos os usuários
 - Em modo `disabled`, nenhum nó aceita interação e o estilo visual indica o estado inativo
 
+## Migração
+
+### `icon` para `selectedIcon`/`unselectedIcon`
+
+O campo `icon` de `RatingScaleNode` está depreciado. Ele sempre exibia o ícone com o glifo `fas` fixo, independente do nó estar selecionado ou não. Os novos campos `selectedIcon`/`unselectedIcon` recebem a classe completa (glifo + ícone) pra cada estado, permitindo escolher livremente qualquer combinação — inclusive estilos diferentes (`fas`/`far`/etc.) por nó:
+
+```typescript
+// Antes
+const nos: RatingScaleNode[] = [
+  { id: 'happy', title: 'Feliz', icon: 'fa-smile' },
+];
+
+// Depois
+const nos: RatingScaleNode[] = [
+  { id: 'happy', title: 'Feliz', selectedIcon: 'fas fa-smile', unselectedIcon: 'far fa-smile' },
+];
+```
+
+`selectedIcon` e `unselectedIcon` devem ser informados sempre em conjunto — informar só um dos dois gera um aviso no console e nenhum ícone é exibido para o nó.
+
 ## Componentes relacionados
 
 - [`StarRating`](../star-rating/README.md) — avaliação por estrelas com escala numérica fixa

package/rating-scale/lib/rating-scale/models/rating-scale-node.d.ts

@@ -1,5 +1,13 @@
 export interface RatingScaleNode {
     id: string;
     title?: string;
+    /**
+     * @deprecated Use `selectedIcon` e `unselectedIcon` para controlar o glifo (`fas`/`far`/etc.)
+     * junto com o ícone. Será removido na próxima versão major.
+     */
     icon?: string;
+    /** @description Classe completa (glifo + ícone, ex: `'fas fa-smile'`) exibida quando o nó está selecionado. Deve ser informado junto com `unselectedIcon`. */
+    selectedIcon?: string;
+    /** @description Classe completa (glifo + ícone, ex: `'far fa-smile'`) exibida quando o nó não está selecionado. Deve ser informado junto com `selectedIcon`. */
+    unselectedIcon?: string;
 }

package/rating-scale/lib/rating-scale/rating-scale.component.d.ts

@@ -1,3 +1,4 @@
+import { OnChanges, SimpleChanges } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { RatingScaleNode } from './models/rating-scale-node';
 import * as i0 from "@angular/core";
@@ -18,7 +19,7 @@ import * as i0 from "@angular/core";
  *
  * @category Feedback
  */
-export declare class RatingScaleComponent implements ControlValueAccessor {
+export declare class RatingScaleComponent implements ControlValueAccessor, OnChanges {
     /**
      * @description Lista de nós que compõem a escala de avaliação. Campo obrigatório.
      * Cada `RatingScaleNode` define o valor, rótulo e cor do item na escala.
@@ -37,6 +38,8 @@ export declare class RatingScaleComponent implements ControlValueAccessor {
     value?: RatingScaleNode;
     private _onChange?;
     private _onTouched?;
+    ngOnChanges(changes: SimpleChanges): void;
+    getNodeIconClass(node: RatingScaleNode): string | undefined;
     writeValue(value: RatingScaleNode): void;
     registerOnChange(onChange: (value: RatingScaleNode) => void): void;
     registerOnTouched(onTouched: (value: RatingScaleNode) => void): void;

package/select/README.md

@@ -62,6 +62,8 @@ export class MeuComponent {}
 | `ariaLabel` | `string` | `''` | Não | Label de acessibilidade do componente |
 | `ariaLabelledBy` | `string` | `''` | Não | ID do elemento externo que descreve o componente |
 
+> **Nota:** o ícone exibido por `checkmark` usa por padrão a classe `far fa-check` (Font Awesome Free), definida internamente pelo `SelectOptionComponent` (sub-componente interno que renderiza cada opção do dropdown) através do input `checkIconClass`. Esse input não é público — não é exposto nem repassado pelo `SelectComponent`.
+
 ### Tipos
 
 ```typescript

package/select/lib/select/components/select-option/select-option.component.d.ts

@@ -7,8 +7,10 @@ export declare class SelectOptionComponent {
     isGrouper: import("@angular/core").InputSignal<boolean>;
     isFocused: import("@angular/core").InputSignal<boolean>;
     isSelected: import("@angular/core").ModelSignal<boolean>;
+    /** @description Classe do ícone de checkmark exibido quando a opção está selecionada. @default 'far fa-check' */
+    checkIconClass: import("@angular/core").InputSignal<string>;
     selected: import("@angular/core").OutputEmitterRef<void>;
     onClick(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SelectOptionComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SelectOptionComponent, "s-select-option", never, { "id": { "alias": "id"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": true; "isSignal": true; }; "checkmark": { "alias": "checkmark"; "required": true; "isSignal": true; }; "isGrouper": { "alias": "isGrouper"; "required": true; "isSignal": true; }; "isFocused": { "alias": "isFocused"; "required": true; "isSignal": true; }; "isSelected": { "alias": "isSelected"; "required": true; "isSignal": true; }; }, { "isSelected": "isSelectedChange"; "selected": "selected"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SelectOptionComponent, "s-select-option", never, { "id": { "alias": "id"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": true; "isSignal": true; }; "checkmark": { "alias": "checkmark"; "required": true; "isSignal": true; }; "isGrouper": { "alias": "isGrouper"; "required": true; "isSignal": true; }; "isFocused": { "alias": "isFocused"; "required": true; "isSignal": true; }; "isSelected": { "alias": "isSelected"; "required": true; "isSignal": true; }; "checkIconClass": { "alias": "checkIconClass"; "required": false; "isSignal": true; }; }, { "isSelected": "isSelectedChange"; "selected": "selected"; }, never, never, true, never>;
 }

package/select/lib/select/select.component.d.ts

@@ -43,6 +43,8 @@ export declare class SelectComponent<T> implements ControlValueAccessor, OnInit,
     filter: import("@angular/core").InputSignal<boolean>;
     /** @description Exibe um ícone de checkmark ao lado da opção selecionada. @default false */
     checkmark: import("@angular/core").InputSignal<boolean>;
+    /** @description Classe do ícone de checkmark exibido quando `checkmark` está ativo. @default 'far fa-check' */
+    checkIconClass: import("@angular/core").InputSignal<string>;
     /** @description Chave(s) do objeto usada(s) para filtragem textual. Quando não informado, usa `optionLabel`. */
     filterBy: import("@angular/core").InputSignal<keyof T | (keyof T)[] | undefined>;
     /** @description Habilita agrupamento de opções. As opções devem conter itens filhos conforme a estrutura de grupo suportada. @default false */
@@ -369,6 +371,6 @@ export declare class SelectComponent<T> implements ControlValueAccessor, OnInit,
      */
     private _focusSelectedOption;
     static ɵfac: i0.ɵɵFactoryDeclaration<SelectComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SelectComponent<any>, "s-select", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": true; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "checkmark": { "alias": "checkmark"; "required": false; "isSignal": true; }; "filterBy": { "alias": "filterBy"; "required": false; "isSignal": true; }; "group": { "alias": "group"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showOptions": { "alias": "showOptions"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; "isSignal": true; }; }, { "disabled": "disabledChange"; "showOptions": "showOptionsChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SelectComponent<any>, "s-select", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": true; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "showClear": { "alias": "showClear"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "checkmark": { "alias": "checkmark"; "required": false; "isSignal": true; }; "checkIconClass": { "alias": "checkIconClass"; "required": false; "isSignal": true; }; "filterBy": { "alias": "filterBy"; "required": false; "isSignal": true; }; "group": { "alias": "group"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollItemSize": { "alias": "virtualScrollItemSize"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showOptions": { "alias": "showOptions"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; "isSignal": true; }; }, { "disabled": "disabledChange"; "showOptions": "showOptionsChange"; }, never, never, true, never>;
 }
 export {};

package/side-sheet/README.md

@@ -16,7 +16,7 @@ Painel que empurra o conteúdo adjacente para a esquerda, dividindo o espaço ho
 
 - Ações destrutivas ou de confirmação — prefira `ConfirmDialog`
 - Conteúdo crítico que exige atenção exclusiva, bloqueando toda a tela — prefira `Dialog`
-- Fechamento configurável por Escape, clique fora ou confirmação de fechamento — prefira `Sidebar`
+- Fechamento configurável por Escape, clique fora ou confirmação de fechamento — prefira `Drawer`
 - Painel embutido no mesmo fluxo de layout, sem necessidade de overlay em mobile — prefira `SlideInBar`
 
 ## Instalação
@@ -173,12 +173,12 @@ protected editarCompleto(pedido: Pedido): void {
 - No modo overlay (< 1024px): `role="dialog"`, `aria-modal="true"` e `cdkTrapFocus` aprisionam o foco dentro do painel enquanto aberto
 - No modo push (>= 1024px): `role="complementary"`, sem aprisionamento de foco — o conteúdo ao lado continua totalmente navegável por teclado
 - O título recebe `aria-labelledby` com um id único por instância
-- Ao abrir, o foco é devolvido ao elemento que estava focado antes de abrir, quando o painel é fechado
-- O scroll da página é bloqueado automaticamente apenas no modo overlay, e restaurado ao fechar
+- Ao fechar, o foco é devolvido ao elemento que estava focado antes da abertura
+- O scroll da página é bloqueado automaticamente apenas no modo overlay, e restaurado ao fechar. O bloqueio é compartilhado com outros overlays da biblioteca (ex: `Drawer`) — fechar um não reativa o scroll enquanto outro ainda estiver aberto
 - Fecha somente pelo botão X do cabeçalho — não há fechamento por Escape ou clique fora, em nenhuma resolução
 
 ## Componentes relacionados
 
-- [`Sidebar`](../sidebar/README.md) — painel lateral que sobrepõe o conteúdo com backdrop, fechamento configurável por Esc/clique fora
+- [`Drawer`](../drawer/README.md) — painel lateral que sobrepõe o conteúdo com backdrop, fechamento configurável por Esc/clique fora
 - [`Dialog`](../dialog/README.md) — modal centralizado para confirmações e conteúdo crítico
 - [`SlideInBar`](../slide-in-bar/README.md) — painel embutido no fluxo do layout, sem necessidade de overlay em mobile

package/side-sheet/lib/side-sheet/side-sheet.component.d.ts

@@ -53,6 +53,7 @@ export declare class SideSheetComponent {
      */
     protected readonly panelWidthClasses: import("@angular/core").Signal<"[@media(min-width:1024px)]:w-[400px] [@media(min-width:1366px)]:w-[max(400px,50vw)]" | "[@media(min-width:1024px)]:w-[400px] [@media(min-width:1920px)]:w-[480px] [@media(min-width:2560px)]:w-[560px] [@media(min-width:3440px)]:w-[640px]">;
     private _elementToRefocus;
+    private readonly _scrollLock;
     constructor();
     protected closeSideSheet(): void;
     private _matchesDesktop;

package/speech-recognition/README.md

@@ -47,6 +47,7 @@ export class MeuModule {}
 | `textAreaElement` | `HTMLTextAreaElement` | — | Sim | Referência ao elemento `<textarea>` nativo que receberá o texto transcrito |
 | `keepContext` | `boolean` | `false` | Não | Quando `true`, o texto reconhecido é adicionado ao texto existente em vez de substituí-lo |
 | `speechRecognitionPlaceholder` | `string` | `''` | Não | Placeholder exibido no textarea durante o reconhecimento de voz |
+| `moreOptionsIconClass` | `string` | `'far fa-ellipsis-h'` | Não | Classe do ícone do botão de mais opções |
 
 ### Outputs
 

package/speech-recognition/lib/speech-recognition/speech-recognition/speech-recognition.component.d.ts

@@ -25,12 +25,15 @@ export declare class SpeechRecognitionComponent implements OnInit, OnDestroy {
     keepContext: boolean;
     /** @description Placeholder exibido no textarea durante o reconhecimento de voz. @default '' */
     speechRecognitionPlaceholder: string;
+    /** @description Classe do ícone do botão de mais opções. @default 'far fa-ellipsis-h' */
+    moreOptionsIconClass: string;
     private _recognizedText;
     private originalTextAreaElementText;
     private isDoneTextToSpeech;
     private readonly onDestroy$;
     private readonly VOICE_SPEEDS;
     private readonly keydownEventListener;
+    disabledSpeechRecognition: import("@angular/core").InputSignal<boolean>;
     disabled: boolean;
     isListeningUserVoice: boolean;
     voiceSpeed: number;
@@ -64,5 +67,5 @@ export declare class SpeechRecognitionComponent implements OnInit, OnDestroy {
     private speak;
     private get textToSpeech();
     static ɵfac: i0.ɵɵFactoryDeclaration<SpeechRecognitionComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SpeechRecognitionComponent, "s-speech-recognition", never, { "textAreaElement": { "alias": "textAreaElement"; "required": true; }; "keepContext": { "alias": "keepContext"; "required": false; }; "speechRecognitionPlaceholder": { "alias": "speechRecognitionPlaceholder"; "required": false; }; }, { "recognizedText": "recognizedText"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SpeechRecognitionComponent, "s-speech-recognition", never, { "textAreaElement": { "alias": "textAreaElement"; "required": true; }; "keepContext": { "alias": "keepContext"; "required": false; }; "speechRecognitionPlaceholder": { "alias": "speechRecognitionPlaceholder"; "required": false; }; "moreOptionsIconClass": { "alias": "moreOptionsIconClass"; "required": false; }; "disabledSpeechRecognition": { "alias": "disabledSpeechRecognition"; "required": false; "isSignal": true; }; }, { "recognizedText": "recognizedText"; }, never, never, true, never>;
 }

package/split-button/README.md

@@ -47,6 +47,8 @@ export class MeuModule {}
 | `options` | `SplitButtonOption[]` | — | Sim | Lista de opções exibidas no dropdown |
 | `type` | `SplitButtonType` | `'primary'` | Não | Estilo visual do botão: `'primary'`, `'secondary'` ou `'default'` |
 | `disabled` | `boolean` | `false` | Não | Desabilita o botão principal e o dropdown |
+| `openIcon` | `string` | `'far fa-chevron-down'` | Não | Classe do ícone exibido no dropdown quando está fechado |
+| `closeIcon` | `string` | `'far fa-chevron-up'` | Não | Classe do ícone exibido no dropdown quando está aberto |
 
 ### Outputs
 

package/split-button/lib/split-button/split-button.component.d.ts

@@ -30,6 +30,10 @@ export declare class SplitButtonComponent {
     type: SplitButtonType;
     /** @description Lista de opções exibidas no dropdown. Campo obrigatório. */
     options: SplitButtonOption[];
+    /** @description Classe do ícone exibido quando o dropdown está fechado. @default 'far fa-chevron-down' */
+    openIcon: string;
+    /** @description Classe do ícone exibido quando o dropdown está aberto. @default 'far fa-chevron-up' */
+    closeIcon: string;
     /** @description Emitido quando o usuário clica no botão principal (não no dropdown). */
     buttonClicked: EventEmitter<any>;
     open: boolean;
@@ -39,5 +43,5 @@ export declare class SplitButtonComponent {
     onOptionClick(option: SplitButtonOption): void;
     private _closeDropdown;
     static ɵfac: i0.ɵɵFactoryDeclaration<SplitButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SplitButtonComponent, "s-split-button", never, { "disabled": { "alias": "disabled"; "required": false; }; "iconClass": { "alias": "iconClass"; "required": true; }; "label": { "alias": "label"; "required": true; }; "type": { "alias": "type"; "required": false; }; "options": { "alias": "options"; "required": true; }; }, { "buttonClicked": "buttonClicked"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SplitButtonComponent, "s-split-button", never, { "disabled": { "alias": "disabled"; "required": false; }; "iconClass": { "alias": "iconClass"; "required": true; }; "label": { "alias": "label"; "required": true; }; "type": { "alias": "type"; "required": false; }; "options": { "alias": "options"; "required": true; }; "openIcon": { "alias": "openIcon"; "required": false; }; "closeIcon": { "alias": "closeIcon"; "required": false; }; }, { "buttonClicked": "buttonClicked"; }, never, never, true, never>;
 }

package/table-header/lib/table-header/table-header-checkbox.component.d.ts

@@ -1,5 +1,4 @@
 import { OnDestroy, OnInit } from '@angular/core';
-import { CheckboxListData, CheckboxListState } from '@seniorsistemas/angular-components/checkbox-list';
 import { Table, TableService } from 'primeng/table';
 import * as i0 from "@angular/core";
 /**
@@ -28,10 +27,8 @@ export declare class TableHeaderCheckboxComponent implements OnInit, OnDestroy {
     rowProps?: string[];
     /** @description Quando `true`, usa o objeto completo da linha em vez de propriedades específicas. */
     useAllObject?: boolean;
-    checkboxItems: CheckboxListData;
     checked: boolean;
     hasFocus: boolean;
-    checkboxState: CheckboxListState;
     private _ngUnsubscribe;
     constructor();
     ngOnInit(): void;
@@ -39,7 +36,7 @@ export declare class TableHeaderCheckboxComponent implements OnInit, OnDestroy {
     onFocus(): void;
     onBlur(): void;
     isDisabled(): boolean;
-    onClick(): void;
+    onClick(checked: boolean): void;
     updateCheckedState(): any;
     onToggleCheckbox(checked: boolean): void;
     isAllFilteredValuesChecked(): boolean;

package/token-list/lib/token-list/token-list.component.d.ts

@@ -26,6 +26,8 @@ export declare class TokenListComponent {
     removableTokens: boolean;
     /** @description Quando `true`, remove os eventos de ponteiro (hover/clique) dos tokens. @default false */
     hidePointerEvents: boolean;
+    /** @description Classe do ícone do botão de remover token. @default 'far fa-times' */
+    removeIconClass: string;
     /** @description Emitido quando o usuário clica em um token não desabilitado. */
     tokenSelected: EventEmitter<IToken>;
     /** @description Emitido quando o usuário remove um token não desabilitado. */
@@ -33,5 +35,5 @@ export declare class TokenListComponent {
     onTokenSelected(token: IToken): void;
     onTokenRemoved(token: IToken): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<TokenListComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TokenListComponent, "s-token-list", never, { "id": { "alias": "id"; "required": false; }; "tokens": { "alias": "tokens"; "required": true; }; "removableTokens": { "alias": "removableTokens"; "required": false; }; "hidePointerEvents": { "alias": "hidePointerEvents"; "required": false; }; }, { "tokenSelected": "tokenSelected"; "tokenRemoved": "tokenRemoved"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TokenListComponent, "s-token-list", never, { "id": { "alias": "id"; "required": false; }; "tokens": { "alias": "tokens"; "required": true; }; "removableTokens": { "alias": "removableTokens"; "required": false; }; "hidePointerEvents": { "alias": "hidePointerEvents"; "required": false; }; "removeIconClass": { "alias": "removeIconClass"; "required": false; }; }, { "tokenSelected": "tokenSelected"; "tokenRemoved": "tokenRemoved"; }, never, never, true, never>;
 }

package/utils/lib/utils/utils.d.ts

@@ -23,6 +23,27 @@ export declare const isMousePositionOutsideOfElement: (event: MouseEvent | Point
 }) => boolean;
 export declare const getElementPositionInfo: (element: HTMLElement) => ElementPosition;
 export declare const getElementLeftoverContentAvailable: (element: HTMLElement) => ElementLeftoverPosition;
+/**
+ * @description Libera um lock de scroll adquirido via `disableScroll`. Como múltiplos overlays
+ * (ex: Drawer, SideSheet) podem estar abertos ao mesmo tempo e todos chamam essa mesma função,
+ * o scroll só é de fato reativado quando o último lock pendente é liberado — e restaura o valor
+ * de `overflow` anterior ao primeiro `disableScroll`, em vez de sempre forçar `'auto'`.
+ */
 export declare const enableScroll: () => void;
+/**
+ * @description Bloqueia o scroll da página. Contabiliza quantos overlays pediram o bloqueio
+ * simultaneamente, para que fechar um não reative o scroll enquanto outro ainda estiver aberto.
+ */
 export declare const disableScroll: () => void;
+export type ScrollLock = {
+    lock: () => void;
+    unlock: () => void;
+};
+/**
+ * @description Cria um controle de lock de scroll para uma instância (ex: um componente de
+ * overlay). Chamar `lock`/`unlock` várias vezes seguidas é seguro — cada instância só chama
+ * `disableScroll`/`enableScroll` (que ela mesma adquiriu, evitando liberar o lock de outro overlay
+ * por engano) na primeira vez que necessário.
+ */
+export declare const createScrollLock: () => ScrollLock;
 export declare function deepClone<T>(value: T, weakMap?: WeakMap<WeakKey, any>): T;