@po-ui/ng-components 20.9.0 → 20.11.0-beta.1

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`.
@@ -14364,12 +14394,12 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
     /**
      * @description
      *
-     * Define se os caracteres especiais da máscara devem ser ignorados ao validar os comprimentos mínimo (`minLength`) e máximo (`maxLength`) do campo.
+     * Controla como o componente aplica as validações de comprimento mínimo (`minLength`) e máximo (`maxLength`) quando há uma máscara (`p-mask`) definida.
      *
      * - Quando `true`, apenas os caracteres alfanuméricos serão contabilizados para a validação dos comprimentos.
      * - Quando `false`, todos os caracteres, incluindo os especiais da máscara, serão considerados na validação.
      *
-     * > Será ignorado essa propriedade , caso esteja utilizando junto com a propriedade `p-mask-format-model`.
+     * > Esta propriedade é ignorada quando utilizada em conjunto com `p-mask-format-model`.
      *
      * Exemplo:
      * ```
@@ -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): {
@@ -17239,6 +17270,17 @@ declare abstract class PoNumberBaseComponent extends PoInputGeneric {
  * </example>
  */
 declare class PoNumberComponent extends PoNumberBaseComponent implements AfterViewInit, OnChanges {
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Indica uma máscara para o campo, porém é incompatível com o `po-number`.
+     * > **Componentes compatíveis:** `po-input`,`po-decimal`.
+     *
+     * @override
+     */
+    mask?: string;
     /**
      * @optional
      *
@@ -17723,7 +17765,6 @@ declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;
         helperSettings?: any;
@@ -19529,7 +19570,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 +20677,6 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
      * ```
      */
     showAdditionalHelp(): boolean;
-    showAdditionalHelpIcon(): boolean;
     private isAdditionalHelpEventTriggered;
     setHelper(label?: string, additionalHelpTooltip?: string): {
         hideAdditionalHelp: boolean;
@@ -21507,17 +21546,44 @@ interface PoDynamicFormField extends PoDynamicField {
     /**
      * Máscara para o campo.
      *
-     * **Componentes compatíveis:** `po-input`.
+     * **Componente compatível:** `po-input`.
      * > também é atribuído ao utilizar a propriedade `type: time`.
      */
     mask?: string;
     /**
      * Define que o valor do componente será conforme especificado na mascára. O valor padrão é `false`.
      *
-     * **Componentes compatíveis:** `po-input`.
+     * **Componente compatível:** `po-input`.
      * > também é atribuído ao utilizar a propriedade `type: time`.
      * */
     maskFormatModel?: boolean;
+    /**
+     * Controla como o componente aplica as validações de comprimento mínimo (`minLength`) e máximo (`maxLength`) quando há uma máscara (`p-mask`) definida.
+     *
+     * - Quando `true`, apenas os caracteres alfanuméricos serão contabilizados para a validação dos comprimentos.
+     * - Quando `false`, todos os caracteres, incluindo os especiais da máscara, serão considerados na validação.
+     *
+     * **Componentes compatíveis:** `po-input`, `po-decimal`.
+     *
+     * > Esta propriedade é ignorada quando utilizada em conjunto com `p-mask-format-model`.
+     *
+     * Exemplo:
+     * ```
+     * fields:Array<PoDynamicFormField> = [
+     * {
+     *   property: 'CNPJ maskNoLengthValidation TRUE',
+     *   required: true,
+     *   showRequired: true,
+     *   mask: '99.999.999/9999-99',
+     *   pattern: '([0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9])',
+     *   maskNoLengthValidation: true,
+     *   maxLength: 14,
+     *   minLength: 0
+     * }
+     * ```
+     * - Entrada: `11.111.111/1111-11` → Validação será aplicada somente aos números, ignorando os caracteres especiais.
+     */
+    maskNoLengthValidation?: boolean;
     /** Define o ícone que será exibido no início do campo.
      * > Esta propriedade só pode ser utilizado nos campos:
      * - Input;
@@ -21800,7 +21866,7 @@ interface PoDynamicFormField extends PoDynamicField {
     /**
      * Permite a seleção de múltiplos itens.
      *
-     * **Componente compatível:** `po-lookup`, `po-upload`
+     * **Componentes compatíveis:** `po-lookup`, `po-upload`
      */
     multiple?: boolean;
     /** Se verdadeiro, o campo receberá um botão para ser limpo.
@@ -21867,7 +21933,7 @@ interface PoDynamicFormField extends PoDynamicField {
      * Define o modo de pesquisa utilizado no filtro da lista de seleção: `startsWith`, `contains` ou `endsWith`.
      * > Quando utilizar a propriedade p-filter-service esta propriedade será ignorada.
      *
-     * **Componentes compatíveis:** `po-multiselect`.
+     * **Componente compatível:** `po-multiselect`.
      */
     filterMode?: PoMultiselectFilterMode;
     /**
@@ -21949,7 +22015,7 @@ interface PoDynamicFormField extends PoDynamicField {
      * O componente envia como parâmetro um array de string com as colunas visíveis atualizadas.
      * Por exemplo: ["idCard", "name", "hireStatus", "age"].
      *
-     * **Componentes compatíveis**: `po-lookup`
+     * **Componente compatível**: `po-lookup`
      */
     changeVisibleColumns?: Function;
     /**
@@ -21958,7 +22024,7 @@ interface PoDynamicFormField extends PoDynamicField {
      * O componente envia como parâmetro um array de string com as colunas configuradas inicialmente.
      * Por exemplo: ["idCard", "name", "hireStatus", "age"].
      *
-     * **Componentes compatíveis**: `po-lookup`
+     * **Componente compatível**: `po-lookup`
      */
     columnRestoreManager?: Function;
     /**

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-dynamic/po-dynamic-form/interfaces/po-dynamic-form-field.interface.d.ts

@@ -104,17 +104,44 @@ export interface PoDynamicFormField extends PoDynamicField {
     /**
      * Máscara para o campo.
      *
-     * **Componentes compatíveis:** `po-input`.
+     * **Componente compatível:** `po-input`.
      * > também é atribuído ao utilizar a propriedade `type: time`.
      */
     mask?: string;
     /**
      * Define que o valor do componente será conforme especificado na mascára. O valor padrão é `false`.
      *
-     * **Componentes compatíveis:** `po-input`.
+     * **Componente compatível:** `po-input`.
      * > também é atribuído ao utilizar a propriedade `type: time`.
      * */
     maskFormatModel?: boolean;
+    /**
+     * Controla como o componente aplica as validações de comprimento mínimo (`minLength`) e máximo (`maxLength`) quando há uma máscara (`p-mask`) definida.
+     *
+     * - Quando `true`, apenas os caracteres alfanuméricos serão contabilizados para a validação dos comprimentos.
+     * - Quando `false`, todos os caracteres, incluindo os especiais da máscara, serão considerados na validação.
+     *
+     * **Componentes compatíveis:** `po-input`, `po-decimal`.
+     *
+     * > Esta propriedade é ignorada quando utilizada em conjunto com `p-mask-format-model`.
+     *
+     * Exemplo:
+     * ```
+     * fields:Array<PoDynamicFormField> = [
+     * {
+     *   property: 'CNPJ maskNoLengthValidation TRUE',
+     *   required: true,
+     *   showRequired: true,
+     *   mask: '99.999.999/9999-99',
+     *   pattern: '([0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9])',
+     *   maskNoLengthValidation: true,
+     *   maxLength: 14,
+     *   minLength: 0
+     * }
+     * ```
+     * - Entrada: `11.111.111/1111-11` → Validação será aplicada somente aos números, ignorando os caracteres especiais.
+     */
+    maskNoLengthValidation?: boolean;
     /** Define o ícone que será exibido no início do campo.
      * > Esta propriedade só pode ser utilizado nos campos:
      * - Input;
@@ -397,7 +424,7 @@ export interface PoDynamicFormField extends PoDynamicField {
     /**
      * Permite a seleção de múltiplos itens.
      *
-     * **Componente compatível:** `po-lookup`, `po-upload`
+     * **Componentes compatíveis:** `po-lookup`, `po-upload`
      */
     multiple?: boolean;
     /** Se verdadeiro, o campo receberá um botão para ser limpo.
@@ -464,7 +491,7 @@ export interface PoDynamicFormField extends PoDynamicField {
      * Define o modo de pesquisa utilizado no filtro da lista de seleção: `startsWith`, `contains` ou `endsWith`.
      * > Quando utilizar a propriedade p-filter-service esta propriedade será ignorada.
      *
-     * **Componentes compatíveis:** `po-multiselect`.
+     * **Componente compatível:** `po-multiselect`.
      */
     filterMode?: PoMultiselectFilterMode;
     /**
@@ -546,7 +573,7 @@ export interface PoDynamicFormField extends PoDynamicField {
      * O componente envia como parâmetro um array de string com as colunas visíveis atualizadas.
      * Por exemplo: ["idCard", "name", "hireStatus", "age"].
      *
-     * **Componentes compatíveis**: `po-lookup`
+     * **Componente compatível**: `po-lookup`
      */
     changeVisibleColumns?: Function;
     /**
@@ -555,7 +582,7 @@ export interface PoDynamicFormField extends PoDynamicField {
      * O componente envia como parâmetro um array de string com as colunas configuradas inicialmente.
      * Por exemplo: ["idCard", "name", "hireStatus", "age"].
      *
-     * **Componentes compatíveis**: `po-lookup`
+     * **Componente compatível**: `po-lookup`
      */
     columnRestoreManager?: Function;
     /**

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

@@ -206,12 +206,12 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
     /**
      * @description
      *
-     * Define se os caracteres especiais da máscara devem ser ignorados ao validar os comprimentos mínimo (`minLength`) e máximo (`maxLength`) do campo.
+     * Controla como o componente aplica as validações de comprimento mínimo (`minLength`) e máximo (`maxLength`) quando há uma máscara (`p-mask`) definida.
      *
      * - Quando `true`, apenas os caracteres alfanuméricos serão contabilizados para a validação dos comprimentos.
      * - Quando `false`, todos os caracteres, incluindo os especiais da máscara, serão considerados na validação.
      *
-     * > Será ignorado essa propriedade , caso esteja utilizando junto com a propriedade `p-mask-format-model`.
+     * > Esta propriedade é ignorada quando utilizada em conjunto com `p-mask-format-model`.
      *
      * Exemplo:
      * ```
@@ -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;