@po-ui/ng-components 19.0.0 → 19.2.0

package/lib/components/po-chart/enums/po-chart-label-format.enum.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @usedBy PoChartComponent
+ *
+ * @description
+ *
+ * *Enum* `PoChartLabelFormat` para especificação dos tipos de formatação do eixo de valor no gráfico.
+ */
+export declare enum PoChartLabelFormat {
+    /**
+     * Os valores serão exibidos no formato numérico com duas casas decimais. Equivalente ao formato `'1.2-2'` da [DecimalPipe](https://angular.io/api/common/DecimalPipe).
+     */
+    Number = "number",
+    /**
+     * Os valores serão exibidos com o símbolo monetário de acordo com a formatação padrão da aplicação, isto é, o valor do token [DEFAULT_CURRENCY_CODE](https://angular.dev/api/core/DEFAULT_CURRENCY_CODE). Para adequar ao padrão numérico brasileiro, é necessário configurar o [LOCALE_ID](https://angular.dev/api/core/LOCALE_ID) da aplicação. A configuração pode ser feita da seguinte forma:
+     * ```
+     * import { LOCALE_ID } from '@angular/core';
+     * import { registerLocaleData } from '@angular/common';
+     * import localePt from '@angular/common/locales/pt';
+     *
+     * registerLocaleData(localePt);
+     *
+     * @NgModule({
+     *   providers: [
+     *     { provide: LOCALE_ID, useValue: 'pt-BR' },
+     *     { provide: DEFAULT_CURRENCY_CODE, useValue: 'BRL' }
+     *   ]
+     * })
+     * export class AppModule { }
+     * ```
+     */
+    Currency = "currency"
+}

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

@@ -1,5 +1,6 @@
 export * from './interfaces/po-chart-serie.interface';
 export * from './enums/po-chart-type.enum';
+export * from './enums/po-chart-label-format.enum';
 export * from './interfaces/po-chart-axis-options.interface';
 export * from './interfaces/po-chart-options.interface';
 export * from './interfaces/po-chart-serie-data-label.interface';

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

@@ -1,3 +1,4 @@
+import { PoChartLabelFormat } from '../enums/po-chart-label-format.enum';
 /**
  * @usedBy PoChartComponent
  *
@@ -34,4 +35,12 @@ export interface PoChartAxisOptions {
      * > Esta definição não deve refletir na plotagem das séries. Os valores máximos e mínimos encontrados nas séries serão as bases para seus alcance.
      */
     minRange?: number;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o tipo do label e a formatação exibida no eixo de valor.
+     */
+    labelType?: PoChartLabelFormat;
 }

package/lib/components/po-chart/po-chart-container/po-chart-axis/po-chart-axis-label/po-chart-axis-label.component.d.ts

@@ -1,13 +1,19 @@
 import { PoChartType } from '../../../enums/po-chart-type.enum';
 import { PoChartLabelCoordinates } from '../../../interfaces/po-chart-label-coordinates.interface';
