@seniorsistemas/angular-components 19.9.3 → 19.9.5

package/autocomplete/README.md

@@ -54,6 +54,8 @@ export class MeuComponent {}
 | `multiple` | `boolean` | `false` | não | Habilita seleção de múltiplos itens como chips |
 | `dropdown` | `boolean` | `false` | não | Exibe botão de seta para abrir a lista sem digitar |
 | `checkmark` | `boolean` | `false` | não | Exibe ícone de check na opção selecionada |
+| `clearIconClass` | `string` | `'far fa-times'` | não | Classe do ícone do botão de limpar o valor do campo |
+| `checkIconClass` | `string` | `'far fa-check'` | não | Classe do ícone de checkmark exibido ao lado da opção selecionada (com `checkmark` e `multiple`) |
 | `lazy` | `boolean` | `false` | não | Ativa carregamento assíncrono via output `lazyLoad` |
 | `virtualScroll` | `boolean` | `false` | não | Virtualiza a lista para melhor performance |
 | `virtualScrollItemSize` | `number` | `37` | não | Altura em pixels de cada item no virtual scroll |
@@ -118,6 +120,8 @@ filtrar(event: { query: string }) {
 </s-autocomplete>
 ```
 
+No modo múltiplo, cada item selecionado é exibido como um chip (`AutocompleteChipComponent`, interno) com um botão de remover. O ícone desse botão pode ser customizado através do input `removeIconClass` (`string`, padrão `'far fa-times'`) do próprio `AutocompleteChipComponent`.
+
 ### Lazy loading (dados de API)
 
 ```html

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

@@ -62,6 +62,12 @@ export declare class AutocompleteComponent<T> implements ControlValueAccessor {
     forceSelection: import("@angular/core").InputSignal<boolean>;
     /** @description Exibe ícone de checkmark ao lado da opção selecionada no dropdown. @default false */
     checkmark: import("@angular/core").InputSignal<boolean>;
+    /** @description Classe do ícone do botão de limpar o valor do campo. @default 'far fa-times' */
+    clearIconClass: import("@angular/core").InputSignal<string>;
+    /** @description Classe do ícone de checkmark exibido ao lado da opção selecionada no dropdown. @default 'far fa-check' */
+    checkIconClass: import("@angular/core").InputSignal<string>;
+    /** @description Classe do ícone do botão de remover chip, exibido no modo `multiple`. @default 'far fa-times' */
+    removeIconClass: import("@angular/core").InputSignal<string>;
     /** @description Habilita seleção de múltiplos itens exibidos como chips no campo. @default false */
     multiple: import("@angular/core").InputSignal<boolean>;
     /** @description Quantidade mínima de caracteres necessária para acionar a busca por sugestões. @default 1 */
@@ -297,6 +303,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; }; "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; }; "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

@@ -2,8 +2,10 @@ 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 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; }; }, { "suggestionRemoved": "suggestionRemoved"; }, never, never, true, 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>;
 }

package/checkbox/lib/checkbox/checkbox.component.d.ts

@@ -28,11 +28,6 @@ export declare class CheckboxComponent implements ControlValueAccessor {
     ariaLabel: import("@angular/core").InputSignal<string | undefined>;
     /** @description ID do elemento que descreve o checkbox (para usar `<label for="...">`). Opcional. */
     ariaLabelledBy: import("@angular/core").InputSignal<string | undefined>;
-    /**
-     * @description Emitido quando o valor do checkbox é alterado pelo usuário.
-     * Emite o novo valor booleano (`true` para marcado, `false` para desmarcado).
-     */
-    readonly checkedChange: import("@angular/core").OutputEmitterRef<boolean>;
     private _onChange;
     private _onTouched;
     private _hasUserInteracted;
@@ -49,5 +44,5 @@ export declare class CheckboxComponent implements ControlValueAccessor {
     setDisabledState(disabled: boolean): void;
     onBlur(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CheckboxComponent, "s-checkbox", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; "isSignal": true; }; }, { "disabled": "disabledChange"; "checked": "checkedChange"; "checkedChange": "checkedChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CheckboxComponent, "s-checkbox", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaLabelledBy": { "alias": "ariaLabelledBy"; "required": false; "isSignal": true; }; }, { "disabled": "disabledChange"; "checked": "checkedChange"; }, never, never, true, never>;
 }

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

