@po-ui/ng-components 19.29.0 → 19.31.0

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';
 import * as i0 from "@angular/core";
 export declare const poLookupLiteralsDefault: {
     en: PoLookupLiterals;
@@ -41,6 +42,9 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
     private _spacing;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -48,6 +52,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;
     /**
@@ -362,11 +368,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>;
     /**
@@ -571,7 +609,7 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
     abstract updateVisibleItems(): any;
     protected abstract getDefaultSpacing(): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoLookupBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoLookupBaseComponent, 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; }; "label": { "alias": "p-label"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "name": { "alias": "name"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "filterParams": { "alias": "p-filter-params"; "required": false; }; "fieldFormat": { "alias": "p-field-format"; "required": false; }; "columns": { "alias": "p-columns"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "advancedFilters": { "alias": "p-advanced-filters"; "required": false; }; "hideColumnsManager": { "alias": "p-hide-columns-manager"; "required": false; }; "infiniteScroll": { "alias": "p-infinite-scroll"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "multiple": { "alias": "p-multiple"; "required": false; }; "autoHeight": { "alias": "p-auto-height"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "spacing": { "alias": "p-spacing"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; }; "virtualScroll": { "alias": "p-virtual-scroll"; "required": false; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onError": "p-error"; "keydown": "p-keydown"; "selected": "p-selected"; "change": "p-change"; "changeVisibleColumns": "p-change-visible-columns"; "columnRestoreManager": "p-restore-column-manager"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoLookupBaseComponent, 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; }; "label": { "alias": "p-label"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "name": { "alias": "name"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "filterParams": { "alias": "p-filter-params"; "required": false; }; "fieldFormat": { "alias": "p-field-format"; "required": false; }; "columns": { "alias": "p-columns"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "advancedFilters": { "alias": "p-advanced-filters"; "required": false; }; "hideColumnsManager": { "alias": "p-hide-columns-manager"; "required": false; }; "infiniteScroll": { "alias": "p-infinite-scroll"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "multiple": { "alias": "p-multiple"; "required": false; }; "autoHeight": { "alias": "p-auto-height"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "spacing": { "alias": "p-spacing"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; }; "virtualScroll": { "alias": "p-virtual-scroll"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onError": "p-error"; "keydown": "p-keydown"; "selected": "p-selected"; "change": "p-change"; "changeVisibleColumns": "p-change-visible-columns"; "columnRestoreManager": "p-restore-column-manager"; }, never, never, true, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_hideColumnsManager: 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';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoLookupBaseComponent
@@ -103,6 +104,7 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
     disclaimers: any[];
     visibleDisclaimers: any[];
     id: string;
+    helperSettings: PoHelperOptions;
     private modalSubscription;
     private isCalculateVisibleItems;
     get autocomplete(): "on" | "off";
@@ -149,9 +151,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
@@ -161,6 +165,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') {
@@ -171,6 +185,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';
 import * as i0 from "@angular/core";
 export declare const poMultiselectLiteralsDefault: {
     en: PoMultiselectLiterals;
@@ -74,6 +75,9 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
     protected cd?: ChangeDetectorRef;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -81,6 +85,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;
     /**
@@ -170,11 +176,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>;
     /**
@@ -226,6 +237,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[];
@@ -522,7 +560,7 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
     abstract applyFilter(value?: string): Observable<Array<PoMultiselectOption | any>>;
     abstract updateVisibleItems(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoMultiselectBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoMultiselectBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "placeholderSearch": { "alias": "p-placeholder-search"; "required": false; }; "name": { "alias": "name"; "required": false; }; "hideSelectAll": { "alias": "p-hide-select-all"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "controlValueWithLabel": { "alias": "p-control-value-with-label"; "required": false; }; "listboxControlPosition": { "alias": "p-listbox-control-position"; "required": false; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "autoHeight": { "alias": "p-auto-height"; "required": false; }; "debounceTime": { "alias": "p-debounce-time"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "hideSearch": { "alias": "p-hide-search"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "sort": { "alias": "p-sort"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; }, { "blur": "p-blur"; "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoMultiselectBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "placeholderSearch": { "alias": "p-placeholder-search"; "required": false; }; "name": { "alias": "name"; "required": false; }; "hideSelectAll": { "alias": "p-hide-select-all"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "controlValueWithLabel": { "alias": "p-control-value-with-label"; "required": false; }; "listboxControlPosition": { "alias": "p-listbox-control-position"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "autoHeight": { "alias": "p-auto-height"; "required": false; }; "debounceTime": { "alias": "p-debounce-time"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "hideSearch": { "alias": "p-hide-search"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "sort": { "alias": "p-sort"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; }, { "blur": "p-blur"; "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_hideSelectAll: any;
     static ngAcceptInputType_appendBox: 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';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoMultiselectBaseComponent
@@ -67,6 +68,7 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
     timeoutResize: any;
     visibleElement: boolean;
     containerWidth: number;
+    helperSettings: PoHelperOptions;
     private subscription;
     private enterCloseTag;
     private initCalculateItems;
@@ -121,6 +123,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
@@ -130,6 +134,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') {
@@ -142,6 +156,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';
 import * as i0 from "@angular/core";
@@ -27,7 +28,7 @@ import * as i0 from "@angular/core";
  *  <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
      *
@@ -53,6 +54,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';
 import * as i0 from "@angular/core";
 /**
  * @description
@@ -53,6 +54,9 @@ import * as i0 from "@angular/core";
 export declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor, Validator {
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -60,6 +64,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;
     /**
@@ -129,11 +135,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>;
     /**
@@ -246,7 +284,7 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
     private validateModel;
     abstract getElementByValue(value: any): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoRadioGroupBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoRadioGroupBaseComponent, 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; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "columns": { "alias": "p-columns"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoRadioGroupBaseComponent, 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; }; "name": { "alias": "name"; "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; }; "columns": { "alias": "p-columns"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
 }

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

@@ -69,9 +69,12 @@ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent imp
     onKeyDown(event: KeyboardEvent, radio?: PoRadioComponent): void;
     onKeyUp(event: KeyboardEvent, value: any): 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-radio-group
      *  #radioGroup
@@ -81,6 +84,16 @@ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent imp
      * ></po-radio-group>
      * ```
      * ```
+     * // Exemplo com p-label e p-helper
+     * <po-radio-group
+     *  #radioGroup
+     *  ...
+     *  p-label="Label do radioGroup"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, radioGroup)"
+     * ></po-radio-group>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoRadioGroupComponent): void {
      *  if (event.code === 'F9') {
@@ -91,6 +104,10 @@ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent imp
      */
     showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     private isAdditionalHelpEventTriggered;
     private isArrowKey;
     private isRadioOptionFocused;

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

@@ -2,6 +2,7 @@ import { EventEmitter } from '@angular/core';
 import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
 import { PoRichTextToolbarActions } from './enum/po-rich-text-toolbar-actions.enum';
 import { PoRichTextService } from './po-rich-text.service';
+import { PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @description
@@ -15,6 +16,9 @@ import * as i0 from "@angular/core";
 export declare abstract class PoRichTextBaseComponent implements ControlValueAccessor, Validator {
     private richTextService;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -22,6 +26,8 @@ export declare abstract class PoRichTextBaseComponent 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;
     /**
@@ -136,11 +142,43 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
     set hideToolbarActions(actions: Array<PoRichTextToolbarActions> | PoRichTextToolbarActions);
     get hideToolbarActions(): Array<PoRichTextToolbarActions>;
     /**
+     * @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>;
     /**
@@ -256,7 +294,7 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
     protected updateModel(value: any): void;
     protected validateModel(value: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoRichTextBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoRichTextBaseComponent, never, never, { "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "disabledTextAlign": { "alias": "p-disabled-text-align"; "required": false; }; "errorMessage": { "alias": "p-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "hideToolbarActions": { "alias": "p-hide-toolbar-actions"; "required": false; }; "height": { "alias": "p-height"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; "changeModel": "p-change-model"; "keydown": "p-keydown"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoRichTextBaseComponent, never, never, { "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "disabledTextAlign": { "alias": "p-disabled-text-align"; "required": false; }; "errorMessage": { "alias": "p-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "hideToolbarActions": { "alias": "p-hide-toolbar-actions"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "height": { "alias": "p-height"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; "changeModel": "p-change-model"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_disabledTextAlign: any;

package/lib/components/po-field/po-rich-text/po-rich-text.component.d.ts

@@ -63,6 +63,8 @@ export declare class PoRichTextComponent extends PoRichTextBaseComponent 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-rich-text
      *  #richtext
@@ -72,6 +74,16 @@ export declare class PoRichTextComponent extends PoRichTextBaseComponent impleme
      * ></po-rich-text>
      * ```
      * ```
+     * // Exemplo com p-label e p-helper
+     * <po-rich-text
+     *  #richtext
+     *  ...
+     *  p-label="Label do richtext"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, richtext)"
+     * ></po-rich-text>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoRichTextComponent): void {
      *  if (event.code === 'F9') {
@@ -88,6 +100,10 @@ export declare class PoRichTextComponent extends PoRichTextBaseComponent impleme
     private validateClassesForRequired;
     isAllActionsHidden(): boolean;
     updateAlignOnHideToolbarActionsList(): void;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     static ɵfac: i0.ɵɵFactoryDeclaration<PoRichTextComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoRichTextComponent, "po-rich-text", never, {}, {}, never, never, false, never>;
 }