@po-ui/ng-components 20.3.0 → 20.4.0

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

@@ -1,4 +1,4 @@
-import { AfterViewInit, OnDestroy } from '@angular/core';
+import { AfterViewInit, OnDestroy, OnInit } 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 {
+export declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnInit {
     id: string;
     icon: string;
     type: string;
@@ -33,6 +33,7 @@ export declare class PoEmailComponent extends PoInputGeneric implements AfterVie
     mask: string;
     private listener;
     constructor();
+    ngOnInit(): 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

@@ -11,6 +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;
     /** Define se o tooltip será inserido no `body` em vez do componente. */
     appendBox: boolean;
@@ -30,7 +31,12 @@ export declare class PoFieldContainerBottomComponent implements OnChanges {
     /** Exibe o ícone de ajuda adicional. */
     showAdditionalHelpIcon: boolean;
     /** 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>;
     private isInitialChange;
     ngOnChanges(changes: SimpleChanges): void;
 }

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

@@ -1,10 +1,14 @@
-import { OnChanges, OnInit, SimpleChanges } from '@angular/core';
+import { ChangeDetectorRef, ElementRef, OnChanges, OnInit, SimpleChanges } from '@angular/core';
+import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
 /**
  * @docsPrivate
  *
  * Componente de uso interno, responsável por atribuir uma label para o campo
  */
 export declare class PoFieldContainerComponent implements OnInit, OnChanges {
+    private readonly cdr;
+    labelEl: ElementRef<HTMLElement>;
+    helperEl?: PoHelperComponent;
     /** Indica se o campo será desabilitado. */
     disabled: boolean;
     /** Identificador do campo */
@@ -13,8 +17,23 @@ export declare class PoFieldContainerComponent implements OnInit, OnChanges {
     label?: string;
     /** Texto de apoio do campo. */
     help: string;
+    /** 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>;
+    /**
+     * @optional
+     *
+     * Habilita a quebra automática do texto do componente po-label. Quando ativada, o texto que excede
+     * o espaço disponível é transferido para a próxima linha em pontos apropriados para uma
+     * leitura clara.
+     *
+     * @default `false`
+     */
+    textWrap: import("@angular/core").InputSignal<boolean>;
     literals: object;
     requirement: string;
+    showTip: boolean;
     private _optional;
     private _required;
     /** Indica se o campo será opcional. */
@@ -25,8 +44,9 @@ export declare class PoFieldContainerComponent implements OnInit, OnChanges {
     get required(): boolean;
     /** Define se a indicação de campo obrigatório será exibida. */
     showRequired: boolean;
-    constructor();
+    constructor(cdr: ChangeDetectorRef);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     private setRequirement;
+    handleLabelTooltip(): void;
 }

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

@@ -4,6 +4,9 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
     private readonly cd;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -11,6 +14,8 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
      * **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.
+     *
+     * > 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.
      */
     additionalHelpTooltip?: string;
     /**
@@ -44,11 +49,16 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      */
     disabled: boolean;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @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.
      */
     additionalHelp: EventEmitter<any>;
     /**
@@ -83,6 +93,8 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida 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
@@ -92,6 +104,16 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      * ></po-nome-component>
      * ```
      * ```
+     * // Exemplo com p-label e p-helper
+     * <po-nome-component
+     *  #component
+     *  ...
+     *  p-label="Label do component"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, component)"
+     * ></po-nome-component>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoNomeDoComponente): void {
      *  if (event.code === 'F9') {
@@ -102,7 +124,7 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      */
     showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
-    private isAdditionalHelpEventTriggered;
+    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

@@ -1,6 +1,8 @@
 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 { PoFieldContainerComponent } from '../po-field-container';
 /**
  * @description
  *
@@ -50,8 +52,12 @@ import { ErrorAsyncProperties } from '../shared/interfaces/error-async-propertie
  */
 export declare abstract class PoInputBaseComponent implements ControlValueAccessor, Validator, OnDestroy {
     protected cd?: ChangeDetectorRef;
+    fieldContainer?: PoFieldContainerComponent;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -59,6 +65,8 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
      * **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.
+     *
+     * > 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.
      */
     additionalHelpTooltip?: string;
     /**
@@ -221,11 +229,16 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
     set maskNoLengthValidation(value: boolean);
     get maskNoLengthValidation(): boolean;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @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.
      */
     additionalHelp: EventEmitter<any>;
     /**
@@ -407,6 +420,33 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      */
     maskFormatModel?: boolean;
     set setMaskFormatModel(maskFormatModel: string);
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     *
+     * > 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.
+     */
+    poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * 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: import("@angular/core").InputSignal<boolean>;
     constructor(cd?: ChangeDetectorRef);
     ngOnDestroy(): void;
     callOnChange(value: any): void;
@@ -423,6 +463,7 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida 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
@@ -432,6 +473,16 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      * ></po-nome-component>
      * ```
      * ```
+     * // Exemplo com p-label e p-helper
+     * <po-nome-component
+     *  #component
+     *  ...
+     *  p-label="Label do componente"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, component)"
+     * ></po-nome-component>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoNomeDoComponente): void {
      *  if (event.code === 'F9') {
@@ -447,7 +498,7 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
     };
     writeValue(value: any): void;
     protected validateModel(): void;
-    private isAdditionalHelpEventTriggered;
+    protected isAdditionalHelpEventTriggered(): boolean;
     private validatePatternOnWriteValue;
     /**
      * Função que atribui foco ao componente.

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

@@ -1,4 +1,4 @@
-import { ElementRef } from '@angular/core';
+import { ElementRef, OnInit } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputGeneric } from '../po-input-generic/po-input-generic';
 /**
@@ -21,10 +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 {
+export declare class PoInputComponent extends PoInputGeneric implements OnInit {
     inp: ElementRef;
     id: string;
     constructor();
+    ngOnInit(): void;
     extraValidation(c: AbstractControl): {
         [key: string]: any;
     };

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

@@ -1,12 +1,14 @@
 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);
@@ -37,4 +39,8 @@ export declare abstract class PoInputGeneric extends PoInputBaseComponent implem
     abstract extraValidation(c: AbstractControl): {
         [key: string]: any;
     };
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
 }

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

@@ -8,6 +8,7 @@ import { PoLookupFilter } from './interfaces/po-lookup-filter.interface';
 import { PoLookupLiterals } from './interfaces/po-lookup-literals.interface';
 import { PoLookupFilterService } from './services/po-lookup-filter.service';
 import { PoLookupModalService } from './services/po-lookup-modal.service';
+import { PoHelperOptions } from '../../po-helper';
 export declare const poLookupLiteralsDefault: {
     en: PoLookupLiterals;
     es: PoLookupLiterals;
@@ -40,6 +41,9 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
     private _spacing;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -47,6 +51,8 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
      * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
      * **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.
+     *
+     * > 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.
      */
     additionalHelpTooltip?: string;
     /**
@@ -361,11 +367,43 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
      */
     virtualScroll?: boolean;
     /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     *
+     * > 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.
+     */
+    poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * 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: import("@angular/core").InputSignal<boolean>;
+    /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @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.
      */
     additionalHelp: EventEmitter<any>;
     /**

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

@@ -1,6 +1,7 @@
 import { AfterViewInit, DoCheck, ElementRef, OnDestroy, OnInit } from '@angular/core';
 import { PoTableColumnSpacing } from '../../po-table';
 import { PoLookupBaseComponent } from './po-lookup-base.component';
+import { PoHelperOptions } from '../../po-helper';
 /**
  * @docsExtends PoLookupBaseComponent
  *
@@ -102,6 +103,7 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
     disclaimers: any[];
     visibleDisclaimers: any[];
     id: string;
+    helperSettings: PoHelperOptions;
     private modalSubscription;
     private isCalculateVisibleItems;
     get autocomplete(): "off" | "on";
@@ -148,9 +150,11 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
     calculateVisibleItems(): void;
     onKeyDown(event: KeyboardEvent): void;
     /**
+     *
      * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida 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
@@ -160,6 +164,16 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
      * ></po-lookup>
      * ```
      * ```
+     * // Exemplo com p-label e p-helper
+     * <po-lookup
+     *  #lookup
+     *  ...
+     *  p-label="Label do lookup"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, lookup)"
+     * ></po-lookup>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoLookupComponent): void {
      *  if (event.code === 'F9') {
@@ -170,6 +184,10 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
      */
     showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     protected getDefaultSpacing(): PoTableColumnSpacing;
     private isAdditionalHelpEventTriggered;
     private isAllowedOpenModal;

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

@@ -7,6 +7,7 @@ import { PoMultiselectFilter } from './interfaces/po-multiselect-filter.interfac
 import { PoMultiselectLiterals } from './interfaces/po-multiselect-literals.interface';
 import { PoMultiselectOption } from './interfaces/po-multiselect-option.interface';
 import { PoMultiselectFilterService } from './po-multiselect-filter.service';
+import { PoHelperOptions } from '../../po-helper';
 export declare const poMultiselectLiteralsDefault: {
     en: PoMultiselectLiterals;
     es: PoMultiselectLiterals;
@@ -73,6 +74,9 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
     protected cd?: ChangeDetectorRef;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -80,6 +84,8 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
      * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
      * **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.
+     *
+     * > 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.
      */
     additionalHelpTooltip?: string;
     /**
@@ -169,11 +175,16 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
      */
     errorLimit: boolean;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @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.
      */
     additionalHelp: EventEmitter<any>;
     /**
@@ -225,6 +236,33 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
      * @default `bottom`
      */
     listboxControlPosition: 'top' | 'bottom';
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     *
+     * > 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.
+     */
+    poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * 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: import("@angular/core").InputSignal<boolean>;
     selectedOptions: Array<PoMultiselectOption | any>;
     visibleOptionsDropdown: Array<PoMultiselectOption | any>;
     visibleTags: any[];

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

@@ -4,6 +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';
 /**
  * @docsExtends PoMultiselectBaseComponent
  *
@@ -66,6 +67,7 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
     timeoutResize: any;
     visibleElement: boolean;
     containerWidth: number;
+    helperSettings: PoHelperOptions;
     private subscription;
     private enterCloseTag;
     private initCalculateItems;
@@ -120,6 +122,8 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
      * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida 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-multiselect
      *  #multiselect
@@ -129,6 +133,16 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
      * ></po-multiselect>
      * ```
      * ```
+     * // Exemplo com p-label e p-helper
+     * <po-multiselect
+     *  #multiselect
+     *  ...
+     *  p-label="Label do multiselect"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, multiselect)"
+     * ></po-multiselect>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoMultiselectComponent): void {
      *  if (event.code === 'F9') {
@@ -141,6 +155,10 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
     showAdditionalHelpIcon(): boolean;
     wasClickedOnToggle(event: MouseEvent): void;
     applyFilter(value?: string): Observable<Array<PoMultiselectOption | any>>;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     private applyFilterInFirstClick;
     private setOptionsByApplyFilter;
     private adjustContainerPosition;

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

@@ -1,3 +1,4 @@
+import { AfterViewInit } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoNumberBaseComponent } from './po-number-base.component';
 /**
@@ -26,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 {
+export declare class PoNumberComponent extends PoNumberBaseComponent implements AfterViewInit {
     /**
      * @optional
      *
@@ -52,6 +53,7 @@ export declare class PoNumberComponent extends PoNumberBaseComponent {
     id: string;
     constructor();
     onWheel(event: Event): void;
+    ngAfterViewInit(): void;
     extraValidation(abstractControl: AbstractControl): {
         [key: string]: any;
     };

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

@@ -1,6 +1,7 @@
 import { EventEmitter } from '@angular/core';
 import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
 import { PoRadioGroupOption } from './po-radio-group-option.interface';
+import { PoHelperOptions } from '../../po-helper';
 /**
  * @description
  *
@@ -52,6 +53,9 @@ import { PoRadioGroupOption } from './po-radio-group-option.interface';
 export declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor, Validator {
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -59,6 +63,8 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
      * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
      * **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.
+     *
+     * > 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.
      */
     additionalHelpTooltip?: string;
     /**
@@ -128,11 +134,43 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
      */
     errorLimit: boolean;
     /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     *
+     * > 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.
+     */
+    poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * 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: import("@angular/core").InputSignal<boolean>;
+    /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @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.
      */
     additionalHelp: EventEmitter<any>;
     /**