@@ -24,13 +24,21 @@ export declare class CheckboxListComponent implements ControlValueAccessor {
      * Campo obrigatório.
      */
     data: CheckboxListData;
+    /**
+     * @description Instância do nó pai na árvore recursiva, obtida via DI (`@SkipSelf`).
+     * `null` para o nó raiz. Usada para herdar o estado `disabled` sem expor um `@Input`
+     * paralelo ao contrato de `ControlValueAccessor`.
+     */
+    private readonly _parent;
     state: CheckboxListState;
     private _onChange;
     private _onTouched;
     writeValue(value: CheckboxListState): void;
     get renderType(): "inline" | "block";
+    get isDisabled(): boolean;
     registerOnChange(onChange: (value: CheckboxListState) => void): void;
     registerOnTouched(onTouched: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
     private _initializeChildren;
     getCheckboxState(item: CheckboxListChildren | undefined, label: string): {};
     updateParent(): void;

package/content-generator/lib/content-generator/content-generator.component.d.ts

@@ -25,10 +25,9 @@ import * as i1 from "@seniorsistemas/angular-components/common/deprecated-select
 export declare class ContentGeneratorComponent implements OnInit, ControlValueAccessor {
     private readonly _iassistService;
     private readonly _formBuilder;
-    private readonly _translateService;
     speechRecognitionService: SpeechRecognitionService;
-    private injector;
     private readonly _destroyRef;
+    disabled: import("@angular/core").WritableSignal<boolean>;
     textArea: import("@angular/core").Signal<TextAreaComponent | undefined>;
     private static id;
     /** @description Identificador único do componente no DOM. Gerado automaticamente se não informado. */
@@ -64,6 +63,7 @@ export declare class ContentGeneratorComponent implements OnInit, ControlValueAc
     private _onTouched?;
     ngOnInit(): void;
     writeValue(value: string): void;
+    setDisabledState(isDisabled: boolean): void;
     registerOnChange(onChange: (value: string) => void): void;
     registerOnTouched(onTouched: () => void): void;
     onValueChange(value: string): void;

package/country-phone-picker/lib/country-phone-picker/country-phone-picker.component.d.ts

@@ -53,6 +53,7 @@ export declare class CountryPhonePickerComponent implements OnInit, ControlValue
     phoneInput: ElementRef | null;
     private readonly filterInput;
     isFocused: boolean;
+    disabled: boolean;
     mask: string | null;
     selectedItem: CountryPhoneData | null;
     currentItemIndex: number;
@@ -81,6 +82,7 @@ export declare class CountryPhonePickerComponent implements OnInit, ControlValue
     writeValue(value: PhoneSelectionData): void;
     registerOnChange(onChange: (value: PhoneSelectionData) => void): void;
     registerOnTouched(onTouched: (value: PhoneSelectionData) => void): void;
+    setDisabledState(isDisabled: boolean): void;
     ngOnInit(): void;
     onSelectItem(country: CountryPhoneData): void;
     onCleanFilter(): void;

package/drawer/README.md

@@ -50,6 +50,7 @@ export class MeuModule {}
 | `dismissible` | `boolean` | `true` | Não | Fechar ao clicar no backdrop (área escurecida fora do painel) |
 | `closeOnEscape` | `boolean` | `true` | Não | Fechar ao pressionar a tecla Escape |
 | `header` | `string` | `undefined` | Não | Texto exibido no cabeçalho padrão. Substituível via `sTemplate="header"` |
+| `ariaLabel` | `string` | `undefined` | Não | Nome acessível do drawer quando o cabeçalho é um template customizado via `sTemplate="header"`. Ignorado quando `header` está definido |
 | `largeSized` | `boolean` | `false` | Não | Aumenta a largura do drawer para acomodar mais conteúdo |
 | `cache` | `boolean` | `false` | Não | Mantém o conteúdo no DOM quando fechado, preservando estado interno |
 | `registerConfirmClose` | `() => boolean` | `() => true` | Não | Função chamada antes de fechar; retornar `false` bloqueia o fechamento |
@@ -109,9 +110,15 @@ confirmClose = (): boolean => {
 ## Acessibilidade
 
 - O drawer utiliza `cdkTrapFocus` para aprisionar o foco dentro do painel enquanto aberto
-- Pressionar `Escape` fecha o drawer quando `closeOnEscape = true`
+- Enquanto visível, o painel recebe `role="dialog"` e `aria-modal="true"`
+- O nome acessível é associado via `aria-labelledby`, apontando para o cabeçalho (`header`) renderizado como `<h2>`. Ao usar `sTemplate="header"`, forneça `ariaLabel` para que o painel continue tendo um nome acessível
+- Pressionar `Escape` fecha o drawer quando `closeOnEscape = true`, mas apenas se a instância estiver visível — instâncias fechadas (inclusive as mantidas no DOM por `cache = true`) ignoram o Escape, mesmo com múltiplas instâncias de `s-drawer` montadas na página
+- Se houver duas instâncias visíveis simultaneamente, um único Escape fecha as duas (a listener é por instância, sem controle centralizado de qual está "no topo")
 - O painel entra e sai com animação de deslizamento (300ms) vindo da direita
-- Ao abrir, o scroll da página é bloqueado automaticamente e restaurado ao fechar
+- Ao abrir, o scroll da página é bloqueado automaticamente e restaurado ao fechar. O bloqueio é compartilhado com outros overlays da biblioteca (ex: `SideSheet`) e com outras instâncias de `s-drawer` — fechar um não reativa o scroll enquanto outro ainda estiver aberto, e o valor de `overflow` anterior ao primeiro bloqueio é preservado
+- Ao fechar, o foco retorna automaticamente ao elemento que estava focado antes da abertura (ex: o botão que abriu o drawer)
+- Com `cache = true`, o painel permanece no DOM enquanto oculto, mas recebe `inert` e `aria-hidden="true"`, e o focus trap é desabilitado — o conteúdo escondido não fica alcançável por teclado ou leitor de tela. Use `cache` apenas quando o estado interno do conteúdo realmente precisa ser preservado entre aberturas
+- Como o backdrop (`dismissible`) só fecha por clique/toque, sem equivalente de teclado, definir `[closable]="false"` junto com `[closeOnEscape]="false"` remove todo caminho de fechamento acessível por teclado, a menos que o conteúdo customizado (`body`/`footer`) forneça o seu próprio. É responsabilidade de quem consome o componente garantir esse caminho ao optar por essa combinação
 
 ## Componentes relacionados
 

package/drawer/lib/drawer/drawer.component.d.ts

@@ -50,6 +50,12 @@ export declare class DrawerComponent implements AfterContentInit, OnDestroy {
      * Pode ser substituído por um template customizado via `sTemplate="header"`.
      */
     header?: string;
+    /**
+     * @description Nome acessível do drawer, usado quando o cabeçalho é um template
+     * customizado via `sTemplate="header"` (nesse caso não há `header` para associar
+     * via `aria-labelledby`). Ignorado quando `header` está definido.
+     */
+    ariaLabel?: string;
     /**
      * @description Quando `true`, aumenta a largura do drawer para acomodar mais conteúdo.
      *
@@ -68,21 +74,26 @@ export declare class DrawerComponent implements AfterContentInit, OnDestroy {
      * Quando retornar `false`, o fechamento é bloqueado. Útil para validar formulários não salvos.
      */
     set registerConfirmClose(fn: () => boolean);
+    /** @description Id único usado para associar o título ao painel via `aria-labelledby`. */
+    protected readonly titleId: string;
     headerTemplate: TemplateRef<unknown> | null;
     bodyTemplate: TemplateRef<unknown> | null;
     footerTemplate: TemplateRef<unknown> | null;
     protected readonly footerComponent: import("@angular/core").Signal<FooterComponent | undefined>;
     private _confirmClose;
+    private _elementToRefocus;
+    private readonly _scrollLock;
     private readonly visibleEffect;
     ngAfterContentInit(): void;
     ngOnDestroy(): void;
     closeDrawer(): void;
     handleEscape(): void;
+    private _restoreFocus;
     private _getCustomTemplate;
     private getHeaderTemplate;
     private getBodyTemplate;
     private getFooterTemplate;
     private _getTemplates;
     static ɵfac: i0.ɵɵFactoryDeclaration<DrawerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DrawerComponent, "s-drawer, s-sidebar", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; }; "dismissible": { "alias": "dismissible"; "required": false; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; }; "header": { "alias": "header"; "required": false; }; "largeSized": { "alias": "largeSized"; "required": false; }; "cache": { "alias": "cache"; "required": false; }; "registerConfirmClose": { "alias": "registerConfirmClose"; "required": false; }; }, { "visible": "visibleChange"; }, ["footerComponent", "templates"], [":not(s-footer)", "s-footer"], true, [{ directive: typeof i1.DeprecatedSelectorDirective; inputs: {}; outputs: {}; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DrawerComponent, "s-drawer, s-sidebar", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; }; "dismissible": { "alias": "dismissible"; "required": false; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; }; "header": { "alias": "header"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "largeSized": { "alias": "largeSized"; "required": false; }; "cache": { "alias": "cache"; "required": false; }; "registerConfirmClose": { "alias": "registerConfirmClose"; "required": false; }; }, { "visible": "visibleChange"; }, ["footerComponent", "templates"], [":not(s-footer)", "s-footer"], true, [{ directive: typeof i1.DeprecatedSelectorDirective; inputs: {}; outputs: {}; }]>;
 }

package/editor/lib/editor/editor.component.d.ts

@@ -60,10 +60,10 @@ export declare class EditorComponent implements AfterViewInit, OnDestroy, Contro
      * @description Emitido quando a seleção de texto no editor muda.
      */
     selectionChange: import("@angular/core").OutputEmitterRef<EditorSelectionChangeEvent>;
+    protected formDisabled: boolean;
     private editorContainer;
     private imageInput;
     private editor?;
-    private _formDisabled;
     private _currentPlaceholder;
     activeStates: {
         isBold: boolean;