@po-ui/ng-components 20.6.0 → 20.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/fesm2022/po-ui-ng-components.mjs +3395 -2696
  2. package/fesm2022/po-ui-ng-components.mjs.map +1 -1
  3. package/index.d.ts +432 -320
  4. package/lib/components/po-breadcrumb/po-breadcrumb-base.component.d.ts +15 -0
  5. package/lib/components/po-chart/interfaces/po-chart-serie.interface.d.ts +3 -2
  6. package/lib/components/po-dynamic/po-dynamic-form/interfaces/po-dynamic-form-field.interface.d.ts +10 -5
  7. package/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form.component.d.ts +2 -2
  8. package/lib/components/po-dynamic/po-dynamic-view/po-dynamic-view-base.component.d.ts +15 -0
  9. package/lib/components/po-field/po-checkbox/po-checkbox-base.component.d.ts +6 -8
  10. package/lib/components/po-field/po-checkbox/po-checkbox.component.d.ts +3 -12
  11. package/lib/components/po-field/po-checkbox-group/po-checkbox-group-base.component.d.ts +6 -8
  12. package/lib/components/po-field/po-checkbox-group/po-checkbox-group.component.d.ts +7 -12
  13. package/lib/components/po-field/po-combo/po-combo-base.component.d.ts +6 -8
  14. package/lib/components/po-field/po-combo/po-combo.component.d.ts +5 -12
  15. package/lib/components/po-field/po-datepicker/po-datepicker-base.component.d.ts +5 -7
  16. package/lib/components/po-field/po-datepicker/po-datepicker.component.d.ts +7 -14
  17. package/lib/components/po-field/po-datepicker-range/po-datepicker-range-base.component.d.ts +5 -7
  18. package/lib/components/po-field/po-datepicker-range/po-datepicker-range.component.d.ts +4 -12
  19. package/lib/components/po-field/po-decimal/po-decimal.component.d.ts +3 -4
  20. package/lib/components/po-field/po-email/po-email.component.d.ts +3 -3
  21. package/lib/components/po-field/po-field-container/po-field-container-bottom/po-field-container-bottom.component.d.ts +2 -0
  22. package/lib/components/po-field/po-field-container/po-field-container.component.d.ts +2 -0
  23. package/lib/components/po-field/po-field.model.d.ts +7 -16
  24. package/lib/components/po-field/po-input/po-input-base.component.d.ts +12 -19
  25. package/lib/components/po-field/po-input/po-input.component.d.ts +3 -3
  26. package/lib/components/po-field/po-input-generic/po-input-generic.d.ts +0 -2
  27. package/lib/components/po-field/po-login/po-login.component.d.ts +3 -1
  28. package/lib/components/po-field/po-lookup/po-lookup-base.component.d.ts +6 -8
  29. package/lib/components/po-field/po-lookup/po-lookup-modal/po-lookup-modal.component.d.ts +1 -1
  30. package/lib/components/po-field/po-lookup/po-lookup.component.d.ts +8 -14
  31. package/lib/components/po-field/po-multiselect/po-multiselect-base.component.d.ts +6 -8
  32. package/lib/components/po-field/po-multiselect/po-multiselect.component.d.ts +4 -12
  33. package/lib/components/po-field/po-number/po-number.component.d.ts +3 -2
  34. package/lib/components/po-field/po-password/po-password.component.d.ts +3 -1
  35. package/lib/components/po-field/po-radio/po-radio.component.d.ts +9 -0
  36. package/lib/components/po-field/po-radio-group/po-radio-group-base.component.d.ts +6 -8
  37. package/lib/components/po-field/po-radio-group/po-radio-group.component.d.ts +7 -12
  38. package/lib/components/po-field/po-rich-text/po-rich-text-base.component.d.ts +6 -8
  39. package/lib/components/po-field/po-rich-text/po-rich-text-body/po-rich-text-body.component.d.ts +1 -2
  40. package/lib/components/po-field/po-rich-text/po-rich-text.component.d.ts +4 -10
  41. package/lib/components/po-field/po-select/po-select.component.d.ts +7 -14
  42. package/lib/components/po-field/po-switch/po-switch.component.d.ts +33 -6
  43. package/lib/components/po-field/po-textarea/po-textarea-base.component.d.ts +6 -8
  44. package/lib/components/po-field/po-textarea/po-textarea.component.d.ts +7 -12
  45. package/lib/components/po-field/po-upload/po-upload-base.component.d.ts +6 -8
  46. package/lib/components/po-field/po-upload/po-upload.component.d.ts +5 -11
  47. package/lib/components/po-field/po-url/po-url.component.d.ts +3 -2
  48. package/lib/components/po-helper/po-helper-base.component.d.ts +11 -0
  49. package/lib/components/po-helper/po-helper.component.d.ts +1 -0
  50. package/lib/components/po-info/po-info-base.component.d.ts +15 -0
  51. package/lib/components/po-loading/po-loading-base.component.d.ts +7 -4
  52. package/lib/components/po-page/po-page-default/po-page-default-base.component.d.ts +9 -8
  53. package/lib/components/po-page/po-page-detail/po-page-detail-base.component.d.ts +14 -0
  54. package/lib/components/po-page/po-page-edit/po-page-edit-base.component.d.ts +14 -0
  55. package/lib/components/po-page/po-page-header/po-page-header-base.component.d.ts +2 -0
  56. package/lib/components/po-page/po-page-list/po-page-list-base.component.d.ts +14 -0
  57. package/lib/components/po-popover/po-popover-base.component.d.ts +12 -0
  58. package/lib/components/po-popover/po-popover.component.d.ts +11 -0
  59. package/lib/components/po-search/po-search-base.component.d.ts +16 -0
  60. package/lib/components/po-search/po-search.component.d.ts +1 -1
  61. package/lib/components/po-table/enums/po-table-spacing.enum.d.ts +1 -1
  62. package/lib/components/po-tag/po-tag-base.component.d.ts +1 -0
  63. package/lib/enums/po-density-mode.enum.d.ts +14 -0
  64. package/lib/enums/po-field-size.enum.d.ts +5 -3
  65. package/lib/services/po-theme/helpers/accessibilities/po-theme-density.constant.d.ts +12 -0
  66. package/lib/services/po-theme/po-theme.module.d.ts +1 -1
  67. package/lib/services/po-theme/po-theme.service.d.ts +39 -11
  68. package/lib/utils/util.d.ts +9 -2
  69. package/package.json +4 -4
  70. package/po-ui-ng-components-20.7.0.tgz +0 -0
  71. package/schematics/ng-add/index.js +1 -1
  72. package/schematics/ng-update/v14/index.js +1 -1
  73. package/schematics/ng-update/v15/index.js +1 -1
  74. package/schematics/ng-update/v16/index.js +1 -1
  75. package/schematics/ng-update/v17/index.js +1 -1
  76. package/schematics/ng-update/v18/index.js +2 -2
  77. package/schematics/ng-update/v19/index.js +2 -2
  78. package/schematics/ng-update/v2/index.js +1 -1
  79. package/schematics/ng-update/v20/index.js +2 -2
  80. package/schematics/ng-update/v3/index.js +1 -1
  81. package/schematics/ng-update/v4/index.js +1 -1
  82. package/schematics/ng-update/v5/index.js +1 -1
  83. package/schematics/ng-update/v6/index.js +1 -1
  84. package/po-ui-ng-components-20.6.0.tgz +0 -0
