@po-ui/ng-components 20.6.0 → 20.8.0

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

@@ -1,7 +1,6 @@
-import { AfterViewInit, ElementRef, OnDestroy, OnInit } from '@angular/core';
+import { AfterViewInit, ElementRef, OnDestroy, OnInit, OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputBaseComponent } from '../po-input/po-input-base.component';
-import { PoHelperOptions } from '../../po-helper';
 /**
  *
  * @docsExtends PoInputBaseComponent
@@ -41,7 +40,7 @@ import { PoHelperOptions } from '../../po-helper';
  *  <file name="sample-po-decimal-hourly-wage-reactive-form/sample-po-decimal-hourly-wage-reactive-form.component.ts"> </file>
  * </example>
  */
-export declare class PoDecimalComponent extends PoInputBaseComponent implements AfterViewInit, OnInit, OnDestroy {
+export declare class PoDecimalComponent extends PoInputBaseComponent implements AfterViewInit, OnInit, OnDestroy, OnChanges {
     private el;
     private poLanguageService;
     inputEl: ElementRef;
@@ -59,7 +58,6 @@ export declare class PoDecimalComponent extends PoInputBaseComponent implements
     private thousandSeparator;
     private valueBeforeChange;
     private subscriptionValidator;
-    helperSettings: PoHelperOptions;
     private regex;
     get autocomplete(): "off" | "on";
     /**
@@ -127,6 +125,7 @@ export declare class PoDecimalComponent extends PoInputBaseComponent implements
     get max(): number;
     constructor();
     ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     setNumbersSeparators(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;

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

@@ -1,4 +1,4 @@
-import { AfterViewInit, OnDestroy, OnInit } from '@angular/core';
+import { AfterViewInit, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputGeneric } from '../po-input-generic/po-input-generic';
 /**
@@ -25,7 +25,7 @@ import { PoInputGeneric } from '../po-input-generic/po-input-generic';
  *  <file name="sample-po-email-newsletter/sample-po-email-newsletter.component.ts"> </file>
  * </example>
  */
-export declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnInit {
+export declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnChanges {
     id: string;
     icon: string;
     type: string;
@@ -33,7 +33,7 @@ export declare class PoEmailComponent extends PoInputGeneric implements AfterVie
     mask: string;
     private listener;
     constructor();
-    ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     extraValidation(c: AbstractControl): {

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

@@ -30,6 +30,8 @@ export declare class PoFieldContainerBottomComponent implements OnChanges {
     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>;

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

@@ -44,6 +44,8 @@ export declare class PoFieldContainerComponent implements OnInit, OnChanges {
     get required(): boolean;
     /** Define se a indicação de campo obrigatório será exibida. */
     showRequired: boolean;
+    /** Define o tamanho do componente. */
+    size?: string;
     constructor(cdr: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;

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

@@ -1,5 +1,6 @@
 import { ChangeDetectorRef, EventEmitter } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
+import { PoHelperComponent, PoHelperOptions } from '../po-helper';
 export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
     private readonly cd;
     additionalHelpEventTrigger: string | undefined;
@@ -10,8 +11,7 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      * @optional
      *
      * @description
-     * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
-     * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
+     * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
      * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
      * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
      *
@@ -23,11 +23,11 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      *
      * @description
      *
-     * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
+     * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
      * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
      * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
      *
-     * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
+     * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
      *
      * @default `false`
      */
@@ -56,7 +56,6 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      *
      * @description
      * Evento disparado ao clicar no ícone de ajuda adicional.
-     * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
      *
      * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
      */
@@ -90,20 +89,12 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
     emitChange(value: any): void;
     getAdditionalHelpTooltip(): string;
     /**
-     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * 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`.
      *
-     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
      *
      * ```
-     * <po-nome-component
-     *  #component
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, component)"
-     * ></po-nome-component>
-     * ```
-     * ```
      * // Exemplo com p-label e p-helper
      * <po-nome-component
      *  #component
@@ -122,7 +113,7 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      * }
      * ```
      */
-    showAdditionalHelp(): boolean;
+    showAdditionalHelp(helperHtmlElement?: PoHelperComponent, poHelperComponent?: string | PoHelperOptions): boolean;
     showAdditionalHelpIcon(): boolean;
     protected isAdditionalHelpEventTriggered(): boolean;
     protected updateModel(value: T): void;

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

@@ -1,7 +1,7 @@
 import { ChangeDetectorRef, EventEmitter, OnDestroy, TemplateRef } from '@angular/core';
 import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
 import { ErrorAsyncProperties } from '../shared/interfaces/error-async-properties.interface';
-import { PoHelperOptions } from '../../po-helper';
+import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
 import { PoFieldContainerComponent } from '../po-field-container';
 /**
  * @description
@@ -53,6 +53,7 @@ import { PoFieldContainerComponent } from '../po-field-container';
 export declare abstract class PoInputBaseComponent implements ControlValueAccessor, Validator, OnDestroy {
     protected cd?: ChangeDetectorRef;
     fieldContainer?: PoFieldContainerComponent;
+    helperEl?: PoHelperComponent;
     additionalHelpEventTrigger: string | undefined;
     /**
      *
@@ -61,8 +62,7 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      * @optional
      *
      * @description
-     * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
-     * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
+     * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
      * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
      * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
      *
@@ -74,11 +74,11 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      *
      * @description
      *
-     * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
+     * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
      * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
      * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
      *
-     * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
+     * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
      *
      * @default `false`
      */
@@ -236,7 +236,6 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      *
      * @description
      * Evento disparado ao clicar no ícone de ajuda adicional.
-     * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
      *
      * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
      */
@@ -427,10 +426,10 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      *
      * @description
      *
-     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
+     * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
      *
-     * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
-     * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
+     * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
@@ -460,18 +459,11 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
     registerOnValidatorChange(fn: () => void): void;
     showAdditionalHelpIcon(): boolean;
     /**
-     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * 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`.
      *
-     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
-     * ```
-     * <po-nome-component
-     *  #component
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, component)"
-     * ></po-nome-component>
-     * ```
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
+     *
      * ```
      * // Exemplo com p-label e p-helper
      * <po-nome-component
@@ -482,6 +474,7 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      *  (p-keydown)="onKeyDown($event, component)"
      * ></po-nome-component>
      * ```
+     *
      * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoNomeDoComponente): void {

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

@@ -1,4 +1,4 @@
-import { ElementRef, OnInit } from '@angular/core';
+import { ElementRef, OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputGeneric } from '../po-input-generic/po-input-generic';
 /**
@@ -21,11 +21,11 @@ import { PoInputGeneric } from '../po-input-generic/po-input-generic';
  *  <file name="sample-po-input-reactive-form/sample-po-input-reactive-form.component.ts"> </file>
  * </example>
  */
-export declare class PoInputComponent extends PoInputGeneric implements OnInit {
+export declare class PoInputComponent extends PoInputGeneric implements OnChanges {
     inp: ElementRef;
     id: string;
     constructor();
-    ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     extraValidation(c: AbstractControl): {
         [key: string]: any;
     };

package/lib/components/po-field/po-input-generic/po-input-generic.d.ts

@@ -1,14 +1,12 @@
 import { AfterViewInit, ChangeDetectorRef, ElementRef, OnDestroy } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputBaseComponent } from '../po-input/po-input-base.component';
-import { PoHelperOptions } from '../../po-helper';
 export declare abstract class PoInputGeneric extends PoInputBaseComponent implements AfterViewInit, OnDestroy {
     inputEl: ElementRef;
     type: string;
     el: ElementRef;
     valueBeforeChange: any;
     timeoutChange: any;
-    helperSettings: PoHelperOptions;
     private subscriptionValidator;
     get autocomplete(): string;
     constructor(el: ElementRef, cd?: ChangeDetectorRef);

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

@@ -1,3 +1,4 @@
+import { OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputGeneric } from '../po-input-generic/po-input-generic';
 /**
@@ -24,7 +25,7 @@ import { PoInputGeneric } from '../po-input-generic/po-input-generic';
  * </example>
  *
  */
-export declare class PoLoginComponent extends PoInputGeneric {
+export declare class PoLoginComponent extends PoInputGeneric implements OnChanges {
     id: string;
     type: string;
     private _noAutocompleteLogin?;
@@ -32,6 +33,7 @@ export declare class PoLoginComponent extends PoInputGeneric {
     get noAutocomplete(): boolean;
     get autocomplete(): string;
     constructor();
+    ngOnChanges(changes: SimpleChanges): void;
     extraValidation(c: AbstractControl): {
         [key: string]: any;
     };

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

@@ -47,8 +47,7 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
      * @optional
      *
      * @description
-     * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
-     * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
+     * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
      * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
      * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
      *
@@ -60,11 +59,11 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
      *
      * @description
      *
-     * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
+     * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
      * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
      * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
      *
-     * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
+     * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
      *
      * @default `false`
      */
@@ -373,10 +372,10 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
      *
      * @description
      *
-     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
+     * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
      *
-     * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
-     * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
+     * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
@@ -401,7 +400,6 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
      *
      * @description
      * Evento disparado ao clicar no ícone de ajuda adicional.
-     * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
      *
      * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
      */

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

@@ -1,8 +1,8 @@
 import { ComponentRef, ElementRef, OnInit, ViewContainerRef } from '@angular/core';
 import { NgForm } from '@angular/forms';
 import { Observable } from 'rxjs';
-import { PoLookupModalBaseComponent } from '../po-lookup-modal/po-lookup-modal-base.component';
 import { PoTableColumnSort } from '../../../po-table/interfaces/po-table-column-sort.interface';
+import { PoLookupModalBaseComponent } from '../po-lookup-modal/po-lookup-modal-base.component';
 /**
  * @docsPrivate
  *

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

@@ -1,7 +1,7 @@
-import { AfterViewInit, DoCheck, ElementRef, OnDestroy, OnInit } from '@angular/core';
+import { AfterViewInit, DoCheck, ElementRef, OnDestroy, OnInit, SimpleChanges, OnChanges } from '@angular/core';
 import { PoTableColumnSpacing } from '../../po-table';
 import { PoLookupBaseComponent } from './po-lookup-base.component';
-import { PoHelperOptions } from '../../po-helper';
+import { PoHelperComponent } from '../../po-helper';
 /**
  * @docsExtends PoLookupBaseComponent
  *
@@ -91,11 +91,12 @@ import { PoHelperOptions } from '../../po-helper';
  *  <file name="sample-po-lookup-multiple/sample-po-lookup-multiple.service.ts"> </file>
  * </example>
  */
-export declare class PoLookupComponent extends PoLookupBaseComponent implements AfterViewInit, OnDestroy, OnInit, DoCheck {
+export declare class PoLookupComponent extends PoLookupBaseComponent implements AfterViewInit, OnDestroy, OnInit, DoCheck, OnChanges {
     private renderer;
     private cd;
     private el;
     inputEl: ElementRef;
+    helperEl?: PoHelperComponent;
     initialized: boolean;
     timeoutResize: any;
     visibleElement: boolean;
@@ -103,7 +104,6 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
     disclaimers: any[];
     visibleDisclaimers: any[];
     id: string;
-    helperSettings: PoHelperOptions;
     private modalSubscription;
     private isCalculateVisibleItems;
     get autocomplete(): "off" | "on";
@@ -112,6 +112,7 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
     ngDoCheck(): void;
     ngOnDestroy(): void;
     ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     /**
      * Função que atribui foco ao componente.
      *
@@ -151,18 +152,11 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
     onKeyDown(event: KeyboardEvent): void;
     /**
      *
-     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * 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`.
      *
-     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
-     * ```
-     * <po-lookup
-     *  #lookup
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, lookup)"
-     * ></po-lookup>
-     * ```
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
+     *
      * ```
      * // Exemplo com p-label e p-helper
      * <po-lookup

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

@@ -80,8 +80,7 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
      * @optional
      *
      * @description
-     * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
-     * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
+     * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
      * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
      * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
      *
@@ -182,7 +181,6 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
      *
      * @description
      * Evento disparado ao clicar no ícone de ajuda adicional.
-     * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
      *
      * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
      */
@@ -208,11 +206,11 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
      *
      * @description
      *
-     * Define que o `listbox` e/ou tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) serão incluídos no body da
+     * Define que o `listbox` e/ou popover (`p-helper` e/ou `p-error-limit`) serão incluídos no body da
      * página e não dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou
      * overflow escondido, garantindo o posicionamento correto de ambos próximo ao elemento.
      *
-     * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
+     * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
      *
      * @default `false`
      */
@@ -243,10 +241,10 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
      *
      * @description
      *
-     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
+     * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
      *
-     * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
-     * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
+     * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**

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

@@ -4,7 +4,7 @@ import { PoMultiselectOption } from './interfaces/po-multiselect-option.interfac
 import { PoMultiselectBaseComponent } from './po-multiselect-base.component';
 import { PoMultiselectFilterService } from './po-multiselect-filter.service';
 import { PoMultiselectOptionTemplateDirective } from './po-multiselect-option-template/po-multiselect-option-template.directive';
-import { PoHelperOptions } from '../../po-helper';
+import { PoHelperComponent } from '../../po-helper';
 /**
  * @docsExtends PoMultiselectBaseComponent
  *
@@ -59,6 +59,7 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
     iconElement: ElementRef;
     inputElement: ElementRef;
     outerContainer: ElementRef;
+    helperEl?: PoHelperComponent;
     literalsTag: any;
     dropdownIcon: string;
     dropdownOpen: boolean;
@@ -67,7 +68,6 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
     timeoutResize: any;
     visibleElement: boolean;
     containerWidth: number;
-    helperSettings: PoHelperOptions;
     private subscription;
     private enterCloseTag;
     private initCalculateItems;
@@ -119,20 +119,12 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
     focusOnFirstItem(): void;
     closeTag(value: any, event: any): void;
     /**
-     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * 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`.
      *
-     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
      *
      * ```
-     * <po-multiselect
-     *  #multiselect
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, multiselect)"
-     * ></po-multiselect>
-     * ```
-     * ```
      * // Exemplo com p-label e p-helper
      * <po-multiselect
      *  #multiselect

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

@@ -1,4 +1,4 @@
-import { AfterViewInit } from '@angular/core';
+import { AfterViewInit, OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoNumberBaseComponent } from './po-number-base.component';
 /**
@@ -27,7 +27,7 @@ import { PoNumberBaseComponent } from './po-number-base.component';
  *  <file name="sample-po-number-calculate/sample-po-number-calculate.component.ts"> </file>
  * </example>
  */
-export declare class PoNumberComponent extends PoNumberBaseComponent implements AfterViewInit {
+export declare class PoNumberComponent extends PoNumberBaseComponent implements AfterViewInit, OnChanges {
     /**
      * @optional
      *
@@ -54,6 +54,7 @@ export declare class PoNumberComponent extends PoNumberBaseComponent implements
     constructor();
     onWheel(event: Event): void;
     ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     extraValidation(abstractControl: AbstractControl): {
         [key: string]: any;
     };

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

@@ -1,3 +1,4 @@
+import { OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputGeneric } from '../po-input-generic/po-input-generic';
 /**
@@ -23,7 +24,7 @@ import { PoInputGeneric } from '../po-input-generic/po-input-generic';
  *   <file name="sample-po-password-reset/sample-po-password-reset.component.ts"> </file>
  * </example>
  */
-export declare class PoPasswordComponent extends PoInputGeneric {
+export declare class PoPasswordComponent extends PoInputGeneric implements OnChanges {
     id: string;
     type: string;
     visiblePassword: boolean;
@@ -44,6 +45,7 @@ export declare class PoPasswordComponent extends PoInputGeneric {
     get hidePasswordPeek(): boolean;
     get autocomplete(): string;
     constructor();
+    ngOnChanges(changes: SimpleChanges): void;
     extraValidation(c: AbstractControl): {
         [key: string]: any;
     };

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

@@ -13,6 +13,15 @@ export declare class PoRadioComponent extends PoFieldModel<boolean> {
     set size(value: string);
     get size(): string;
     required?: boolean;
+    /**
+     *
+     * Habilita a quebra automática do texto da propriedade `p-label`. Quando `p-label-text-wrap` for verdadeiro, o texto que excede
+     * o espaço disponível é transferido para a próxima linha em pontos apropriados para uma
+     * leitura clara.
+     *
+     * @default `false`
+     */
+    labelTextWrap?: boolean;
     /** Define o status do *radio* */
     checked: boolean;
     blur: EventEmitter<any>;

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

@@ -59,8 +59,7 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
      * @optional
      *
      * @description
-     * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
-     * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
+     * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
      * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
      * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
      *
@@ -72,11 +71,11 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
      *
      * @description
      *
-     * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
+     * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
      * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
      * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
      *
-     * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
+     * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
      *
      * @default `false`
      */
@@ -140,10 +139,10 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
      *
      * @description
      *
-     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
+     * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
      *
-     * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
-     * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
+     * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
@@ -168,7 +167,6 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
      *
      * @description
      * Evento disparado ao clicar no ícone de ajuda adicional.
-     * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
      *
      * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
      */