@po-ui/ng-components 19.29.0 → 19.31.0

package/lib/components/components.module.d.ts

@@ -47,9 +47,10 @@ import * as i45 from "./po-field/po-switch/po-switch.module";
 import * as i46 from "./po-search/po-search.module";
 import * as i47 from "./po-badge/po-badge.module";
 import * as i48 from "./po-toaster/po-toaster.module";
-import * as i49 from "./po-header/po-header.module";
+import * as i49 from "./po-helper/po-helper.module";
+import * as i50 from "./po-header/po-header.module";
 export declare class PoComponentsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoComponentsModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PoComponentsModule, never, [typeof i1.PoAccordionModule, typeof i2.PoAvatarModule, typeof i3.PoBreadcrumbModule, typeof i4.PoButtonModule, typeof i5.PoButtonGroupModule, typeof i6.PoCalendarModule, typeof i7.PoChartModule, typeof i8.PoContainerModule, typeof i9.PoDisclaimerGroupModule, typeof i10.PoDisclaimerModule, typeof i11.PoDividerModule, typeof i12.PoDropdownModule, typeof i13.PoDynamicModule, typeof i14.PoFieldModule, typeof i15.PoGaugeModule, typeof i16.PoGridModule, typeof i17.PoIconModule, typeof i18.PoInfoModule, typeof i19.PoListViewModule, typeof i20.PoListBoxModule, typeof i21.PoLoadingModule, typeof i22.PoLogoModule, typeof i23.PoMenuModule, typeof i24.PoMenuPanelModule, typeof i25.PoModalModule, typeof i26.PoNavbarModule, typeof i27.PoOverlayModule, typeof i28.PoPageModule, typeof i29.PoPopoverModule, typeof i30.PoPopupModule, typeof i31.PoProgressModule, typeof i32.PoSlideModule, typeof i33.PoStepperModule, typeof i34.PoTableModule, typeof i35.PoTabsModule, typeof i36.PoContextTabsModule, typeof i37.PoTagModule, typeof i38.PoToolbarModule, typeof i39.PoTreeViewModule, typeof i40.PoWidgetModule, typeof i41.PoLinkModule, typeof i42.PoLabelModule, typeof i43.PoImageModule, typeof i44.PoPageSlideModule, typeof i45.PoSwitchModule, typeof i46.PoSearchModule, typeof i47.PoBadgeModule, typeof i48.PoToasterModule, typeof i49.PoHeaderModule], [typeof i1.PoAccordionModule, typeof i2.PoAvatarModule, typeof i3.PoBreadcrumbModule, typeof i4.PoButtonModule, typeof i5.PoButtonGroupModule, typeof i6.PoCalendarModule, typeof i7.PoChartModule, typeof i8.PoContainerModule, typeof i9.PoDisclaimerGroupModule, typeof i10.PoDisclaimerModule, typeof i11.PoDividerModule, typeof i12.PoDropdownModule, typeof i13.PoDynamicModule, typeof i14.PoFieldModule, typeof i15.PoGaugeModule, typeof i16.PoGridModule, typeof i17.PoIconModule, typeof i18.PoInfoModule, typeof i19.PoListViewModule, typeof i20.PoListBoxModule, typeof i21.PoLoadingModule, typeof i22.PoLogoModule, typeof i23.PoMenuModule, typeof i24.PoMenuPanelModule, typeof i25.PoModalModule, typeof i26.PoNavbarModule, typeof i27.PoOverlayModule, typeof i28.PoPageModule, typeof i29.PoPopoverModule, typeof i30.PoPopupModule, typeof i31.PoProgressModule, typeof i32.PoSlideModule, typeof i33.PoStepperModule, typeof i34.PoTableModule, typeof i36.PoContextTabsModule, typeof i35.PoTabsModule, typeof i37.PoTagModule, typeof i38.PoToolbarModule, typeof i39.PoTreeViewModule, typeof i40.PoWidgetModule, typeof i41.PoLinkModule, typeof i42.PoLabelModule, typeof i43.PoImageModule, typeof i44.PoPageSlideModule, typeof i45.PoSwitchModule, typeof i46.PoSearchModule, typeof i47.PoBadgeModule, typeof i48.PoToasterModule, typeof i49.PoHeaderModule]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoComponentsModule, never, [typeof i1.PoAccordionModule, typeof i2.PoAvatarModule, typeof i3.PoBreadcrumbModule, typeof i4.PoButtonModule, typeof i5.PoButtonGroupModule, typeof i6.PoCalendarModule, typeof i7.PoChartModule, typeof i8.PoContainerModule, typeof i9.PoDisclaimerGroupModule, typeof i10.PoDisclaimerModule, typeof i11.PoDividerModule, typeof i12.PoDropdownModule, typeof i13.PoDynamicModule, typeof i14.PoFieldModule, typeof i15.PoGaugeModule, typeof i16.PoGridModule, typeof i17.PoIconModule, typeof i18.PoInfoModule, typeof i19.PoListViewModule, typeof i20.PoListBoxModule, typeof i21.PoLoadingModule, typeof i22.PoLogoModule, typeof i23.PoMenuModule, typeof i24.PoMenuPanelModule, typeof i25.PoModalModule, typeof i26.PoNavbarModule, typeof i27.PoOverlayModule, typeof i28.PoPageModule, typeof i29.PoPopoverModule, typeof i30.PoPopupModule, typeof i31.PoProgressModule, typeof i32.PoSlideModule, typeof i33.PoStepperModule, typeof i34.PoTableModule, typeof i35.PoTabsModule, typeof i36.PoContextTabsModule, typeof i37.PoTagModule, typeof i38.PoToolbarModule, typeof i39.PoTreeViewModule, typeof i40.PoWidgetModule, typeof i41.PoLinkModule, typeof i42.PoLabelModule, typeof i43.PoImageModule, typeof i44.PoPageSlideModule, typeof i45.PoSwitchModule, typeof i46.PoSearchModule, typeof i47.PoBadgeModule, typeof i48.PoToasterModule, typeof i49.PoHelperModule, typeof i50.PoHeaderModule], [typeof i1.PoAccordionModule, typeof i2.PoAvatarModule, typeof i3.PoBreadcrumbModule, typeof i4.PoButtonModule, typeof i5.PoButtonGroupModule, typeof i6.PoCalendarModule, typeof i7.PoChartModule, typeof i8.PoContainerModule, typeof i9.PoDisclaimerGroupModule, typeof i10.PoDisclaimerModule, typeof i11.PoDividerModule, typeof i12.PoDropdownModule, typeof i13.PoDynamicModule, typeof i14.PoFieldModule, typeof i15.PoGaugeModule, typeof i16.PoGridModule, typeof i17.PoIconModule, typeof i18.PoInfoModule, typeof i19.PoListViewModule, typeof i20.PoListBoxModule, typeof i21.PoLoadingModule, typeof i22.PoLogoModule, typeof i23.PoMenuModule, typeof i24.PoMenuPanelModule, typeof i25.PoModalModule, typeof i26.PoNavbarModule, typeof i27.PoOverlayModule, typeof i28.PoPageModule, typeof i29.PoPopoverModule, typeof i30.PoPopupModule, typeof i31.PoProgressModule, typeof i32.PoSlideModule, typeof i33.PoStepperModule, typeof i34.PoTableModule, typeof i35.PoTabsModule, typeof i36.PoContextTabsModule, typeof i37.PoTagModule, typeof i38.PoToolbarModule, typeof i39.PoTreeViewModule, typeof i40.PoWidgetModule, typeof i41.PoLinkModule, typeof i42.PoLabelModule, typeof i43.PoImageModule, typeof i44.PoPageSlideModule, typeof i45.PoSwitchModule, typeof i46.PoSearchModule, typeof i47.PoBadgeModule, typeof i48.PoToasterModule, typeof i49.PoHelperModule, typeof i50.PoHeaderModule]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoComponentsModule>;
 }

