@po-ui/ng-components 19.29.0 → 19.31.0

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

@@ -2,6 +2,7 @@ import { AfterViewInit, ElementRef, OnDestroy } from '@angular/core';
 import { PoButtonComponent } from '../../po-button/po-button.component';
 import { PoCalendarComponent } from '../../po-calendar/po-calendar.component';
 import { PoDatepickerBaseComponent } from './po-datepicker-base.component';
+import { PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoDatepickerBaseComponent
@@ -45,6 +46,7 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     id: string;
     visible: boolean;
     literals: any;
+    helperSettings: PoHelperOptions;
     eventListenerFunction: () => void;
     eventResizeListener: () => void;
     private clickListener;
@@ -95,6 +97,8 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
      * 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-datepicker
      *  #datepicker
@@ -104,6 +108,16 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
      * ></po-datepicker>
      * ```
      * ```
+     * // Exemplo com p-label e p-helper
+     * <po-datepicker
+     *  #datepicker
+     *  ...
+     *  p-label="Label do datepicker"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, datepicker)"
+     * ></po-datepicker>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoDatepickerComponent): void {
      *  if (event.code === 'F9') {
@@ -133,6 +147,10 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     private shouldHandleTab;
     private focusCalendar;
     onCalendarKeyDown(event: KeyboardEvent): void;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     static ɵfac: i0.ɵɵFactoryDeclaration<PoDatepickerComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoDatepickerComponent, "po-datepicker", never, { "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; }, {}, never, never, false, never>;
 }

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

@@ -5,6 +5,7 @@ import { PoMask } from '../po-input/po-mask';
 import { PoDateService } from './../../../services/po-date/po-date.service';
 import { PoDatepickerRangeLiterals } from './interfaces/po-datepicker-range-literals.interface';
 import { PoDatepickerRange } from './interfaces/po-datepicker-range.interface';
+import { PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @description
@@ -54,6 +55,9 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
     additionalHelpEventTrigger: string | undefined;
     name: string;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -61,6 +65,8 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      * 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;
     /**
@@ -131,11 +137,16 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      */
     fieldErrorMessage: string;
     /**
+     *
+     * @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>;
     /**
@@ -151,6 +162,33 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      * @default `false`
      */
     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>;
     /**
      * @optional
      *
@@ -379,7 +417,7 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
     protected abstract resetDateRangeInputValidation(): void;
     protected abstract updateScreenByModel(dateRange: PoDatepickerRange): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoDatepickerRangeBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDatepickerRangeBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "name": { "alias": "name"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "endDate": { "alias": "p-end-date"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "minDate": { "alias": "p-min-date"; "required": false; }; "maxDate": { "alias": "p-max-date"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "startDate": { "alias": "p-start-date"; "required": false; }; "locale": { "alias": "p-locale"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onChange": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDatepickerRangeBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "name": { "alias": "name"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "clean": { "alias": "p-clean"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "endDate": { "alias": "p-end-date"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "minDate": { "alias": "p-min-date"; "required": false; }; "maxDate": { "alias": "p-max-date"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "startDate": { "alias": "p-start-date"; "required": false; }; "locale": { "alias": "p-locale"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onChange": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
 }

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

@@ -1,6 +1,7 @@
 import { AfterViewInit, ElementRef, OnChanges, OnDestroy, OnInit, SimpleChanges } from '@angular/core';
 import { PoDatepickerRange } from './interfaces/po-datepicker-range.interface';
 import { PoDatepickerRangeBaseComponent } from './po-datepicker-range-base.component';
+import { PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoDatepickerRangeBaseComponent
@@ -40,6 +41,7 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     iconCalendar: ElementRef;
     calendarPicker: ElementRef;
     isCalendarVisible: boolean;
+    helperSettings: PoHelperOptions;
     private clickListener;
     private eventResizeListener;
     private poDatepickerRangeElement;
@@ -96,6 +98,8 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
      * 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-datepicker-range
      *  #datepickerRange
@@ -105,6 +109,16 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
      * ></po-datepicker-range>
      * ```
      * ```
+     * // Exemplo com p-label e p-helper
+     * <po-datepicker-range
+     *  #datepickerRange
+     *  ...
+     *  p-label="Label do datepickerRange
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, datepickerRange)"
+     * ></po-datepicker-range>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoDatepickerRangeComponent): void {
      *  if (event.code === 'F9') {
@@ -116,6 +130,10 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     showAdditionalHelp(): boolean;
     toggleCalendar(): void;
     updateScreenByModel(model: PoDatepickerRange): void;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     private applyFocusOnDatePickerRangeField;
     private formatDate;
     private formatScreenToModel;

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

@@ -1,6 +1,7 @@
 import { AfterViewInit, ElementRef, OnDestroy, OnInit } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputBaseComponent } from '../po-input/po-input-base.component';
+import { PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  *
@@ -59,6 +60,7 @@ export declare class PoDecimalComponent extends PoInputBaseComponent implements
     private thousandSeparator;
     private valueBeforeChange;
     private subscriptionValidator;
+    helperSettings: PoHelperOptions;
     private regex;
     get autocomplete(): "on" | "off";
     /**
@@ -148,6 +150,10 @@ export declare class PoDecimalComponent extends PoInputBaseComponent implements
     writeValueModel(value: any): void;
     getErrorPatternMessage(): string;
     private addZeroBefore;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     private containsComma;
     private containsMoreThanOneDecimalSeparator;
     private controlChangeEmitter;

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';
 import * as i0 from "@angular/core";
@@ -26,7 +26,7 @@ import * as i0 from "@angular/core";
  *  <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;
@@ -34,6 +34,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

@@ -12,6 +12,7 @@ import * as i0 from "@angular/core";
 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;
@@ -31,10 +32,15 @@ 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;
     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; }; }, { "additionalHelp": "p-additional-help"; }, never, never, false, 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; }; "hideAdditionalHelpByLabel": { "alias": "p-hide-additional-help-by-label"; "required": false; "isSignal": true; }; }, { "additionalHelp": "p-additional-help"; }, never, never, false, never>;
     static ngAcceptInputType_appendBox: any;
 }

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

@@ -1,4 +1,5 @@
-import { OnChanges, OnInit, SimpleChanges } from '@angular/core';
+import { ChangeDetectorRef, ElementRef, OnChanges, OnInit, SimpleChanges } from '@angular/core';
+import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsPrivate
@@ -6,6 +7,9 @@ import * as i0 from "@angular/core";
  * 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 */
@@ -14,8 +18,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. */
@@ -26,10 +45,11 @@ 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;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldContainerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PoFieldContainerComponent, "po-field-container", never, { "disabled": { "alias": "p-disabled"; "required": false; }; "id": { "alias": "p-id"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, {}, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoFieldContainerComponent, "po-field-container", never, { "disabled": { "alias": "p-disabled"; "required": false; }; "id": { "alias": "p-id"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "showHelperComponent": { "alias": "p-show-helper"; "required": false; "isSignal": true; }; "textWrap": { "alias": "p-text-wrap"; "required": false; "isSignal": true; }; "optional": { "alias": "p-optional"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, {}, never, ["*"], false, never>;
 }

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

@@ -5,6 +5,7 @@ import * as i3 from "@angular/common";
 import * as i4 from "../../po-label/po-label.module";
 import * as i5 from "../../po-icon/po-icon.module";
 import * as i6 from "../../../directives/po-tooltip/po-tooltip.module";
+import * as i7 from "../../po-helper/po-helper.module";
 /**
  * @description
  *
@@ -12,6 +13,6 @@ import * as i6 from "../../../directives/po-tooltip/po-tooltip.module";
  */
 export declare class PoFieldContainerModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldContainerModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PoFieldContainerModule, [typeof i1.PoFieldContainerBottomComponent, typeof i2.PoFieldContainerComponent], [typeof i3.CommonModule, typeof i4.PoLabelModule, typeof i5.PoIconModule, typeof i6.PoTooltipModule], [typeof i1.PoFieldContainerBottomComponent, typeof i2.PoFieldContainerComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoFieldContainerModule, [typeof i1.PoFieldContainerBottomComponent, typeof i2.PoFieldContainerComponent], [typeof i3.CommonModule, typeof i4.PoLabelModule, typeof i5.PoIconModule, typeof i6.PoTooltipModule, typeof i7.PoHelperModule], [typeof i1.PoFieldContainerBottomComponent, typeof i2.PoFieldContainerComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoFieldContainerModule>;
 }

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

@@ -5,6 +5,9 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
     private readonly cd;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -12,6 +15,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;
     /**
@@ -45,11 +50,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>;
     /**
@@ -84,6 +94,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
@@ -93,6 +105,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') {
@@ -103,7 +125,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;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldModel<any>, never>;

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

@@ -54,6 +54,7 @@ import * as i52 from "../po-label/po-label.module";
 import * as i53 from "../po-listbox/po-listbox.module";
 import * as i54 from "./po-switch/po-switch.module";
 import * as i55 from "../po-tag/po-tag.module";
+import * as i56 from "../po-helper/po-helper.module";
 /**
  * @description
  *
@@ -66,6 +67,6 @@ import * as i55 from "../po-tag/po-tag.module";
  */
 export declare class PoFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PoFieldModule, [typeof i1.PoComboComponent, typeof i2.PoComboOptionTemplateDirective, typeof i3.PoMultiselectOptionTemplateDirective, typeof i4.PoDecimalComponent, typeof i5.PoDatepickerRangeComponent, typeof i6.PoEmailComponent, typeof i7.PoInputComponent, typeof i8.PoLoginComponent, typeof i9.PoLookupComponent, typeof i10.PoLookupModalComponent, typeof i11.PoMultiselectComponent, typeof i12.PoMultiselectDropdownComponent, typeof i13.PoNumberComponent, typeof i14.PoPasswordComponent, typeof i15.PoRichTextBodyComponent, typeof i16.PoRichTextComponent, typeof i17.PoRichTextImageModalComponent, typeof i18.PoRichTextLinkModalComponent, typeof i19.PoRichTextToolbarComponent, typeof i20.PoSelectComponent, typeof i21.PoTextareaComponent, typeof i22.PoUploadComponent, typeof i23.PoUploadDragDropComponent, typeof i24.PoUploadDragDropDirective, typeof i25.PoUploadDragDropAreaOverlayComponent, typeof i26.PoUploadDragDropAreaComponent, typeof i27.PoUploadFileRestrictionsComponent, typeof i28.PoUrlComponent], [typeof i29.CommonModule, typeof i30.FormsModule, typeof i30.FormsModule, typeof i31.OverlayModule, typeof i32.PoButtonGroupModule, typeof i33.PoButtonModule, typeof i34.PoCleanModule, typeof i35.PoCalendarModule, typeof i36.PoCheckboxGroupModule, typeof i37.PoRadioGroupModule, typeof i38.PoContainerModule, typeof i39.PoDatepickerModule, typeof i40.PoDisclaimerGroupModule, typeof i41.PoDisclaimerModule, typeof i42.PoFieldContainerModule, typeof i43.PoLoadingModule, typeof i44.PoModalModule, typeof i45.PoProgressModule, typeof i46.PoServicesModule, typeof i47.PoTableModule, typeof i48.PoTooltipModule, typeof i49.PoIconModule, typeof i50.PoCheckboxModule, typeof i51.PoRadioModule, typeof i52.PoLabelModule, typeof i53.PoListBoxModule, typeof i54.PoSwitchModule, typeof i55.PoTagModule], [typeof i36.PoCheckboxGroupModule, typeof i37.PoRadioGroupModule, typeof i34.PoCleanModule, typeof i39.PoDatepickerModule, typeof i1.PoComboComponent, typeof i2.PoComboOptionTemplateDirective, typeof i3.PoMultiselectOptionTemplateDirective, typeof i4.PoDecimalComponent, typeof i5.PoDatepickerRangeComponent, typeof i6.PoEmailComponent, typeof i42.PoFieldContainerModule, typeof i7.PoInputComponent, typeof i8.PoLoginComponent, typeof i9.PoLookupComponent, typeof i10.PoLookupModalComponent, typeof i11.PoMultiselectComponent, typeof i13.PoNumberComponent, typeof i14.PoPasswordComponent, typeof i16.PoRichTextComponent, typeof i20.PoSelectComponent, typeof i21.PoTextareaComponent, typeof i22.PoUploadComponent, typeof i28.PoUrlComponent, typeof i50.PoCheckboxModule, typeof i51.PoRadioModule, typeof i52.PoLabelModule, typeof i54.PoSwitchModule, typeof i55.PoTagModule]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoFieldModule, [typeof i1.PoComboComponent, typeof i2.PoComboOptionTemplateDirective, typeof i3.PoMultiselectOptionTemplateDirective, typeof i4.PoDecimalComponent, typeof i5.PoDatepickerRangeComponent, typeof i6.PoEmailComponent, typeof i7.PoInputComponent, typeof i8.PoLoginComponent, typeof i9.PoLookupComponent, typeof i10.PoLookupModalComponent, typeof i11.PoMultiselectComponent, typeof i12.PoMultiselectDropdownComponent, typeof i13.PoNumberComponent, typeof i14.PoPasswordComponent, typeof i15.PoRichTextBodyComponent, typeof i16.PoRichTextComponent, typeof i17.PoRichTextImageModalComponent, typeof i18.PoRichTextLinkModalComponent, typeof i19.PoRichTextToolbarComponent, typeof i20.PoSelectComponent, typeof i21.PoTextareaComponent, typeof i22.PoUploadComponent, typeof i23.PoUploadDragDropComponent, typeof i24.PoUploadDragDropDirective, typeof i25.PoUploadDragDropAreaOverlayComponent, typeof i26.PoUploadDragDropAreaComponent, typeof i27.PoUploadFileRestrictionsComponent, typeof i28.PoUrlComponent], [typeof i29.CommonModule, typeof i30.FormsModule, typeof i30.FormsModule, typeof i31.OverlayModule, typeof i32.PoButtonGroupModule, typeof i33.PoButtonModule, typeof i34.PoCleanModule, typeof i35.PoCalendarModule, typeof i36.PoCheckboxGroupModule, typeof i37.PoRadioGroupModule, typeof i38.PoContainerModule, typeof i39.PoDatepickerModule, typeof i40.PoDisclaimerGroupModule, typeof i41.PoDisclaimerModule, typeof i42.PoFieldContainerModule, typeof i43.PoLoadingModule, typeof i44.PoModalModule, typeof i45.PoProgressModule, typeof i46.PoServicesModule, typeof i47.PoTableModule, typeof i48.PoTooltipModule, typeof i49.PoIconModule, typeof i50.PoCheckboxModule, typeof i51.PoRadioModule, typeof i52.PoLabelModule, typeof i53.PoListBoxModule, typeof i54.PoSwitchModule, typeof i55.PoTagModule, typeof i56.PoHelperModule], [typeof i36.PoCheckboxGroupModule, typeof i37.PoRadioGroupModule, typeof i34.PoCleanModule, typeof i39.PoDatepickerModule, typeof i1.PoComboComponent, typeof i2.PoComboOptionTemplateDirective, typeof i3.PoMultiselectOptionTemplateDirective, typeof i4.PoDecimalComponent, typeof i5.PoDatepickerRangeComponent, typeof i6.PoEmailComponent, typeof i42.PoFieldContainerModule, typeof i7.PoInputComponent, typeof i8.PoLoginComponent, typeof i9.PoLookupComponent, typeof i10.PoLookupModalComponent, typeof i11.PoMultiselectComponent, typeof i13.PoNumberComponent, typeof i14.PoPasswordComponent, typeof i16.PoRichTextComponent, typeof i20.PoSelectComponent, typeof i21.PoTextareaComponent, typeof i22.PoUploadComponent, typeof i28.PoUrlComponent, typeof i50.PoCheckboxModule, typeof i51.PoRadioModule, typeof i52.PoLabelModule, typeof i54.PoSwitchModule, typeof i55.PoTagModule]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoFieldModule>;
 }

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';
 import * as i0 from "@angular/core";
 /**
  * @description
@@ -51,8 +53,12 @@ import * as i0 from "@angular/core";
  */
 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
@@ -60,6 +66,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;
     /**
@@ -222,11 +230,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>;
     /**
@@ -408,6 +421,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;
@@ -424,6 +464,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
@@ -433,6 +474,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') {
@@ -448,7 +499,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.
@@ -474,7 +525,7 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
     };
     abstract getScreenValue(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoInputBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoInputBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "emitAllChanges": { "alias": "p-emit-all-changes"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "errorAsyncProperties": { "alias": "p-error-async-properties"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "showErrorMessageRequired": { "alias": "p-required-field-error-message"; "required": false; }; "upperCase": { "alias": "p-upper-case"; "required": false; }; "maskNoLengthValidation": { "alias": "p-mask-no-length-validation"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "setDisabled": { "alias": "p-disabled"; "required": false; }; "setReadonly": { "alias": "p-readonly"; "required": false; }; "setRequired": { "alias": "p-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "setClean": { "alias": "p-clean"; "required": false; }; "setPattern": { "alias": "p-pattern"; "required": false; }; "maxlength": { "alias": "p-maxlength"; "required": false; }; "minlength": { "alias": "p-minlength"; "required": false; }; "setMask": { "alias": "p-mask"; "required": false; }; "setMaskFormatModel": { "alias": "p-mask-format-model"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "blur": "p-blur"; "enter": "p-enter"; "change": "p-change"; "changeModel": "p-change-model"; "keydown": "p-keydown"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoInputBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "emitAllChanges": { "alias": "p-emit-all-changes"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "errorAsyncProperties": { "alias": "p-error-async-properties"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "showErrorMessageRequired": { "alias": "p-required-field-error-message"; "required": false; }; "upperCase": { "alias": "p-upper-case"; "required": false; }; "maskNoLengthValidation": { "alias": "p-mask-no-length-validation"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "setDisabled": { "alias": "p-disabled"; "required": false; }; "setReadonly": { "alias": "p-readonly"; "required": false; }; "setRequired": { "alias": "p-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "setClean": { "alias": "p-clean"; "required": false; }; "setPattern": { "alias": "p-pattern"; "required": false; }; "maxlength": { "alias": "p-maxlength"; "required": false; }; "minlength": { "alias": "p-minlength"; "required": false; }; "setMask": { "alias": "p-mask"; "required": false; }; "setMaskFormatModel": { "alias": "p-mask-format-model"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; }, { "additionalHelp": "p-additional-help"; "blur": "p-blur"; "enter": "p-enter"; "change": "p-change"; "changeModel": "p-change-model"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_emitAllChanges: any;

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';
 import * as i0 from "@angular/core";
@@ -22,10 +22,11 @@ import * as i0 from "@angular/core";
  *  <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,6 +1,7 @@
 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';
 import * as i0 from "@angular/core";
 export declare abstract class PoInputGeneric extends PoInputBaseComponent implements AfterViewInit, OnDestroy {
     inputEl: ElementRef;
@@ -8,6 +9,7 @@ export declare abstract class PoInputGeneric extends PoInputBaseComponent implem
     el: ElementRef;
     valueBeforeChange: any;
     timeoutChange: any;
+    helperSettings: PoHelperOptions;
     private subscriptionValidator;
     get autocomplete(): string;
     constructor(el: ElementRef, cd?: ChangeDetectorRef);
@@ -38,6 +40,10 @@ export declare abstract class PoInputGeneric extends PoInputBaseComponent implem
     abstract extraValidation(c: AbstractControl): {
         [key: string]: any;
     };
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     static ɵfac: i0.ɵɵFactoryDeclaration<PoInputGeneric, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<PoInputGeneric, never, never, {}, {}, never, never, true, never>;
 }