@po-ui/ng-components 20.3.0 → 20.4.0

package/lib/components/index.d.ts

@@ -16,6 +16,7 @@ export * from './po-dynamic/index';
 export * from './po-field/index';
 export * from './po-gauge/index';
 export * from './po-grid/index';
+export * from './po-helper/index';
 export * from './po-icon/index';
 export * from './po-image/index';
 export * from './po-info/index';

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

@@ -1,5 +1,6 @@
 import { ChangeDetectorRef, EventEmitter } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
+import { PoHelperOptions } from '../../po-helper';
 /**
  * @description
  *
@@ -45,6 +46,9 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
     private readonly cd;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -52,6 +56,8 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
      * 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;
     /**
@@ -91,11 +97,16 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
     /** Texto de exibição do *checkbox*. */
     label?: 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>;
     /**
@@ -159,10 +170,37 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
      *
      */
     set size(value: 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>;
     get size(): string;
     constructor(cd: ChangeDetectorRef);
     changeValue(): void;
-    checkOption(value: boolean | null | string): void;
+    checkOption(event: any, value: boolean | null | string): void;
     setDisabledState(isDisabled: boolean): void;
     registerOnChange(fn: any): void;
     registerOnTouched(fn: any): void;

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

@@ -1,5 +1,6 @@
-import { AfterViewInit, ElementRef } from '@angular/core';
+import { AfterViewInit, ElementRef, OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import { PoCheckboxBaseComponent } from './po-checkbox-base.component';
+import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
 /**
  * @docsExtends PoCheckboxBaseComponent
  *
@@ -20,10 +21,14 @@ import { PoCheckboxBaseComponent } from './po-checkbox-base.component';
  *   <file name="sample-po-checkbox-acceptance-term/sample-po-checkbox-acceptance-term.component.ts"> </file>
  * </example>
  */
-export declare class PoCheckboxComponent extends PoCheckboxBaseComponent implements AfterViewInit {
+export declare class PoCheckboxComponent extends PoCheckboxBaseComponent implements AfterViewInit, OnChanges, OnInit {
     private readonly changeDetector;
     private _iconToken;
+    helperSettings: PoHelperOptions;
+    showTip: boolean;
     checkboxLabel: ElementRef;
+    labelEl: ElementRef<HTMLElement>;
+    helperEl?: PoHelperComponent;
     constructor();
     /**
      * Função que atribui foco ao *checkbox*.
@@ -47,6 +52,8 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
     focus(): void;
     onBlur(): void;
     ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnInit(): void;
     emitAdditionalHelp(): void;
     getAdditionalHelpTooltip(): string;
     onKeyDown(event: KeyboardEvent, value: boolean | string): void;
@@ -54,6 +61,8 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
      * 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-checkbox
      *  #checkbox
@@ -63,6 +72,16 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
      * ></po-checkbox>
      * ```
      * ```
+     * //Exemplo com label e p-helper
+     * <po-checkbox
+     *  #checkbox
+     *  ...
+     *  p-label="Label do checkbox"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, checkbox)"
+     * ></po-checkbox>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoCheckboxComponent): void {
      *  if (event.code === 'F9') {
@@ -73,7 +92,12 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
      */
     showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     protected changeModelValue(value: boolean | null | string): void;
     private isAdditionalHelpEventTriggered;
+    handleLabelTooltip(): void;
     get iconNameLib(): string;
 }

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

@@ -2,6 +2,7 @@ import { EventEmitter } from '@angular/core';
 import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
 import { PoCheckboxGroupOptionView } from './interfaces/po-checkbox-group-option-view.interface';
 import { PoCheckboxGroupOption } from './interfaces/po-checkbox-group-option.interface';
+import { PoHelperOptions } from '../../po-helper';
 /**
  * @description
  *
@@ -34,6 +35,9 @@ import { PoCheckboxGroupOption } from './interfaces/po-checkbox-group-option.int
 export declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Validator {
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -41,6 +45,8 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      * 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;
     /**
@@ -113,6 +119,32 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      * @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
      *
@@ -130,11 +162,15 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      */
     ngModelChange: EventEmitter<any>;
     /**
+     * @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-checkbox-group/po-checkbox-group.component.d.ts

@@ -56,6 +56,8 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
      * 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-checkbox-group
      *  #checkboxGroup
@@ -65,6 +67,16 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
      * ></po-checkbox-group>
      * ```
      * ```
+     * //Exemplo com p-label e p-helper
+     * <po-checkbox-group
+     *  #checkboxGroup
+     *  ...
+     *  p-label="Label do checkbox"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, checkboxGroup)"
+     * ></po-checkbox-group>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoCheckboxGroupComponent): void {
      *  if (event.code === 'F9') {
@@ -76,6 +88,10 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
     showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
     trackByFn(index: any): any;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     private isAdditionalHelpEventTriggered;
     private isCheckboxOptionFocused;
 }

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

@@ -8,6 +8,7 @@ import { PoComboLiterals } from './interfaces/po-combo-literals.interface';
 import { PoComboOptionGroup } from './interfaces/po-combo-option-group.interface';
 import { PoComboOption } from './interfaces/po-combo-option.interface';
 import { PoComboFilterService } from './po-combo-filter.service';
+import { PoHelperOptions } from '../../po-helper';
 /**
  * @description
  *
@@ -66,6 +67,9 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
     protected changeDetector: ChangeDetectorRef;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -73,6 +77,8 @@ export declare abstract class PoComboBaseComponent 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;
     /**
@@ -235,11 +241,16 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      */
     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>;
     /**
@@ -317,6 +328,33 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      * @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>;
     cacheOptions: Array<any>;
     defaultService: PoComboFilterService;
     firstInWriteValue: boolean;

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

@@ -5,6 +5,7 @@ import { PoComboOption } from './interfaces/po-combo-option.interface';
 import { PoComboBaseComponent } from './po-combo-base.component';
 import { PoComboFilterService } from './po-combo-filter.service';
 import { PoComboOptionTemplateDirective } from './po-combo-option-template/po-combo-option-template.directive';
+import { PoHelperOptions } from '../../po-helper';
 /**
  * @docsExtends PoComboBaseComponent
  *
@@ -74,6 +75,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     shouldMarkLetters: boolean;
     infiniteLoading: boolean;
     containerWidth: number;
+    helperSettings: PoHelperOptions;
     private _isServerSearching;
     private lastKey;
     private clickoutListener;
@@ -132,6 +134,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
      * 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-combo
      *  #combo
@@ -141,6 +144,16 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
      * ></po-combo>
      * ```
      * ```
+     * // Exemplo com p-label e p-helper
+     * <po-combo
+     *  #combo
+     *  ...
+     *  p-label="Label do combo"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, combo)"
+     * ></po-combo>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoComboComponent): void {
      *  if (event.code === 'F9') {
@@ -178,4 +191,8 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     private focusItem;
     private focusInput;
     private shouldHandleTab;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
 }

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

@@ -4,6 +4,7 @@ import { PoMask } from '../po-input/po-mask';
 import { Observable } from 'rxjs';
 import { PoLanguageService } from '../../../services/po-language/po-language.service';
 import { PoDatepickerIsoFormat } from './enums/po-datepicker-iso-format.enum';
+import { PoHelperOptions } from '../../po-helper';
 /**
  * @description
  *
@@ -80,6 +81,9 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
     protected cd: ChangeDetectorRef;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -87,6 +91,9 @@ export declare abstract class PoDatepickerBaseComponent 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;
     /**
@@ -162,11 +169,15 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      */
     showErrorMessageRequired: 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>;
     /**
@@ -193,6 +204,33 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
      */
     keydown: EventEmitter<KeyboardEvent>;
+    /**
+     * @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>;
     offset: number;
     protected firstStart: boolean;
     protected hour: string;

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';
 /**
  * @docsExtends PoDatepickerBaseComponent
  *
@@ -44,6 +45,7 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     id: string;
     visible: boolean;
     literals: any;
+    helperSettings: PoHelperOptions;
     eventListenerFunction: () => void;
     eventResizeListener: () => void;
     private clickListener;
@@ -94,6 +96,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
@@ -103,6 +107,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') {
@@ -132,4 +146,8 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     private shouldHandleTab;
     private focusCalendar;
     onCalendarKeyDown(event: KeyboardEvent): void;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
 }

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';
 /**
  * @description
  *
@@ -53,6 +54,9 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
     additionalHelpEventTrigger: string | undefined;
     name: string;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -60,6 +64,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;
     /**
@@ -130,11 +136,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>;
     /**
@@ -150,6 +161,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
      *

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';
 /**
  * @docsExtends PoDatepickerRangeBaseComponent
  *
@@ -39,6 +40,7 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     iconCalendar: ElementRef;
     calendarPicker: ElementRef;
     isCalendarVisible: boolean;
+    helperSettings: PoHelperOptions;
     private clickListener;
     private eventResizeListener;
     private poDatepickerRangeElement;
@@ -95,6 +97,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
@@ -104,6 +108,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') {
@@ -115,6 +129,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';
 /**
  *
  * @docsExtends PoInputBaseComponent
@@ -58,6 +59,7 @@ export declare class PoDecimalComponent extends PoInputBaseComponent implements
     private thousandSeparator;
     private valueBeforeChange;
     private subscriptionValidator;
+    helperSettings: PoHelperOptions;
     private regex;
     get autocomplete(): "off" | "on";
     /**
@@ -147,6 +149,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;