@po-ui/ng-components 19.32.0 → 19.33.0

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

@@ -106,6 +106,7 @@ export declare class PoBreadcrumbBaseComponent {
     protected clickoutListener: () => void;
     protected resizeListener: () => void;
     private _items;
+    private _size?;
     /**
      * @description
      *
@@ -118,8 +119,22 @@ export declare class PoBreadcrumbBaseComponent {
      */
     set items(items: Array<PoBreadcrumbItem>);
     get items(): Array<PoBreadcrumbItem>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o tamanho do componente entre `small` ou `medium`.
+     *
+     * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido.
+     * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme).
+     *
+     * @default `medium`
+     */
+    set size(value: string);
+    get size(): string;
     private transformToArrayPopup;
     private transformArrayToActionPopUp;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoBreadcrumbBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoBreadcrumbBaseComponent, never, never, { "favoriteService": { "alias": "p-favorite-service"; "required": false; }; "paramsService": { "alias": "p-params-service"; "required": false; }; "items": { "alias": "p-items"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoBreadcrumbBaseComponent, never, never, { "favoriteService": { "alias": "p-favorite-service"; "required": false; }; "paramsService": { "alias": "p-params-service"; "required": false; }; "items": { "alias": "p-items"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, {}, never, never, true, never>;
 }

package/lib/components/po-chart/interfaces/po-chart-serie.interface.d.ts

@@ -11,9 +11,10 @@ export interface PoChartSerie {
      * @description
      *
      * Determina a cor da série. As maneiras de customizar o *preset* padrão de cores são:
-     * * Hexadeximal, por exemplo `#c64840`;
-     * * RGB, como `rgb(0, 0, 165)`
+     * * Hexadecimal, por exemplo `#c64840`;
+     * * RGB, por exemplo `rgb(0, 0, 165)`
      * * O nome da cor, por exemplo `blue`;
+     * * Variáveis CSS, por exemplo `var(--color-01)`;
      * * Usando uma das cores do tema do PO:
      *   Valores válidos:
      *     - <span class="dot po-color-01"></span> `color-01`

package/lib/components/po-dynamic/po-dynamic-form/interfaces/po-dynamic-form-field.interface.d.ts

@@ -8,6 +8,7 @@ import { PoProgressAction } from '../../../po-progress';
 import { ForceBooleanComponentEnum, ForceOptionComponentEnum } from '../../enums/po-dynamic-field-force-component.enum';
 import { Observable } from 'rxjs';
 import { PoDynamicField } from '../../po-dynamic-field.interface';
+import { PoHelperOptions } from '../../../po-helper';
 /**
  * @usedBy PoDynamicFormComponent, PoAdvancedFilterComponent, PoPageDynamicSearchComponent
  *
@@ -20,21 +21,23 @@ import { PoDynamicField } from '../../po-dynamic-field.interface';
 export interface PoDynamicFormField extends PoDynamicField {
     /**
      * 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?: Function;
     /**
-     * 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.**
+     *
+     * > 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;
     /**
-     * Define que o `listbox` e/ou tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) serão incluídos no body da
+     * Define que o `listbox` e/ou popover (`p-helper` e/ou `p-error-limit`) serão incluídos no body da
      * página e não dentro do componente. Essa opção é necessária para cenários com containers que possuem scroll ou
      * overflow escondido, garantindo o posicionamento correto de ambos 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.
      */
     appendBox?: boolean;
     /**
@@ -155,6 +158,8 @@ export interface PoDynamicFormField extends PoDynamicField {
     disabled?: boolean;
     /** Texto de ajuda. */
     help?: string;
+    /** Texto simples que será apresentado como auxílio ao campo ou objeto com as definições do po-helper. */
+    helper?: string | PoHelperOptions;
     /** Texto exibido quando o valor do componente for *true*. */
     booleanTrue?: string;
     /** Texto exibido quando o valor do componente for *false*. */

package/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form.component.d.ts

@@ -81,7 +81,7 @@ export declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent i
     getObjectValue(): Observable<any>;
     sendObjectValue(objectValue: any): void;
     /**
-     * Método que exibe `additionalHelpTooltip` ou executa a ação definida em `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 `keydown`.
      *
      * ```
@@ -94,7 +94,7 @@ export declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent i
      *    property: 'name',
      *    ...
      *    help: 'Mensagem de ajuda.',
-     *    additionalHelpTooltip: 'Mensagem de ajuda complementar.',
+     *    helper: 'Mensagem de ajuda complementar com o componente po-helper implementado.',
      *    keydown: this.onKeyDown.bind(this, 'name')
      *  },
      * ]

package/lib/components/po-dynamic/po-dynamic-view/po-dynamic-view-base.component.d.ts

@@ -58,9 +58,24 @@ export declare class PoDynamicViewBaseComponent extends PoDynamicSharedBase {
      */
     load: string | Function;
     service: any;
+    private _componentsSize?;
     private _fields;
     private _showAllValue;
     private _value;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o tamanho dos componentes no template entre `small` ou `medium`.
+     *
+     * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido.
+     * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme).
+     *
+     * @default `medium`
+     */
+    set componentsSize(value: string);
+    get componentsSize(): string;
     /**
      * @optional
      *
@@ -190,5 +205,5 @@ export declare class PoDynamicViewBaseComponent extends PoDynamicSharedBase {
     private transformValue;
     private formatField;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoDynamicViewBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDynamicViewBaseComponent, never, never, { "load": { "alias": "p-load"; "required": false; }; "fields": { "alias": "p-fields"; "required": false; }; "showAllValue": { "alias": "p-show-all-value"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDynamicViewBaseComponent, never, never, { "load": { "alias": "p-load"; "required": false; }; "componentsSize": { "alias": "p-components-size"; "required": false; }; "fields": { "alias": "p-fields"; "required": false; }; "showAllValue": { "alias": "p-show-all-value"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; }, {}, never, never, true, never>;
 }

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

@@ -53,8 +53,7 @@ export declare abstract class PoCheckboxBaseComponent 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.
      *
@@ -66,11 +65,11 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
      *
      * @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`
      */
@@ -105,7 +104,6 @@ export declare abstract class PoCheckboxBaseComponent 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.
      */
@@ -178,10 +176,10 @@ export declare abstract class PoCheckboxBaseComponent 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>;
     /**

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

@@ -1,6 +1,6 @@
 import { AfterViewInit, ElementRef, OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import { PoCheckboxBaseComponent } from './po-checkbox-base.component';
-import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
+import { PoHelperComponent } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoCheckboxBaseComponent
@@ -25,7 +25,6 @@ import * as i0 from "@angular/core";
 export declare class PoCheckboxComponent extends PoCheckboxBaseComponent implements AfterViewInit, OnChanges, OnInit {
     private readonly changeDetector;
     private _iconToken;
-    helperSettings: PoHelperOptions;
     showTip: boolean;
     checkboxLabel: ElementRef;
     labelEl: ElementRef<HTMLElement>;
@@ -59,20 +58,12 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
     getAdditionalHelpTooltip(): string;
     onKeyDown(event: KeyboardEvent, value: boolean | string): 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-checkbox
-     *  #checkbox
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, checkbox)"
-     * ></po-checkbox>
-     * ```
-     * ```
      * //Exemplo com label e p-helper
      * <po-checkbox
      *  #checkbox

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

@@ -42,8 +42,7 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      * @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.
      *
@@ -55,11 +54,11 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      *
      * @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`
      */
@@ -127,10 +126,10 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      *
      * @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 class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      *
      * @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-checkbox-group/po-checkbox-group.component.d.ts

@@ -1,7 +1,8 @@
-import { AfterViewChecked, AfterViewInit, QueryList } from '@angular/core';
+import { AfterViewChecked, AfterViewInit, OnChanges, QueryList, SimpleChanges } from '@angular/core';
 import { PoCheckboxComponent } from '../po-checkbox/po-checkbox.component';
 import { PoCheckboxGroupOption } from './interfaces/po-checkbox-group-option.interface';
 import { PoCheckboxGroupBaseComponent } from './po-checkbox-group-base.component';
+import { PoHelperComponent } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoCheckboxGroupBaseComponent
@@ -23,10 +24,12 @@ import * as i0 from "@angular/core";
  *  <file name="sample-po-checkbox-group-password-policy/sample-po-checkbox-group-password-policy.component.ts"> </file>
  * </example>
  */
-export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseComponent implements AfterViewChecked, AfterViewInit {
+export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseComponent implements AfterViewChecked, AfterViewInit, OnChanges {
     private changeDetector;
     checkboxLabels: QueryList<PoCheckboxComponent>;
+    helperEl?: PoHelperComponent;
     private el;
+    ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewChecked(): void;
     ngAfterViewInit(): void;
     onBlur(checkbox: PoCheckboxComponent): void;
@@ -54,20 +57,12 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
     hasInvalidClass(): any;
     onKeyDown(event: KeyboardEvent, option: PoCheckboxGroupOption, checkbox?: PoCheckboxComponent): 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-checkbox-group
-     *  #checkboxGroup
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, checkboxGroup)"
-     * ></po-checkbox-group>
-     * ```
-     * ```
      * //Exemplo com p-label e p-helper
      * <po-checkbox-group
      *  #checkboxGroup

package/lib/components/po-field/po-checkbox-group/po-checkbox-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-checkbox/po-checkbox.module";
+import * as i6 from "../../po-helper/po-helper.module";
 /**
  * @description
  *
@@ -11,6 +12,6 @@ import * as i5 from "../po-checkbox/po-checkbox.module";
  */
 export declare class PoCheckboxGroupModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxGroupModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PoCheckboxGroupModule, [typeof i1.PoCheckboxGroupComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.PoFieldContainerModule, typeof i5.PoCheckboxModule], [typeof i1.PoCheckboxGroupComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoCheckboxGroupModule, [typeof i1.PoCheckboxGroupComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.PoFieldContainerModule, typeof i5.PoCheckboxModule, typeof i6.PoHelperModule], [typeof i1.PoCheckboxGroupComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoCheckboxGroupModule>;
 }

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

@@ -74,8 +74,7 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      * @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.
      *
@@ -249,7 +248,6 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      *
      * @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.
      */
@@ -336,10 +334,10 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      *
      * @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>;
     /**
@@ -605,11 +603,11 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      *
      * @description
      *
-     * Define que o `listbox` e/ou tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) serão incluídos no body da
+     * Define que o `listbox` e/ou popover (`p-helper` e/ou `p-error-limit`) serão incluídos 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 de ambos 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`
      */

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

@@ -5,7 +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';
+import { PoHelperComponent } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoComboBaseComponent
@@ -67,6 +67,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     iconElement: ElementRef;
     inputEl: ElementRef;
     poListbox: PoListBoxComponent;
+    helperEl?: PoHelperComponent;
     comboIcon: string;
     comboOpen: boolean;
     differ: any;
@@ -76,7 +77,6 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     shouldMarkLetters: boolean;
     infiniteLoading: boolean;
     containerWidth: number;
-    helperSettings: PoHelperOptions;
     private _isServerSearching;
     private lastKey;
     private clickoutListener;
@@ -132,18 +132,11 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     getInputValue(): any;
     setInputValue(value: string): 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-combo
-     *  #combo
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, combo)"
-     * ></po-combo>
-     * ```
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
+     *
      * ```
      * // Exemplo com p-label e p-helper
      * <po-combo

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

@@ -88,8 +88,7 @@ export declare abstract class PoDatepickerBaseComponent 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.
      *
@@ -176,7 +175,6 @@ export declare abstract class PoDatepickerBaseComponent 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.
      */
@@ -212,10 +210,10 @@ export declare abstract class PoDatepickerBaseComponent 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>;
     /**
@@ -382,7 +380,7 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      * 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 de ambos 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`
      */

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

@@ -1,8 +1,8 @@
-import { AfterViewInit, ElementRef, OnDestroy } from '@angular/core';
+import { AfterViewInit, ElementRef, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
 import { PoButtonComponent } from '../../po-button/po-button.component';
 import { PoCalendarComponent } from '../../po-calendar/po-calendar.component';
 import { PoDatepickerBaseComponent } from './po-datepicker-base.component';
-import { PoHelperOptions } from '../../po-helper';
+import { PoHelperComponent } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoDatepickerBaseComponent
@@ -29,13 +29,14 @@ import * as i0 from "@angular/core";
  *  <file name="sample-po-datepicker-airfare-reactive-form/sample-po-datepicker-airfare-reactive-form.component.ts"> </file>
  * </example>
  */
-export declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements AfterViewInit, OnDestroy {
+export declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements AfterViewInit, OnDestroy, OnChanges {
     private controlPosition;
     private renderer;
     calendar: PoCalendarComponent;
     dialogPicker: ElementRef;
     iconDatepicker: PoButtonComponent;
     inputEl: ElementRef;
+    helperEl?: PoHelperComponent;
     /** Rótulo do campo. */
     label?: string;
     /** Texto de apoio do campo. */
@@ -46,7 +47,6 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     id: string;
     visible: boolean;
     literals: any;
-    helperSettings: PoHelperOptions;
     eventListenerFunction: () => void;
     eventResizeListener: () => void;
     private clickListener;
@@ -60,6 +60,7 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     onKeyup($event: any): void;
     onKeydown($event?: any): void;
     ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     emitAdditionalHelp(): void;
     /**
@@ -94,20 +95,12 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     formatToDate(value: Date): string;
     refreshValue(value: Date): 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-datepicker
-     *  #datepicker
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, datepicker)"
-     * ></po-datepicker>
-     * ```
-     * ```
      * // Exemplo com p-label e p-helper
      * <po-datepicker
      *  #datepicker

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

@@ -7,6 +7,7 @@ import * as i5 from "@angular/cdk/overlay";
 import * as i6 from "../po-clean/po-clean.module";
 import * as i7 from "../../po-calendar/po-calendar.module";
 import * as i8 from "../../po-button/po-button.module";
+import * as i9 from "../../po-helper/po-helper.module";
 /**
  * @description
  *
@@ -14,6 +15,6 @@ import * as i8 from "../../po-button/po-button.module";
  */
 export declare class PoDatepickerModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoDatepickerModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PoDatepickerModule, [typeof i1.PoDatepickerComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.PoFieldContainerModule, typeof i5.OverlayModule, typeof i6.PoCleanModule, typeof i7.PoCalendarModule, typeof i8.PoButtonModule], [typeof i1.PoDatepickerComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoDatepickerModule, [typeof i1.PoDatepickerComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.PoFieldContainerModule, typeof i5.OverlayModule, typeof i6.PoCleanModule, typeof i7.PoCalendarModule, typeof i8.PoButtonModule, typeof i9.PoHelperModule], [typeof i1.PoDatepickerComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoDatepickerModule>;
 }

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

@@ -61,8 +61,7 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      * @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.
      *
@@ -78,7 +77,7 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      * 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 de ambos 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`
      */
@@ -144,7 +143,6 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      *
      * @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.
      */
@@ -169,10 +167,10 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      *
      * @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>;
     /**

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

@@ -1,7 +1,7 @@
 import { AfterViewInit, ElementRef, OnChanges, OnDestroy, OnInit, SimpleChanges } from '@angular/core';
 import { PoDatepickerRange } from './interfaces/po-datepicker-range.interface';
 import { PoDatepickerRangeBaseComponent } from './po-datepicker-range-base.component';
-import { PoHelperOptions } from '../../po-helper';
+import { PoHelperComponent } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoDatepickerRangeBaseComponent
@@ -40,8 +40,8 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     startDateInput: ElementRef;
     iconCalendar: ElementRef;
     calendarPicker: ElementRef;
+    helperEl?: PoHelperComponent;
     isCalendarVisible: boolean;
-    helperSettings: PoHelperOptions;
     private clickListener;
     private eventResizeListener;
     private poDatepickerRangeElement;
@@ -95,20 +95,12 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     resetDateRangeInputValidation(): void;
     showAdditionalHelpIcon(): boolean;
     /**
-     * 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-datepicker-range
-     *  #datepickerRange
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, datepickerRange)"
-     * ></po-datepicker-range>
-     * ```
-     * ```
      * // Exemplo com p-label e p-helper
      * <po-datepicker-range
      *  #datepickerRange