@po-ui/ng-components 19.32.0 → 19.34.0

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

@@ -14,6 +14,15 @@ export declare class PoRadioComponent extends PoFieldModel<boolean> {
     set size(value: string);
     get size(): string;
     required?: boolean;
+    /**
+     *
+     * Habilita a quebra automática do texto da propriedade `p-label`. Quando `p-label-text-wrap` for verdadeiro, o texto que excede
+     * o espaço disponível é transferido para a próxima linha em pontos apropriados para uma
+     * leitura clara.
+     *
+     * @default `false`
+     */
+    labelTextWrap?: boolean;
     /** Define o status do *radio* */
     checked: boolean;
     blur: EventEmitter<any>;
@@ -48,6 +57,7 @@ export declare class PoRadioComponent extends PoFieldModel<boolean> {
     onKeyup(): void;
     onKeydown(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoRadioComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PoRadioComponent, "po-radio", never, { "radioValue": { "alias": "p-value"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "checked": { "alias": "p-checked"; "required": false; }; }, { "blur": "p-blur"; "changeSelected": "p-change-selected"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoRadioComponent, "po-radio", never, { "radioValue": { "alias": "p-value"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; }; "checked": { "alias": "p-checked"; "required": false; }; }, { "blur": "p-blur"; "changeSelected": "p-change-selected"; }, never, never, false, never>;
     static ngAcceptInputType_required: any;
+    static ngAcceptInputType_labelTextWrap: any;
 }

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

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

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

@@ -1,6 +1,7 @@
-import { AfterViewInit, DoCheck, ElementRef, QueryList } from '@angular/core';
+import { AfterViewInit, DoCheck, ElementRef, QueryList, OnChanges, SimpleChanges } from '@angular/core';
 import { PoRadioComponent } from '../po-radio/po-radio.component';
 import { PoRadioGroupBaseComponent } from './po-radio-group-base.component';
+import { PoHelperComponent } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoRadioGroupBaseComponent
@@ -28,7 +29,7 @@ import * as i0 from "@angular/core";
  * </example>
  *
  */
-export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements AfterViewInit, DoCheck {
+export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements AfterViewInit, DoCheck, OnChanges {
     private el;
     private cd;
     /** Label do campo. */
@@ -37,10 +38,12 @@ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent imp
     help?: string;
     inputEl: ElementRef;
     radioLabels: QueryList<PoRadioComponent>;
+    helperEl?: PoHelperComponent;
     differ: any;
     constructor();
     ngAfterViewInit(): void;
     ngDoCheck(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     emitAdditionalHelp(): void;
     eventClick(value: any, disabled: any): void;
     /**
@@ -70,20 +73,12 @@ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent imp
     onKeyUp(event: KeyboardEvent, value: any): void;
     /**
      *
-     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
      * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
      *
-     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
      *
      * ```
-     * <po-radio-group
-     *  #radioGroup
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, radioGroup)"
-     * ></po-radio-group>
-     * ```
-     * ```
      * // Exemplo com p-label e p-helper
      * <po-radio-group
      *  #radioGroup

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

@@ -4,6 +4,7 @@ import * as i2 from "@angular/common";
 import * as i3 from "@angular/forms";
 import * as i4 from "../po-field-container/po-field-container.module";
 import * as i5 from "../po-radio/po-radio.module";
+import * as i6 from "../../po-helper/po-helper.module";
 /**
  * @description
  *
@@ -11,6 +12,6 @@ import * as i5 from "../po-radio/po-radio.module";
  */
 export declare class PoRadioGroupModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoRadioGroupModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PoRadioGroupModule, [typeof i1.PoRadioGroupComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.PoFieldContainerModule, typeof i5.PoRadioModule], [typeof i1.PoRadioGroupComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoRadioGroupModule, [typeof i1.PoRadioGroupComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.PoFieldContainerModule, typeof i5.PoRadioModule, typeof i6.PoHelperModule], [typeof i1.PoRadioGroupComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoRadioGroupModule>;
 }

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

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

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

@@ -8,12 +8,11 @@ export declare class PoRichTextBodyComponent implements OnInit, OnDestroy {
     modelValue?: string;
     placeholder?: string;
     readonly?: string;
-    /** Tamanho do fonte */
-    size?: string;
     change: EventEmitter<any>;
     commands: EventEmitter<any>;
     keydown: EventEmitter<KeyboardEvent>;
     selectedLink: EventEmitter<any>;
+    size: string;
     shortcutCommand: EventEmitter<any>;
     value: EventEmitter<any>;
     blur: EventEmitter<any>;

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

@@ -3,6 +3,7 @@ import { PoRichTextToolbarActions } from './enum/po-rich-text-toolbar-actions.en
 import { PoRichTextBaseComponent } from './po-rich-text-base.component';
 import { PoRichTextBodyComponent } from './po-rich-text-body/po-rich-text-body.component';
 import { PoRichTextToolbarComponent } from './po-rich-text-toolbar/po-rich-text-toolbar.component';
+import { PoHelperComponent } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoRichTextBaseComponent
@@ -29,6 +30,7 @@ export declare class PoRichTextComponent extends PoRichTextBaseComponent impleme
     private element;
     bodyElement: PoRichTextBodyComponent;
     richTextToolbar: PoRichTextToolbarComponent;
+    helperEl?: PoHelperComponent;
     private listener;
     private modelLastUpdate;
     toolbarActions: Array<PoRichTextToolbarActions>;
@@ -60,20 +62,12 @@ export declare class PoRichTextComponent extends PoRichTextBaseComponent impleme
     onChangeValue(value: any): void;
     onKeyDown(event: KeyboardEvent): void;
     /**
-     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
      * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
      *
-     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
      *
      * ```
-     * <po-rich-text
-     *  #richtext
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, richtext)"
-     * ></po-rich-text>
-     * ```
-     * ```
      * // Exemplo com p-label e p-helper
      * <po-rich-text
      *  #richtext

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

@@ -3,7 +3,7 @@ import { AbstractControl } from '@angular/forms';
 import { PoFieldValidateModel } from '../po-field-validate.model';
 import { PoSelectOptionGroup } from './po-select-option-group.interface';
 import { PoSelectOption } from './po-select-option.interface';
-import { PoHelperOptions } from '../../po-helper';
+import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoFieldValidateModel
@@ -78,6 +78,7 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
     renderer: Renderer2;
     private _iconToken;
     selectElement: ElementRef;
+    helperEl?: PoHelperComponent;
     /**
      * @optional
      *
@@ -214,10 +215,10 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
      *
      * @description
      *
-     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
+     * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
      *
-     * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
-     * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
+     * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
@@ -269,19 +270,11 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
     onKeyDown(event: KeyboardEvent): void;
     registerOnTouched(fn: any): void;
     /**
-     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
      * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
      *
-     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
      *
-     * ```html
-     * <po-select
-     *  #select
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, select)"
-     * ></po-select>
-     * ```
      * ```
      * //Exemplo com p-label e p-helper
      * <po-select

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

@@ -1,8 +1,8 @@
-import { AfterViewInit, ElementRef, OnDestroy } from '@angular/core';
+import { AfterViewInit, ElementRef, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl, ValidationErrors, Validator } from '@angular/forms';
 import { PoFieldModel } from '../po-field.model';
 import { PoSwitchLabelPosition } from './po-switch-label-position.enum';
-import { PoHelperOptions } from '../../po-helper';
+import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoFieldModel
@@ -77,10 +77,11 @@ import * as i0 from "@angular/core";
  *   <file name="sample-po-switch-order-reactive-form/sample-po-switch-order-reactive-form.component.ts"> </file>
  * </example>
  */
-export declare class PoSwitchComponent extends PoFieldModel<any> implements Validator, AfterViewInit, OnDestroy {
+export declare class PoSwitchComponent extends PoFieldModel<any> implements Validator, AfterViewInit, OnDestroy, OnChanges {
     private readonly changeDetector;
     private readonly injector;
     switchContainer: ElementRef;
+    helperEl?: PoHelperComponent;
     id: string;
     value: boolean;
     private _labelOff;
@@ -197,10 +198,10 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
      *
      * @description
      *
-     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
+     * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
      *
-     * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
-     * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
+     * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
@@ -219,6 +220,7 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
     private readonly el;
     private readonly injectOptions;
     private control;
+    ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     /**
      * Função que atribui foco ao componente.
@@ -253,6 +255,31 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
         hideAdditionalHelp: boolean;
         helperSettings?: any;
     };
+    /**
+     * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
+     * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
+     *
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
+     *
+     * ```
+     * //Exemplo com p-label e p-helper
+     * <po-switch
+     *  #switch
+     *  ...
+     *  p-label="Label do switch"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, switch)"
+     * ></po-switch>
+     * ```
+     * ```typescript
+     * onKeyDown(event: KeyboardEvent, inp: PoSwitchComponent): void {
+     *  if (event.code === 'F9') {
+     *    inp.showAdditionalHelp();
+     *  }
+     * }
+     * ```
+     */
+    showAdditionalHelp(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoSwitchComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoSwitchComponent, "po-switch", never, { "value": { "alias": "p-value"; "required": false; }; "formatModel": { "alias": "p-format-model"; "required": false; }; "hideLabelStatus": { "alias": "p-hide-label-status"; "required": false; }; "labelPosition": { "alias": "p-label-position"; "required": false; }; "labelOff": { "alias": "p-label-off"; "required": false; }; "labelOn": { "alias": "p-label-on"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "invalidValue": { "alias": "p-invalid-value"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; }, {}, never, never, false, never>;
     static ngAcceptInputType_value: any;

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

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

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

@@ -1,5 +1,6 @@
-import { AfterViewInit, ElementRef } from '@angular/core';
+import { AfterViewInit, ElementRef, OnChanges, SimpleChanges } from '@angular/core';
 import { PoTextareaBaseComponent } from './po-textarea-base.component';
+import { PoHelperComponent } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoTextareaBaseComponent
@@ -27,9 +28,10 @@ import * as i0 from "@angular/core";
  * </example>
  *
  */
-export declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit {
+export declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit, OnChanges {
     private el;
     inputEl: ElementRef;
+    helperEl?: PoHelperComponent;
     id: string;
     valueBeforeChange: any;
     fireChange: boolean;
@@ -54,6 +56,7 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
      */
     focus(): void;
     ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     getAdditionalHelpTooltip(): string;
     getErrorPattern(): string;
     hasInvalidClass(): boolean;
@@ -65,20 +68,12 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
     controlChangeEmitter(): void;
     onKeyDown(event: KeyboardEvent): void;
     /**
-     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
      * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
      *
-     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
      *
      * ```
-     * <po-textarea
-     *  #textarea
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, textarea)"
-     * ></po-textarea>
-     * ```
-     * ```
      * //Exemplo com p-label e p-helper
      * <po-textarea
      *  #textarea

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

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

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

@@ -5,6 +5,7 @@ import { PoModalAction, PoModalComponent } from '../../po-modal';
 import { PoUploadBaseComponent } from './po-upload-base.component';
 import { PoUploadFile } from './po-upload-file';
 import { PoUploadStatus } from './po-upload-status.enum';
+import { PoHelperComponent } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoUploadBaseComponent
@@ -49,6 +50,7 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
     private poUploadDragDropComponent;
     uploadButton: PoButtonComponent;
     modalComponent: PoModalComponent;
+    helperEl?: PoHelperComponent;
     id: string;
     infoByUploadStatus: {
         [key: string]: {
@@ -103,7 +105,6 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
     getAdditionalHelpTooltip(): string;
     hasAnyFileUploading(files: Array<PoUploadFile>): boolean;
     isAllowCancelEvent(status: PoUploadStatus): status is PoUploadStatus.Uploading | PoUploadStatus.Error | PoUploadStatus.None;
-    onBlur(): void;
     onFileChange(event: any): void;
     onFileChangeDragDrop(files: any): void;
     onKeyDown(event: KeyboardEvent): void;
@@ -120,18 +121,11 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
     sendFiles(): void;
     setDirectoryAttribute(canHandleDirectory: boolean): void;
     /**
-     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
      * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
      *
-     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
-     * ```
-     * <po-upload
-     *  #upload
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, upload)"
-     * ></po-upload>
-     * ```
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
+     *
      * ```
      * //Exemplo com p-label e p-helper
      * <po-upload

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

@@ -1,4 +1,4 @@
-import { AfterViewInit, OnDestroy } from '@angular/core';
+import { AfterViewInit, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputGeneric } from '../po-input-generic/po-input-generic';
 import * as i0 from "@angular/core";
@@ -27,7 +27,7 @@ import * as i0 from "@angular/core";
  * </example>
  *
  */
-export declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy {
+export declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnChanges {
     id: string;
     icon: string;
     type: string;
@@ -37,6 +37,7 @@ export declare class PoUrlComponent extends PoInputGeneric implements AfterViewI
     constructor();
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     extraValidation(c: AbstractControl): {
         [key: string]: any;
     };

package/lib/components/po-helper/po-helper-base.component.d.ts

@@ -106,7 +106,18 @@ export declare class PoHelperBaseComponent {
      * @default `false`
      */
     disabled: import("@angular/core").InputSignal<boolean>;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     * Define que o popover será inserido no body da página em vez do elemento definido em `p-target`. Essa opção pode
+     * ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o posicionamento
+     * correto do conteúdo próximo ao elemento.
+     */
+    appendBox: import("@angular/core").InputSignal<boolean>;
     private transformHelper;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoHelperBaseComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PoHelperBaseComponent, "po-helper-base", never, { "helper": { "alias": "p-helper"; "required": false; "isSignal": true; }; "size": { "alias": "p-size"; "required": false; "isSignal": true; }; "disabled": { "alias": "p-disabled"; "required": false; "isSignal": true; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoHelperBaseComponent, "po-helper-base", never, { "helper": { "alias": "p-helper"; "required": false; "isSignal": true; }; "size": { "alias": "p-size"; "required": false; "isSignal": true; }; "disabled": { "alias": "p-disabled"; "required": false; "isSignal": true; }; "appendBox": { "alias": "p-append-in-body"; "required": false; "isSignal": true; }; }, {}, never, never, false, never>;
 }

package/lib/components/po-helper/po-helper.component.d.ts

@@ -41,6 +41,7 @@ export declare class PoHelperComponent extends PoHelperBaseComponent implements
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     openHelperPopover(): void;
+    helperIsVisible(): boolean;
     closeHelperPopover(): void;
     emitClick(event: MouseEvent): void;
     onKeyDown(event: KeyboardEvent): void;