@po-ui/ng-components 19.0.0 → 19.1.0

package/lib/components/po-field/po-field-container/po-field-container-bottom/po-field-container-bottom.component.d.ts

@@ -1,3 +1,4 @@
+import { EventEmitter } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
  * @docsPrivate
@@ -8,6 +9,11 @@ import * as i0 from "@angular/core";
  * Essa margem inferior pode conter uma mensagem de erro.
  */
 export declare class PoFieldContainerBottomComponent {
+    /** Texto exibido no tooltip do ícone de ajuda adicional. */
+    additionalHelpTooltip?: string;
+    /** Define se o tooltip será inserido no `body` em vez do componente. */
+    appendBox: boolean;
+    disabled: boolean;
     /**
      * Mensagem que será apresentada quando o pattern ou a máscara não for satisfeita.
      * Obs: Esta mensagem não é apresentada quando o campo estiver vazio, mesmo que ele seja requerido.
@@ -17,10 +23,12 @@ export declare class PoFieldContainerBottomComponent {
      * Limita a exibição da mensagem de erro a duas linhas e exibe um tooltip com o texto completo.
      */
     errorLimit: boolean;
-    disabled: boolean;
     help?: string;
-    appendBox?: boolean;
+    /** Exibe o ícone de ajuda adicional. */
+    showAdditionalHelpIcon: boolean;
+    /** Evento disparado ao clicar no ícone de ajuda adicional. */
+    additionalHelp: EventEmitter<any>;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldContainerBottomComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PoFieldContainerBottomComponent, "po-field-container-bottom", never, { "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoFieldContainerBottomComponent, "po-field-container-bottom", never, { "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "showAdditionalHelpIcon": { "alias": "p-show-additional-help-icon"; "required": false; }; }, { "additionalHelp": "p-additional-help"; }, never, never, false, never>;
     static ngAcceptInputType_appendBox: any;
 }

package/lib/components/po-field/po-field-validate.model.d.ts

@@ -42,7 +42,6 @@ export declare abstract class PoFieldValidateModel<T> extends PoFieldModel<T> im
      *
      */
     fieldErrorMessage: string;
-    errorAppendBox?: boolean;
     /**
      * @optional
      *
@@ -73,8 +72,7 @@ export declare abstract class PoFieldValidateModel<T> extends PoFieldModel<T> im
         [key: string]: any;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldValidateModel<any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoFieldValidateModel<any>, never, never, { "optional": { "alias": "p-optional"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorAppendBox": { "alias": "p-error-append-in-body"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoFieldValidateModel<any>, never, never, { "optional": { "alias": "p-optional"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, {}, never, never, true, never>;
     static ngAcceptInputType_optional: any;
     static ngAcceptInputType_required: any;
-    static ngAcceptInputType_errorAppendBox: any;
 }

package/lib/components/po-field/po-field.model.d.ts

@@ -2,6 +2,31 @@ import { EventEmitter } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i0 from "@angular/core";
 export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
+    additionalHelpEventTrigger: string | undefined;
+    /**
+     * @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.
+     * **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.
+     */
+    additionalHelpTooltip?: string;
+    /**
+     * @optional
+     *
+     * @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
+     * 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.
+     *
+     * @default `false`
+     */
+    appendBox: boolean;
     /** Rótulo exibido pelo componente. */
     label: string;
     /** Nome do componente. */
@@ -18,6 +43,14 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
      * @default `false`
      */
     disabled: boolean;
