@po-ui/ng-components 20.3.0 → 20.5.0

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';
 /**
  * @description
  *
@@ -52,6 +53,9 @@ import { PoRadioGroupOption } from './po-radio-group-option.interface';
 export declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor, Validator {
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -59,6 +63,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;
     /**
@@ -128,11 +134,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>;
     /**

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

@@ -68,9 +68,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
@@ -80,6 +83,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') {
@@ -90,6 +103,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';
 /**
  * @description
  *
@@ -14,6 +15,9 @@ import { PoRichTextService } from './po-rich-text.service';
 export declare abstract class PoRichTextBaseComponent implements ControlValueAccessor, Validator {
     private richTextService;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -21,6 +25,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;
     /**
@@ -135,11 +141,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>;
     /**

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

@@ -62,6 +62,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
@@ -71,6 +73,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') {
@@ -87,4 +99,8 @@ export declare class PoRichTextComponent extends PoRichTextBaseComponent impleme
     private validateClassesForRequired;
     isAllActionsHidden(): boolean;
     updateAlignOnHideToolbarActionsList(): void;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
 }

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

@@ -1,8 +1,9 @@
-import { ElementRef, EventEmitter, OnChanges, Renderer2, SimpleChanges } from '@angular/core';
+import { ElementRef, EventEmitter, OnChanges, Renderer2, SimpleChanges, AfterViewInit } from '@angular/core';
 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';
 /**
  * @docsExtends PoFieldValidateModel
  *
@@ -71,7 +72,7 @@ import { PoSelectOption } from './po-select-option.interface';
  * | `--background-color-disabled`     | Cor de background no estado disabled                  | `var(--color-neutral-light-20)`                 |
  *
  */