+import { PoChartAxisOptions } from '../../../interfaces/po-chart-axis-options.interface';
+import { CurrencyPipe, DecimalPipe } from '@angular/common';
 import * as i0 from "@angular/core";
 export declare class PoChartAxisLabelComponent {
+    private decimalPipe;
+    private currencyPipe;
     alignByTheCorners: boolean;
     axisXLabelCoordinates: Array<PoChartLabelCoordinates>;
     axisYLabelCoordinates: Array<PoChartLabelCoordinates>;
     type: PoChartType;
-    constructor();
+    axisOptions: PoChartAxisOptions;
+    constructor(decimalPipe: DecimalPipe, currencyPipe: CurrencyPipe);
     trackBy(index: any): any;
+    formatValueAxis(label: string, axis: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoChartAxisLabelComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PoChartAxisLabelComponent, "[po-chart-axis-label]", never, { "alignByTheCorners": { "alias": "p-align-by-the-corners"; "required": false; }; "axisXLabelCoordinates": { "alias": "p-axis-x-label-coordinates"; "required": false; }; "axisYLabelCoordinates": { "alias": "p-axis-y-label-coordinates"; "required": false; }; "type": { "alias": "p-type"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoChartAxisLabelComponent, "[po-chart-axis-label]", never, { "alignByTheCorners": { "alias": "p-align-by-the-corners"; "required": false; }; "axisXLabelCoordinates": { "alias": "p-axis-x-label-coordinates"; "required": false; }; "axisYLabelCoordinates": { "alias": "p-axis-y-label-coordinates"; "required": false; }; "type": { "alias": "p-type"; "required": false; }; "axisOptions": { "alias": "p-options"; "required": false; }; }, {}, never, never, false, never>;
 }

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

@@ -18,6 +18,38 @@ import { PoDynamicField } from '../po-dynamic-field.interface';
  * Interface para definição das propriedades dos campos de entrada que serão criados dinamicamente.
  */
 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`.
+     *
+     * **Componentes compatíveis:** `po-checkbox`, `po-checkbox-group`, `po-combo`, `po-datepicker`, `po-datepicker-range`,
+     * `po-decimal`, `po-email`, `po-input`, `po-login`, `po-lookup`, `po-multiselect`, `po-number`, `po-password`,
+     * `po-radio-group`, `po-rich-text`, `po-select`, `po-switch`, `po-textarea`, `po-upload`, `po-url`.
+     */
+    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.
+     * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
+     *
+     * **Componentes compatíveis:** `po-checkbox`, `po-checkbox-group`, `po-combo`, `po-datepicker`, `po-datepicker-range`,
+     * `po-decimal`, `po-email`, `po-input`, `po-login`, `po-lookup`, `po-multiselect`, `po-number`, `po-password`,
+     * `po-radio-group`, `po-rich-text`, `po-select`, `po-switch`, `po-textarea`, `po-upload`, `po-url`.
+     */
+    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
+     * 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.
+     *
+     * > O uso dessa propriedade pode acarretar na perda sequencial da 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.
+     *
+     * **Componentes compatíveis:** `po-checkbox`, `po-checkbox-group`, `po-combo`, `po-datepicker`, `po-datepicker-range`,
+     * `po-decimal`, `po-email`, `po-input`, `po-login`, `po-lookup`, `po-multiselect`, `po-number`, `po-password`,
+     * `po-radio-group`, `po-rich-text`, `po-select`, `po-switch`, `po-textarea`, `po-upload`, `po-url`.
+     */
+    appendBox?: boolean;
     /**
      * Define as colunas para utilização da busca avançada. Usada somente em conjunto com a propriedade `searchService`,
      * essa propriedade deve receber um array de objetos que implementam a interface [`PoLookupColumn`](/documentation/po-lookup).
@@ -245,7 +277,6 @@ export interface PoDynamicFormField extends PoDynamicField {
      * @default `false`
      */
     errorLimit?: boolean;
-    errorAppendBox?: boolean;
     /**
      * Função executada para realizar a validação assíncrona personalizada.
      * Executada ao disparar o output `change` ou `change-model`, dependendo do valor da propriedade `triggerMode`.
@@ -677,4 +708,14 @@ export interface PoDynamicFormField extends PoDynamicField {
      * **Componente compatível**: `po-upload`
      */
     onUpload?: Function;
+    /**
+     *
+     * Define que o filtro no primeiro clique será removido.
+     *
+     * > Caso o combo tenha um valor padrão de inicialização, o primeiro clique
+     * no componente retornará todos os itens da lista e não apenas o item inicialiazado.
+     *
+     * **Componente compatível**: `po-combo`
+     */
+    removeInitialFilter?: boolean;
 }

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

@@ -43,6 +43,37 @@ import * as i0 from "@angular/core";
  *
  */
 export declare abstract class PoCheckboxBaseComponent 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`) 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
+     *
+     * @description
+     * Texto de apoio do campo */
+    help?: string;
     /** Define o nome do *checkbox*. */
     name: string;
     /**
@@ -59,6 +90,14 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
     autoFocus: boolean;
     /** Texto de exibição do *checkbox*. */
     label?: 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
      *
@@ -110,7 +149,8 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
     writeValue(value: any): void;
     protected abstract changeModelValue(value: boolean | null): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoCheckboxBaseComponent, never, never, { "name": { "alias": "name"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "checkboxValue": { "alias": "p-checkboxValue"; "required": false; }; "checkBoxRequired": { "alias": "p-required"; "required": false; }; "disabladTabindex": { "alias": "p-disabled-tabindex"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "change": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoCheckboxBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "name": { "alias": "name"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "checkboxValue": { "alias": "p-checkboxValue"; "required": false; }; "checkBoxRequired": { "alias": "p-required"; "required": false; }; "disabladTabindex": { "alias": "p-disabled-tabindex"; "required": false; }; "disabled": { "alias": "p-disabled"; "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;
     static ngAcceptInputType_checkBoxRequired: any;
     static ngAcceptInputType_disabladTabindex: any;

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

@@ -50,8 +50,12 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
     focus(): void;
     onBlur(): void;
     ngAfterViewInit(): void;
+    emitAdditionalHelp(): void;
+    getAdditionalHelpTooltip(): string;
     onKeyDown(event: KeyboardEvent, value: boolean | string): void;
+    showAdditionalHelpIcon(): boolean;
     protected changeModelValue(value: boolean | null | string): void;
+    private isAdditionalHelpEventTriggered;
     get iconNameLib(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxComponent, [{ optional: true; }, null]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoCheckboxComponent, "po-checkbox", never, {}, {}, never, never, false, never>;

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

@@ -3,8 +3,9 @@ import * as i1 from "./po-checkbox.component";
 import * as i2 from "@angular/common";
 import * as i3 from "@angular/forms";
 import * as i4 from "../../po-label/po-label.module";
+import * as i5 from "../po-field-container/po-field-container.module";
 export declare class PoCheckboxModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PoCheckboxModule, [typeof i1.PoCheckboxComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.PoLabelModule], [typeof i1.PoCheckboxComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoCheckboxModule, [typeof i1.PoCheckboxComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.PoLabelModule, typeof i5.PoFieldContainerModule], [typeof i1.PoCheckboxComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoCheckboxModule>;
 }

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

@@ -33,6 +33,31 @@ import * as i0 from "@angular/core";
  * ```
  */
 export declare class PoCheckboxGroupBaseComponent 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
      *
@@ -76,6 +101,14 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      *
      */
     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
      *
@@ -214,6 +247,7 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
     private removeDuplicatedOptions;
     private setCheckboxGroupOptionsView;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxGroupBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoCheckboxGroupBaseComponent, never, never, { "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "name": { "alias": "name"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "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; }; "indeterminate": { "alias": "p-indeterminate"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, { "ngModelChange": "ngModelChange"; "change": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoCheckboxGroupBaseComponent, 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; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "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; }; "indeterminate": { "alias": "p-indeterminate"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "ngModelChange": "ngModelChange"; "change": "p-change"; }, never, never, true, never>;
+    static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
 }

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

@@ -30,6 +30,7 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
     constructor(changeDetector: ChangeDetectorRef);
     ngAfterViewChecked(): void;
     ngAfterViewInit(): void;
+    emitAdditionalHelp(): void;
     /**
      * Função que atribui foco ao componente.
      *
@@ -48,10 +49,13 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
      * ```
      */
     focus(): void;
+    getAdditionalHelpTooltip(): string;
     getErrorPattern(): string;
     hasInvalidClass(): any;
     onKeyDown(event: KeyboardEvent, option: PoCheckboxGroupOption): void;
+    showAdditionalHelpIcon(): boolean;
     trackByFn(index: any): any;
+    private isAdditionalHelpEventTriggered;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxGroupComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoCheckboxGroupComponent, "po-checkbox-group", never, {}, {}, never, never, false, never>;
 }

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

@@ -65,6 +65,17 @@ import * as i0 from "@angular/core";
  */
 export declare abstract class PoComboBaseComponent implements ControlValueAccessor, OnInit, Validator {
     protected changeDetector: 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
      *
@@ -216,6 +227,14 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      *
      */
     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
      *
@@ -229,7 +248,6 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      * @default `false`
      */
     errorLimit: boolean;
-    errorAppendBox?: boolean;
     /**
      * @optional
      *
@@ -496,10 +514,12 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      *
      * @description
      *
-     * Define que o dropdown do combo 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 combo 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 acarretar na perda sequencial da 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`
      */
@@ -556,12 +576,11 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
     abstract getInputValue(): string;
     abstract initInputObservable(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoComboBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoComboBaseComponent, 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; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "infiniteScroll": { "alias": "p-infinite-scroll"; "required": false; }; "infiniteScrollDistance": { "alias": "p-infinite-scroll-distance"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "emitObjectValue": { "alias": "p-emit-object-value"; "required": false; }; "disabledTabFilter": { "alias": "p-disabled-tab-filter"; "required": false; }; "removeInitialFilter": { "alias": "p-remove-initial-filter"; "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; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "debounceTime": { "alias": "p-debounce-time"; "required": false; }; "disabledInitFilter": { "alias": "p-disabled-init-filter"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "filterMinlength": { "alias": "p-filter-minlength"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "changeOnEnter": { "alias": "p-change-on-enter"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "sort": { "alias": "p-sort"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "filterParams": { "alias": "p-filter-params"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "cache": { "alias": "p-cache"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; }, { "change": "p-change"; "ngModelChange": "ngModelChange"; "inputChange": "p-input-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoComboBaseComponent, 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; }; "name": { "alias": "name"; "required": false; }; "filterService": { "alias": "p-filter-service"; "required": false; }; "infiniteScroll": { "alias": "p-infinite-scroll"; "required": false; }; "infiniteScrollDistance": { "alias": "p-infinite-scroll-distance"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "emitObjectValue": { "alias": "p-emit-object-value"; "required": false; }; "disabledTabFilter": { "alias": "p-disabled-tab-filter"; "required": false; }; "removeInitialFilter": { "alias": "p-remove-initial-filter"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "placeholder": { "alias": "p-placeholder"; "required": false; }; "debounceTime": { "alias": "p-debounce-time"; "required": false; }; "disabledInitFilter": { "alias": "p-disabled-init-filter"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "filterMinlength": { "alias": "p-filter-minlength"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "changeOnEnter": { "alias": "p-change-on-enter"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "sort": { "alias": "p-sort"; "required": false; }; "options": { "alias": "p-options"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "filterParams": { "alias": "p-filter-params"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "cache": { "alias": "p-cache"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "change": "p-change"; "ngModelChange": "ngModelChange"; "inputChange": "p-input-change"; }, never, never, true, never>;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_clean: any;
     static ngAcceptInputType_emitObjectValue: any;
     static ngAcceptInputType_disabledTabFilter: any;
-    static ngAcceptInputType_errorAppendBox: any;
     static ngAcceptInputType_cache: any;
     static ngAcceptInputType_appendBox: any;
 }

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

@@ -91,6 +91,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     ngAfterViewInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
+    emitAdditionalHelp(): void;
     /**
      * Função que atribui foco ao componente.
      *
@@ -109,6 +110,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
      * ```
      */
     focus(): void;
+    getAdditionalHelpTooltip(): string;
     onBlur(): void;
     onKeyDown(event?: any): void;
     onKeyUp(event?: any): void;
@@ -133,11 +135,14 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     wasClickedOnToggle(event: MouseEvent): void;
     isValidCharacterToSearch(keyCode: any): boolean;
     searchOnEnterOrArrow(event: any, value: string): void;
+    showAdditionalHelpIcon(): boolean;
     showMoreInfiniteScroll(): void;
     clearAndFocus(): void;
+    updateCacheOptions(): void;
     private adjustContainerPosition;
     private close;
     private initializeListeners;
+    private isAdditionalHelpEventTriggered;
     private onErrorGetObjectByValue;
     private onScroll;
     private onErrorFilteredData;

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

@@ -79,6 +79,17 @@ import * as i0 from "@angular/core";
 export declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor, OnInit, OnDestroy, Validator {
     protected languageService: PoLanguageService;
     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
      *
@@ -139,7 +150,6 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      * @default `false`
      */
     errorLimit: boolean;
-    errorAppendBox?: boolean;
     /**
      * @optional
      *
@@ -152,6 +162,14 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      * @default `false`
      */
     showErrorMessageRequired: 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
      *
@@ -297,11 +315,11 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      *
      * @description
      *
-     * Define que o calendário do DatePicker será incluído no body da página, em vez de suspenso junto ao campo de entrada do componente.
-     * Essa opção é útil em cenários onde o DatePicker precisa ser renderizado fora do conteúdo principal da página,
-     * como em formulários que utilizam scroll ou containers com overflow escondido.
+     * Define que o `calendar` 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 interferir na sequência de tabulação da página, especialmente em formulários longos.
+     * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
      *
      * @default `false`
      */
@@ -328,8 +346,7 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
     abstract writeValue(value: any): void;
     abstract refreshValue(value: Date): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoDatepickerBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDatepickerBaseComponent, never, never, { "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "errorAsync": { "alias": "p-error-async"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "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; }; "showErrorMessageRequired": { "alias": "p-required-field-error-message"; "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; }; "minDate": { "alias": "p-min-date"; "required": false; }; "maxDate": { "alias": "p-max-date"; "required": false; }; "format": { "alias": "p-format"; "required": false; }; "isoFormat": { "alias": "p-iso-format"; "required": false; }; "locale": { "alias": "p-locale"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; }, { "onblur": "p-blur"; "onchange": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDatepickerBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "errorAsync": { "alias": "p-error-async"; "required": false; }; "name": { "alias": "name"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "errorPattern": { "alias": "p-error-pattern"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "showErrorMessageRequired": { "alias": "p-required-field-error-message"; "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; }; "minDate": { "alias": "p-min-date"; "required": false; }; "maxDate": { "alias": "p-max-date"; "required": false; }; "format": { "alias": "p-format"; "required": false; }; "isoFormat": { "alias": "p-iso-format"; "required": false; }; "locale": { "alias": "p-locale"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onblur": "p-blur"; "onchange": "p-change"; }, never, never, true, never>;
     static ngAcceptInputType_autoFocus: any;
-    static ngAcceptInputType_errorAppendBox: any;
     static ngAcceptInputType_appendBox: any;
 }

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

@@ -64,6 +64,7 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     onKeydown($event?: any): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
+    emitAdditionalHelp(): void;
     /**
      * Função que atribui foco ao componente.
      *
@@ -82,6 +83,7 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
      * ```
      */
     focus(): void;
+    getAdditionalHelpTooltip(): string;
     togglePicker(): void;
     dateSelected(): void;
     wasClickedOnPicker(event: any): void;
@@ -97,12 +99,14 @@ export declare class PoDatepickerComponent extends PoDatepickerBaseComponent imp
     isValidDateIso(value: string): boolean;
     isValidExtendedIso(value: any): boolean;
     hasOverlayClass(element: any): any;
+    showAdditionalHelpIcon(): boolean;
     verifyErrorAsync(value: any): void;
     verifyMobile(): RegExpMatchArray;
     private closeCalendar;
     private controlChangeEmitter;
     private hasAttrCalendar;
     private initializeListeners;
+    private isAdditionalHelpEventTriggered;
     private onScroll;
     private removeListeners;
     private setDialogPickerStyleDisplay;

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

@@ -51,6 +51,31 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
     protected changeDetector: ChangeDetectorRef;
     protected poDateService: PoDateService;
     private languageService;
+    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 `calendar` 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.
+     *
+     * > 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
      *
@@ -104,6 +129,14 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
      *
      */
     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
      *
@@ -319,6 +352,7 @@ export declare abstract class PoDatepickerRangeBaseComponent implements ControlV
     protected abstract resetDateRangeInputValidation(): void;
     protected abstract updateScreenByModel(dateRange: PoDatepickerRange): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoDatepickerRangeBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDatepickerRangeBaseComponent, never, never, { "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "endDate": { "alias": "p-end-date"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "minDate": { "alias": "p-min-date"; "required": false; }; "maxDate": { "alias": "p-max-date"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "startDate": { "alias": "p-start-date"; "required": false; }; "locale": { "alias": "p-locale"; "required": false; }; }, { "onChange": "p-change"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoDatepickerRangeBaseComponent, 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; }; "help": { "alias": "p-help"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "clean": { "alias": "p-clean"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "endDate": { "alias": "p-end-date"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "minDate": { "alias": "p-min-date"; "required": false; }; "maxDate": { "alias": "p-max-date"; "required": false; }; "noAutocomplete": { "alias": "p-no-autocomplete"; "required": false; }; "readonly": { "alias": "p-readonly"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "startDate": { "alias": "p-start-date"; "required": false; }; "locale": { "alias": "p-locale"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "onChange": "p-change"; }, never, never, true, never>;
+    static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
 }

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

@@ -65,6 +65,7 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     clear(): void;
+    emitAdditionalHelp(): void;
     eventOnClick($event: any): void;
     /**
      * Função que atribui foco ao componente.
@@ -84,6 +85,7 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
      * ```
      */
     focus(): void;
+    getAdditionalHelpTooltip(): string;
     onBlur(event: any): void;
     onCalendarChange({ start, end }: {
         start: any;
@@ -93,6 +95,7 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     onKeydown(event?: any): void;
     onKeyup(event: any): void;
     resetDateRangeInputValidation(): void;
+    showAdditionalHelpIcon(): boolean;
     toggleCalendar(): void;
     updateScreenByModel(model: PoDatepickerRange): void;
     private applyFocusOnDatePickerRangeField;
@@ -104,6 +107,7 @@ export declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseCom
     private hasAttrCalendar;
     private hasInvalidClass;
     private initializeListeners;
+    private isAdditionalHelpEventTriggered;
     private isEqualBeforeValue;
     private isSetFocusOnBackspace;
     private onScroll;