+    /**
+     * @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`.
+     */
+    additionalHelp: EventEmitter<any>;
     /**
      * @optional
      *
@@ -34,10 +67,15 @@ export declare abstract class PoFieldModel<T> implements ControlValueAccessor {
     registerOnChange(fn: any): void;
     registerOnTouched(fn: any): void;
     writeValue(value: T): void;
+    emitAdditionalHelp(): void;
     emitChange(value: any): void;
+    getAdditionalHelpTooltip(): string;
+    showAdditionalHelpIcon(): boolean;
+    private isAdditionalHelpEventTriggered;
     protected updateModel(value: T): void;
     abstract onWriteValue(value: T): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldModel<any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoFieldModel<any>, never, never, { "label": { "alias": "p-label"; "required": false; }; "name": { "alias": "name"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; }, { "change": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoFieldModel<any>, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "name": { "alias": "name"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; }, never, never, true, never>;
+    static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_disabled: any;
 }

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

@@ -51,6 +51,31 @@ import * as i0 from "@angular/core";
  */
 export declare abstract class PoInputBaseComponent implements ControlValueAccessor, Validator, OnDestroy {
     protected cd?: ChangeDetectorRef;
+    additionalHelpEventTrigger: string | undefined;
+    /**
+     * @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.
+     * **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.
+     */
+    additionalHelpTooltip?: string;
+    /**
+     * @optional
+     *
+     * @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
+     * 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.
+     *
+     * @default `false`
+     */
+    appendBox: boolean;
     /**
      * @optional
      *
@@ -137,7 +162,6 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      * @default `false`
      */
     errorLimit: boolean;
-    errorAppendBox?: boolean;
     /**
      * @optional
      *
@@ -197,6 +221,14 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
      */
     set maskNoLengthValidation(value: boolean);
     get maskNoLengthValidation(): boolean;
+    /**
+     * @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`.
+     */
+    additionalHelp: EventEmitter<any>;
     /**
      * @optional
      *
@@ -355,16 +387,20 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
     callOnChange(value: any): void;
     callUpdateModelWithTimeout(value: any): void;
     controlChangeModelEmitter(value: any): void;
+    emitAdditionalHelp(): void;
+    getAdditionalHelpTooltip(): string;
     setDisabledState(isDisabled: boolean): void;
     registerOnChange(func: any): void;
     registerOnTouched(func: any): void;
     registerOnValidatorChange(fn: () => void): void;
+    showAdditionalHelpIcon(): boolean;
     updateModel(value: any): void;
     validate(c: AbstractControl): {
         [key: string]: any;
     };
     writeValue(value: any): void;
     protected validateModel(): void;
+    private isAdditionalHelpEventTriggered;
     private validatePatternOnWriteValue;
     /**
      * Função que atribui foco ao componente.
@@ -390,9 +426,9 @@ export declare abstract class PoInputBaseComponent implements ControlValueAccess
     };
     abstract getScreenValue(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoInputBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoInputBaseComponent, never, never, { "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "emitAllChanges": { "alias": "p-emit-all-changes"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "errorAsyncProperties": { "alias": "p-error-async-properties"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "errorAppendBox": { "alias": "p-error-append-in-body"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "showErrorMessageRequired": { "alias": "p-required-field-error-message"; "required": false; }; "upperCase": { "alias": "p-upper-case"; "required": false; }; "maskNoLengthValidation": { "alias": "p-mask-no-length-validation"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "setDisabled": { "alias": "p-disabled"; "required": false; }; "setReadonly": { "alias": "p-readonly"; "required": false; }; "setRequired": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "setClean": { "alias": "p-clean"; "required": false; }; "setPattern": { "alias": "p-pattern"; "required": false; }; "maxlength": { "alias": "p-maxlength"; "required": false; }; "minlength": { "alias": "p-minlength"; "required": false; }; "setMask": { "alias": "p-mask"; "required": false; }; "setMaskFormatModel": { "alias": "p-mask-format-model"; "required": false; }; }, { "blur": "p-blur"; "enter": "p-enter"; "change": "p-change"; "changeModel": "p-change-model"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoInputBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "emitAllChanges": { "alias": "p-emit-all-changes"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "errorAsyncProperties": { "alias": "p-error-async-properties"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "showErrorMessageRequired": { "alias": "p-required-field-error-message"; "required": false; }; "upperCase": { "alias": "p-upper-case"; "required": false; }; "maskNoLengthValidation": { "alias": "p-mask-no-length-validation"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "setDisabled": { "alias": "p-disabled"; "required": false; }; "setReadonly": { "alias": "p-readonly"; "required": false; }; "setRequired": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "setClean": { "alias": "p-clean"; "required": false; }; "setPattern": { "alias": "p-pattern"; "required": false; }; "maxlength": { "alias": "p-maxlength"; "required": false; }; "minlength": { "alias": "p-minlength"; "required": false; }; "setMask": { "alias": "p-mask"; "required": false; }; "setMaskFormatModel": { "alias": "p-mask-format-model"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "blur": "p-blur"; "enter": "p-enter"; "change": "p-change"; "changeModel": "p-change-model"; }, never, never, true, never>;
+    static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_emitAllChanges: any;
-    static ngAcceptInputType_errorAppendBox: any;
     static ngAcceptInputType_upperCase: any;
 }

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

@@ -38,6 +38,31 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
     poLookupModalService: PoLookupModalService;
     private _literals?;
     private language;
+    additionalHelpEventTrigger: string | undefined;
+    /**
+     * @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.
+     * **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.
+     */
+    additionalHelpTooltip?: string;
+    /**
+     * @optional
+     *
+     * @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
+     * 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.
+     *
+     * @default `false`
+     */
+    appendBox?: boolean;
     /**
      * @optional
      *
@@ -272,7 +297,6 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
      * @default `false`
      */
     errorLimit: boolean;
-    errorAppendBox?: boolean;
     /**
      * @optional
      *
@@ -314,6 +338,14 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
      * @default `true`
      */
     virtualScroll?: boolean;
+    /**
+     * @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`.
+     */
+    additionalHelp: EventEmitter<any>;
     /**
      * Evento será disparado quando ocorrer algum erro na requisição de busca do item.
      * Será passado por parâmetro o objeto de erro retornado.
@@ -506,14 +538,14 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
     abstract setDisclaimers(a: any): any;
     abstract updateVisibleItems(): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoLookupBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoLookupBaseComponent, never, never, { "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "name": { "alias": "name"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "filterParams": { "alias": "p-filter-params"; "required": false; }; "fieldFormat": { "alias": "p-field-format"; "required": false; }; "columns": { "alias": "p-columns"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "advancedFilters": { "alias": "p-advanced-filters"; "required": false; }; "hideColumnsManager": { "alias": "p-hide-columns-manager"; "required": false; }; "infiniteScroll": { "alias": "p-infinite-scroll"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "multiple": { "alias": "p-multiple"; "required": false; }; "autoHeight": { "alias": "p-auto-height"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "errorAppendBox": { "alias": "p-error-append-in-body"; "required": false; }; "spacing": { "alias": "p-spacing"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; }; "virtualScroll": { "alias": "p-virtual-scroll"; "required": false; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; }, { "onError": "p-error"; "selected": "p-selected"; "change": "p-change"; "changeVisibleColumns": "p-change-visible-columns"; "columnRestoreManager": "p-restore-column-manager"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoLookupBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "name": { "alias": "name"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "filterParams": { "alias": "p-filter-params"; "required": false; }; "fieldFormat": { "alias": "p-field-format"; "required": false; }; "columns": { "alias": "p-columns"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "advancedFilters": { "alias": "p-advanced-filters"; "required": false; }; "hideColumnsManager": { "alias": "p-hide-columns-manager"; "required": false; }; "infiniteScroll": { "alias": "p-infinite-scroll"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "multiple": { "alias": "p-multiple"; "required": false; }; "autoHeight": { "alias": "p-auto-height"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "spacing": { "alias": "p-spacing"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; }; "virtualScroll": { "alias": "p-virtual-scroll"; "required": false; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onError": "p-error"; "selected": "p-selected"; "change": "p-change"; "changeVisibleColumns": "p-change-visible-columns"; "columnRestoreManager": "p-restore-column-manager"; }, never, never, true, never>;
+    static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_hideColumnsManager: any;
     static ngAcceptInputType_infiniteScroll: any;
     static ngAcceptInputType_clean: any;
     static ngAcceptInputType_multiple: any;
     static ngAcceptInputType_autoHeight: any;
-    static ngAcceptInputType_errorAppendBox: any;
     static ngAcceptInputType_textWrap: any;
     static ngAcceptInputType_virtualScroll: any;
 }

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

@@ -131,6 +131,8 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
      * ```
      */
     focus(): void;
+    emitAdditionalHelp(): void;
+    getAdditionalHelpTooltip(): string;
     openLookup(): void;
     checkSelectedItems(): any;
     setDisclaimers(selectedOptions: Array<any>): void;
@@ -146,6 +148,8 @@ export declare class PoLookupComponent extends PoLookupBaseComponent implements
     getInputWidth(): number;
     getDisclaimersWidth(): any[];
     calculateVisibleItems(): void;
+    showAdditionalHelpIcon(): boolean;
+    private isAdditionalHelpEventTriggered;
     private isAllowedOpenModal;
     private formatFields;
     private setInputValueWipoieldFormat;

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

@@ -73,6 +73,17 @@ export declare const poMultiselectLiteralsDefault: {
  *
  */
 export declare abstract class PoMultiselectBaseComponent implements ControlValueAccessor, OnInit, Validator {
+    additionalHelpEventTrigger: string | undefined;
+    /**
+     * @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.
+     * **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.
+     */
+    additionalHelpTooltip?: string;
     /**
      * @optional
      *
@@ -138,6 +149,14 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
      *
      */
     fieldErrorMessage: string;
+    /**
+     * @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`.
+     */
+    additionalHelp: EventEmitter<any>;
     /**
      * @optional
      *
@@ -164,15 +183,16 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
      *
      * @description
      *
-     * Define que o dropdown do multiselect será incluido no body da página e não suspenso com a caixa de texto do componente.
-     * Opção necessária para o caso de uso do componente em páginas que necessitam renderizar o multiselect fora do conteúdo principal.
+     * Define que o `listbox` e/ou tooltip (`p-additional-help-tooltip` 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.
      *
-     * > Obs: O uso dessa propriedade pode acarretar na perda sequencial da tabulação da página
+     * > O uso dessa propriedade pode interferir na sequência de tabulação da página. Quando utilizado com
+     * `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
      *
      * @default `false`
      */
     appendBox?: boolean;
-    errorAppendBox?: boolean;
     selectedOptions: Array<PoMultiselectOption | any>;
     visibleOptionsDropdown: Array<PoMultiselectOption | any>;
     visibleTags: any[];
@@ -449,10 +469,9 @@ export declare abstract class PoMultiselectBaseComponent implements ControlValue
     abstract applyFilter(value?: string): Observable<Array<PoMultiselectOption | any>>;
     abstract updateVisibleItems(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoMultiselectBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoMultiselectBaseComponent, never, never, { "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "placeholderSearch": { "alias": "p-placeholder-search"; "required": false; }; "name": { "alias": "name"; "required": false; }; "hideSelectAll": { "alias": "p-hide-select-all"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "errorAppendBox": { "alias": "p-error-append-in-body"; "required": false; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "autoHeight": { "alias": "p-auto-height"; "required": false; }; "debounceTime": { "alias": "p-debounce-time"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "hideSearch": { "alias": "p-hide-search"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "sort": { "alias": "p-sort"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; }, { "change": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoMultiselectBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "placeholderSearch": { "alias": "p-placeholder-search"; "required": false; }; "name": { "alias": "name"; "required": false; }; "hideSelectAll": { "alias": "p-hide-select-all"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "autoHeight": { "alias": "p-auto-height"; "required": false; }; "debounceTime": { "alias": "p-debounce-time"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "hideSearch": { "alias": "p-hide-search"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "sort": { "alias": "p-sort"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; }, never, never, true, never>;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_hideSelectAll: any;
     static ngAcceptInputType_appendBox: any;
-    static ngAcceptInputType_errorAppendBox: any;
     static ngAcceptInputType_autoHeight: any;
 }

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

@@ -80,6 +80,7 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
     ngOnChanges(changes: SimpleChanges): void;
     ngDoCheck(): void;
     ngOnDestroy(): void;
+    emitAdditionalHelp(): void;
     /**
      * Função que atribui foco ao componente.
      *
@@ -98,6 +99,7 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
      * ```
      */
     focus(): void;
+    getAdditionalHelpTooltip(): string;
     getInputWidth(): number;
     getTagsWidth(): any[];
     getErrorPattern(): string;
@@ -116,6 +118,7 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
     setVisibleOptionsDropdown(options: any): void;
     changeSearch(event: any): void;
     closeTag(value: any, event: any): void;
+    showAdditionalHelpIcon(): boolean;
     wasClickedOnToggle(event: MouseEvent): void;
     applyFilter(value?: string): Observable<Array<PoMultiselectOption | any>>;
     private applyFilterInFirstClick;
@@ -131,6 +134,7 @@ export declare class PoMultiselectComponent extends PoMultiselectBaseComponent i
     private handleKeyDown;
     private initializeTagRemoveElements;
     private initializeListeners;
+    private isAdditionalHelpEventTriggered;
     private onScroll;
     private open;
     private removeListeners;

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

@@ -51,6 +51,31 @@ import * as i0 from "@angular/core";
  *
  */
 export declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor, Validator {
+    additionalHelpEventTrigger: string | undefined;
+    /**
+     * @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.
+     * **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.
+     */
+    additionalHelpTooltip?: string;
+    /**
+     * @optional
+     *
+     * @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
+     * 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.
+     *
+     * @default `false`
+     */
+    appendBox?: boolean;
     /**
      * @optional
      *
@@ -90,6 +115,14 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
      *
      */
     fieldErrorMessage: string;
+    /**
+     * @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`.
+     */
+    additionalHelp: EventEmitter<any>;
     /**
      * @optional
      *
@@ -195,6 +228,7 @@ export declare abstract class PoRadioGroupBaseComponent implements ControlValueA
     private validateModel;
     abstract getElementByValue(value: any): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoRadioGroupBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoRadioGroupBaseComponent, never, never, { "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "columns": { "alias": "p-columns"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "change": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoRadioGroupBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "columns": { "alias": "p-columns"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; }, never, never, true, never>;
+    static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
 }

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

@@ -43,6 +43,7 @@ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent imp
     constructor(differs: IterableDiffers, el: ElementRef, cd: ChangeDetectorRef);
     ngAfterViewInit(): void;
     ngDoCheck(): void;
+    emitAdditionalHelp(): void;
     eventClick(value: any, disabled: any): void;
     /**
      * Função que atribui foco ao componente.
@@ -62,10 +63,13 @@ export declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent imp
      * ```
      */
     focus(): void;
+    getAdditionalHelpTooltip(): string;
     getElementByValue(value: any): any;
     getErrorPattern(): string;
     hasInvalidClass(): any;
     onKeyUp(event: KeyboardEvent, value: any): void;
+    showAdditionalHelpIcon(): boolean;
+    private isAdditionalHelpEventTriggered;
     private isArrowKey;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoRadioGroupComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoRadioGroupComponent, "po-radio-group", never, { "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; }, {}, never, never, false, never>;

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

@@ -14,6 +14,30 @@ import * as i0 from "@angular/core";
  */
 export declare abstract class PoRichTextBaseComponent implements ControlValueAccessor, Validator {
     private richTextService;
+    /**
+     * @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.
+     * **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.
+     */
+    additionalHelpTooltip?: string;
+    /**
+     * @optional
+     *
+     * @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
+     * 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.
+     *
+     * @default `false`
+     */
+    appendBox?: boolean;
     /**
      * @optional
      *
@@ -111,6 +135,14 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
      */
     set hideToolbarActions(actions: Array<PoRichTextToolbarActions> | PoRichTextToolbarActions);
     get hideToolbarActions(): Array<PoRichTextToolbarActions>;
+    /**
+     * @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`.
+     */
+    additionalHelp: EventEmitter<any>;
     /**
      * @optional
      *
@@ -198,7 +230,8 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
     protected updateModel(value: any): void;
     protected validateModel(value: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoRichTextBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoRichTextBaseComponent, never, never, { "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "disabledTextAlign": { "alias": "p-disabled-text-align"; "required": false; }; "errorMessage": { "alias": "p-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "hideToolbarActions": { "alias": "p-hide-toolbar-actions"; "required": false; }; "height": { "alias": "p-height"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, { "change": "p-change"; "changeModel": "p-change-model"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoRichTextBaseComponent, never, never, { "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "disabledTextAlign": { "alias": "p-disabled-text-align"; "required": false; }; "errorMessage": { "alias": "p-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "hideToolbarActions": { "alias": "p-hide-toolbar-actions"; "required": false; }; "height": { "alias": "p-height"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; "changeModel": "p-change-model"; }, never, never, true, never>;
+    static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_disabledTextAlign: any;
 }

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

@@ -31,6 +31,31 @@ import * as i0 from "@angular/core";
  */
 export declare abstract class PoTextareaBaseComponent implements ControlValueAccessor, Validator {
     cd: ChangeDetectorRef;
+    additionalHelpEventTrigger: string | undefined;
+    /**
+     * @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.
+     * **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.
+     */
+    additionalHelpTooltip?: string;
+    /**
+     * @optional
+     *
+     * @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
+     * 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.
+     *
+     * @default `false`
+     */
+    appendBox?: boolean;
     /**
      * @optional
      *
@@ -74,6 +99,14 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
      *
      */
     fieldErrorMessage: string;
+    /**
+     * @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`.
+     */
+    additionalHelp: EventEmitter<any>;
     /**
      * @optional
      *
@@ -218,6 +251,7 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
     protected validateModel(): void;
     abstract writeValueModel(value: any): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoTextareaBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoTextareaBaseComponent, never, never, { "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "minlength": { "alias": "p-minlength"; "required": false; }; "maxlength": { "alias": "p-maxlength"; "required": false; }; "rows": { "alias": "p-rows"; "required": false; }; }, { "blur": "p-blur"; "enter": "p-enter"; "change": "p-change"; "changeModel": "p-change-model"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoTextareaBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "minlength": { "alias": "p-minlength"; "required": false; }; "maxlength": { "alias": "p-maxlength"; "required": false; }; "rows": { "alias": "p-rows"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "blur": "p-blur"; "enter": "p-enter"; "change": "p-change"; "changeModel": "p-change-model"; }, never, never, true, never>;
+    static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
 }