-export declare class PoSelectComponent extends PoFieldValidateModel<any> implements OnChanges {
+export declare class PoSelectComponent extends PoFieldValidateModel<any> implements AfterViewInit, OnChanges {
     private el;
     renderer: Renderer2;
     private _iconToken;
@@ -205,8 +206,36 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
      */
     set size(value: string);
     get size(): string;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     *
+     * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
+     * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
+     */
+    poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Habilita a quebra automática do texto da propriedade `p-label`. Quando `p-label-text-wrap` for verdadeiro, o texto que excede
+     * o espaço disponível é transferido para a próxima linha em pontos apropriados para uma
+     * leitura clara.
+     *
+     * @default `false`
+     */
+    labelTextWrap: import("@angular/core").InputSignal<boolean>;
     constructor();
     ngOnChanges(changes: SimpleChanges): void;
+    ngAfterViewInit(): void;
     /**
      * Função que atribui foco ao componente.
      *
@@ -242,6 +271,8 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> 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.
+     *
      * ```html
      * <po-select
      *  #select
@@ -250,6 +281,16 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
      *  (p-keydown)="onKeyDown($event, select)"
      * ></po-select>
      * ```
+     * ```
+     * //Exemplo com p-label e p-helper
+     * <po-select
+     *  #select
+     *  ...
+     *  p-label="Label do select"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, select)"
+     * ></po-select>
+     * ```
      * ```typescript
      * onKeyDown(event: KeyboardEvent, inp: PoSelectComponent): void {
      *  if (event.code === 'F9') {
@@ -259,6 +300,10 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
      * ```
      */
     showAdditionalHelp(): boolean;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     private isEqual;
     private findOptionValue;
     private getValueUpdate;

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

@@ -2,6 +2,7 @@ import { AfterViewInit, ElementRef, OnDestroy } 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';
 /**
  * @docsExtends PoFieldModel
  *
@@ -188,6 +189,32 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
      */
     set size(value: string);
     get size(): string;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     *
+     * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
+     * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
+     */
+    poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     * Habilita a quebra automática do texto da propriedade `p-label`. Quando `p-label-text-wrap` for verdadeiro, o texto que excede
+     * o espaço disponível é transferido para a próxima linha em pontos apropriados para uma
+     * leitura clara.
+     *
+     * @default `false`
+     */
+    labelTextWrap: import("@angular/core").InputSignal<boolean>;
     private readonly el;
     private readonly injectOptions;
     private control;
@@ -221,4 +248,8 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
     private setControl;
     getErrorPattern(): string;
     hasInvalidClass(): boolean;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
 }

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

@@ -1,5 +1,6 @@
 import { ChangeDetectorRef, EventEmitter } from '@angular/core';
 import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
+import { PoHelperOptions } from '../../po-helper';
 /**
  * @description
  *
@@ -48,6 +49,9 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
     cd: ChangeDetectorRef;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -55,6 +59,8 @@ export declare abstract class PoTextareaBaseComponent 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;
     /**
@@ -128,11 +134,43 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
      */
     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>;
     /**

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

@@ -67,6 +67,8 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent 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-textarea
      *  #textarea
@@ -76,6 +78,16 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
      * ></po-textarea>
      * ```
      * ```
+     * //Exemplo com p-label e p-helper
+     * <po-textarea
+     *  #textarea
+     *  ...
+     *  p-label="Label do textarea"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, textarea)"
+     * ></po-textarea>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoTextareaComponent): void {
      *  if (event.code === 'F9') {
@@ -87,4 +99,8 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
     showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
     private isAdditionalHelpEventTriggered;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
 }

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

@@ -6,6 +6,7 @@ import { PoUploadFileRestrictions } from './interfaces/po-upload-file-restrictio
 import { PoUploadLiterals } from './interfaces/po-upload-literals.interface';
 import { PoUploadFile } from './po-upload-file';
 import { PoUploadService } from './po-upload.service';
+import { PoHelperOptions } from '../../po-helper';
 export declare const poUploadLiteralsDefault: {
     en: PoUploadLiterals;
     es: PoUploadLiterals;
@@ -31,6 +32,9 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
     protected cd: ChangeDetectorRef;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -38,6 +42,8 @@ export declare abstract class PoUploadBaseComponent 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;
     /**
@@ -143,11 +149,43 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
      */
     requiredUrl: 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>;
     /**

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

@@ -103,6 +103,7 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
      * 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-upload
      *  #upload
@@ -112,6 +113,16 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
      * ></po-upload>
      * ```
      * ```
+     * //Exemplo com p-label e p-helper
+     * <po-upload
+     *  #upload
+     *  ...
+     *  p-label="Label do upload"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, upload)"
+     * ></po-upload>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoUploadComponent): void {
      *  if (event.code === 'F9') {
@@ -126,6 +137,10 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
     trackByFn(index: any, file: PoUploadFile): string;
     uploadFiles(files: Array<PoUploadFile>): void;
     customClick(file: PoUploadFile): void;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     private cleanInputValue;
     private isAdditionalHelpEventTriggered;
     private isUploadButtonFocused;

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

@@ -0,0 +1,3 @@
+export * from './po-helper.module';
+export * from './po-helper.component';
+export * from './interfaces/po-helper.interface';

package/lib/components/po-helper/interfaces/po-helper.interface.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @usedBy PoHelperComponent
+ *
+ * @description
+ *
+ * *Interface* que define as opções de configuração do componente po-helper.
+ *
+ * Permite customizar o conteúdo, título, tipo do ícone, modo de abertura do popover, ações customizadas e eventos.
+ *
+ */
+export interface PoHelperOptions {
+    /**
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Título do helper exibido no popover.
+     */
+    title?: string;
+    /**
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Texto explicativo exibido no popover.
+     */
+    content?: string;
+    /**
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Tipo do ícone exibido: `info` ou `help`.
+     *
+     * Quando o valor é `info`, o popover exibe apenas informações e não permite ações customizadas.
+     *
+     * Quando o valor é `help`, o popover pode exibir ações customizadas no rodapé.
+     *
+     * @default `help`
+     */
+    type?: 'info' | 'help';
+    /**
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Ação customizada exibida no rodapé do popover.
+     * Compatível apenas com a propriedade type com o valor `help` e desconsiderada quando o type for `info`.
+     *
+     * Deve ser um objeto com as propriedades:
+     * - `label`: Texto do botão.
+     * - `action`: Função executada ao clicar no botão.
+     *
+     * Exemplo:
+     * ```typescript
+     * { label: 'Saiba mais', action: this.footerAction.bind(this)) }
+     * ```
+     */
+    footerAction?: {
+        label: string;
+        action: Function;
+    };
+    /**
+     * @optional
+     *
+     * @description
+     * Evento disparado ao clicar no ícone do helper.
+     *
+     * O conteúdo do popover não é exibido quando esta propriedade é definida, para controle total do evento pelo desenvolvedor.
+     *
+     * Pode ser uma função ou um `EventEmitter`.
+     *
+     * Exemplo:
+     * ```
+     * eventOnClick: (event) => {
+     *  alert('Clicou no helper');
+     *  console.log(event);
+     * }
+     * ```
+     */
+    eventOnClick?: Function;
+    size?: string;
+}