package/lib/components/index.d.ts

@@ -16,6 +16,7 @@ export * from './po-dynamic/index';
 export * from './po-field/index';
 export * from './po-gauge/index';
 export * from './po-grid/index';
+export * from './po-helper/index';
 export * from './po-icon/index';
 export * from './po-image/index';
 export * from './po-info/index';

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

@@ -364,15 +364,15 @@ export interface PoDynamicFormField extends PoDynamicField {
     placeholder?: string;
     /**
      * Define a localidade a ser utilizada no componente.
-     * Por padrão o valor será configurado segundo a o módulo [`I18n`](documentation/po-i18n)
+     * Por padrão o valor será configurado segundo o módulo [`I18n`](documentation/po-i18n)
      *
      * Exemplo de utilização:
-     * ``
+     * ```
      * [
      *   { property: 'birthday', locale: 'en', type: 'date' },
      *   { property: 'wage', locale: 'ru', type: 'currency' }
      * ];
-     * ``
+     * ```
      *
      * > Para ver quais linguagens suportadas acesse [`I18n`](documentation/po-i18n)
      * > A propriedade será repassada para os componentes que suportam a mesma.

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

@@ -1,5 +1,6 @@
 import { ChangeDetectorRef, EventEmitter } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
+import { PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @description
@@ -46,6 +47,9 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
     private readonly cd;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -53,6 +57,8 @@ export declare abstract class PoCheckboxBaseComponent 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;
     /**
@@ -92,11 +98,16 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
     /** Texto de exibição do *checkbox*. */
     label?: string;
     /**
+     *
+     * @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>;
     /**
@@ -160,17 +171,44 @@ export declare abstract class PoCheckboxBaseComponent implements ControlValueAcc
      *
      */
     set size(value: 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>;
     get size(): string;
     constructor(cd: ChangeDetectorRef);
     changeValue(): void;
-    checkOption(value: boolean | null | string): void;
+    checkOption(event: any, value: boolean | null | string): void;
     setDisabledState(isDisabled: boolean): void;
     registerOnChange(fn: any): void;
     registerOnTouched(fn: any): void;
     writeValue(value: any): void;
     protected abstract changeModelValue(value: boolean | null): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxBaseComponent, 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"; "blur": "p-blur"; "change": "p-change"; "keydown": "p-keydown"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoCheckboxBaseComponent, "po-checkbox-base", 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; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; }, { "additionalHelp": "p-additional-help"; "blur": "p-blur"; "change": "p-change"; "keydown": "p-keydown"; }, never, never, false, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_checkBoxRequired: any;

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

@@ -1,5 +1,6 @@
-import { AfterViewInit, ElementRef } from '@angular/core';
+import { AfterViewInit, ElementRef, OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import { PoCheckboxBaseComponent } from './po-checkbox-base.component';
+import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoCheckboxBaseComponent
@@ -21,10 +22,14 @@ import * as i0 from "@angular/core";
  *   <file name="sample-po-checkbox-acceptance-term/sample-po-checkbox-acceptance-term.component.ts"> </file>
  * </example>
  */
-export declare class PoCheckboxComponent extends PoCheckboxBaseComponent implements AfterViewInit {
+export declare class PoCheckboxComponent extends PoCheckboxBaseComponent implements AfterViewInit, OnChanges, OnInit {
     private readonly changeDetector;
     private _iconToken;
+    helperSettings: PoHelperOptions;
+    showTip: boolean;
     checkboxLabel: ElementRef;
+    labelEl: ElementRef<HTMLElement>;
+    helperEl?: PoHelperComponent;
     constructor();
     /**
      * Função que atribui foco ao *checkbox*.
@@ -48,6 +53,8 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
     focus(): void;
     onBlur(): void;
     ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnInit(): void;
     emitAdditionalHelp(): void;
     getAdditionalHelpTooltip(): string;
     onKeyDown(event: KeyboardEvent, value: boolean | string): void;
@@ -55,6 +62,8 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent 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-checkbox
      *  #checkbox
@@ -64,6 +73,16 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
      * ></po-checkbox>
      * ```
      * ```
+     * //Exemplo com label e p-helper
+     * <po-checkbox
+     *  #checkbox
+     *  ...
+     *  p-label="Label do checkbox"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, checkbox)"
+     * ></po-checkbox>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoCheckboxComponent): void {
      *  if (event.code === 'F9') {
@@ -74,8 +93,13 @@ export declare class PoCheckboxComponent extends PoCheckboxBaseComponent impleme
      */
     showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     protected changeModelValue(value: boolean | null | string): void;
     private isAdditionalHelpEventTriggered;
+    handleLabelTooltip(): void;
     get iconNameLib(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoCheckboxComponent, "po-checkbox", never, {}, {}, never, never, false, never>;

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

@@ -4,8 +4,10 @@ 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";
+import * as i6 from "../../po-helper/po-helper.module";
+import * as i7 from "../../../directives/po-tooltip/po-tooltip.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 i5.PoFieldContainerModule], [typeof i1.PoCheckboxComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PoCheckboxModule, [typeof i1.PoCheckboxComponent], [typeof i2.CommonModule, typeof i3.FormsModule, typeof i4.PoLabelModule, typeof i5.PoFieldContainerModule, typeof i6.PoHelperModule, typeof i7.PoTooltipModule], [typeof i1.PoCheckboxComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PoCheckboxModule>;
 }

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

@@ -2,6 +2,7 @@ import { EventEmitter } from '@angular/core';
 import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
 import { PoCheckboxGroupOptionView } from './interfaces/po-checkbox-group-option-view.interface';
 import { PoCheckboxGroupOption } from './interfaces/po-checkbox-group-option.interface';
+import { PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @description
@@ -35,6 +36,9 @@ import * as i0 from "@angular/core";
 export declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Validator {
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -42,6 +46,8 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      * 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;
     /**
@@ -114,6 +120,32 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      * @default `false`
      */
     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>;
     /**
      * @optional
      *
@@ -131,11 +163,15 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
      */
     ngModelChange: EventEmitter<any>;
     /**
+     * @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>;
     /**
@@ -274,7 +310,7 @@ export declare class PoCheckboxGroupBaseComponent implements ControlValueAccesso
     private removeDuplicatedOptions;
     private setCheckboxGroupOptionsView;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxGroupBaseComponent, 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; }; "size": { "alias": "p-size"; "required": false; }; }, { "ngModelChange": "ngModelChange"; "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; }, 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; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "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; }; "size": { "alias": "p-size"; "required": false; }; }, { "ngModelChange": "ngModelChange"; "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; }, 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

@@ -57,6 +57,8 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
      * 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-checkbox-group
      *  #checkboxGroup
@@ -66,6 +68,16 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
      * ></po-checkbox-group>
      * ```
      * ```
+     * //Exemplo com p-label e p-helper
+     * <po-checkbox-group
+     *  #checkboxGroup
+     *  ...
+     *  p-label="Label do checkbox"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, checkboxGroup)"
+     * ></po-checkbox-group>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoCheckboxGroupComponent): void {
      *  if (event.code === 'F9') {
@@ -77,6 +89,10 @@ export declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseCompone
     showAdditionalHelp(): boolean;
     showAdditionalHelpIcon(): boolean;
     trackByFn(index: any): any;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     private isAdditionalHelpEventTriggered;
     private isCheckboxOptionFocused;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxGroupComponent, never>;

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

@@ -8,6 +8,7 @@ import { PoComboLiterals } from './interfaces/po-combo-literals.interface';
 import { PoComboOptionGroup } from './interfaces/po-combo-option-group.interface';
 import { PoComboOption } from './interfaces/po-combo-option.interface';
 import { PoComboFilterService } from './po-combo-filter.service';
+import { PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @description
@@ -67,6 +68,9 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
     protected changeDetector: ChangeDetectorRef;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -74,6 +78,8 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      * 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;
     /**
@@ -236,11 +242,16 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      */
     fieldErrorMessage: string;
     /**
+     *
+     * @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>;
     /**
@@ -318,6 +329,33 @@ export declare abstract class PoComboBaseComponent implements ControlValueAccess
      * @default `bottom`
      */
     listboxControlPosition: 'top' | 'bottom';
+    /**
+     * @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>;
     cacheOptions: Array<any>;
     defaultService: PoComboFilterService;
     firstInWriteValue: boolean;
@@ -630,7 +668,7 @@ 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, { "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; }; "controlValueWithLabel": { "alias": "p-control-value-with-label"; "required": false; }; "listboxControlPosition": { "alias": "p-listbox-control-position"; "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; }; "size": { "alias": "p-size"; "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; }; }, { "blur": "p-blur"; "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; "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; }; "controlValueWithLabel": { "alias": "p-control-value-with-label"; "required": false; }; "listboxControlPosition": { "alias": "p-listbox-control-position"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "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; }; "size": { "alias": "p-size"; "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; }; }, { "blur": "p-blur"; "additionalHelp": "p-additional-help"; "change": "p-change"; "keydown": "p-keydown"; "ngModelChange": "ngModelChange"; "inputChange": "p-input-change"; }, never, never, true, never>;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_clean: any;
     static ngAcceptInputType_emitObjectValue: any;

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

@@ -5,6 +5,7 @@ import { PoComboOption } from './interfaces/po-combo-option.interface';
 import { PoComboBaseComponent } from './po-combo-base.component';
 import { PoComboFilterService } from './po-combo-filter.service';
 import { PoComboOptionTemplateDirective } from './po-combo-option-template/po-combo-option-template.directive';
+import { PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoComboBaseComponent
@@ -75,6 +76,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     shouldMarkLetters: boolean;
     infiniteLoading: boolean;
     containerWidth: number;
+    helperSettings: PoHelperOptions;
     private _isServerSearching;
     private lastKey;
     private clickoutListener;
@@ -133,6 +135,7 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
      * 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-combo
      *  #combo
@@ -142,6 +145,16 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
      * ></po-combo>
      * ```
      * ```
+     * // Exemplo com p-label e p-helper
+     * <po-combo
+     *  #combo
+     *  ...
+     *  p-label="Label do combo"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, combo)"
+     * ></po-combo>
+     * ```
+     * ```
      * ...
      * onKeyDown(event: KeyboardEvent, inp: PoComboComponent): void {
      *  if (event.code === 'F9') {
@@ -179,6 +192,10 @@ export declare class PoComboComponent extends PoComboBaseComponent implements Af
     private focusItem;
     private focusInput;
     private shouldHandleTab;
+    setHelper(label?: string, additionalHelpTooltip?: string): {
+        hideAdditionalHelp: boolean;
+        helperSettings?: any;
+    };
     static ɵfac: i0.ɵɵFactoryDeclaration<PoComboComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoComboComponent, "po-combo", never, {}, {}, ["comboOptionTemplate"], never, false, never>;
 }

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

@@ -4,6 +4,7 @@ import { PoMask } from '../po-input/po-mask';
 import { Observable } from 'rxjs';
 import { PoLanguageService } from '../../../services/po-language/po-language.service';
 import { PoDatepickerIsoFormat } from './enums/po-datepicker-iso-format.enum';
+import { PoHelperOptions } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @description
@@ -81,6 +82,9 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
     protected cd: ChangeDetectorRef;
     additionalHelpEventTrigger: string | undefined;
     /**
+     *
+     * @deprecated v23.x.x use `p-helper`
+     *
      * @optional
      *
      * @description
@@ -88,6 +92,9 @@ export declare abstract class PoDatepickerBaseComponent 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;
     /**
@@ -163,11 +170,15 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      */
     showErrorMessageRequired: 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>;
     /**
@@ -194,6 +205,33 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
      */
     keydown: EventEmitter<KeyboardEvent>;
+    /**
+     * @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>;
     offset: number;
     protected firstStart: boolean;
     protected hour: string;
@@ -371,7 +409,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, { "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; }; "size": { "alias": "p-size"; "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"; "keydown": "p-keydown"; }, 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; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "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; }; "size": { "alias": "p-size"; "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"; "keydown": "p-keydown"; }, never, never, true, never>;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_appendBox: any;
 }