package/index.d.ts CHANGED
@@ -405,6 +405,7 @@ declare enum PoTagIcon {
405
405
  * | `--font-size` | Tamanho da fonte | `var(--font-size-sm)` |
406
406
  * | `--line-height` | Tamanho da label | `var(---line-height-sm)` |
407
407
  * | `--border-radius` | Contém o valor do raio dos cantos do elemento  | `var(--border-radius-pill)` |
408
+ * | `--gap` | Espaçamento entre o label e o value | `var(--spacing-xs)` |
408
409
  * | **Neutral** | | |
409
410
  * | `--color-neutral` | Cor principal no estado neutral | `var(--color-neutral-light-10)` |
410
411
  * | `--text-color-positive` | Cor do texto no estado neutral | `var(--color-neutral-dark-80)` |
@@ -1560,6 +1561,7 @@ declare class PoBreadcrumbBaseComponent {
1560
1561
  protected clickoutListener: () => void;
1561
1562
  protected resizeListener: () => void;
1562
1563
  private _items;
1564
+ private _size?;
1563
1565
  /**
1564
1566
  * @description
1565
1567
  *
@@ -1572,10 +1574,24 @@ declare class PoBreadcrumbBaseComponent {
1572
1574
  */
1573
1575
  set items(items: Array<PoBreadcrumbItem>);
1574
1576
  get items(): Array<PoBreadcrumbItem>;
1577
+ /**
1578
+ * @optional
1579
+ *
1580
+ * @description
1581
+ *
1582
+ * Define o tamanho do componente entre `small` ou `medium`.
1583
+ *
1584
+ * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido.
1585
+ * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme).
1586
+ *
1587
+ * @default `medium`
1588
+ */
1589
+ set size(value: string);
1590
+ get size(): string;
1575
1591
  private transformToArrayPopup;
1576
1592
  private transformArrayToActionPopUp;
1577
1593
  static ɵfac: i0.ɵɵFactoryDeclaration<PoBreadcrumbBaseComponent, never>;
1578
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoBreadcrumbBaseComponent, never, never, { "favoriteService": { "alias": "p-favorite-service"; "required": false; }; "paramsService": { "alias": "p-params-service"; "required": false; }; "items": { "alias": "p-items"; "required": false; }; }, {}, never, never, true, never>;
1594
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoBreadcrumbBaseComponent, never, never, { "favoriteService": { "alias": "p-favorite-service"; "required": false; }; "paramsService": { "alias": "p-params-service"; "required": false; }; "items": { "alias": "p-items"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, {}, never, never, true, never>;
1579
1595
  }
1580
1596
 
1581
1597
  interface PoItemListOption {
@@ -2213,9 +2229,20 @@ declare class PoHelperBaseComponent {
2213
2229
  * @default `false`
2214
2230
  */
2215
2231
  disabled: i0.InputSignal<boolean>;
2232
+ /**
2233
+ * @Input
2234
+ *
2235
+ * @optional
2236
+ *
2237
+ * @description
2238
+ * Define que o popover será inserido no body da página em vez do elemento definido em `p-target`. Essa opção pode
2239
+ * ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o posicionamento
2240
+ * correto do conteúdo próximo ao elemento.
2241
+ */
2242
+ appendBox: i0.InputSignal<boolean>;
2216
2243
  private transformHelper;
2217
2244
  static ɵfac: i0.ɵɵFactoryDeclaration<PoHelperBaseComponent, never>;
2218
- static ɵcmp: i0.ɵɵComponentDeclaration<PoHelperBaseComponent, "po-helper-base", never, { "helper": { "alias": "p-helper"; "required": false; "isSignal": true; }; "size": { "alias": "p-size"; "required": false; "isSignal": true; }; "disabled": { "alias": "p-disabled"; "required": false; "isSignal": true; }; }, {}, never, never, false, never>;
2245
+ static ɵcmp: i0.ɵɵComponentDeclaration<PoHelperBaseComponent, "po-helper-base", never, { "helper": { "alias": "p-helper"; "required": false; "isSignal": true; }; "size": { "alias": "p-size"; "required": false; "isSignal": true; }; "disabled": { "alias": "p-disabled"; "required": false; "isSignal": true; }; "appendBox": { "alias": "p-append-in-body"; "required": false; "isSignal": true; }; }, {}, never, never, false, never>;
2219
2246
  }
2220
2247
 
2221
2248
  /**
@@ -2359,8 +2386,20 @@ declare class PoPopoverBaseComponent {
2359
2386
  */
2360
2387
  set trigger(value: string);
2361
2388
  get trigger(): string;
2389
+ /**
2390
+ * @Input
2391
+ *
2392
+ * @optional
2393
+ *
2394
+ * @description
2395
+ * Permite a inclusão de classes CSS customizadas ao componente.
2396
+ *
2397
+ * Exemplo: `p-custom-classes="minha-classe-1 minha-classe-2"`.
2398
+ *
2399
+ */
2400
+ customClasses: i0.InputSignal<string>;
2362
2401
  static ɵfac: i0.ɵɵFactoryDeclaration<PoPopoverBaseComponent, never>;
2363
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoPopoverBaseComponent, never, never, { "appendBox": { "alias": "p-append-in-body"; "required": false; }; "target": { "alias": "p-target"; "required": false; }; "title": { "alias": "p-title"; "required": false; }; "hideArrow": { "alias": "p-hide-arrow"; "required": false; }; "position": { "alias": "p-position"; "required": false; }; "trigger": { "alias": "p-trigger"; "required": false; }; }, { "closePopover": "p-close"; }, never, never, true, never>;
2402
+ static ɵcmp: i0.ɵɵComponentDeclaration<PoPopoverBaseComponent, "po-popover-base", never, { "appendBox": { "alias": "p-append-in-body"; "required": false; }; "target": { "alias": "p-target"; "required": false; }; "title": { "alias": "p-title"; "required": false; }; "hideArrow": { "alias": "p-hide-arrow"; "required": false; }; "position": { "alias": "p-position"; "required": false; }; "trigger": { "alias": "p-trigger"; "required": false; }; "customClasses": { "alias": "p-custom-classes"; "required": false; "isSignal": true; }; }, { "closePopover": "p-close"; }, never, never, false, never>;
2364
2403
  static ngAcceptInputType_appendBox: any;
2365
2404
  }
2366
2405
 
@@ -2394,7 +2433,10 @@ declare class PoPopoverComponent extends PoPopoverBaseComponent implements After
2394
2433
  timeoutResize: any;
2395
2434
  targetElement: any;
2396
2435
  afterViewInitWasCalled: boolean;
2436
+ private keydownTargetListener?;
2437
+ private keydownPopoverListener?;
2397
2438
  eventListenerFunction: () => void;
2439
+ private readonly tabbableSelector;
2398
2440
  constructor(renderer: Renderer2, poControlPosition: PoControlPositionService, cd: ChangeDetectorRef);
2399
2441
  ngOnChanges(changes: SimpleChanges): void;
2400
2442
  ngAfterViewInit(): void;
@@ -2412,6 +2454,14 @@ declare class PoPopoverComponent extends PoPopoverBaseComponent implements After
2412
2454
  private initEventListenerFunction;
2413
2455
  private removeListeners;
2414
2456
  private setElementsControlPosition;
2457
+ private focusOnTarget;
2458
+ private focusOnFirstFocusable;
2459
+ private attachPopoverKeydown;
2460
+ private isVisible;
2461
+ private getTabbablesIn;
2462
+ private getDocumentTabbables;
2463
+ private focusNextAfterTarget;
2464
+ private focusPrevBeforeTarget;
2415
2465
  static ɵfac: i0.ɵɵFactoryDeclaration<PoPopoverComponent, never>;
2416
2466
  static ɵcmp: i0.ɵɵComponentDeclaration<PoPopoverComponent, "po-popover", never, {}, {}, never, ["*"], false, never>;
2417
2467
  }
@@ -2716,7 +2766,7 @@ declare class PoButtonComponent extends PoButtonBaseComponent {
2716
2766
  * ou aguardando a resposta de alguma requisição.
2717
2767
  */
2718
2768
  declare class PoLoadingBaseComponent {
2719
- private languageService;
2769
+ protected languageService: PoLanguageService;
2720
2770
  private _text?;
2721
2771
  private _size?;
2722
2772
  /**
@@ -2726,14 +2776,17 @@ declare class PoLoadingBaseComponent {
2726
2776
  get text(): string;
2727
2777
  /**
2728
2778
  * Define o tamanho do ícone.
2729
- *
2730
- * @default `lg`
2731
- *
2732
2779
  * Valores válidos:
2733
2780
  * - `xs`: 16px
2734
2781
  * - `sm`: 24px
2735
2782
  * - `md`: 32px
2736
2783
  * - `lg`: 80px
2784
+ *
2785
+ * > Em nível de acessibilidade **AA**, caso o valor de `p-size` não seja definido, o valor padrão será `sm`
2786
+ * > quando o valor padrão dos componentes for configurado como `small` no
2787
+ * > [serviço de tema](https://po-ui.io/documentation/po-theme).
2788
+ *
2789
+ * @default `lg`
2737
2790
  */
2738
2791
  set size(value: string);
2739
2792
  get size(): string;
@@ -3061,6 +3114,7 @@ declare class PoHelperComponent extends PoHelperBaseComponent implements AfterVi
3061
3114
  ngOnChanges(changes: SimpleChanges): void;
3062
3115
  ngOnDestroy(): void;
3063
3116
  openHelperPopover(): void;
3117
+ helperIsVisible(): boolean;
3064
3118
  closeHelperPopover(): void;
3065
3119
  emitClick(event: MouseEvent): void;
3066
3120
  onKeyDown(event: KeyboardEvent): void;
@@ -3243,8 +3297,7 @@ declare abstract class PoCheckboxBaseComponent implements ControlValueAccessor {
3243
3297
  * @optional
3244
3298
  *
3245
3299
  * @description
3246
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
3247
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
3300
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
3248
3301
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
3249
3302
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
3250
3303
  *
@@ -3256,11 +3309,11 @@ declare abstract class PoCheckboxBaseComponent implements ControlValueAccessor {
3256
3309
  *
3257
3310
  * @description
3258
3311
  *
3259
- * Define que o tooltip (`p-additional-help-tooltip`) será incluído no body da página e não dentro do componente. Essa
3312
+ * Define que o popover (`p-helper`) será incluído no body da página e não dentro do componente. Essa
3260
3313
  * opção pode ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o
3261
3314
  * posicionamento correto do tooltip próximo ao elemento.
3262
3315
  *
3263
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
3316
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
3264
3317
  *
3265
3318
  * @default `false`
3266
3319
  */
@@ -3295,7 +3348,6 @@ declare abstract class PoCheckboxBaseComponent implements ControlValueAccessor {
3295
3348
  *
3296
3349
  * @description
3297
3350
  * Evento disparado ao clicar no ícone de ajuda adicional.
3298
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
3299
3351
  *
3300
3352
  * > 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.
3301
3353
  */
@@ -3368,10 +3420,10 @@ declare abstract class PoCheckboxBaseComponent implements ControlValueAccessor {
3368
3420
  *
3369
3421
  * @description
3370
3422
  *
3371
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
3423
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
3424
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
3372
3425
  *
3373
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
3374
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
3426
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
3375
3427
  */
3376
3428
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
3377
3429
  /**
@@ -3428,7 +3480,6 @@ declare abstract class PoCheckboxBaseComponent implements ControlValueAccessor {
3428
3480
  declare class PoCheckboxComponent extends PoCheckboxBaseComponent implements AfterViewInit, OnChanges, OnInit {
3429
3481
  private readonly changeDetector;
3430
3482
  private _iconToken;
3431
- helperSettings: PoHelperOptions;
3432
3483
  showTip: boolean;
3433
3484
  checkboxLabel: ElementRef;
3434
3485
  labelEl: ElementRef<HTMLElement>;
@@ -3462,20 +3513,12 @@ declare class PoCheckboxComponent extends PoCheckboxBaseComponent implements Aft
3462
3513
  getAdditionalHelpTooltip(): string;
3463
3514
  onKeyDown(event: KeyboardEvent, value: boolean | string): void;
3464
3515
  /**
3465
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
3516
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
3466
3517
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
3467
3518
  *
3468
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
3519
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
3469
3520
  *
3470
3521
  * ```
3471
- * <po-checkbox
3472
- * #checkbox
3473
- * ...
3474
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
3475
- * (p-keydown)="onKeyDown($event, checkbox)"
3476
- * ></po-checkbox>
3477
- * ```
3478
- * ```
3479
3522
  * //Exemplo com label e p-helper
3480
3523
  * <po-checkbox
3481
3524
  * #checkbox
@@ -3603,6 +3646,8 @@ declare class PoFieldContainerBottomComponent implements OnChanges {
3603
3646
  showAdditionalHelp: boolean;
3604
3647
  /** Exibe o ícone de ajuda adicional. */
3605
3648
  showAdditionalHelpIcon: boolean;
3649
+ /** Define o tamanho do componente. */
3650
+ size?: string;
3606
3651
  /** Evento disparado ao clicar no ícone de ajuda adicional. */
3607
3652
  /** @deprecated v23.x.x */
3608
3653
  additionalHelp: EventEmitter<any>;
@@ -3613,7 +3658,7 @@ declare class PoFieldContainerBottomComponent implements OnChanges {
3613
3658
  private isInitialChange;
3614
3659
  ngOnChanges(changes: SimpleChanges): void;
3615
3660
  static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldContainerBottomComponent, never>;
3616
- 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; }; "showAdditionalHelp": { "alias": "p-show-additional-help"; "required": false; }; "showAdditionalHelpIcon": { "alias": "p-show-additional-help-icon"; "required": false; }; "hideAdditionalHelpByLabel": { "alias": "p-hide-additional-help-by-label"; "required": false; "isSignal": true; }; }, { "additionalHelp": "p-additional-help"; }, never, never, false, never>;
3661
+ 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; }; "showAdditionalHelp": { "alias": "p-show-additional-help"; "required": false; }; "showAdditionalHelpIcon": { "alias": "p-show-additional-help-icon"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "hideAdditionalHelpByLabel": { "alias": "p-hide-additional-help-by-label"; "required": false; "isSignal": true; }; }, { "additionalHelp": "p-additional-help"; }, never, never, false, never>;
3617
3662
  static ngAcceptInputType_appendBox: any;
3618
3663
  }
3619
3664
 
@@ -3661,13 +3706,15 @@ declare class PoFieldContainerComponent implements OnInit, OnChanges {
3661
3706
  get required(): boolean;
3662
3707
  /** Define se a indicação de campo obrigatório será exibida. */
3663
3708
  showRequired: boolean;
3709
+ /** Define o tamanho do componente. */
3710
+ size?: string;
3664
3711
  constructor(cdr: ChangeDetectorRef);
3665
3712
  ngOnInit(): void;
3666
3713
  ngOnChanges(changes: SimpleChanges): void;
3667
3714
  private setRequirement;
3668
3715
  handleLabelTooltip(): void;
3669
3716
  static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldContainerComponent, never>;
3670
- static ɵcmp: i0.ɵɵComponentDeclaration<PoFieldContainerComponent, "po-field-container", never, { "disabled": { "alias": "p-disabled"; "required": false; }; "id": { "alias": "p-id"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "showHelperComponent": { "alias": "p-show-helper"; "required": false; "isSignal": true; }; "textWrap": { "alias": "p-text-wrap"; "required": false; "isSignal": true; }; "optional": { "alias": "p-optional"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; }, {}, never, ["*"], false, never>;
3717
+ static ɵcmp: i0.ɵɵComponentDeclaration<PoFieldContainerComponent, "po-field-container", never, { "disabled": { "alias": "p-disabled"; "required": false; }; "id": { "alias": "p-id"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "showHelperComponent": { "alias": "p-show-helper"; "required": false; "isSignal": true; }; "textWrap": { "alias": "p-text-wrap"; "required": false; "isSignal": true; }; "optional": { "alias": "p-optional"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, {}, never, ["*"], false, never>;
3671
3718
  }
3672
3719
 
3673
3720
  /**
@@ -5068,7 +5115,7 @@ declare enum PoTableRowTemplateArrowDirection {
5068
5115
  * Tipos de espaçamento interno (padding) das células (**p-spacing**) do po-table.
5069
5116
  */
5070
5117
  declare enum PoTableColumnSpacing {
5071
- /** Espaçamento extra pequeno: 0.25rem (vertical) x 1rem (horizontal). */
5118
+ /** Espaçamento extra pequeno: 0.25rem (vertical) x 0.5rem (horizontal). */
5072
5119
  ExtraSmall = "extraSmall",
5073
5120
  /** Espaçamento pequeno: 0.5rem (vertical) x 1rem (horizontal). */
5074
5121
  Small = "small",
@@ -8228,8 +8275,7 @@ declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Vali
8228
8275
  * @optional
8229
8276
  *
8230
8277
  * @description
8231
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
8232
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
8278
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
8233
8279
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
8234
8280
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
8235
8281
  *
@@ -8241,11 +8287,11 @@ declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Vali
8241
8287
  *
8242
8288
  * @description
8243
8289
  *
8244
- * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
8290
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
8245
8291
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
8246
8292
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
8247
8293
  *
8248
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
8294
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
8249
8295
  *
8250
8296
  * @default `false`
8251
8297
  */
@@ -8313,10 +8359,10 @@ declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Vali
8313
8359
  *
8314
8360
  * @description
8315
8361
  *
8316
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
8362
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
8363
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
8317
8364
  *
8318
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
8319
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
8365
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
8320
8366
  */
8321
8367
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
8322
8368
  /**
@@ -8355,7 +8401,6 @@ declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Vali
8355
8401
  *
8356
8402
  * @description
8357
8403
  * Evento disparado ao clicar no ícone de ajuda adicional.
8358
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
8359
8404
  *
8360
8405
  * > 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.
8361
8406
  */
@@ -8521,10 +8566,12 @@ declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Vali
8521
8566
  * <file name="sample-po-checkbox-group-password-policy/sample-po-checkbox-group-password-policy.component.ts"> </file>
8522
8567
  * </example>
8523
8568
  */
8524
- declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseComponent implements AfterViewChecked, AfterViewInit {
8569
+ declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseComponent implements AfterViewChecked, AfterViewInit, OnChanges {
8525
8570
  private changeDetector;
8526
8571
  checkboxLabels: QueryList<PoCheckboxComponent>;
8572
+ helperEl?: PoHelperComponent;
8527
8573
  private el;
8574
+ ngOnChanges(changes: SimpleChanges): void;
8528
8575
  ngAfterViewChecked(): void;
8529
8576
  ngAfterViewInit(): void;
8530
8577
  onBlur(checkbox: PoCheckboxComponent): void;
@@ -8552,20 +8599,12 @@ declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseComponent impl
8552
8599
  hasInvalidClass(): any;
8553
8600
  onKeyDown(event: KeyboardEvent, option: PoCheckboxGroupOption, checkbox?: PoCheckboxComponent): void;
8554
8601
  /**
8555
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
8602
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
8556
8603
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
8557
8604
  *
8558
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
8605
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
8559
8606
  *
8560
8607
  * ```
8561
- * <po-checkbox-group
8562
- * #checkboxGroup
8563
- * ...
8564
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
8565
- * (p-keydown)="onKeyDown($event, checkboxGroup)"
8566
- * ></po-checkbox-group>
8567
- * ```
8568
- * ```
8569
8608
  * //Exemplo com p-label e p-helper
8570
8609
  * <po-checkbox-group
8571
8610
  * #checkboxGroup
@@ -8822,7 +8861,7 @@ declare class PoTableSubtitleFooterComponent implements AfterViewInit, DoCheck,
8822
8861
  */
8823
8862
  declare class PoCheckboxGroupModule {
8824
8863
  static ɵfac: i0.ɵɵFactoryDeclaration<PoCheckboxGroupModule, never>;
8825
- static ɵmod: i0.ɵɵNgModuleDeclaration<PoCheckboxGroupModule, [typeof PoCheckboxGroupComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof PoCheckboxModule], [typeof PoCheckboxGroupComponent]>;
8864
+ static ɵmod: i0.ɵɵNgModuleDeclaration<PoCheckboxGroupModule, [typeof PoCheckboxGroupComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof PoCheckboxModule, typeof PoHelperModule], [typeof PoCheckboxGroupComponent]>;
8826
8865
  static ɵinj: i0.ɵɵInjectorDeclaration<PoCheckboxGroupModule>;
8827
8866
  }
8828
8867
 
@@ -8982,8 +9021,7 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
8982
9021
  * @optional
8983
9022
  *
8984
9023
  * @description
8985
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
8986
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
9024
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
8987
9025
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
8988
9026
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
8989
9027
  *
@@ -8995,11 +9033,11 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
8995
9033
  *
8996
9034
  * @description
8997
9035
  *
8998
- * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
9036
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
8999
9037
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
9000
9038
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
9001
9039
  *
9002
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
9040
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
9003
9041
  *
9004
9042
  * @default `false`
9005
9043
  */
@@ -9028,7 +9066,6 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
9028
9066
  *
9029
9067
  * @description
9030
9068
  * Evento disparado ao clicar no ícone de ajuda adicional.
9031
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
9032
9069
  *
9033
9070
  * > 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.
9034
9071
  */
@@ -9062,20 +9099,12 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
9062
9099
  emitChange(value: any): void;
9063
9100
  getAdditionalHelpTooltip(): string;
9064
9101
  /**
9065
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
9102
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
9066
9103
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
9067
9104
  *
9068
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
9105
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
9069
9106
  *
9070
9107
  * ```
9071
- * <po-nome-component
9072
- * #component
9073
- * ...
9074
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
9075
- * (p-keydown)="onKeyDown($event, component)"
9076
- * ></po-nome-component>
9077
- * ```
9078
- * ```
9079
9108
  * // Exemplo com p-label e p-helper
9080
9109
  * <po-nome-component
9081
9110
  * #component
@@ -9094,7 +9123,7 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
9094
9123
  * }
9095
9124
  * ```
9096
9125
  */
9097
- showAdditionalHelp(): boolean;
9126
+ showAdditionalHelp(helperHtmlElement?: PoHelperComponent, poHelperComponent?: string | PoHelperOptions): boolean;
9098
9127
  showAdditionalHelpIcon(): boolean;
9099
9128
  protected isAdditionalHelpEventTriggered(): boolean;
9100
9129
  protected updateModel(value: T): void;
@@ -9118,6 +9147,15 @@ declare class PoRadioComponent extends PoFieldModel<boolean> {
9118
9147
  set size(value: string);
9119
9148
  get size(): string;
9120
9149
  required?: boolean;
9150
+ /**
9151
+ *
9152
+ * Habilita a quebra automática do texto da propriedade `p-label`. Quando `p-label-text-wrap` for verdadeiro, o texto que excede
9153
+ * o espaço disponível é transferido para a próxima linha em pontos apropriados para uma
9154
+ * leitura clara.
9155
+ *
9156
+ * @default `false`
9157
+ */
9158
+ labelTextWrap?: boolean;
9121
9159
  /** Define o status do *radio* */
9122
9160
  checked: boolean;
9123
9161
  blur: EventEmitter<any>;
@@ -9152,8 +9190,9 @@ declare class PoRadioComponent extends PoFieldModel<boolean> {
9152
9190
  onKeyup(): void;
9153
9191
  onKeydown(): void;
9154
9192
  static ɵfac: i0.ɵɵFactoryDeclaration<PoRadioComponent, never>;
9155
- static ɵcmp: i0.ɵɵComponentDeclaration<PoRadioComponent, "po-radio", never, { "radioValue": { "alias": "p-value"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "checked": { "alias": "p-checked"; "required": false; }; }, { "blur": "p-blur"; "changeSelected": "p-change-selected"; }, never, never, false, never>;
9193
+ static ɵcmp: i0.ɵɵComponentDeclaration<PoRadioComponent, "po-radio", never, { "radioValue": { "alias": "p-value"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; }; "checked": { "alias": "p-checked"; "required": false; }; }, { "blur": "p-blur"; "changeSelected": "p-change-selected"; }, never, never, false, never>;
9156
9194
  static ngAcceptInputType_required: any;
9195
+ static ngAcceptInputType_labelTextWrap: any;
9157
9196
  }
9158
9197
 
9159
9198
  declare class PoRadioModule {
@@ -9249,10 +9288,11 @@ declare enum PoSwitchLabelPosition {
9249
9288
  * <file name="sample-po-switch-order-reactive-form/sample-po-switch-order-reactive-form.component.ts"> </file>
9250
9289
  * </example>
9251
9290
  */
9252
- declare class PoSwitchComponent extends PoFieldModel<any> implements Validator, AfterViewInit, OnDestroy {
9291
+ declare class PoSwitchComponent extends PoFieldModel<any> implements Validator, AfterViewInit, OnDestroy, OnChanges {
9253
9292
  private readonly changeDetector;
9254
9293
  private readonly injector;
9255
9294
  switchContainer: ElementRef;
9295
+ helperEl?: PoHelperComponent;
9256
9296
  id: string;
9257
9297
  value: boolean;
9258
9298
  private _labelOff;
@@ -9369,10 +9409,10 @@ declare class PoSwitchComponent extends PoFieldModel<any> implements Validator,
9369
9409
  *
9370
9410
  * @description
9371
9411
  *
9372
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
9412
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
9413
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
9373
9414
  *
9374
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
9375
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
9415
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
9376
9416
  */
9377
9417
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
9378
9418
  /**
@@ -9391,6 +9431,7 @@ declare class PoSwitchComponent extends PoFieldModel<any> implements Validator,
9391
9431
  private readonly el;
9392
9432
  private readonly injectOptions;
9393
9433
  private control;
9434
+ ngOnChanges(changes: SimpleChanges): void;
9394
9435
  ngOnDestroy(): void;
9395
9436
  /**
9396
9437
  * Função que atribui foco ao componente.
@@ -9425,6 +9466,31 @@ declare class PoSwitchComponent extends PoFieldModel<any> implements Validator,
9425
9466
  hideAdditionalHelp: boolean;
9426
9467
  helperSettings?: any;
9427
9468
  };
9469
+ /**
9470
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
9471
+ * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
9472
+ *
9473
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
9474
+ *
9475
+ * ```
9476
+ * //Exemplo com p-label e p-helper
9477
+ * <po-switch
9478
+ * #switch
9479
+ * ...
9480
+ * p-label="Label do switch"
9481
+ * [p-helper]="helperOptions"
9482
+ * (p-keydown)="onKeyDown($event, switch)"
9483
+ * ></po-switch>
9484
+ * ```
9485
+ * ```typescript
9486
+ * onKeyDown(event: KeyboardEvent, inp: PoSwitchComponent): void {
9487
+ * if (event.code === 'F9') {
9488
+ * inp.showAdditionalHelp();
9489
+ * }
9490
+ * }
9491
+ * ```
9492
+ */
9493
+ showAdditionalHelp(): boolean;
9428
9494
  static ɵfac: i0.ɵɵFactoryDeclaration<PoSwitchComponent, never>;
9429
9495
  static ɵcmp: i0.ɵɵComponentDeclaration<PoSwitchComponent, "po-switch", never, { "value": { "alias": "p-value"; "required": false; }; "formatModel": { "alias": "p-format-model"; "required": false; }; "hideLabelStatus": { "alias": "p-hide-label-status"; "required": false; }; "labelPosition": { "alias": "p-label-position"; "required": false; }; "labelOff": { "alias": "p-label-off"; "required": false; }; "labelOn": { "alias": "p-label-on"; "required": false; }; "fieldErrorMessage": { "alias": "p-field-error-message"; "required": false; }; "errorLimit": { "alias": "p-error-limit"; "required": false; }; "invalidValue": { "alias": "p-invalid-value"; "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; }; }, {}, never, never, false, never>;
9430
9496
  static ngAcceptInputType_value: any;
@@ -10027,6 +10093,22 @@ declare class PoSearchBaseComponent {
10027
10093
  * > Incompatível com a propriedade `p-search-type` do tipo `locate`.
10028
10094
  */
10029
10095
  filteredItemsChange: EventEmitter<any[]>;
10096
+ /**
10097
+ * @optional
10098
+ *
10099
+ * @description
10100
+ *
10101
+ * Evento emitido quando o campo de entrada (input) recebe foco.
10102
+ */
10103
+ focusEvent: EventEmitter<any>;
10104
+ /**
10105
+ * @optional
10106
+ *
10107
+ * @description
10108
+ * Evento disparado quando uma tecla é pressionada enquanto o foco está no componente.
10109
+ * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
10110
+ */
10111
+ keydown: EventEmitter<KeyboardEvent>;
10030
10112
  /**
10031
10113
  * @optional
10032
10114
  *
@@ -10069,7 +10151,7 @@ declare class PoSearchBaseComponent {
10069
10151
  constructor(languageService: PoLanguageService);
10070
10152
  ensureFilterSelectOption(values: any): any[];
10071
10153
  static ɵfac: i0.ɵɵFactoryDeclaration<PoSearchBaseComponent, never>;
10072
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoSearchBaseComponent, never, never, { "ariaLabel": { "alias": "p-aria-label"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "filterKeys": { "alias": "p-filter-keys"; "required": false; }; "filterSelect": { "alias": "p-filter-select"; "required": false; }; "filterType": { "alias": "p-filter-type"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "items": { "alias": "p-items"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "locateSummary": { "alias": "p-locate-summary"; "required": false; }; "type": { "alias": "p-search-type"; "required": false; }; "showListbox": { "alias": "p-show-listbox"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "keysLabel": { "alias": "p-keys-label"; "required": false; }; }, { "blur": "p-blur"; "changeModel": "p-change-model"; "filter": "p-filter"; "filteredItemsChange": "p-filtered-items-change"; "listboxOnClick": "p-listbox-onclick"; "locateNext": "p-locate-next"; "locatePrevious": "p-locate-previous"; "footerAction": "p-footer-action-listbox"; }, never, never, true, never>;
10154
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoSearchBaseComponent, never, never, { "ariaLabel": { "alias": "p-aria-label"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "filterKeys": { "alias": "p-filter-keys"; "required": false; }; "filterSelect": { "alias": "p-filter-select"; "required": false; }; "filterType": { "alias": "p-filter-type"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "items": { "alias": "p-items"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "locateSummary": { "alias": "p-locate-summary"; "required": false; }; "type": { "alias": "p-search-type"; "required": false; }; "showListbox": { "alias": "p-show-listbox"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "keysLabel": { "alias": "p-keys-label"; "required": false; }; }, { "blur": "p-blur"; "changeModel": "p-change-model"; "filter": "p-filter"; "filteredItemsChange": "p-filtered-items-change"; "focusEvent": "p-focus"; "keydown": "p-keydown"; "listboxOnClick": "p-listbox-onclick"; "locateNext": "p-locate-next"; "locatePrevious": "p-locate-previous"; "footerAction": "p-footer-action-listbox"; }, never, never, true, never>;
10073
10155
  static ngAcceptInputType_disabled: any;
10074
10156
  static ngAcceptInputType_showListbox: any;
10075
10157
  }
@@ -10191,7 +10273,7 @@ declare class PoSearchComponent extends PoSearchBaseComponent implements OnInit,
10191
10273
  getInputValue(): any;
10192
10274
  createDropdownFilterSelect(): void;
10193
10275
  isSelected(filterOption: PoSearchFilterSelect): boolean;
10194
- changeFilterSelect(filterOption: PoSearchFilterSelect): void;
10276
+ changeFilterSelect(filterOption: PoSearchFilterSelect, focus?: boolean): void;
10195
10277
  handlerFooterActionListbox(): void;
10196
10278
  private openListboxFooterAction;
10197
10279
  private handlerPlaceholderListbox;
@@ -10872,9 +10954,10 @@ interface PoChartSerie {
10872
10954
  * @description
10873
10955
  *
10874
10956
  * Determina a cor da série. As maneiras de customizar o *preset* padrão de cores são:
10875
- * * Hexadeximal, por exemplo `#c64840`;
10876
- * * RGB, como `rgb(0, 0, 165)`
10957
+ * * Hexadecimal, por exemplo `#c64840`;
10958
+ * * RGB, por exemplo `rgb(0, 0, 165)`
10877
10959
  * * O nome da cor, por exemplo `blue`;
10960
+ * * Variáveis CSS, por exemplo `var(--color-01)`;
10878
10961
  * * Usando uma das cores do tema do PO:
10879
10962
  * Valores válidos:
10880
10963
  * - <span class="dot po-color-01"></span> `color-01`
@@ -11978,8 +12061,7 @@ declare abstract class PoComboBaseComponent implements ControlValueAccessor, OnI
11978
12061
  * @optional
11979
12062
  *
11980
12063
  * @description
11981
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
11982
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
12064
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
11983
12065
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
11984
12066
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
11985
12067
  *
@@ -12153,7 +12235,6 @@ declare abstract class PoComboBaseComponent implements ControlValueAccessor, OnI
12153
12235
  *
12154
12236
  * @description
12155
12237
  * Evento disparado ao clicar no ícone de ajuda adicional.
12156
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
12157
12238
  *
12158
12239
  * > 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.
12159
12240
  */
@@ -12240,10 +12321,10 @@ declare abstract class PoComboBaseComponent implements ControlValueAccessor, OnI
12240
12321
  *
12241
12322
  * @description
12242
12323
  *
12243
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
12324
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
12325
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
12244
12326
  *
12245
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
12246
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
12327
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
12247
12328
  */
12248
12329
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
12249
12330
  /**
@@ -12509,11 +12590,11 @@ declare abstract class PoComboBaseComponent implements ControlValueAccessor, OnI
12509
12590
  *
12510
12591
  * @description
12511
12592
  *
12512
- * Define que o `listbox` e/ou tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) serão incluídos no body da
12593
+ * Define que o `listbox` e/ou popover (`p-helper` e/ou `p-error-limit`) serão incluídos no body da
12513
12594
  * página e não dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou
12514
12595
  * overflow escondido,garantindo o posicionamento correto de ambos próximo ao elemento.
12515
12596
  *
12516
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
12597
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
12517
12598
  *
12518
12599
  * @default `false`
12519
12600
  */
@@ -12642,6 +12723,7 @@ declare class PoComboComponent extends PoComboBaseComponent implements AfterView
12642
12723
  iconElement: ElementRef;
12643
12724
  inputEl: ElementRef;
12644
12725
  poListbox: PoListBoxComponent;
12726
+ helperEl?: PoHelperComponent;
12645
12727
  comboIcon: string;
12646
12728
  comboOpen: boolean;
12647
12729
  differ: any;
@@ -12651,7 +12733,6 @@ declare class PoComboComponent extends PoComboBaseComponent implements AfterView
12651
12733
  shouldMarkLetters: boolean;
12652
12734
  infiniteLoading: boolean;
12653
12735
  containerWidth: number;
12654
- helperSettings: PoHelperOptions;
12655
12736
  private _isServerSearching;
12656
12737
  private lastKey;
12657
12738
  private clickoutListener;
@@ -12707,18 +12788,11 @@ declare class PoComboComponent extends PoComboBaseComponent implements AfterView
12707
12788
  getInputValue(): any;
12708
12789
  setInputValue(value: string): void;
12709
12790
  /**
12710
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
12791
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
12711
12792
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
12712
12793
  *
12713
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
12714
- * ```
12715
- * <po-combo
12716
- * #combo
12717
- * ...
12718
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
12719
- * (p-keydown)="onKeyDown($event, combo)"
12720
- * ></po-combo>
12721
- * ```
12794
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
12795
+ *
12722
12796
  * ```
12723
12797
  * // Exemplo com p-label e p-helper
12724
12798
  * <po-combo
@@ -12923,8 +12997,7 @@ declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor
12923
12997
  * @optional
12924
12998
  *
12925
12999
  * @description
12926
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
12927
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
13000
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
12928
13001
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
12929
13002
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
12930
13003
  *
@@ -13011,7 +13084,6 @@ declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor
13011
13084
  *
13012
13085
  * @description
13013
13086
  * Evento disparado ao clicar no ícone de ajuda adicional.
13014
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
13015
13087
  *
13016
13088
  * > 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.
13017
13089
  */
@@ -13047,10 +13119,10 @@ declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor
13047
13119
  *
13048
13120
  * @description
13049
13121
  *
13050
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
13122
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
13123
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
13051
13124
  *
13052
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
13053
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
13125
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
13054
13126
  */
13055
13127
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
13056
13128
  /**
@@ -13217,7 +13289,7 @@ declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor
13217
13289
  * página e não dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou
13218
13290
  * overflow escondido, garantindo o posicionamento correto de ambos próximo ao elemento.
13219
13291
  *
13220
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
13292
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
13221
13293
  *
13222
13294
  * @default `false`
13223
13295
  */
@@ -13274,13 +13346,14 @@ declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor
13274
13346
  * <file name="sample-po-datepicker-airfare-reactive-form/sample-po-datepicker-airfare-reactive-form.component.ts"> </file>
13275
13347
  * </example>
13276
13348
  */
13277
- declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements AfterViewInit, OnDestroy {
13349
+ declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements AfterViewInit, OnDestroy, OnChanges {
13278
13350
  private controlPosition;
13279
13351
  private renderer;
13280
13352
  calendar: PoCalendarComponent;
13281
13353
  dialogPicker: ElementRef;
13282
13354
  iconDatepicker: PoButtonComponent;
13283
13355
  inputEl: ElementRef;
13356
+ helperEl?: PoHelperComponent;
13284
13357
  /** Rótulo do campo. */
13285
13358
  label?: string;
13286
13359
  /** Texto de apoio do campo. */
@@ -13291,7 +13364,6 @@ declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements
13291
13364
  id: string;
13292
13365
  visible: boolean;
13293
13366
  literals: any;
13294
- helperSettings: PoHelperOptions;
13295
13367
  eventListenerFunction: () => void;
13296
13368
  eventResizeListener: () => void;
13297
13369
  private clickListener;
@@ -13305,6 +13377,7 @@ declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements
13305
13377
  onKeyup($event: any): void;
13306
13378
  onKeydown($event?: any): void;
13307
13379
  ngAfterViewInit(): void;
13380
+ ngOnChanges(changes: SimpleChanges): void;
13308
13381
  ngOnDestroy(): void;
13309
13382
  emitAdditionalHelp(): void;
13310
13383
  /**
@@ -13339,20 +13412,12 @@ declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements
13339
13412
  formatToDate(value: Date): string;
13340
13413
  refreshValue(value: Date): void;
13341
13414
  /**
13342
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
13415
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
13343
13416
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
13344
13417
  *
13345
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
13418
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
13346
13419
  *
13347
13420
  * ```
13348
- * <po-datepicker
13349
- * #datepicker
13350
- * ...
13351
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
13352
- * (p-keydown)="onKeyDown($event, datepicker)"
13353
- * ></po-datepicker>
13354
- * ```
13355
- * ```
13356
13421
  * // Exemplo com p-label e p-helper
13357
13422
  * <po-datepicker
13358
13423
  * #datepicker
@@ -13489,8 +13554,7 @@ declare abstract class PoDatepickerRangeBaseComponent implements ControlValueAcc
13489
13554
  * @optional
13490
13555
  *
13491
13556
  * @description
13492
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
13493
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
13557
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
13494
13558
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
13495
13559
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
13496
13560
  *
@@ -13506,7 +13570,7 @@ declare abstract class PoDatepickerRangeBaseComponent implements ControlValueAcc
13506
13570
  * página e não dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou
13507
13571
  * overflow escondido, garantindo o posicionamento correto de ambos próximo ao elemento.
13508
13572
  *
13509
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
13573
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
13510
13574
  *
13511
13575
  * @default `false`
13512
13576
  */
@@ -13572,7 +13636,6 @@ declare abstract class PoDatepickerRangeBaseComponent implements ControlValueAcc
13572
13636
  *
13573
13637
  * @description
13574
13638
  * Evento disparado ao clicar no ícone de ajuda adicional.
13575
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
13576
13639
  *
13577
13640
  * > 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.
13578
13641
  */
@@ -13597,10 +13660,10 @@ declare abstract class PoDatepickerRangeBaseComponent implements ControlValueAcc
13597
13660
  *
13598
13661
  * @description
13599
13662
  *
13600
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
13663
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
13664
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
13601
13665
  *
13602
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
13603
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
13666
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
13604
13667
  */
13605
13668
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
13606
13669
  /**
@@ -13887,8 +13950,8 @@ declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseComponent
13887
13950
  startDateInput: ElementRef;
13888
13951
  iconCalendar: ElementRef;
13889
13952
  calendarPicker: ElementRef;
13953
+ helperEl?: PoHelperComponent;
13890
13954
  isCalendarVisible: boolean;
13891
- helperSettings: PoHelperOptions;
13892
13955
  private clickListener;
13893
13956
  private eventResizeListener;
13894
13957
  private poDatepickerRangeElement;
@@ -13942,20 +14005,12 @@ declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseComponent
13942
14005
  resetDateRangeInputValidation(): void;
13943
14006
  showAdditionalHelpIcon(): boolean;
13944
14007
  /**
13945
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
14008
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
13946
14009
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
13947
14010
  *
13948
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
14011
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
13949
14012
  *
13950
14013
  * ```
13951
- * <po-datepicker-range
13952
- * #datepickerRange
13953
- * ...
13954
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
13955
- * (p-keydown)="onKeyDown($event, datepickerRange)"
13956
- * ></po-datepicker-range>
13957
- * ```
13958
- * ```
13959
14014
  * // Exemplo com p-label e p-helper
13960
14015
  * <po-datepicker-range
13961
14016
  * #datepickerRange
@@ -14094,6 +14149,7 @@ interface ErrorAsyncProperties {
14094
14149
  declare abstract class PoInputBaseComponent implements ControlValueAccessor, Validator, OnDestroy {
14095
14150
  protected cd?: ChangeDetectorRef;
14096
14151
  fieldContainer?: PoFieldContainerComponent;
14152
+ helperEl?: PoHelperComponent;
14097
14153
  additionalHelpEventTrigger: string | undefined;
14098
14154
  /**
14099
14155
  *
@@ -14102,8 +14158,7 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14102
14158
  * @optional
14103
14159
  *
14104
14160
  * @description
14105
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
14106
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
14161
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
14107
14162
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
14108
14163
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
14109
14164
  *
@@ -14115,11 +14170,11 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14115
14170
  *
14116
14171
  * @description
14117
14172
  *
14118
- * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
14173
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
14119
14174
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
14120
14175
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
14121
14176
  *
14122
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
14177
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
14123
14178
  *
14124
14179
  * @default `false`
14125
14180
  */
@@ -14277,7 +14332,6 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14277
14332
  *
14278
14333
  * @description
14279
14334
  * Evento disparado ao clicar no ícone de ajuda adicional.
14280
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
14281
14335
  *
14282
14336
  * > 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.
14283
14337
  */
@@ -14468,10 +14522,10 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14468
14522
  *
14469
14523
  * @description
14470
14524
  *
14471
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
14525
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
14526
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
14472
14527
  *
14473
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
14474
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
14528
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
14475
14529
  */
14476
14530
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
14477
14531
  /**
@@ -14501,18 +14555,11 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14501
14555
  registerOnValidatorChange(fn: () => void): void;
14502
14556
  showAdditionalHelpIcon(): boolean;
14503
14557
  /**
14504
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
14558
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
14505
14559
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
14506
14560
  *
14507
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
14508
- * ```
14509
- * <po-nome-component
14510
- * #component
14511
- * ...
14512
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
14513
- * (p-keydown)="onKeyDown($event, component)"
14514
- * ></po-nome-component>
14515
- * ```
14561
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
14562
+ *
14516
14563
  * ```
14517
14564
  * // Exemplo com p-label e p-helper
14518
14565
  * <po-nome-component
@@ -14523,6 +14570,7 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14523
14570
  * (p-keydown)="onKeyDown($event, component)"
14524
14571
  * ></po-nome-component>
14525
14572
  * ```
14573
+ *
14526
14574
  * ```
14527
14575
  * ...
14528
14576
  * onKeyDown(event: KeyboardEvent, inp: PoNomeDoComponente): void {
@@ -14611,7 +14659,7 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14611
14659
  * <file name="sample-po-decimal-hourly-wage-reactive-form/sample-po-decimal-hourly-wage-reactive-form.component.ts"> </file>
14612
14660
  * </example>
14613
14661
  */
14614
- declare class PoDecimalComponent extends PoInputBaseComponent implements AfterViewInit, OnInit, OnDestroy {
14662
+ declare class PoDecimalComponent extends PoInputBaseComponent implements AfterViewInit, OnInit, OnDestroy, OnChanges {
14615
14663
  private el;
14616
14664
  private poLanguageService;
14617
14665
  inputEl: ElementRef;
@@ -14629,7 +14677,6 @@ declare class PoDecimalComponent extends PoInputBaseComponent implements AfterVi
14629
14677
  private thousandSeparator;
14630
14678
  private valueBeforeChange;
14631
14679
  private subscriptionValidator;
14632
- helperSettings: PoHelperOptions;
14633
14680
  private regex;
14634
14681
  get autocomplete(): "on" | "off";
14635
14682
  /**
@@ -14697,6 +14744,7 @@ declare class PoDecimalComponent extends PoInputBaseComponent implements AfterVi
14697
14744
  get max(): number;
14698
14745
  constructor();
14699
14746
  ngOnInit(): void;
14747
+ ngOnChanges(changes: SimpleChanges): void;
14700
14748
  setNumbersSeparators(): void;
14701
14749
  ngAfterViewInit(): void;
14702
14750
  ngOnDestroy(): void;
@@ -14766,7 +14814,6 @@ declare abstract class PoInputGeneric extends PoInputBaseComponent implements Af
14766
14814
  el: ElementRef;
14767
14815
  valueBeforeChange: any;
14768
14816
  timeoutChange: any;
14769
- helperSettings: PoHelperOptions;
14770
14817
  private subscriptionValidator;
14771
14818
  get autocomplete(): string;
14772
14819
  constructor(el: ElementRef, cd?: ChangeDetectorRef);
@@ -14829,7 +14876,7 @@ declare abstract class PoInputGeneric extends PoInputBaseComponent implements Af
14829
14876
  * <file name="sample-po-email-newsletter/sample-po-email-newsletter.component.ts"> </file>
14830
14877
  * </example>
14831
14878
  */
14832
- declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnInit {
14879
+ declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnChanges {
14833
14880
  id: string;
14834
14881
  icon: string;
14835
14882
  type: string;
@@ -14837,7 +14884,7 @@ declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit,
14837
14884
  mask: string;
14838
14885
  private listener;
14839
14886
  constructor();
14840
- ngOnInit(): void;
14887
+ ngOnChanges(changes: SimpleChanges): void;
14841
14888
  ngAfterViewInit(): void;
14842
14889
  ngOnDestroy(): void;
14843
14890
  extraValidation(c: AbstractControl): {
@@ -14867,11 +14914,11 @@ declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit,
14867
14914
  * <file name="sample-po-input-reactive-form/sample-po-input-reactive-form.component.ts"> </file>
14868
14915
  * </example>
14869
14916
  */
14870
- declare class PoInputComponent extends PoInputGeneric implements OnInit {
14917
+ declare class PoInputComponent extends PoInputGeneric implements OnChanges {
14871
14918
  inp: ElementRef;
14872
14919
  id: string;
14873
14920
  constructor();
14874
- ngOnInit(): void;
14921
+ ngOnChanges(changes: SimpleChanges): void;
14875
14922
  extraValidation(c: AbstractControl): {
14876
14923
  [key: string]: any;
14877
14924
  };
@@ -14903,7 +14950,7 @@ declare class PoInputComponent extends PoInputGeneric implements OnInit {
14903
14950
  * </example>
14904
14951
  *
14905
14952
  */
14906
- declare class PoLoginComponent extends PoInputGeneric {
14953
+ declare class PoLoginComponent extends PoInputGeneric implements OnChanges {
14907
14954
  id: string;
14908
14955
  type: string;
14909
14956
  private _noAutocompleteLogin?;
@@ -14911,6 +14958,7 @@ declare class PoLoginComponent extends PoInputGeneric {
14911
14958
  get noAutocomplete(): boolean;
14912
14959
  get autocomplete(): string;
14913
14960
  constructor();
14961
+ ngOnChanges(changes: SimpleChanges): void;
14914
14962
  extraValidation(c: AbstractControl): {
14915
14963
  [key: string]: any;
14916
14964
  };
@@ -15473,8 +15521,7 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
15473
15521
  * @optional
15474
15522
  *
15475
15523
  * @description
15476
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
15477
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
15524
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
15478
15525
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
15479
15526
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
15480
15527
  *
@@ -15486,11 +15533,11 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
15486
15533
  *
15487
15534
  * @description
15488
15535
  *
15489
- * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
15536
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
15490
15537
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
15491
15538
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
15492
15539
  *
15493
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
15540
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
15494
15541
  *
15495
15542
  * @default `false`
15496
15543
  */
@@ -15799,10 +15846,10 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
15799
15846
  *
15800
15847
  * @description
15801
15848
  *
15802
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
15849
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
15850
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
15803
15851
  *
15804
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
15805
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
15852
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
15806
15853
  */
15807
15854
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
15808
15855
  /**
@@ -15827,7 +15874,6 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
15827
15874
  *
15828
15875
  * @description
15829
15876
  * Evento disparado ao clicar no ícone de ajuda adicional.
15830
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
15831
15877
  *
15832
15878
  * > 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.
15833
15879
  */
@@ -16135,11 +16181,12 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
16135
16181
  * <file name="sample-po-lookup-multiple/sample-po-lookup-multiple.service.ts"> </file>
16136
16182
  * </example>
16137
16183
  */
16138
- declare class PoLookupComponent extends PoLookupBaseComponent implements AfterViewInit, OnDestroy, OnInit, DoCheck {
16184
+ declare class PoLookupComponent extends PoLookupBaseComponent implements AfterViewInit, OnDestroy, OnInit, DoCheck, OnChanges {
16139
16185
  private renderer;
16140
16186
  private cd;
16141
16187
  private el;
16142
16188
  inputEl: ElementRef;
16189
+ helperEl?: PoHelperComponent;
16143
16190
  initialized: boolean;
16144
16191
  timeoutResize: any;
16145
16192
  visibleElement: boolean;
@@ -16147,7 +16194,6 @@ declare class PoLookupComponent extends PoLookupBaseComponent implements AfterVi
16147
16194
  disclaimers: any[];
16148
16195
  visibleDisclaimers: any[];
16149
16196
  id: string;
16150
- helperSettings: PoHelperOptions;
16151
16197
  private modalSubscription;
16152
16198
  private isCalculateVisibleItems;
16153
16199
  get autocomplete(): "on" | "off";
@@ -16156,6 +16202,7 @@ declare class PoLookupComponent extends PoLookupBaseComponent implements AfterVi
16156
16202
  ngDoCheck(): void;
16157
16203
  ngOnDestroy(): void;
16158
16204
  ngOnInit(): void;
16205
+ ngOnChanges(changes: SimpleChanges): void;
16159
16206
  /**
16160
16207
  * Função que atribui foco ao componente.
16161
16208
  *
@@ -16195,18 +16242,11 @@ declare class PoLookupComponent extends PoLookupBaseComponent implements AfterVi
16195
16242
  onKeyDown(event: KeyboardEvent): void;
16196
16243
  /**
16197
16244
  *
16198
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
16245
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
16199
16246
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
16200
16247
  *
16201
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
16202
- * ```
16203
- * <po-lookup
16204
- * #lookup
16205
- * ...
16206
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
16207
- * (p-keydown)="onKeyDown($event, lookup)"
16208
- * ></po-lookup>
16209
- * ```
16248
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
16249
+ *
16210
16250
  * ```
16211
16251
  * // Exemplo com p-label e p-helper
16212
16252
  * <po-lookup
@@ -16437,8 +16477,7 @@ declare abstract class PoMultiselectBaseComponent implements ControlValueAccesso
16437
16477
  * @optional
16438
16478
  *
16439
16479
  * @description
16440
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
16441
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
16480
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
16442
16481
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
16443
16482
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
16444
16483
  *
@@ -16539,7 +16578,6 @@ declare abstract class PoMultiselectBaseComponent implements ControlValueAccesso
16539
16578
  *
16540
16579
  * @description
16541
16580
  * Evento disparado ao clicar no ícone de ajuda adicional.
16542
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
16543
16581
  *
16544
16582
  * > 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.
16545
16583
  */
@@ -16565,11 +16603,11 @@ declare abstract class PoMultiselectBaseComponent implements ControlValueAccesso
16565
16603
  *
16566
16604
  * @description
16567
16605
  *
16568
- * Define que o `listbox` e/ou tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) serão incluídos no body da
16606
+ * Define que o `listbox` e/ou popover (`p-helper` e/ou `p-error-limit`) serão incluídos no body da
16569
16607
  * página e não dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou
16570
16608
  * overflow escondido, garantindo o posicionamento correto de ambos próximo ao elemento.
16571
16609
  *
16572
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
16610
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
16573
16611
  *
16574
16612
  * @default `false`
16575
16613
  */
@@ -16600,10 +16638,10 @@ declare abstract class PoMultiselectBaseComponent implements ControlValueAccesso
16600
16638
  *
16601
16639
  * @description
16602
16640
  *
16603
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
16641
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
16642
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
16604
16643
  *
16605
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
16606
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
16644
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
16607
16645
  */
16608
16646
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
16609
16647
  /**
@@ -16978,6 +17016,7 @@ declare class PoMultiselectComponent extends PoMultiselectBaseComponent implemen
16978
17016
  iconElement: ElementRef;
16979
17017
  inputElement: ElementRef;
16980
17018
  outerContainer: ElementRef;
17019
+ helperEl?: PoHelperComponent;
16981
17020
  literalsTag: any;
16982
17021
  dropdownIcon: string;
16983
17022
  dropdownOpen: boolean;
@@ -16986,7 +17025,6 @@ declare class PoMultiselectComponent extends PoMultiselectBaseComponent implemen
16986
17025
  timeoutResize: any;
16987
17026
  visibleElement: boolean;
16988
17027
  containerWidth: number;
16989
- helperSettings: PoHelperOptions;
16990
17028
  private subscription;
16991
17029
  private enterCloseTag;
16992
17030
  private initCalculateItems;
@@ -17038,20 +17076,12 @@ declare class PoMultiselectComponent extends PoMultiselectBaseComponent implemen
17038
17076
  focusOnFirstItem(): void;
17039
17077
  closeTag(value: any, event: any): void;
17040
17078
  /**
17041
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
17079
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
17042
17080
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
17043
17081
  *
17044
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
17082
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
17045
17083
  *
17046
17084
  * ```
17047
- * <po-multiselect
17048
- * #multiselect
17049
- * ...
17050
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
17051
- * (p-keydown)="onKeyDown($event, multiselect)"
17052
- * ></po-multiselect>
17053
- * ```
17054
- * ```
17055
17085
  * // Exemplo com p-label e p-helper
17056
17086
  * <po-multiselect
17057
17087
  * #multiselect
@@ -17146,7 +17176,7 @@ declare abstract class PoNumberBaseComponent extends PoInputGeneric {
17146
17176
  * <file name="sample-po-number-calculate/sample-po-number-calculate.component.ts"> </file>
17147
17177
  * </example>
17148
17178
  */
17149
- declare class PoNumberComponent extends PoNumberBaseComponent implements AfterViewInit {
17179
+ declare class PoNumberComponent extends PoNumberBaseComponent implements AfterViewInit, OnChanges {
17150
17180
  /**
17151
17181
  * @optional
17152
17182
  *
@@ -17173,6 +17203,7 @@ declare class PoNumberComponent extends PoNumberBaseComponent implements AfterVi
17173
17203
  constructor();
17174
17204
  onWheel(event: Event): void;
17175
17205
  ngAfterViewInit(): void;
17206
+ ngOnChanges(changes: SimpleChanges): void;
17176
17207
  extraValidation(abstractControl: AbstractControl): {
17177
17208
  [key: string]: any;
17178
17209
  };
@@ -17205,7 +17236,7 @@ declare class PoNumberComponent extends PoNumberBaseComponent implements AfterVi
17205
17236
  * <file name="sample-po-password-reset/sample-po-password-reset.component.ts"> </file>
17206
17237
  * </example>
17207
17238
  */
17208
- declare class PoPasswordComponent extends PoInputGeneric {
17239
+ declare class PoPasswordComponent extends PoInputGeneric implements OnChanges {
17209
17240
  id: string;
17210
17241
  type: string;
17211
17242
  visiblePassword: boolean;
@@ -17226,6 +17257,7 @@ declare class PoPasswordComponent extends PoInputGeneric {
17226
17257
  get hidePasswordPeek(): boolean;
17227
17258
  get autocomplete(): string;
17228
17259
  constructor();
17260
+ ngOnChanges(changes: SimpleChanges): void;
17229
17261
  extraValidation(c: AbstractControl): {
17230
17262
  [key: string]: any;
17231
17263
  };
@@ -17307,8 +17339,7 @@ declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor
17307
17339
  * @optional
17308
17340
  *
17309
17341
  * @description
17310
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
17311
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
17342
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
17312
17343
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
17313
17344
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
17314
17345
  *
@@ -17320,11 +17351,11 @@ declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor
17320
17351
  *
17321
17352
  * @description
17322
17353
  *
17323
- * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
17354
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
17324
17355
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
17325
17356
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
17326
17357
  *
17327
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
17358
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
17328
17359
  *
17329
17360
  * @default `false`
17330
17361
  */
@@ -17388,10 +17419,10 @@ declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor
17388
17419
  *
17389
17420
  * @description
17390
17421
  *
17391
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
17422
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
17423
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
17392
17424
  *
17393
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
17394
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
17425
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
17395
17426
  */
17396
17427
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
17397
17428
  /**
@@ -17416,7 +17447,6 @@ declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor
17416
17447
  *
17417
17448
  * @description
17418
17449
  * Evento disparado ao clicar no ícone de ajuda adicional.
17419
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
17420
17450
  *
17421
17451
  * > 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.
17422
17452
  */
@@ -17562,7 +17592,7 @@ declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor
17562
17592
  * </example>
17563
17593
  *
17564
17594
  */
17565
- declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements AfterViewInit, DoCheck {
17595
+ declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements AfterViewInit, DoCheck, OnChanges {
17566
17596
  private el;
17567
17597
  private cd;
17568
17598
  /** Label do campo. */
@@ -17571,10 +17601,12 @@ declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements
17571
17601
  help?: string;
17572
17602
  inputEl: ElementRef;
17573
17603
  radioLabels: QueryList<PoRadioComponent>;
17604
+ helperEl?: PoHelperComponent;
17574
17605
  differ: any;
17575
17606
  constructor();
17576
17607
  ngAfterViewInit(): void;
17577
17608
  ngDoCheck(): void;
17609
+ ngOnChanges(changes: SimpleChanges): void;
17578
17610
  emitAdditionalHelp(): void;
17579
17611
  eventClick(value: any, disabled: any): void;
17580
17612
  /**
@@ -17604,20 +17636,12 @@ declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements
17604
17636
  onKeyUp(event: KeyboardEvent, value: any): void;
17605
17637
  /**
17606
17638
  *
17607
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
17639
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
17608
17640
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
17609
17641
  *
17610
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
17642
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
17611
17643
  *
17612
17644
  * ```
17613
- * <po-radio-group
17614
- * #radioGroup
17615
- * ...
17616
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
17617
- * (p-keydown)="onKeyDown($event, radioGroup)"
17618
- * ></po-radio-group>
17619
- * ```
17620
- * ```
17621
17645
  * // Exemplo com p-label e p-helper
17622
17646
  * <po-radio-group
17623
17647
  * #radioGroup
@@ -17710,8 +17734,7 @@ declare abstract class PoRichTextBaseComponent implements ControlValueAccessor,
17710
17734
  * @optional
17711
17735
  *
17712
17736
  * @description
17713
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
17714
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
17737
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
17715
17738
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
17716
17739
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
17717
17740
  *
@@ -17723,11 +17746,11 @@ declare abstract class PoRichTextBaseComponent implements ControlValueAccessor,
17723
17746
  *
17724
17747
  * @description
17725
17748
  *
17726
- * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
17749
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
17727
17750
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
17728
17751
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
17729
17752
  *
17730
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
17753
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
17731
17754
  *
17732
17755
  * @default `false`
17733
17756
  */
@@ -17836,10 +17859,10 @@ declare abstract class PoRichTextBaseComponent implements ControlValueAccessor,
17836
17859
  *
17837
17860
  * @description
17838
17861
  *
17839
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
17862
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
17863
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
17840
17864
  *
17841
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
17842
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
17865
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
17843
17866
  */
17844
17867
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
17845
17868
  /**
@@ -17864,7 +17887,6 @@ declare abstract class PoRichTextBaseComponent implements ControlValueAccessor,
17864
17887
  *
17865
17888
  * @description
17866
17889
  * Evento disparado ao clicar no ícone de ajuda adicional.
17867
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
17868
17890
  *
17869
17891
  * > 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.
17870
17892
  */
@@ -17996,12 +18018,11 @@ declare class PoRichTextBodyComponent implements OnInit, OnDestroy {
17996
18018
  modelValue?: string;
17997
18019
  placeholder?: string;
17998
18020
  readonly?: string;
17999
- /** Tamanho do fonte */
18000
- size?: string;
18001
18021
  change: EventEmitter<any>;
18002
18022
  commands: EventEmitter<any>;
18003
18023
  keydown: EventEmitter<KeyboardEvent>;
18004
18024
  selectedLink: EventEmitter<any>;
18025
+ size: string;
18005
18026
  shortcutCommand: EventEmitter<any>;
18006
18027
  value: EventEmitter<any>;
18007
18028
  blur: EventEmitter<any>;
@@ -18718,8 +18739,7 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18718
18739
  * @optional
18719
18740
  *
18720
18741
  * @description
18721
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
18722
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
18742
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
18723
18743
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
18724
18744
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
18725
18745
  *
@@ -18731,11 +18751,11 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18731
18751
  *
18732
18752
  * @description
18733
18753
  *
18734
- * Define que o tooltip (`p-additional-help-tooltip`) será incluído no body da página e não dentro do componente. Essa
18754
+ * Define que o popover (`p-helper`) será incluído no body da página e não dentro do componente. Essa
18735
18755
  * opção pode ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o
18736
18756
  * posicionamento correto do tooltip próximo ao elemento.
18737
18757
  *
18738
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
18758
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
18739
18759
  *
18740
18760
  * @default `false`
18741
18761
  */
@@ -18848,10 +18868,10 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18848
18868
  *
18849
18869
  * @description
18850
18870
  *
18851
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
18871
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
18872
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
18852
18873
  *
18853
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
18854
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
18874
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
18855
18875
  */
18856
18876
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
18857
18877
  /**
@@ -18876,7 +18896,6 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18876
18896
  *
18877
18897
  * @description
18878
18898
  * Evento disparado ao clicar no ícone de ajuda adicional.
18879
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
18880
18899
  *
18881
18900
  * > 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.
18882
18901
  */
@@ -19352,6 +19371,7 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
19352
19371
  private poUploadDragDropComponent;
19353
19372
  uploadButton: PoButtonComponent;
19354
19373
  modalComponent: PoModalComponent;
19374
+ helperEl?: PoHelperComponent;
19355
19375
  id: string;
19356
19376
  infoByUploadStatus: {
19357
19377
  [key: string]: {
@@ -19406,7 +19426,6 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
19406
19426
  getAdditionalHelpTooltip(): string;
19407
19427
  hasAnyFileUploading(files: Array<PoUploadFile>): boolean;
19408
19428
  isAllowCancelEvent(status: PoUploadStatus): status is PoUploadStatus.Uploading | PoUploadStatus.Error | PoUploadStatus.None;
19409
- onBlur(): void;
19410
19429
  onFileChange(event: any): void;
19411
19430
  onFileChangeDragDrop(files: any): void;
19412
19431
  onKeyDown(event: KeyboardEvent): void;
@@ -19423,18 +19442,11 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
19423
19442
  sendFiles(): void;
19424
19443
  setDirectoryAttribute(canHandleDirectory: boolean): void;
19425
19444
  /**
19426
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
19445
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
19427
19446
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
19428
19447
  *
19429
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
19430
- * ```
19431
- * <po-upload
19432
- * #upload
19433
- * ...
19434
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
19435
- * (p-keydown)="onKeyDown($event, upload)"
19436
- * ></po-upload>
19437
- * ```
19448
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
19449
+ *
19438
19450
  * ```
19439
19451
  * //Exemplo com p-label e p-helper
19440
19452
  * <po-upload
@@ -19659,6 +19671,7 @@ declare class PoRichTextComponent extends PoRichTextBaseComponent implements Aft
19659
19671
  private element;
19660
19672
  bodyElement: PoRichTextBodyComponent;
19661
19673
  richTextToolbar: PoRichTextToolbarComponent;
19674
+ helperEl?: PoHelperComponent;
19662
19675
  private listener;
19663
19676
  private modelLastUpdate;
19664
19677
  toolbarActions: Array<PoRichTextToolbarActions>;
@@ -19690,20 +19703,12 @@ declare class PoRichTextComponent extends PoRichTextBaseComponent implements Aft
19690
19703
  onChangeValue(value: any): void;
19691
19704
  onKeyDown(event: KeyboardEvent): void;
19692
19705
  /**
19693
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
19706
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
19694
19707
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
19695
19708
  *
19696
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
19709
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
19697
19710
  *
19698
19711
  * ```
19699
- * <po-rich-text
19700
- * #richtext
19701
- * ...
19702
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
19703
- * (p-keydown)="onKeyDown($event, richtext)"
19704
- * ></po-rich-text>
19705
- * ```
19706
- * ```
19707
19712
  * // Exemplo com p-label e p-helper
19708
19713
  * <po-rich-text
19709
19714
  * #richtext
@@ -19914,6 +19919,7 @@ declare class PoSelectComponent extends PoFieldValidateModel<any> implements Aft
19914
19919
  renderer: Renderer2;
19915
19920
  private _iconToken;
19916
19921
  selectElement: ElementRef;
19922
+ helperEl?: PoHelperComponent;
19917
19923
  /**
19918
19924
  * @optional
19919
19925
  *
@@ -20050,10 +20056,10 @@ declare class PoSelectComponent extends PoFieldValidateModel<any> implements Aft
20050
20056
  *
20051
20057
  * @description
20052
20058
  *
20053
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
20059
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
20060
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
20054
20061
  *
20055
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
20056
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
20062
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
20057
20063
  */
20058
20064
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
20059
20065
  /**
@@ -20105,19 +20111,11 @@ declare class PoSelectComponent extends PoFieldValidateModel<any> implements Aft
20105
20111
  onKeyDown(event: KeyboardEvent): void;
20106
20112
  registerOnTouched(fn: any): void;
20107
20113
  /**
20108
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
20114
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
20109
20115
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
20110
20116
  *
20111
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
20117
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
20112
20118
  *
20113
- * ```html
20114
- * <po-select
20115
- * #select
20116
- * ...
20117
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
20118
- * (p-keydown)="onKeyDown($event, select)"
20119
- * ></po-select>
20120
- * ```
20121
20119
  * ```
20122
20120
  * //Exemplo com p-label e p-helper
20123
20121
  * <po-select
@@ -20208,8 +20206,7 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20208
20206
  * @optional
20209
20207
  *
20210
20208
  * @description
20211
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
20212
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
20209
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
20213
20210
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
20214
20211
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
20215
20212
  *
@@ -20221,11 +20218,11 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20221
20218
  *
20222
20219
  * @description
20223
20220
  *
20224
- * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
20221
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
20225
20222
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
20226
20223
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
20227
20224
  *
20228
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
20225
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
20229
20226
  *
20230
20227
  * @default `false`
20231
20228
  */
@@ -20293,10 +20290,10 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20293
20290
  *
20294
20291
  * @description
20295
20292
  *
20296
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
20293
+ * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label quando a propriedade `p-label` for definida, ou, ao lado do componente na ausência da propriedade `p-label`.
20294
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
20297
20295
  *
20298
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
20299
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
20296
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
20300
20297
  */
20301
20298
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
20302
20299
  /**
@@ -20321,7 +20318,6 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20321
20318
  *
20322
20319
  * @description
20323
20320
  * Evento disparado ao clicar no ícone de ajuda adicional.
20324
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
20325
20321
  *
20326
20322
  * > 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.
20327
20323
  */
@@ -20514,9 +20510,10 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20514
20510
  * </example>
20515
20511
  *
20516
20512
  */
20517
- declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit {
20513
+ declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit, OnChanges {
20518
20514
  private el;
20519
20515
  inputEl: ElementRef;
20516
+ helperEl?: PoHelperComponent;
20520
20517
  id: string;
20521
20518
  valueBeforeChange: any;
20522
20519
  fireChange: boolean;
@@ -20541,6 +20538,7 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
20541
20538
  */
20542
20539
  focus(): void;
20543
20540
  ngAfterViewInit(): void;
20541
+ ngOnChanges(changes: SimpleChanges): void;
20544
20542
  getAdditionalHelpTooltip(): string;
20545
20543
  getErrorPattern(): string;
20546
20544
  hasInvalidClass(): boolean;
@@ -20552,20 +20550,12 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
20552
20550
  controlChangeEmitter(): void;
20553
20551
  onKeyDown(event: KeyboardEvent): void;
20554
20552
  /**
20555
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
20553
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
20556
20554
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
20557
20555
  *
20558
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
20556
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
20559
20557
  *
20560
20558
  * ```
20561
- * <po-textarea
20562
- * #textarea
20563
- * ...
20564
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
20565
- * (p-keydown)="onKeyDown($event, textarea)"
20566
- * ></po-textarea>
20567
- * ```
20568
- * ```
20569
20559
  * //Exemplo com p-label e p-helper
20570
20560
  * <po-textarea
20571
20561
  * #textarea
@@ -20620,7 +20610,7 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
20620
20610
  * </example>
20621
20611
  *
20622
20612
  */
20623
- declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy {
20613
+ declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnChanges {
20624
20614
  id: string;
20625
20615
  icon: string;
20626
20616
  type: string;
@@ -20630,6 +20620,7 @@ declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, On
20630
20620
  constructor();
20631
20621
  ngAfterViewInit(): void;
20632
20622
  ngOnDestroy(): void;
20623
+ ngOnChanges(changes: SimpleChanges): void;
20633
20624
  extraValidation(c: AbstractControl): {
20634
20625
  [key: string]: any;
20635
20626
  };
@@ -20644,7 +20635,7 @@ declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, On
20644
20635
  */
20645
20636
  declare class PoDatepickerModule {
20646
20637
  static ɵfac: i0.ɵɵFactoryDeclaration<PoDatepickerModule, never>;
20647
- static ɵmod: i0.ɵɵNgModuleDeclaration<PoDatepickerModule, [typeof PoDatepickerComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof i3.OverlayModule, typeof PoCleanModule, typeof PoCalendarModule, typeof PoButtonModule], [typeof PoDatepickerComponent]>;
20638
+ static ɵmod: i0.ɵɵNgModuleDeclaration<PoDatepickerModule, [typeof PoDatepickerComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof i3.OverlayModule, typeof PoCleanModule, typeof PoCalendarModule, typeof PoButtonModule, typeof PoHelperModule], [typeof PoDatepickerComponent]>;
20648
20639
  static ɵinj: i0.ɵɵInjectorDeclaration<PoDatepickerModule>;
20649
20640
  }
20650
20641
 
@@ -20655,7 +20646,7 @@ declare class PoDatepickerModule {
20655
20646
  */
20656
20647
  declare class PoRadioGroupModule {
20657
20648
  static ɵfac: i0.ɵɵFactoryDeclaration<PoRadioGroupModule, never>;
20658
- static ɵmod: i0.ɵɵNgModuleDeclaration<PoRadioGroupModule, [typeof PoRadioGroupComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof PoRadioModule], [typeof PoRadioGroupComponent]>;
20649
+ static ɵmod: i0.ɵɵNgModuleDeclaration<PoRadioGroupModule, [typeof PoRadioGroupComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof PoRadioModule, typeof PoHelperModule], [typeof PoRadioGroupComponent]>;
20659
20650
  static ɵinj: i0.ɵɵInjectorDeclaration<PoRadioGroupModule>;
20660
20651
  }
20661
20652
 
@@ -21092,7 +21083,7 @@ declare class PoMediaQueryModule {
21092
21083
  }
21093
21084
 
21094
21085
  /**
21095
- * Módulo responsável por fornecer serviços relacionados ao tema PO.
21086
+ * Módulo do serviço PoThemeService.
21096
21087
  */
21097
21088
  declare class PoThemeModule {
21098
21089
  static ɵfac: i0.ɵɵFactoryDeclaration<PoThemeModule, never>;
@@ -21371,21 +21362,23 @@ interface PoDynamicField {
21371
21362
  interface PoDynamicFormField extends PoDynamicField {
21372
21363
  /**
21373
21364
  * Evento disparado ao clicar no ícone de ajuda adicional.
21374
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
21365
+ *
21366
+ * > 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.
21375
21367
  */
21376
21368
  additionalHelp?: Function;
21377
21369
  /**
21378
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
21379
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
21370
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
21380
21371
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
21372
+ *
21373
+ * > 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.
21381
21374
  */
21382
21375
  additionalHelpTooltip?: string;
21383
21376
  /**
21384
- * Define que o `listbox` e/ou tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) serão incluídos no body da
21377
+ * Define que o `listbox` e/ou popover (`p-helper` e/ou `p-error-limit`) serão incluídos no body da
21385
21378
  * página e não dentro do componente. Essa opção é necessária para cenários com containers que possuem scroll ou
21386
21379
  * overflow escondido, garantindo o posicionamento correto de ambos próximo ao elemento.
21387
21380
  *
21388
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
21381
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
21389
21382
  */
21390
21383
  appendBox?: boolean;
21391
21384
  /**
@@ -21506,6 +21499,8 @@ interface PoDynamicFormField extends PoDynamicField {
21506
21499
  disabled?: boolean;
21507
21500
  /** Texto de ajuda. */
21508
21501
  help?: string;
21502
+ /** Texto simples que será apresentado como auxílio ao campo ou objeto com as definições do po-helper. */
21503
+ helper?: string | PoHelperOptions;
21509
21504
  /** Texto exibido quando o valor do componente for *true*. */
21510
21505
  booleanTrue?: string;
21511
21506
  /** Texto exibido quando o valor do componente for *false*. */
@@ -22520,7 +22515,7 @@ declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent implemen
22520
22515
  getObjectValue(): Observable<any>;
22521
22516
  sendObjectValue(objectValue: any): void;
22522
22517
  /**
22523
- * Método que exibe `additionalHelpTooltip` ou executa a ação definida em `additionalHelp`.
22518
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
22524
22519
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `keydown`.
22525
22520
  *
22526
22521
  * ```
@@ -22533,7 +22528,7 @@ declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent implemen
22533
22528
  * property: 'name',
22534
22529
  * ...
22535
22530
  * help: 'Mensagem de ajuda.',
22536
- * additionalHelpTooltip: 'Mensagem de ajuda complementar.',
22531
+ * helper: 'Mensagem de ajuda complementar com o componente po-helper implementado.',
22537
22532
  * keydown: this.onKeyDown.bind(this, 'name')
22538
22533
  * },
22539
22534
  * ]
@@ -23012,9 +23007,24 @@ declare class PoDynamicViewBaseComponent extends PoDynamicSharedBase {
23012
23007
  */
23013
23008
  load: string | Function;
23014
23009
  service: any;
23010
+ private _componentsSize?;
23015
23011
  private _fields;
23016
23012
  private _showAllValue;
23017
23013
  private _value;
23014
+ /**
23015
+ * @optional
23016
+ *
23017
+ * @description
23018
+ *
23019
+ * Define o tamanho dos componentes no template entre `small` ou `medium`.
23020
+ *
23021
+ * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido.
23022
+ * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme).
23023
+ *
23024
+ * @default `medium`
23025
+ */
23026
+ set componentsSize(value: string);
23027
+ get componentsSize(): string;
23018
23028
  /**
23019
23029
  * @optional
23020
23030
  *
@@ -23144,7 +23154,7 @@ declare class PoDynamicViewBaseComponent extends PoDynamicSharedBase {
23144
23154
  private transformValue;
23145
23155
  private formatField;
23146
23156
  static ɵfac: i0.ɵɵFactoryDeclaration<PoDynamicViewBaseComponent, never>;
23147
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoDynamicViewBaseComponent, never, never, { "load": { "alias": "p-load"; "required": false; }; "fields": { "alias": "p-fields"; "required": false; }; "showAllValue": { "alias": "p-show-all-value"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; }, {}, never, never, true, never>;
23157
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoDynamicViewBaseComponent, never, never, { "load": { "alias": "p-load"; "required": false; }; "componentsSize": { "alias": "p-components-size"; "required": false; }; "fields": { "alias": "p-fields"; "required": false; }; "showAllValue": { "alias": "p-show-all-value"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; }, {}, never, never, true, never>;
23148
23158
  }
23149
23159
 
23150
23160
  /**
@@ -23227,6 +23237,7 @@ declare class PoInfoBaseComponent {
23227
23237
  readonly poInfoOrientation: typeof PoInfoOrientation;
23228
23238
  private _labelSize;
23229
23239
  private _orientation;
23240
+ private _size?;
23230
23241
  /**
23231
23242
  * @optional
23232
23243
  *
@@ -23255,8 +23266,22 @@ declare class PoInfoBaseComponent {
23255
23266
  */
23256
23267
  set orientation(value: PoInfoOrientation);
23257
23268
  get orientation(): PoInfoOrientation;
23269
+ /**
23270
+ * @optional
23271
+ *
23272
+ * @description
23273
+ *
23274
+ * Define o tamanho do componente entre `small` ou `medium`.
23275
+ *
23276
+ * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido.
23277
+ * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme).
23278
+ *
23279
+ * @default `medium`
23280
+ */
23281
+ set size(value: string);
23282
+ get size(): string;
23258
23283
  static ɵfac: i0.ɵɵFactoryDeclaration<PoInfoBaseComponent, never>;
23259
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoInfoBaseComponent, never, never, { "label": { "alias": "p-label"; "required": false; }; "url": { "alias": "p-url"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; "labelSize": { "alias": "p-label-size"; "required": false; }; "orientation": { "alias": "p-orientation"; "required": false; }; }, {}, never, never, true, never>;
23284
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoInfoBaseComponent, never, never, { "label": { "alias": "p-label"; "required": false; }; "url": { "alias": "p-url"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; "labelSize": { "alias": "p-label-size"; "required": false; }; "orientation": { "alias": "p-orientation"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, {}, never, never, true, never>;
23260
23285
  }
23261
23286
 
23262
23287
  /**
@@ -26221,14 +26246,15 @@ interface PoPageDefaultLiterals {
26221
26246
  *
26222
26247
  * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
26223
26248
  *
26224
- * | Propriedade | Descrição | Valor Padrão |
26225
- * |----------------------------------------|-------------------------------------------------------|-------------------------------------------------|
26226
- * | **Default Values** | | |
26227
- * | `--padding` | Espaçamento do componente | `var(--spacing-xs) var(--spacing-md)` |
26228
- * | `--gap` | Gap entre o header e o conteúdo | `var(--spacing-md)` |
26229
- * | `--padding-top-header` | Espaçamento do topo do header | `var(--color-neutral-light-30)` |
26230
- * | `--gap-actions` | Gap entre os botões de action | `var(--spacing-xs)` |
26231
- * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
26249
+ * | Propriedade | Descrição | Valor Padrão |
26250
+ * |---------------------|---------------------------------------------|---------------------------------------|
26251
+ * | **Header** | | |
26252
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
26253
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
26254
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
26255
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
26256
+ * | **Content** | | |
26257
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
26232
26258
  */
26233
26259
  declare abstract class PoPageDefaultBaseComponent {
26234
26260
  poPageContent: PoPageContentComponent;
@@ -26384,6 +26410,20 @@ interface PoPageDetailLiterals {
26384
26410
  *
26385
26411
  * O componente **po-page-detail** é utilizado como container principal para a tela de
26386
26412
  * detalhamento de um registro, tendo a possibilidade de usar as ações de "Voltar", "Editar" e "Remover".
26413
+ *
26414
+ * #### Tokens customizáveis
26415
+ *
26416
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
26417
+ *
26418
+ * | Propriedade | Descrição | Valor Padrão |
26419
+ * |---------------------|---------------------------------------------|---------------------------------------|
26420
+ * | **Header** | | |
26421
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
26422
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
26423
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
26424
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
26425
+ * | **Content** | | |
26426
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
26387
26427
  */
26388
26428
  declare class PoPageDetailBaseComponent {
26389
26429
  poPageContent: PoPageContentComponent;
@@ -26551,6 +26591,20 @@ interface PoPageEditLiterals {
26551
26591
  * Os botões "Salvar" e "Salvar e Novo" podem ser habilitados/desabilitados utilizando a propriedade `p-disable-submit`.
26552
26592
  * Esta propriedade pode ser utilizada para desabilitar os botões caso exista um formulário inválido na página ou alguma
26553
26593
  * regra de negócio não tenha sido atendida.
26594
+ *
26595
+ * #### Tokens customizáveis
26596
+ *
26597
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
26598
+ *
26599
+ * | Propriedade | Descrição | Valor Padrão |
26600
+ * |---------------------|---------------------------------------------|---------------------------------------|
26601
+ * | **Header** | | |
26602
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
26603
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
26604
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
26605
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
26606
+ * | **Content** | | |
26607
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
26554
26608
  */
26555
26609
  declare class PoPageEditBaseComponent {
26556
26610
  poPageContent: PoPageContentComponent;
@@ -26707,6 +26761,8 @@ declare class PoPageEditComponent extends PoPageEditBaseComponent {
26707
26761
  declare class PoPageHeaderBaseComponent {
26708
26762
  /** Título da página. */
26709
26763
  title: string;
26764
+ /** Define o tamanho dos componentes no header. */
26765
+ size: string;
26710
26766
  /** Subtítulo da página. */
26711
26767
  subtitle: string;
26712
26768
  private _breadcrumb;
@@ -26714,7 +26770,7 @@ declare class PoPageHeaderBaseComponent {
26714
26770
  set breadcrumb(value: PoBreadcrumb);
26715
26771
  get breadcrumb(): PoBreadcrumb;
26716
26772
  static ɵfac: i0.ɵɵFactoryDeclaration<PoPageHeaderBaseComponent, never>;
26717
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoPageHeaderBaseComponent, never, never, { "title": { "alias": "p-title"; "required": false; }; "subtitle": { "alias": "p-subtitle"; "required": false; }; "breadcrumb": { "alias": "p-breadcrumb"; "required": false; }; }, {}, never, never, true, never>;
26773
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoPageHeaderBaseComponent, never, never, { "title": { "alias": "p-title"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "subtitle": { "alias": "p-subtitle"; "required": false; }; "breadcrumb": { "alias": "p-breadcrumb"; "required": false; }; }, {}, never, never, true, never>;
26718
26774
  }
26719
26775
 
26720
26776
  /**
@@ -26726,6 +26782,21 @@ declare class PoPageHeaderComponent extends PoPageHeaderBaseComponent {
26726
26782
  static ɵcmp: i0.ɵɵComponentDeclaration<PoPageHeaderComponent, "po-page-header", never, {}, {}, never, ["*"], false, never>;
26727
26783
  }
26728
26784
 
26785
+ /**
26786
+ * @docsPrivate
26787
+ *
26788
+ * @description
26789
+ *
26790
+ * Define o nível de densidade (espaçamento) aplicado em componentes agrupadores. Pode ser ajustado conforme a
26791
+ * preferência do usuário ou requisitos de acessibilidade.
26792
+ */
26793
+ declare enum PoDensityMode {
26794
+ /** Define espaçamentos mais compactos entre os elementos. */
26795
+ Small = "small",
26796
+ /** Define espaçamentos mais amplos e confortáveis. */
26797
+ Medium = "medium"
26798
+ }
26799
+
26729
26800
  /**
26730
26801
  * @usedBy PoThemeService
26731
26802
  *
@@ -27306,11 +27377,20 @@ interface PoThemeActive {
27306
27377
  /**
27307
27378
  * @description
27308
27379
  *
27309
- * O `PoThemeService` possibilita a personalização das cores do tema padrão do `PO-UI`, permitindo a alteração dos valores das variáveis de estilo usadas no CSS padrão.
27380
+ * O serviço `PoThemeService` permite customizar as cores do tema padrão do `PO-UI` e definir o nível de acessibilidade
27381
+ * mais adequado ao projeto.
27382
+ *
27383
+ * O nível **AAA** (padrão) garante maior contraste, áreas clicáveis amplas e espaçamentos maiores entre os elementos,
27384
+ * enquanto o nível **AA** mantém a conformidade com as diretrizes de acessibilidade, mas com proporções mais equilibradas
27385
+ * e contornos mais sutis.
27310
27386
  *
27311
- * > Para saber mais sobre como customizar o tema padrão verifique o item [Customização de Temas usando o serviço PO-UI](guides/theme-service) na aba `Guias`.
27387
+ * O serviço também possibilita configurar a **densidade de espaçamentos**, permitindo ajustar o espaço entre e dentro dos
27388
+ * componentes. Essa configuração pode ser utilizada com qualquer nível de acessibilidade.
27312
27389
  *
27313
- * > Obs.: Não está documentado aqui e não indicamos a customização das cores de 'feedback' por motivos de acessibilidade e usabilidade.
27390
+ * > Observação: a customização das cores de `feedback` não é recomendada por motivos de acessibilidade e usabilidade.
27391
+ *
27392
+ * > Para saber mais sobre como customizar o tema padrão, consulte o item
27393
+ * [Customização de Temas usando o serviço PO-UI](guides/theme-service) na aba `Guias`.
27314
27394
  */
27315
27395
  /**
27316
27396
  * @example
@@ -27339,7 +27419,8 @@ declare class PoThemeService {
27339
27419
  * @param {PoTheme} themeConfig - Configuração de tema a ser aplicada ao componente.
27340
27420
  * @param {PoThemeTypeEnum} [themeType=PoThemeTypeEnum.light] - (Opcional) Tipo de tema, podendo ser 'light' (claro) ou 'dark' (escuro). O tema claro é o padrão.
27341
27421
  * @param {PoThemeA11yEnum} [a11yLevel=PoThemeA11yEnum.AAA] - (Opcional) Nível de acessibilidade dos componentes, podendo ser AA ou AAA. Padrão é AAA.
27342
- * @param {boolean} [persistPreference=true] - (Opcional) Define se a preferência de tema deve ser salva no localStorage para persistência. `true` para salvar, `false` para não salvar.
27422
+ * @param {boolean} [persistPreference=true] - (Opcional) Define se a preferência de tema deve ser salva no
27423
+ * localStorage para persistência. Por padrão é `true`, ou seja, a preferência será salva automaticamente.
27343
27424
  */
27344
27425
  setTheme(themeConfig: PoTheme, themeType?: PoThemeTypeEnum, a11yLevel?: PoThemeA11yEnum, persistPreference?: boolean): void;
27345
27426
  private setDataDefaultSizeHTML;
@@ -27350,18 +27431,35 @@ declare class PoThemeService {
27350
27431
  */
27351
27432
  getA11yLevel(): PoThemeA11yEnum;
27352
27433
  /**
27353
- * Define o tamanho `small` como padrão para componentes de formulário que não possuem um tamanho definido.
27354
- * Essa configuração é aplicada globalmente apenas quando o nível de acessibilidade for `AA`.
27355
- * Caso contrário, o tamanho padrão será `medium`.
27434
+ * Define o tamanho `small` como padrão para componentes de formulário que não possuem um tamanho definido. Essa
27435
+ * configuração é aplicada globalmente apenas quando o nível de acessibilidade for `AA`. O valor definido é salvo no
27436
+ * `localStorage` sob a chave `po-default-size`.
27356
27437
  *
27357
27438
  * > Para garantir que o tamanho `small` seja aplicado corretamente a todos os componentes, recomendamos
27358
27439
  * definir esta configuração **junto com o nível de acessibilidade `AA` na inicialização da aplicação**.
27359
27440
  * Se for aplicada em tempo de execução, será necessário recarregar a aplicação (`reload`)
27360
27441
  * para que os estilos sejam aplicados corretamente.
27442
+ * > Para ajustar a densidade visual dos componentes agrupadores (como pages, container, etc.), utilize também
27443
+ * o método `setDensityMode` conforme necessário.
27361
27444
  *
27362
27445
  * @param {boolean} enable Habilita ou desabilita o tamanho `small` globalmente.
27363
27446
  */
27364
27447
  setA11yDefaultSizeSmall(enable: boolean): boolean;
27448
+ /**
27449
+ * Retorna o modo de adensamento dos componentes agrupadores.
27450
+ * Se não estiver configurado, retorna `medium` como padrão.
27451
+ * @returns {PoDensityMode} O modo de adensamento, que pode ser `small` ou `medium`.
27452
+ */
27453
+ getDensityMode(): PoDensityMode;
27454
+ /**
27455
+ * Aplica o modo de adensamento compacto (`small`) ou espaçoso (`medium`) para os componentes agrupadores,
27456
+ * independentemente do nível de acessibilidade. O valor definido é salvo no `localStorage` sob a chave
27457
+ * `po-density-mode`.
27458
+ *
27459
+ * @param {'small' | 'medium'} mode Define o modo de densidade: `small` para compacto, `medium` para espaçoso.
27460
+ * O valor padrão é `medium`.
27461
+ */
27462
+ setDensityMode(mode: string): void;
27365
27463
  /**
27366
27464
  * @docsPrivate
27367
27465
  * Retorna a preferência global de tamanho dos componentes.
@@ -27443,11 +27541,10 @@ declare class PoThemeService {
27443
27541
  private applyThemeStyles;
27444
27542
  private changeThemeType;
27445
27543
  /**
27446
- * Persiste e define o tema do aplicativo com base nos dados armazenados.
27544
+ * Restaura e aplica as preferências visuais do usuário para o tema da aplicação, garantindo que essas preferências
27545
+ * sejam persistidas no `localStorage` para uso em recarregamentos futuros.
27447
27546
  *
27448
- * Este método recupera os dados do tema armazenados e os aplica ao aplicativo.
27449
- *
27450
- * @returns {PoTheme} Recupera o tema armazenado.
27547
+ * @returns {PoTheme} O tema atualmente aplicado.
27451
27548
  */
27452
27549
  persistThemeActive(): PoTheme;
27453
27550
  private formatTheme;
@@ -27469,6 +27566,7 @@ declare class PoThemeService {
27469
27566
  cleanThemeActive(persistPreference?: boolean): void;
27470
27567
  private getActiveTypeFromTheme;
27471
27568
  private getActiveA11yFromTheme;
27569
+ private isValidA11yLevel;
27472
27570
  /**
27473
27571
  * @docsPrivate
27474
27572
  *
@@ -27644,6 +27742,20 @@ interface PoPageListLiterals {
27644
27742
  *
27645
27743
  * Para facilitar a manipulação e visualização dos filtros aplicados, é possível também utilizar o componente
27646
27744
  * [`po-disclaimer-group`](/documentation/po-disclaimer-group).
27745
+ *
27746
+ * #### Tokens customizáveis
27747
+ *
27748
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
27749
+ *
27750
+ * | Propriedade | Descrição | Valor Padrão |
27751
+ * |---------------------|---------------------------------------------|---------------------------------------|
27752
+ * | **Header** | | |
27753
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
27754
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
27755
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
27756
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
27757
+ * | **Content** | | |
27758
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
27647
27759
  */
27648
27760
  declare abstract class PoPageListBaseComponent {
27649
27761
  poPageContent: PoPageContentComponent;