@po-ui/ng-components 20.8.0 → 20.10.0

package/index.d.ts

@@ -2751,11 +2751,12 @@ declare class PoButtonBaseComponent {
      * @description
      * Ícone exibido ao lado esquerdo do label do botão.
      *
-     * É possível usar qualquer um dos ícones da [Biblioteca de ícones](https://po-ui.io/icons). conforme exemplo abaixo:
+     * É possível usar qualquer um dos ícones da [Biblioteca de ícones](https://po-ui.io/icons), conforme exemplo:
      * ```
      * <po-button p-icon="an an-user" p-label="PO button"></po-button>
      * ```
-     * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
+     * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, desde que a biblioteca
+     * esteja carregada no projeto:
      * ```
      * <po-button p-icon="fa fa-podcast" p-label="PO button"></po-button>
      * ```
@@ -3704,7 +3705,6 @@ declare class PoCheckboxComponent extends PoCheckboxBaseComponent implements Aft
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;
         helperSettings?: any;
@@ -3792,9 +3792,7 @@ declare class PoDirectivesModule {
  */
 declare class PoFieldContainerBottomComponent implements OnChanges {
     poTooltip: PoTooltipDirective;
-    /** Texto exibido no tooltip do ícone de ajuda adicional. */
-    /** @deprecated v23.x.x */
-    additionalHelpTooltip?: string;
+    helperEl?: PoHelperComponent;
     /** Define se o tooltip será inserido no `body` em vez do componente. */
     appendBox: boolean;
     disabled: boolean;
@@ -3807,24 +3805,18 @@ declare class PoFieldContainerBottomComponent implements OnChanges {
      * Limita a exibição da mensagem de erro a duas linhas e exibe um tooltip com o texto completo.
      */
     errorLimit: boolean;
+    /** Texto de apoio do campo. */
     help?: string;
-    /** Ativa a exibição da ajuda adicional. */
-    showAdditionalHelp: boolean;
-    /** Exibe o ícone de ajuda adicional. */
-    showAdditionalHelpIcon: boolean;
     /** Define o tamanho do componente. */
     size?: string;
-    /** Evento disparado ao clicar no ícone de ajuda adicional. */
-    /** @deprecated v23.x.x */
-    additionalHelp: EventEmitter<any>;
-    /** Propriedade para controlar a visibilidade do additionalHelp de acordo com a visibilidade do p-label do field.
-     * Caso o p-label esteja visível, o additionalHelp não será exibido.
-     **/
-    hideAdditionalHelpByLabel: i0.InputSignalWithTransform<boolean, unknown>;
+    /** Configurações do ícone de ajuda adicional vínculado ao label. */
+    poHelperComponent: i0.InputSignal<PoHelperOptions>;
+    /** Define se o componente helper estará visível através das ações customizadas */
+    showHelperComponent: i0.InputSignal<boolean>;
     private isInitialChange;
     ngOnChanges(changes: SimpleChanges): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldContainerBottomComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PoFieldContainerBottomComponent, "po-field-container-bottom", never, { "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "showAdditionalHelp": { "alias": "p-show-additional-help"; "required": false; }; "showAdditionalHelpIcon": { "alias": "p-show-additional-help-icon"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "hideAdditionalHelpByLabel": { "alias": "p-hide-additional-help-by-label"; "required": false; "isSignal": true; }; }, { "additionalHelp": "p-additional-help"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoFieldContainerBottomComponent, "po-field-container-bottom", never, { "appendBox": { "alias": "p-append-in-body"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "showHelperComponent": { "alias": "p-show-helper"; "required": false; "isSignal": true; }; }, {}, never, never, false, never>;
     static ngAcceptInputType_appendBox: any;
 }
 
@@ -4915,6 +4907,49 @@ interface PoModalAction {
     danger?: boolean;
     /** Desabilita o botão impossibilitando que sua ação seja executada. */
     disabled?: boolean;
+    /**
+     * Ícone exibido ao lado esquerdo do label do botão.
+     *
+     * É possível usar qualquer um dos ícones da [Biblioteca de ícones](https://po-ui.io/icons), conforme exemplo:
+     * ```
+     * modalAction: PoModalAction = {
+     *   action: () => {},
+     *   label: 'Botão com ícone PO',
+     *   icon: 'an an-user'
+     * };
+     * ```
+     * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, desde que a biblioteca
+     * esteja carregada no projeto:
+     * ```
+     * modalAction: PoModalAction = {
+     *   action: () => {},
+     *   label: 'Botão com ícone Font Awesome',
+     *   icon: 'fa fa-user'
+     * };
+     * ```
+     * Outra opção seria a customização do ícone através do `TemplateRef`, conforme exemplo abaixo:
+     * ```
+     * // Template HTML
+     * <ng-template #customIcon>
+     *   <span class="fa fa-user"></span>
+     * </ng-template>
+     *
+     * // Componente TypeScript
+     * @ViewChild('customIcon', { static: true }) customIcon: TemplateRef<void>;
+     *
+     * modalAction: PoModalAction = {
+     *   action: () => {},
+     *   label: 'Botão com ícone customizado',
+     * };
+     *
+     * // Atribuição do TemplateRef à propriedade icon após a inicialização da view
+     * ngAfterViewInit() {
+     *   this.modalAction.icon = this.customIcon;
+     * }
+     * ```
+     * > Para o ícone enquadrar corretamente, deve-se utilizar `font-size: inherit` caso o ícone utilizado não aplique-o.
+     */
+    icon?: string | TemplateRef<void>;
     /** Rótulo do botão. */
     label: string;
     /** Habilita um estado de carregamento ao botão, desabilitando-o e exibindo um ícone de carregamento à esquerda de seu rótulo. */
@@ -8692,7 +8727,6 @@ declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseComponent impl
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     trackByFn(index: any): any;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;
@@ -9192,7 +9226,6 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      * ```
      */
     showAdditionalHelp(helperHtmlElement?: PoHelperComponent, poHelperComponent?: string | PoHelperOptions): boolean;
-    showAdditionalHelpIcon(): boolean;
     protected isAdditionalHelpEventTriggered(): boolean;
     protected updateModel(value: T): void;
     abstract onWriteValue(value: T): void;
@@ -12878,7 +12911,6 @@ declare class PoComboComponent extends PoComboBaseComponent implements AfterView
     wasClickedOnToggle(event: MouseEvent): void;
     isValidCharacterToSearch(keyCode: any): boolean;
     searchOnEnterOrArrow(event: any, value: string): void;
-    showAdditionalHelpIcon(): boolean;
     showMoreInfiniteScroll(): void;
     clearAndFocus(): void;
     updateCacheOptions(): void;
@@ -13503,7 +13535,6 @@ declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements
     isValidDateIso(value: string): boolean;
     isValidExtendedIso(value: any): boolean;
     hasOverlayClass(element: any): any;
-    showAdditionalHelpIcon(): boolean;
     verifyErrorAsync(value: any): void;
     verifyMobile(): RegExpMatchArray;
     private closeCalendar;
@@ -14065,7 +14096,6 @@ declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseComponent
     onKeydown(event?: any): void;
     onKeyup(event: any): void;
     resetDateRangeInputValidation(): void;
-    showAdditionalHelpIcon(): boolean;
     /**
      * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
      * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
@@ -14615,7 +14645,6 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
     registerOnChange(func: any): void;
     registerOnTouched(func: any): void;
     registerOnValidatorChange(fn: () => void): void;
-    showAdditionalHelpIcon(): boolean;
     /**
      * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
      * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
@@ -15575,6 +15604,7 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
     private readonly language;
     private _size?;
     private _spacing;
+    inputEl: ElementRef;
     additionalHelpEventTrigger: string | undefined;
     /**
      *
@@ -16001,6 +16031,7 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
     protected oldValueToModel: any;
     protected onTouched: any;
     protected resizeListener: () => void;
+    protected isExpandedHeight: boolean;
     private _disabled?;
     private _fieldLabel;
     private _filterService;
@@ -16136,6 +16167,7 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
     private setService;
     private setControl;
     private initializeColumn;
+    private updateLookupInputHeight;
     abstract setViewValue(value: any, object: any): void;
     abstract openLookup(): void;
     abstract setDisclaimers(a: any): any;
@@ -16247,7 +16279,6 @@ declare class PoLookupComponent extends PoLookupBaseComponent implements AfterVi
     private renderer;
     private cd;
     private el;
-    inputEl: ElementRef;
     helperEl?: PoHelperComponent;
     initialized: boolean;
     timeoutResize: any;
@@ -16329,7 +16360,6 @@ declare class PoLookupComponent extends PoLookupBaseComponent implements AfterVi
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;
         helperSettings?: any;
@@ -16531,6 +16561,7 @@ declare class PoMultiselectFilterService implements PoMultiselectFilter {
  */
 declare abstract class PoMultiselectBaseComponent implements ControlValueAccessor, OnInit, Validator {
     protected cd?: ChangeDetectorRef;
+    inputElement: ElementRef;
     additionalHelpEventTrigger: string | undefined;
     /**
      *
@@ -16733,6 +16764,7 @@ declare abstract class PoMultiselectBaseComponent implements ControlValueAccesso
     protected clickOutListener: () => void;
     protected resizeListener: () => void;
     protected getObjectsByValuesSubscription: Subscription;
+    protected isExpandedHeight: boolean;
     private _filterService?;
     private _debounceTime?;
     private _disabled?;
@@ -17013,6 +17045,7 @@ declare abstract class PoMultiselectBaseComponent implements ControlValueAccesso
     private getValueWrite;
     private setLabelsAndValuesOptions;
     private validateModel;
+    private updateInputHeight;
     abstract applyFilter(value?: string): Observable<Array<PoMultiselectOption | any>>;
     abstract updateVisibleItems(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoMultiselectBaseComponent, never>;
@@ -17076,7 +17109,6 @@ declare class PoMultiselectComponent extends PoMultiselectBaseComponent implemen
     dropdownElement: ElementRef;
     dropdown: any;
     iconElement: ElementRef;
-    inputElement: ElementRef;
     outerContainer: ElementRef;
     helperEl?: PoHelperComponent;
     literalsTag: any;
@@ -17163,7 +17195,6 @@ declare class PoMultiselectComponent extends PoMultiselectBaseComponent implemen
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     wasClickedOnToggle(event: MouseEvent): void;
     applyFilter(value?: string): Observable<Array<PoMultiselectOption | any>>;
     setHelper(label?: string, additionalHelpTooltip?: string): {
@@ -17723,7 +17754,6 @@ declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;
         helperSettings?: any;
@@ -19529,7 +19559,6 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     stopUpload(file: PoUploadFile): void;
     trackByFn(index: any, file: PoUploadFile): string;
     uploadFiles(files: Array<PoUploadFile>): void;
@@ -20637,7 +20666,6 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     private isAdditionalHelpEventTriggered;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;

package/lib/components/po-button/po-button-base.component.d.ts

@@ -84,11 +84,12 @@ export declare class PoButtonBaseComponent {
      * @description
      * Ícone exibido ao lado esquerdo do label do botão.
      *
-     * É possível usar qualquer um dos ícones da [Biblioteca de ícones](https://po-ui.io/icons). conforme exemplo abaixo:
+     * É possível usar qualquer um dos ícones da [Biblioteca de ícones](https://po-ui.io/icons), conforme exemplo:
      * ```
      * <po-button p-icon="an an-user" p-label="PO button"></po-button>
      * ```
-     * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, da seguinte forma:
+     * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, desde que a biblioteca
+     * esteja carregada no projeto:
      * ```
      * <po-button p-icon="fa fa-podcast" p-label="PO button"></po-button>
      * ```

package/lib/components/po-field/po-checkbox/po-checkbox.component.d.ts

@@ -82,7 +82,6 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;
         helperSettings?: any;

package/lib/components/po-field/po-checkbox-group/po-checkbox-group.component.d.ts

@@ -81,7 +81,6 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     trackByFn(index: any): any;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;

package/lib/components/po-field/po-combo/po-combo.component.d.ts

@@ -159,7 +159,6 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     wasClickedOnToggle(event: MouseEvent): void;
     isValidCharacterToSearch(keyCode: any): boolean;
     searchOnEnterOrArrow(event: any, value: string): void;
-    showAdditionalHelpIcon(): boolean;
     showMoreInfiniteScroll(): void;
     clearAndFocus(): void;
     updateCacheOptions(): void;

package/lib/components/po-field/po-datepicker/po-datepicker.component.d.ts

@@ -123,7 +123,6 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     isValidDateIso(value: string): boolean;
     isValidExtendedIso(value: any): boolean;
     hasOverlayClass(element: any): any;
-    showAdditionalHelpIcon(): boolean;
     verifyErrorAsync(value: any): void;
     verifyMobile(): RegExpMatchArray;
     private closeCalendar;

package/lib/components/po-field/po-datepicker-range/po-datepicker-range.component.d.ts

@@ -92,7 +92,6 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     onKeydown(event?: any): void;
     onKeyup(event: any): void;
     resetDateRangeInputValidation(): void;
-    showAdditionalHelpIcon(): boolean;
     /**
      * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
      * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.

package/lib/components/po-field/po-field-container/po-field-container-bottom/po-field-container-bottom.component.d.ts

@@ -1,5 +1,6 @@
-import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { OnChanges, SimpleChanges } from '@angular/core';
 import { PoTooltipDirective } from '../../../../directives';
+import { PoHelperComponent, PoHelperOptions } from '../../../po-helper';
 /**
  * @docsPrivate
  *
@@ -10,9 +11,7 @@ import { PoTooltipDirective } from '../../../../directives';
  */
 export declare class PoFieldContainerBottomComponent implements OnChanges {
     poTooltip: PoTooltipDirective;
-    /** Texto exibido no tooltip do ícone de ajuda adicional. */
-    /** @deprecated v23.x.x */
-    additionalHelpTooltip?: string;
+    helperEl?: PoHelperComponent;
     /** Define se o tooltip será inserido no `body` em vez do componente. */
     appendBox: boolean;
     disabled: boolean;
@@ -25,20 +24,14 @@ export declare class PoFieldContainerBottomComponent implements OnChanges {
      * Limita a exibição da mensagem de erro a duas linhas e exibe um tooltip com o texto completo.
      */
     errorLimit: boolean;
+    /** Texto de apoio do campo. */
     help?: string;
-    /** Ativa a exibição da ajuda adicional. */
-    showAdditionalHelp: boolean;
-    /** Exibe o ícone de ajuda adicional. */
-    showAdditionalHelpIcon: boolean;
     /** Define o tamanho do componente. */
     size?: string;
-    /** Evento disparado ao clicar no ícone de ajuda adicional. */
-    /** @deprecated v23.x.x */
-    additionalHelp: EventEmitter<any>;
-    /** Propriedade para controlar a visibilidade do additionalHelp de acordo com a visibilidade do p-label do field.
-     * Caso o p-label esteja visível, o additionalHelp não será exibido.
-     **/
-    hideAdditionalHelpByLabel: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /** Configurações do ícone de ajuda adicional vínculado ao label. */
+    poHelperComponent: import("@angular/core").InputSignal<PoHelperOptions>;
+    /** Define se o componente helper estará visível através das ações customizadas */
+    showHelperComponent: import("@angular/core").InputSignal<boolean>;
     private isInitialChange;
     ngOnChanges(changes: SimpleChanges): void;
 }

package/lib/components/po-field/po-field.model.d.ts

@@ -114,7 +114,6 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      * ```
      */
     showAdditionalHelp(helperHtmlElement?: PoHelperComponent, poHelperComponent?: string | PoHelperOptions): boolean;
-    showAdditionalHelpIcon(): boolean;
     protected isAdditionalHelpEventTriggered(): boolean;
     protected updateModel(value: T): void;
     abstract onWriteValue(value: T): void;

package/lib/components/po-field/po-input/po-input-base.component.d.ts

@@ -457,7 +457,6 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
     registerOnChange(func: any): void;
     registerOnTouched(func: any): void;
     registerOnValidatorChange(fn: () => void): void;
-    showAdditionalHelpIcon(): boolean;
     /**
      * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
      * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.

package/lib/components/po-field/po-lookup/po-lookup-base.component.d.ts

@@ -1,4 +1,4 @@
-import { AfterViewInit, EventEmitter, Injector, OnChanges, OnDestroy, OnInit, SimpleChanges } from '@angular/core';
+import { AfterViewInit, ElementRef, EventEmitter, Injector, OnChanges, OnDestroy, OnInit, SimpleChanges } from '@angular/core';
 import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
 import { Subscription } from 'rxjs';
 import { PoLanguageService } from '../../../services/po-language/po-language.service';
@@ -39,6 +39,7 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
     private readonly language;
     private _size?;
     private _spacing;
+    inputEl: ElementRef;
     additionalHelpEventTrigger: string | undefined;
     /**
      *
@@ -465,6 +466,7 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
     protected oldValueToModel: any;
     protected onTouched: any;
     protected resizeListener: () => void;
+    protected isExpandedHeight: boolean;
     private _disabled?;
     private _fieldLabel;
     private _filterService;
@@ -600,6 +602,7 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
     private setService;
     private setControl;
     private initializeColumn;
+    private updateLookupInputHeight;
     abstract setViewValue(value: any, object: any): void;
     abstract openLookup(): void;
     abstract setDisclaimers(a: any): any;

package/lib/components/po-field/po-lookup/po-lookup.component.d.ts

@@ -1,4 +1,4 @@
-import { AfterViewInit, DoCheck, ElementRef, OnDestroy, OnInit, SimpleChanges, OnChanges } from '@angular/core';
+import { AfterViewInit, DoCheck, OnDestroy, OnInit, SimpleChanges, OnChanges } from '@angular/core';
 import { PoTableColumnSpacing } from '../../po-table';
 import { PoLookupBaseComponent } from './po-lookup-base.component';
 import { PoHelperComponent } from '../../po-helper';
@@ -95,7 +95,6 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
     private renderer;
     private cd;
     private el;
-    inputEl: ElementRef;
     helperEl?: PoHelperComponent;
     initialized: boolean;
     timeoutResize: any;
@@ -177,7 +176,6 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;
         helperSettings?: any;

package/lib/components/po-field/po-multiselect/po-multiselect-base.component.d.ts

@@ -1,4 +1,4 @@
-import { ChangeDetectorRef, EventEmitter, OnInit } from '@angular/core';
+import { ChangeDetectorRef, ElementRef, EventEmitter, OnInit } from '@angular/core';
 import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
 import { Observable, Subject, Subscription } from 'rxjs';
 import { PoLanguageService } from '../../../services/po-language/po-language.service';
@@ -72,6 +72,7 @@ export declare const poMultiselectLiteralsDefault: {
  */
 export declare abstract class PoMultiselectBaseComponent implements ControlValueAccessor, OnInit, Validator {
     protected cd?: ChangeDetectorRef;
+    inputElement: ElementRef;
     additionalHelpEventTrigger: string | undefined;
     /**
      *
@@ -274,6 +275,7 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
     protected clickOutListener: () => void;
     protected resizeListener: () => void;
     protected getObjectsByValuesSubscription: Subscription;
+    protected isExpandedHeight: boolean;
     private _filterService?;
     private _debounceTime?;
     private _disabled?;
@@ -554,6 +556,7 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
     private getValueWrite;
     private setLabelsAndValuesOptions;
     private validateModel;
+    private updateInputHeight;
     abstract applyFilter(value?: string): Observable<Array<PoMultiselectOption | any>>;
     abstract updateVisibleItems(): void;
 }

package/lib/components/po-field/po-multiselect/po-multiselect.component.d.ts

@@ -57,7 +57,6 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
     dropdownElement: ElementRef;
     dropdown: any;
     iconElement: ElementRef;
-    inputElement: ElementRef;
     outerContainer: ElementRef;
     helperEl?: PoHelperComponent;
     literalsTag: any;
@@ -144,7 +143,6 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     wasClickedOnToggle(event: MouseEvent): void;
     applyFilter(value?: string): Observable<Array<PoMultiselectOption | any>>;
     setHelper(label?: string, additionalHelpTooltip?: string): {

package/lib/components/po-field/po-radio-group/po-radio-group.component.d.ts

@@ -97,7 +97,6 @@ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent imp
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;
         helperSettings?: any;

package/lib/components/po-field/po-textarea/po-textarea.component.d.ts

@@ -92,7 +92,6 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     private isAdditionalHelpEventTriggered;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;

package/lib/components/po-field/po-upload/po-upload.component.d.ts

@@ -145,7 +145,6 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     stopUpload(file: PoUploadFile): void;
     trackByFn(index: any, file: PoUploadFile): string;
     uploadFiles(files: Array<PoUploadFile>): void;

package/lib/components/po-modal/po-modal-action.interface.d.ts

@@ -1,3 +1,4 @@
+import { TemplateRef } from '@angular/core';
 /**
  * @usedBy PoModalComponent
  *
@@ -16,6 +17,49 @@ export interface PoModalAction {
     danger?: boolean;
     /** Desabilita o botão impossibilitando que sua ação seja executada. */
     disabled?: boolean;
+    /**
+     * Ícone exibido ao lado esquerdo do label do botão.
+     *
+     * É possível usar qualquer um dos ícones da [Biblioteca de ícones](https://po-ui.io/icons), conforme exemplo:
+     * ```
+     * modalAction: PoModalAction = {
+     *   action: () => {},
+     *   label: 'Botão com ícone PO',
+     *   icon: 'an an-user'
+     * };
+     * ```
+     * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca *Font Awesome*, desde que a biblioteca
+     * esteja carregada no projeto:
+     * ```
+     * modalAction: PoModalAction = {
+     *   action: () => {},
+     *   label: 'Botão com ícone Font Awesome',
+     *   icon: 'fa fa-user'
+     * };
+     * ```
+     * Outra opção seria a customização do ícone através do `TemplateRef`, conforme exemplo abaixo:
+     * ```
+     * // Template HTML
+     * <ng-template #customIcon>
+     *   <span class="fa fa-user"></span>
+     * </ng-template>
+     *
+     * // Componente TypeScript
+     * @ViewChild('customIcon', { static: true }) customIcon: TemplateRef<void>;
+     *
+     * modalAction: PoModalAction = {
+     *   action: () => {},
+     *   label: 'Botão com ícone customizado',
+     * };
+     *
+     * // Atribuição do TemplateRef à propriedade icon após a inicialização da view
+     * ngAfterViewInit() {
+     *   this.modalAction.icon = this.customIcon;
+     * }
+     * ```
+     * > Para o ícone enquadrar corretamente, deve-se utilizar `font-size: inherit` caso o ícone utilizado não aplique-o.
+     */
+    icon?: string | TemplateRef<void>;
     /** Rótulo do botão. */
     label: string;
     /** Habilita um estado de carregamento ao botão, desabilitando-o e exibindo um ícone de carregamento à esquerda de seu rótulo. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@po-ui/ng-components",
-  "version": "20.8.0",
+  "version": "20.10.0",
   "description": "PO UI - Components",
   "author": "PO UI",
   "license": "MIT",
@@ -22,8 +22,8 @@
   },
   "dependencies": {
     "@angular/cdk": "~20.0.3",
-    "@po-ui/style": "20.8.0",
-    "@po-ui/ng-schematics": "20.8.0",
+    "@po-ui/style": "20.10.0",
+    "@po-ui/ng-schematics": "20.10.0",
     "echarts": "^5.6.0",
     "tslib": "^2.3.0"
   },
@@ -38,7 +38,7 @@
     "@angular/platform-browser-dynamic": "^20",
     "@angular/router": "^20",
     "@angular-devkit/schematics": "^20",
-    "@po-ui/style": "20.8.0",
+    "@po-ui/style": "20.10.0",
     "rxjs": "~7.8.1",
     "zone.js": "~0.15.0"
   },

package/schematics/ng-add/index.js

@@ -18,7 +18,7 @@ function default_1(options) {
 }
 function addPoPackageAndInstall() {
     return (tree, context) => {
-        (0, package_config_1.addPackageToPackageJson)(tree, '@po-ui/ng-components', '20.8.0');
+        (0, package_config_1.addPackageToPackageJson)(tree, '@po-ui/ng-components', '20.10.0');
         // install packages
         context.addTask(new tasks_1.NodePackageInstallTask());
     };

package/schematics/ng-update/v14/index.js

@@ -6,7 +6,7 @@ const tasks_1 = require("@angular-devkit/schematics/tasks");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('20.8.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('20.10.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v15/index.js

@@ -11,7 +11,7 @@ const changes_1 = require("./changes");
 const httpClientModuleName = 'HttpClientModule';
 const httpClientModuleSourcePath = '@angular/common/http';
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('20.8.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('20.10.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v16/index.js

@@ -6,7 +6,7 @@ const tasks_1 = require("@angular-devkit/schematics/tasks");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('20.8.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('20.10.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v17/index.js

@@ -6,7 +6,7 @@ const tasks_1 = require("@angular-devkit/schematics/tasks");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('20.8.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('20.10.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {