@po-ui/ng-components 20.5.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 (86) hide show
  1. package/fesm2022/po-ui-ng-components.mjs +3765 -2740
  2. package/fesm2022/po-ui-ng-components.mjs.map +1 -1
  3. package/index.d.ts +599 -326
  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 +18 -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/interfaces/po-upload-literals.interface.d.ts +14 -0
  46. package/lib/components/po-field/po-upload/po-upload-base.component.d.ts +118 -9
  47. package/lib/components/po-field/po-upload/po-upload-file.d.ts +6 -0
  48. package/lib/components/po-field/po-upload/po-upload.component.d.ts +33 -15
  49. package/lib/components/po-field/po-url/po-url.component.d.ts +3 -2
  50. package/lib/components/po-helper/po-helper-base.component.d.ts +11 -0
  51. package/lib/components/po-helper/po-helper.component.d.ts +1 -0
  52. package/lib/components/po-info/po-info-base.component.d.ts +15 -0
  53. package/lib/components/po-loading/po-loading-base.component.d.ts +7 -4
  54. package/lib/components/po-page/po-page-default/po-page-default-base.component.d.ts +9 -8
  55. package/lib/components/po-page/po-page-detail/po-page-detail-base.component.d.ts +14 -0
  56. package/lib/components/po-page/po-page-edit/po-page-edit-base.component.d.ts +14 -0
  57. package/lib/components/po-page/po-page-header/po-page-header-base.component.d.ts +2 -0
  58. package/lib/components/po-page/po-page-list/po-page-list-base.component.d.ts +14 -0
  59. package/lib/components/po-popover/po-popover-base.component.d.ts +12 -0
  60. package/lib/components/po-popover/po-popover.component.d.ts +11 -0
  61. package/lib/components/po-search/po-search-base.component.d.ts +16 -0
  62. package/lib/components/po-search/po-search.component.d.ts +1 -1
  63. package/lib/components/po-table/enums/po-table-spacing.enum.d.ts +1 -1
  64. package/lib/components/po-tag/po-tag-base.component.d.ts +1 -0
  65. package/lib/enums/po-density-mode.enum.d.ts +14 -0
  66. package/lib/enums/po-field-size.enum.d.ts +5 -3
  67. package/lib/services/po-theme/helpers/accessibilities/po-theme-density.constant.d.ts +12 -0
  68. package/lib/services/po-theme/po-theme.module.d.ts +1 -1
  69. package/lib/services/po-theme/po-theme.service.d.ts +39 -11
  70. package/lib/utils/util.d.ts +9 -2
  71. package/package.json +4 -4
  72. package/po-ui-ng-components-20.7.0.tgz +0 -0
  73. package/schematics/ng-add/index.js +1 -1
  74. package/schematics/ng-update/v14/index.js +1 -1
  75. package/schematics/ng-update/v15/index.js +1 -1
  76. package/schematics/ng-update/v16/index.js +1 -1
  77. package/schematics/ng-update/v17/index.js +1 -1
  78. package/schematics/ng-update/v18/index.js +2 -2
  79. package/schematics/ng-update/v19/index.js +2 -2
  80. package/schematics/ng-update/v2/index.js +1 -1
  81. package/schematics/ng-update/v20/index.js +2 -2
  82. package/schematics/ng-update/v3/index.js +1 -1
  83. package/schematics/ng-update/v4/index.js +1 -1
  84. package/schematics/ng-update/v5/index.js +1 -1
  85. package/schematics/ng-update/v6/index.js +1 -1
  86. package/po-ui-ng-components-20.5.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>;
@@ -18576,6 +18597,20 @@ interface PoUploadLiterals {
18576
18597
  errorOccurred?: string;
18577
18598
  /** Texto a ser exibido quando o envio do arquivo for realizado com sucesso. */
18578
18599
  sentWithSuccess?: string;
18600
+ /** Texto a ser exibido no container de informação quando o estado for de sucesso. */
18601
+ doneText?: string;
18602
+ /** Texto a ser exibido no container de informação quando o estado for enviando. */
18603
+ uploadingText?: string;
18604
+ /** Texto de Tente novamente ao ocorrer erro ao enviar. */
18605
+ tryAgain?: string;
18606
+ /** Texto do leitor de tela ao focar no ícone de fechar. */
18607
+ close?: string;
18608
+ /** Título do modal de pré-visualizar. */
18609
+ preview?: string;
18610
+ /** Texto do leitor da miniatura da imagem. */
18611
+ thumbnail?: string;
18612
+ /** Texto do botão padrão do modal de pré-visualizar. */
18613
+ continue?: string;
18579
18614
  }
18580
18615
 
18581
18616
  declare enum PoUploadStatus {
@@ -18594,6 +18629,12 @@ declare class PoUploadFile {
18594
18629
  size: number;
18595
18630
  displayName?: string;
18596
18631
  percent?: number;
18632
+ sizeNotAllowed?: boolean;
18633
+ extensionNotAllowed?: boolean;
18634
+ hideDoneContent?: boolean;
18635
+ errorMessage?: string;
18636
+ thumbnailUrl?: string;
18637
+ imageError?: boolean;
18597
18638
  constructor(file: any);
18598
18639
  private getExtension;
18599
18640
  private generateUUID;
@@ -18648,6 +18689,44 @@ declare class PoUploadService extends PoUploadBaseService {
18648
18689
  * - Função de sucesso que será disparada quando os arquivos forem enviados com sucesso.
18649
18690
  * - Função de erro que será disparada quando houver erro no envio dos arquivos.
18650
18691
  * - Permite habilitar uma área onde os arquivos podem ser arrastados.
18692
+ *
18693
+ * #### Tokens customizáveis
18694
+ *
18695
+ * É possível alterar o estilo do componente usando os seguintes tokens (CSS):
18696
+ *
18697
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
18698
+ *
18699
+ * | Propriedade | Descrição | Valor Padrão |
18700
+ * |----------------------------------------|-------------------------------------------------------|---------------------------------------------------|
18701
+ * | **TEXT SUPPORT** | | |
18702
+ * | `--font-family-text-support` | Família tipográfica usada no texto de suporte | `var(--font-family-theme)` |
18703
+ * | `--text-color-text-support` | Cor da fonte no texto de suporte | `var(--color-neutral-dark-90)` |
18704
+ * | **UPLOAD CONTENT** | | |
18705
+ * | `--background-color-content` &nbsp; | Cor de fundo | `var(--color-neutral-light-10)` |
18706
+ * | `--border-color-content` | Cor da borda | `var(--color-neutral-light-20)` |
18707
+ * | `--border-radius-content` | Contém o valor do raio dos cantos do elemento | `var(--border-radius-md)` |
18708
+ * | `--text-color-file-name` | Cor do texto do nome do arquivo | `var(--color-neutral-dark-90)` |
18709
+ * | `--font-family-file-name` | Família tipográfica usada no texto do arquivo | `var(--font-family-theme)` |
18710
+ * | `--text-color-info-bar` | Cor do texto de informação | `var(--color-neutral-mid-60)` |
18711
+ * | `--font-family-info-bar` | Família tipográfica usada no texto de informação | `var(--font-family-theme)` |
18712
+ * | **ERROR STATE** | | |
18713
+ * | `--background-color-content-error` | Cor de fundo do container de erro | `var(--color-neutral-light-00)` |
18714
+ * | `--border-color-content-error` | Cor da borda do container de erro | `var(--color-feedback-negative-base)` |
18715
+ * | `--text-color-error` | Cor do texto do container de erro | `var(--color-feedback-negative-dark)` |
18716
+ * | `--color-icon-error` | Cor do ícone no estado de erro | `var(--color-feedback-negative-base)` |
18717
+ * | `--font-family-error` | Família tipográfica usada no texto de erro | `var(--font-family-theme)` |
18718
+ * | **UPLOADED STATE** | | |
18719
+ * | `--background-color-content-uploaded` | Cor de fundo do container com status de enviado | `var(--color-neutral-light-00)` |
18720
+ * | `--border-color-content-uploaded` | Cor da borda do container com status de enviado | `var(--color-neutral-light-20)` |
18721
+ * | **INTERACTIVE STATE** | | |
18722
+ * | `--text-color-file-name-interactive` | Cor do texto do nome do arquivo quando interativo | `var(--color-action-default)` |
18723
+ * | **THUMBNAIL** | | |
18724
+ * | `--color-icon-thumbnail` | Cor do ícone na thumbnail | `var(--color-action-default)` |
18725
+ * | `--border-width-thumbnail` | Tamanho da fonte na thumbnail | `var(--border-width-sm)` |
18726
+ * | `--border-radius-thumbnail` | Contém o valor do raio dos cantos na thumbnail | `var(--border-radius-md)` |
18727
+ * | `--background-color-thumbnail` | Cor de fundo na thumbnail | `var(--color-neutral-light-05)` |
18728
+ * | **Focused** | | |
18729
+ * | `--outline-color-focused` | Cor do outline do estado de focus | `var(--color-action-focus)` |
18651
18730
  */
18652
18731
  declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Validator {
18653
18732
  protected uploadService: PoUploadService;
@@ -18660,8 +18739,7 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18660
18739
  * @optional
18661
18740
  *
18662
18741
  * @description
18663
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
18664
- * 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`.
18665
18743
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
18666
18744
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
18667
18745
  *
@@ -18673,11 +18751,11 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18673
18751
  *
18674
18752
  * @description
18675
18753
  *
18676
- * 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
18677
18755
  * opção pode ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o
18678
18756
  * posicionamento correto do tooltip próximo ao elemento.
18679
18757
  *
18680
- * > 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.
18681
18759
  *
18682
18760
  * @default `false`
18683
18761
  */
@@ -18750,6 +18828,19 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18750
18828
  * @default `false`
18751
18829
  */
18752
18830
  optional: boolean;
18831
+ /**
18832
+ * @optional
18833
+ *
18834
+ * @description
18835
+ *
18836
+ * Exibe a pré-visualização de imagens ao anexá-las.
18837
+ *
18838
+ * > Propriedade funciona apenas em arquivos de formato de imagem (`.png`, `.jpg`, `.jpeg` e `.gif`).
18839
+ * Será ignorada em outros tipos de arquivo.
18840
+ *
18841
+ * @default `true`
18842
+ */
18843
+ showThumbnail: boolean;
18753
18844
  /** Objeto que contém os cabeçalhos que será enviado na requisição dos arquivos. */
18754
18845
  headers: {
18755
18846
  [name: string]: string | Array<string>;
@@ -18777,10 +18868,10 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18777
18868
  *
18778
18869
  * @description
18779
18870
  *
18780
- * 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.
18781
18873
  *
18782
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
18783
- * 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.
18784
18875
  */
18785
18876
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
18786
18877
  /**
@@ -18805,7 +18896,6 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18805
18896
  *
18806
18897
  * @description
18807
18898
  * Evento disparado ao clicar no ícone de ajuda adicional.
18808
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
18809
18899
  *
18810
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.
18811
18901
  */
@@ -18848,6 +18938,38 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18848
18938
  * ```
18849
18939
  */
18850
18940
  customAction?: PoProgressAction;
18941
+ /**
18942
+ * @optional
18943
+ *
18944
+ * @description
18945
+ *
18946
+ * Define uma ou duas ações personalizadas do modal de pré-visualização, adicionando um botão ou dois botões no canto inferior direito
18947
+ * do modal.
18948
+ *
18949
+ * A ação deve implementar a interface **PoModalAction**, permitindo configurar propriedades como:
18950
+ * - `label`: Texto do botão.
18951
+ * - `action`: Ícone a ser exibido no botão.
18952
+ * - `danger`: Define a propriedade `p-danger` do botão.
18953
+ * - `disabled`: Indica se o botão deve estar desabilitado.
18954
+ * - `visible`: Indica se o botão deve estar visível.
18955
+ *
18956
+ * **Exemplo de uso:**
18957
+ *
18958
+ * ```html
18959
+ * <po-upload
18960
+ * [p-custom-modal-actions]="customActions"
18961
+ * </po-upload>
18962
+ * ```
18963
+ *
18964
+ * ```typescript
18965
+ * customActions: Array<PoModalAction> = [
18966
+ * { label: 'Confirmar', action: this.confirmModal.bind(this) },
18967
+ * { label: 'Cancelar', action: this.closeModal.bind(this) }
18968
+ *];
18969
+ *
18970
+ * ```
18971
+ */
18972
+ customModalActions?: Array<PoModalAction>;
18851
18973
  /**
18852
18974
  * @optional
18853
18975
  *
@@ -18918,6 +19040,33 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18918
19040
  * ```
18919
19041
  */
18920
19042
  onUpload: EventEmitter<any>;
19043
+ /**
19044
+ * @optional
19045
+ *
19046
+ * @description
19047
+ *
19048
+ * Evento será disparado ao clicar no ícone de fechar.
19049
+ * > Por parâmetro será passado o objeto do arquivo.
19050
+ */
19051
+ onCancel: EventEmitter<any>;
19052
+ /**
19053
+ * @optional
19054
+ *
19055
+ * @description
19056
+ *
19057
+ * Evento será disparado ao abrir o modal de pré-visualização.
19058
+ * > Por parâmetro será passado o objeto do arquivo.
19059
+ */
19060
+ onOpenModalPreview: EventEmitter<any>;
19061
+ /**
19062
+ * @optional
19063
+ *
19064
+ * @description
19065
+ *
19066
+ * Evento será disparado ao clicar no ícone de remover.
19067
+ * > Por parâmetro será passado o objeto do arquivo.
19068
+ */
19069
+ onRemove: EventEmitter<any>;
18921
19070
  /**
18922
19071
  * @optional
18923
19072
  *
@@ -19169,10 +19318,10 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
19169
19318
  private setAllowedExtensions;
19170
19319
  private initRestrictions;
19171
19320
  private updateExistsFileInFiles;
19172
- abstract sendFeedback(): void;
19321
+ abstract sendFeedback(file?: any): void;
19173
19322
  abstract setDirectoryAttribute(value: boolean): any;
19174
19323
  static ɵfac: i0.ɵɵFactoryDeclaration<PoUploadBaseComponent, never>;
19175
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoUploadBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "dragDropHeight": { "alias": "p-drag-drop-height"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "url": { "alias": "p-url"; "required": false; }; "name": { "alias": "name"; "required": false; }; "autoUpload": { "alias": "p-auto-upload"; "required": false; }; "disabledRemoveFile": { "alias": "p-disabled-remove-file"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "headers": { "alias": "p-headers"; "required": false; }; "requiredUrl": { "alias": "p-required-url"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "customAction": { "alias": "p-custom-action"; "required": false; }; "directory": { "alias": "p-directory"; "required": false; }; "dragDrop": { "alias": "p-drag-drop"; "required": false; }; "hideRestrictionsInfo": { "alias": "p-hide-restrictions-info"; "required": false; }; "hideSelectButton": { "alias": "p-hide-select-button"; "required": false; }; "hideSendButton": { "alias": "p-hide-send-button"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "fileRestrictions": { "alias": "p-restrictions"; "required": false; }; "formField": { "alias": "p-form-field"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "isMultiple": { "alias": "p-multiple"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "customActionClick": "p-custom-action-click"; "keydown": "p-keydown"; "onUpload": "p-upload"; "onError": "p-error"; "onSuccess": "p-success"; "ngModelChange": "ngModelChange"; }, never, never, true, never>;
19324
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoUploadBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "dragDropHeight": { "alias": "p-drag-drop-height"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "url": { "alias": "p-url"; "required": false; }; "name": { "alias": "name"; "required": false; }; "autoUpload": { "alias": "p-auto-upload"; "required": false; }; "disabledRemoveFile": { "alias": "p-disabled-remove-file"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "showThumbnail": { "alias": "p-show-thumbnail"; "required": false; }; "headers": { "alias": "p-headers"; "required": false; }; "requiredUrl": { "alias": "p-required-url"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "customAction": { "alias": "p-custom-action"; "required": false; }; "customModalActions": { "alias": "p-custom-modal-actions"; "required": false; }; "directory": { "alias": "p-directory"; "required": false; }; "dragDrop": { "alias": "p-drag-drop"; "required": false; }; "hideRestrictionsInfo": { "alias": "p-hide-restrictions-info"; "required": false; }; "hideSelectButton": { "alias": "p-hide-select-button"; "required": false; }; "hideSendButton": { "alias": "p-hide-send-button"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "fileRestrictions": { "alias": "p-restrictions"; "required": false; }; "formField": { "alias": "p-form-field"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "isMultiple": { "alias": "p-multiple"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "customActionClick": "p-custom-action-click"; "keydown": "p-keydown"; "onUpload": "p-upload"; "onCancel": "p-cancel"; "onOpenModalPreview": "p-open-modal-preview"; "onRemove": "p-remove"; "onError": "p-error"; "onSuccess": "p-success"; "ngModelChange": "ngModelChange"; }, never, never, true, never>;
19176
19325
  static ngAcceptInputType_appendBox: any;
19177
19326
  static ngAcceptInputType_autoFocus: any;
19178
19327
  static ngAcceptInputType_disabledRemoveFile: any;
@@ -19208,14 +19357,21 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
19208
19357
  * <file name="sample-po-upload-download/sample-po-upload-download.component.html"> </file>
19209
19358
  * <file name="sample-po-upload-download/sample-po-upload-download.component.ts"> </file>
19210
19359
  * </example>
19360
+ *
19361
+ * <example name="po-upload-preview" title="PO Upload - with Preview">
19362
+ * <file name="sample-po-upload-preview/sample-po-upload-preview.component.html"> </file>
19363
+ * <file name="sample-po-upload-preview/sample-po-upload-preview.component.ts"> </file>
19364
+ * </example>
19211
19365
  */
19212
- declare class PoUploadComponent extends PoUploadBaseComponent implements AfterViewInit {
19366
+ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterViewInit, OnChanges {
19213
19367
  renderer: Renderer2;
19214
19368
  private i18nPipe;
19215
19369
  private notification;
19216
19370
  private inputFile;
19217
19371
  private poUploadDragDropComponent;
19218
19372
  uploadButton: PoButtonComponent;
19373
+ modalComponent: PoModalComponent;
19374
+ helperEl?: PoHelperComponent;
19219
19375
  id: string;
19220
19376
  infoByUploadStatus: {
19221
19377
  [key: string]: {
@@ -19228,6 +19384,12 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
19228
19384
  2: PoProgressStatus;
19229
19385
  };
19230
19386
  private calledByCleanInputValue;
19387
+ protected modalPrimaryAction: PoModalAction;
19388
+ protected modalSecondaryAction: PoModalAction;
19389
+ protected errorMessage: string;
19390
+ protected tooltipTitle: string;
19391
+ protected modalImageUrl: string;
19392
+ protected errorModalImage: boolean;
19231
19393
  constructor();
19232
19394
  get displayDragDrop(): boolean;
19233
19395
  get displaySendButton(): boolean;
@@ -19237,7 +19399,8 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
19237
19399
  get hasFileNotUploaded(): boolean;
19238
19400
  get isDisabled(): boolean;
19239
19401
  get maxFiles(): number;
19240
- cancel(file: PoUploadFile): void;
19402
+ cancel(file: PoUploadFile, keydown?: KeyboardEvent): void;
19403
+ ngOnChanges(changes: SimpleChanges): void;
19241
19404
  ngAfterViewInit(): void;
19242
19405
  /** Método responsável por **limpar** o(s) arquivo(s) selecionado(s). */
19243
19406
  clear(): void;
@@ -19263,30 +19426,27 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
19263
19426
  getAdditionalHelpTooltip(): string;
19264
19427
  hasAnyFileUploading(files: Array<PoUploadFile>): boolean;
19265
19428
  isAllowCancelEvent(status: PoUploadStatus): status is PoUploadStatus.Uploading | PoUploadStatus.Error | PoUploadStatus.None;
19266
- onBlur(): void;
19267
19429
  onFileChange(event: any): void;
19268
19430
  onFileChangeDragDrop(files: any): void;
19269
19431
  onKeyDown(event: KeyboardEvent): void;
19432
+ /**
19433
+ * Método responsável por fechar o modal.
19434
+ */
19435
+ closeModal(): void;
19436
+ openModal(file: PoUploadFile, keydown?: KeyboardEvent): void;
19270
19437
  removeFile(file: any): void;
19271
19438
  /** Método responsável por **abrir** a janela para seleção de arquivo(s). */
19272
19439
  selectFiles(): void;
19273
- sendFeedback(): void;
19440
+ sendFeedback(file?: any): void;
19274
19441
  /** Método responsável por **enviar** o(s) arquivo(s) selecionado(s). */
19275
19442
  sendFiles(): void;
19276
19443
  setDirectoryAttribute(canHandleDirectory: boolean): void;
19277
19444
  /**
19278
- * 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`.
19279
19446
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
19280
19447
  *
19281
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
19282
- * ```
19283
- * <po-upload
19284
- * #upload
19285
- * ...
19286
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
19287
- * (p-keydown)="onKeyDown($event, upload)"
19288
- * ></po-upload>
19289
- * ```
19448
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
19449
+ *
19290
19450
  * ```
19291
19451
  * //Exemplo com p-label e p-helper
19292
19452
  * <po-upload
@@ -19316,11 +19476,16 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
19316
19476
  hideAdditionalHelp: boolean;
19317
19477
  helperSettings?: any;
19318
19478
  };
19479
+ protected actionIsDisabled(action: any): any;
19480
+ protected isActionVisible(action: any): boolean;
19481
+ protected onImageError(file: any): void;
19482
+ protected showTooltipText(e: MouseEvent, text: string): void;
19319
19483
  private cleanInputValue;
19320
19484
  private isAdditionalHelpEventTriggered;
19321
19485
  private isUploadButtonFocused;
19322
19486
  private responseHandler;
19323
19487
  private setPipeArguments;
19488
+ private setPrimaryActionModal;
19324
19489
  private stopUploadHandler;
19325
19490
  private updateFiles;
19326
19491
  private updateModel;
@@ -19506,6 +19671,7 @@ declare class PoRichTextComponent extends PoRichTextBaseComponent implements Aft
19506
19671
  private element;
19507
19672
  bodyElement: PoRichTextBodyComponent;
19508
19673
  richTextToolbar: PoRichTextToolbarComponent;
19674
+ helperEl?: PoHelperComponent;
19509
19675
  private listener;
19510
19676
  private modelLastUpdate;
19511
19677
  toolbarActions: Array<PoRichTextToolbarActions>;
@@ -19537,20 +19703,12 @@ declare class PoRichTextComponent extends PoRichTextBaseComponent implements Aft
19537
19703
  onChangeValue(value: any): void;
19538
19704
  onKeyDown(event: KeyboardEvent): void;
19539
19705
  /**
19540
- * 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`.
19541
19707
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
19542
19708
  *
19543
- * > 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.
19544
19710
  *
19545
19711
  * ```
19546
- * <po-rich-text
19547
- * #richtext
19548
- * ...
19549
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
19550
- * (p-keydown)="onKeyDown($event, richtext)"
19551
- * ></po-rich-text>
19552
- * ```
19553
- * ```
19554
19712
  * // Exemplo com p-label e p-helper
19555
19713
  * <po-rich-text
19556
19714
  * #richtext
@@ -19761,6 +19919,7 @@ declare class PoSelectComponent extends PoFieldValidateModel<any> implements Aft
19761
19919
  renderer: Renderer2;
19762
19920
  private _iconToken;
19763
19921
  selectElement: ElementRef;
19922
+ helperEl?: PoHelperComponent;
19764
19923
  /**
19765
19924
  * @optional
19766
19925
  *
@@ -19897,10 +20056,10 @@ declare class PoSelectComponent extends PoFieldValidateModel<any> implements Aft
19897
20056
  *
19898
20057
  * @description
19899
20058
  *
19900
- * 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.
19901
20061
  *
19902
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
19903
- * 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.
19904
20063
  */
19905
20064
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
19906
20065
  /**
@@ -19952,19 +20111,11 @@ declare class PoSelectComponent extends PoFieldValidateModel<any> implements Aft
19952
20111
  onKeyDown(event: KeyboardEvent): void;
19953
20112
  registerOnTouched(fn: any): void;
19954
20113
  /**
19955
- * 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`.
19956
20115
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
19957
20116
  *
19958
- * > 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.
19959
20118
  *
19960
- * ```html
19961
- * <po-select
19962
- * #select
19963
- * ...
19964
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
19965
- * (p-keydown)="onKeyDown($event, select)"
19966
- * ></po-select>
19967
- * ```
19968
20119
  * ```
19969
20120
  * //Exemplo com p-label e p-helper
19970
20121
  * <po-select
@@ -20055,8 +20206,7 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20055
20206
  * @optional
20056
20207
  *
20057
20208
  * @description
20058
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
20059
- * 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`.
20060
20210
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
20061
20211
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
20062
20212
  *
@@ -20068,11 +20218,11 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20068
20218
  *
20069
20219
  * @description
20070
20220
  *
20071
- * 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
20072
20222
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
20073
20223
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
20074
20224
  *
20075
- * > 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.
20076
20226
  *
20077
20227
  * @default `false`
20078
20228
  */
@@ -20140,10 +20290,10 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20140
20290
  *
20141
20291
  * @description
20142
20292
  *
20143
- * 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.
20144
20295
  *
20145
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
20146
- * 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.
20147
20297
  */
20148
20298
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
20149
20299
  /**
@@ -20168,7 +20318,6 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20168
20318
  *
20169
20319
  * @description
20170
20320
  * Evento disparado ao clicar no ícone de ajuda adicional.
20171
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
20172
20321
  *
20173
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.
20174
20323
  */
@@ -20361,9 +20510,10 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20361
20510
  * </example>
20362
20511
  *
20363
20512
  */
20364
- declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit {
20513
+ declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit, OnChanges {
20365
20514
  private el;
20366
20515
  inputEl: ElementRef;
20516
+ helperEl?: PoHelperComponent;
20367
20517
  id: string;
20368
20518
  valueBeforeChange: any;
20369
20519
  fireChange: boolean;
@@ -20388,6 +20538,7 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
20388
20538
  */
20389
20539
  focus(): void;
20390
20540
  ngAfterViewInit(): void;
20541
+ ngOnChanges(changes: SimpleChanges): void;
20391
20542
  getAdditionalHelpTooltip(): string;
20392
20543
  getErrorPattern(): string;
20393
20544
  hasInvalidClass(): boolean;
@@ -20399,20 +20550,12 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
20399
20550
  controlChangeEmitter(): void;
20400
20551
  onKeyDown(event: KeyboardEvent): void;
20401
20552
  /**
20402
- * 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`.
20403
20554
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
20404
20555
  *
20405
- * > 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.
20406
20557
  *
20407
20558
  * ```
20408
- * <po-textarea
20409
- * #textarea
20410
- * ...
20411
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
20412
- * (p-keydown)="onKeyDown($event, textarea)"
20413
- * ></po-textarea>
20414
- * ```
20415
- * ```
20416
20559
  * //Exemplo com p-label e p-helper
20417
20560
  * <po-textarea
20418
20561
  * #textarea
@@ -20467,7 +20610,7 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
20467
20610
  * </example>
20468
20611
  *
20469
20612
  */
20470
- declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy {
20613
+ declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnChanges {
20471
20614
  id: string;
20472
20615
  icon: string;
20473
20616
  type: string;
@@ -20477,6 +20620,7 @@ declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, On
20477
20620
  constructor();
20478
20621
  ngAfterViewInit(): void;
20479
20622
  ngOnDestroy(): void;
20623
+ ngOnChanges(changes: SimpleChanges): void;
20480
20624
  extraValidation(c: AbstractControl): {
20481
20625
  [key: string]: any;
20482
20626
  };
@@ -20491,7 +20635,7 @@ declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, On
20491
20635
  */
20492
20636
  declare class PoDatepickerModule {
20493
20637
  static ɵfac: i0.ɵɵFactoryDeclaration<PoDatepickerModule, never>;
20494
- 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]>;
20495
20639
  static ɵinj: i0.ɵɵInjectorDeclaration<PoDatepickerModule>;
20496
20640
  }
20497
20641
 
@@ -20502,7 +20646,7 @@ declare class PoDatepickerModule {
20502
20646
  */
20503
20647
  declare class PoRadioGroupModule {
20504
20648
  static ɵfac: i0.ɵɵFactoryDeclaration<PoRadioGroupModule, never>;
20505
- 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]>;
20506
20650
  static ɵinj: i0.ɵɵInjectorDeclaration<PoRadioGroupModule>;
20507
20651
  }
20508
20652
 
@@ -20939,7 +21083,7 @@ declare class PoMediaQueryModule {
20939
21083
  }
20940
21084
 
20941
21085
  /**
20942
- * Módulo responsável por fornecer serviços relacionados ao tema PO.
21086
+ * Módulo do serviço PoThemeService.
20943
21087
  */
20944
21088
  declare class PoThemeModule {
20945
21089
  static ɵfac: i0.ɵɵFactoryDeclaration<PoThemeModule, never>;
@@ -20965,7 +21109,7 @@ declare class PoServicesModule {
20965
21109
  */
20966
21110
  declare class PoFieldModule {
20967
21111
  static ɵfac: i0.ɵɵFactoryDeclaration<PoFieldModule, never>;
20968
- static ɵmod: i0.ɵɵNgModuleDeclaration<PoFieldModule, [typeof PoComboComponent, typeof PoComboOptionTemplateDirective, typeof PoMultiselectOptionTemplateDirective, typeof PoDecimalComponent, typeof PoDatepickerRangeComponent, typeof PoEmailComponent, typeof PoInputComponent, typeof PoLoginComponent, typeof PoLookupComponent, typeof PoLookupModalComponent, typeof PoMultiselectComponent, typeof PoMultiselectDropdownComponent, typeof PoNumberComponent, typeof PoPasswordComponent, typeof PoRichTextBodyComponent, typeof PoRichTextComponent, typeof PoRichTextImageModalComponent, typeof PoRichTextLinkModalComponent, typeof PoRichTextToolbarComponent, typeof PoSelectComponent, typeof PoTextareaComponent, typeof PoUploadComponent, typeof PoUploadDragDropComponent, typeof PoUploadDragDropDirective, typeof PoUploadDragDropAreaOverlayComponent, typeof PoUploadDragDropAreaComponent, typeof PoUploadFileRestrictionsComponent, typeof PoUrlComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof i3$1.FormsModule, typeof i3.OverlayModule, typeof PoButtonGroupModule, typeof PoButtonModule, typeof PoCleanModule, typeof PoCalendarModule, typeof PoCheckboxGroupModule, typeof PoRadioGroupModule, typeof PoContainerModule, typeof PoDatepickerModule, typeof PoDisclaimerGroupModule, typeof PoDisclaimerModule, typeof PoFieldContainerModule, typeof PoLoadingModule, typeof PoModalModule, typeof PoProgressModule, typeof PoServicesModule, typeof PoTableModule, typeof PoTooltipModule, typeof PoIconModule, typeof PoCheckboxModule, typeof PoRadioModule, typeof PoLabelModule, typeof PoListBoxModule, typeof PoSwitchModule, typeof PoTagModule, typeof PoHelperModule], [typeof PoCheckboxGroupModule, typeof PoRadioGroupModule, typeof PoCleanModule, typeof PoDatepickerModule, typeof PoComboComponent, typeof PoComboOptionTemplateDirective, typeof PoMultiselectOptionTemplateDirective, typeof PoDecimalComponent, typeof PoDatepickerRangeComponent, typeof PoEmailComponent, typeof PoFieldContainerModule, typeof PoInputComponent, typeof PoLoginComponent, typeof PoLookupComponent, typeof PoLookupModalComponent, typeof PoMultiselectComponent, typeof PoNumberComponent, typeof PoPasswordComponent, typeof PoRichTextComponent, typeof PoSelectComponent, typeof PoTextareaComponent, typeof PoUploadComponent, typeof PoUrlComponent, typeof PoCheckboxModule, typeof PoRadioModule, typeof PoLabelModule, typeof PoSwitchModule, typeof PoTagModule]>;
21112
+ static ɵmod: i0.ɵɵNgModuleDeclaration<PoFieldModule, [typeof PoComboComponent, typeof PoComboOptionTemplateDirective, typeof PoMultiselectOptionTemplateDirective, typeof PoDecimalComponent, typeof PoDatepickerRangeComponent, typeof PoEmailComponent, typeof PoInputComponent, typeof PoLoginComponent, typeof PoLookupComponent, typeof PoLookupModalComponent, typeof PoMultiselectComponent, typeof PoMultiselectDropdownComponent, typeof PoNumberComponent, typeof PoPasswordComponent, typeof PoRichTextBodyComponent, typeof PoRichTextComponent, typeof PoRichTextImageModalComponent, typeof PoRichTextLinkModalComponent, typeof PoRichTextToolbarComponent, typeof PoSelectComponent, typeof PoTextareaComponent, typeof PoUploadComponent, typeof PoUploadDragDropComponent, typeof PoUploadDragDropDirective, typeof PoUploadDragDropAreaOverlayComponent, typeof PoUploadDragDropAreaComponent, typeof PoUploadFileRestrictionsComponent, typeof PoUrlComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof i3$1.FormsModule, typeof i3.OverlayModule, typeof PoButtonGroupModule, typeof PoButtonModule, typeof PoCleanModule, typeof PoCalendarModule, typeof PoCheckboxGroupModule, typeof PoRadioGroupModule, typeof PoContainerModule, typeof PoDatepickerModule, typeof PoDisclaimerGroupModule, typeof PoDisclaimerModule, typeof PoFieldContainerModule, typeof PoLoadingModule, typeof PoModalModule, typeof PoProgressModule, typeof PoServicesModule, typeof PoTableModule, typeof PoTooltipModule, typeof PoIconModule, typeof PoCheckboxModule, typeof PoRadioModule, typeof PoLabelModule, typeof PoLinkModule, typeof PoListBoxModule, typeof PoSwitchModule, typeof PoTagModule, typeof PoHelperModule], [typeof PoCheckboxGroupModule, typeof PoRadioGroupModule, typeof PoCleanModule, typeof PoDatepickerModule, typeof PoComboComponent, typeof PoComboOptionTemplateDirective, typeof PoMultiselectOptionTemplateDirective, typeof PoDecimalComponent, typeof PoDatepickerRangeComponent, typeof PoEmailComponent, typeof PoFieldContainerModule, typeof PoInputComponent, typeof PoLoginComponent, typeof PoLookupComponent, typeof PoLookupModalComponent, typeof PoMultiselectComponent, typeof PoNumberComponent, typeof PoPasswordComponent, typeof PoRichTextComponent, typeof PoSelectComponent, typeof PoTextareaComponent, typeof PoUploadComponent, typeof PoUrlComponent, typeof PoCheckboxModule, typeof PoRadioModule, typeof PoLabelModule, typeof PoSwitchModule, typeof PoTagModule]>;
20969
21113
  static ɵinj: i0.ɵɵInjectorDeclaration<PoFieldModule>;
20970
21114
  }
20971
21115
 
@@ -21218,21 +21362,23 @@ interface PoDynamicField {
21218
21362
  interface PoDynamicFormField extends PoDynamicField {
21219
21363
  /**
21220
21364
  * Evento disparado ao clicar no ícone de ajuda adicional.
21221
- * 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.
21222
21367
  */
21223
21368
  additionalHelp?: Function;
21224
21369
  /**
21225
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
21226
- * 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`.
21227
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.
21228
21374
  */
21229
21375
  additionalHelpTooltip?: string;
21230
21376
  /**
21231
- * 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
21232
21378
  * página e não dentro do componente. Essa opção é necessária para cenários com containers que possuem scroll ou
21233
21379
  * overflow escondido, garantindo o posicionamento correto de ambos próximo ao elemento.
21234
21380
  *
21235
- * > 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.
21236
21382
  */
21237
21383
  appendBox?: boolean;
21238
21384
  /**
@@ -21353,6 +21499,8 @@ interface PoDynamicFormField extends PoDynamicField {
21353
21499
  disabled?: boolean;
21354
21500
  /** Texto de ajuda. */
21355
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;
21356
21504
  /** Texto exibido quando o valor do componente for *true*. */
21357
21505
  booleanTrue?: string;
21358
21506
  /** Texto exibido quando o valor do componente for *false*. */
@@ -21844,6 +21992,14 @@ interface PoDynamicFormField extends PoDynamicField {
21844
21992
  * - Não possuir `p-help` e/ou `p-label`.
21845
21993
  */
21846
21994
  showRequired?: boolean;
21995
+ /**
21996
+ * Exibe a pré-visualização de imagens ao anexá-las.
21997
+ *
21998
+ * > Propriedade funciona apenas em arquivos de formato de imagem (`.png`, `.jpg`, `.jpeg` e `.gif`).
21999
+ *
22000
+ * **Componente compatível**: `po-upload`
22001
+ */
22002
+ showThumbnail?: boolean;
21847
22003
  /**
21848
22004
  * Define uma ação personalizada no componente `po-upload`, adicionando um botão no canto inferior direito
21849
22005
  * de cada barra de progresso associada aos arquivos enviados ou em envio.
@@ -22359,7 +22515,7 @@ declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent implemen
22359
22515
  getObjectValue(): Observable<any>;
22360
22516
  sendObjectValue(objectValue: any): void;
22361
22517
  /**
22362
- * 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`.
22363
22519
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `keydown`.
22364
22520
  *
22365
22521
  * ```
@@ -22372,7 +22528,7 @@ declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent implemen
22372
22528
  * property: 'name',
22373
22529
  * ...
22374
22530
  * help: 'Mensagem de ajuda.',
22375
- * additionalHelpTooltip: 'Mensagem de ajuda complementar.',
22531
+ * helper: 'Mensagem de ajuda complementar com o componente po-helper implementado.',
22376
22532
  * keydown: this.onKeyDown.bind(this, 'name')
22377
22533
  * },
22378
22534
  * ]
@@ -22851,9 +23007,24 @@ declare class PoDynamicViewBaseComponent extends PoDynamicSharedBase {
22851
23007
  */
22852
23008
  load: string | Function;
22853
23009
  service: any;
23010
+ private _componentsSize?;
22854
23011
  private _fields;
22855
23012
  private _showAllValue;
22856
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;
22857
23028
  /**
22858
23029
  * @optional
22859
23030
  *
@@ -22983,7 +23154,7 @@ declare class PoDynamicViewBaseComponent extends PoDynamicSharedBase {
22983
23154
  private transformValue;
22984
23155
  private formatField;
22985
23156
  static ɵfac: i0.ɵɵFactoryDeclaration<PoDynamicViewBaseComponent, never>;
22986
- 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>;
22987
23158
  }
22988
23159
 
22989
23160
  /**
@@ -23066,6 +23237,7 @@ declare class PoInfoBaseComponent {
23066
23237
  readonly poInfoOrientation: typeof PoInfoOrientation;
23067
23238
  private _labelSize;
23068
23239
  private _orientation;
23240
+ private _size?;
23069
23241
  /**
23070
23242
  * @optional
23071
23243
  *
@@ -23094,8 +23266,22 @@ declare class PoInfoBaseComponent {
23094
23266
  */
23095
23267
  set orientation(value: PoInfoOrientation);
23096
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;
23097
23283
  static ɵfac: i0.ɵɵFactoryDeclaration<PoInfoBaseComponent, never>;
23098
- 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>;
23099
23285
  }
23100
23286
 
23101
23287
  /**
@@ -26060,14 +26246,15 @@ interface PoPageDefaultLiterals {
26060
26246
  *
26061
26247
  * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
26062
26248
  *
26063
- * | Propriedade | Descrição | Valor Padrão |
26064
- * |----------------------------------------|-------------------------------------------------------|-------------------------------------------------|
26065
- * | **Default Values** | | |
26066
- * | `--padding` | Espaçamento do componente | `var(--spacing-xs) var(--spacing-md)` |
26067
- * | `--gap` | Gap entre o header e o conteúdo | `var(--spacing-md)` |
26068
- * | `--padding-top-header` | Espaçamento do topo do header | `var(--color-neutral-light-30)` |
26069
- * | `--gap-actions` | Gap entre os botões de action | `var(--spacing-xs)` |
26070
- * | `--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)` |
26071
26258
  */
26072
26259
  declare abstract class PoPageDefaultBaseComponent {
26073
26260
  poPageContent: PoPageContentComponent;
@@ -26223,6 +26410,20 @@ interface PoPageDetailLiterals {
26223
26410
  *
26224
26411
  * O componente **po-page-detail** é utilizado como container principal para a tela de
26225
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)` |
26226
26427
  */
26227
26428
  declare class PoPageDetailBaseComponent {
26228
26429
  poPageContent: PoPageContentComponent;
@@ -26390,6 +26591,20 @@ interface PoPageEditLiterals {
26390
26591
  * Os botões "Salvar" e "Salvar e Novo" podem ser habilitados/desabilitados utilizando a propriedade `p-disable-submit`.
26391
26592
  * Esta propriedade pode ser utilizada para desabilitar os botões caso exista um formulário inválido na página ou alguma
26392
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)` |
26393
26608
  */
26394
26609
  declare class PoPageEditBaseComponent {
26395
26610
  poPageContent: PoPageContentComponent;
@@ -26546,6 +26761,8 @@ declare class PoPageEditComponent extends PoPageEditBaseComponent {
26546
26761
  declare class PoPageHeaderBaseComponent {
26547
26762
  /** Título da página. */
26548
26763
  title: string;
26764
+ /** Define o tamanho dos componentes no header. */
26765
+ size: string;
26549
26766
  /** Subtítulo da página. */
26550
26767
  subtitle: string;
26551
26768
  private _breadcrumb;
@@ -26553,7 +26770,7 @@ declare class PoPageHeaderBaseComponent {
26553
26770
  set breadcrumb(value: PoBreadcrumb);
26554
26771
  get breadcrumb(): PoBreadcrumb;
26555
26772
  static ɵfac: i0.ɵɵFactoryDeclaration<PoPageHeaderBaseComponent, never>;
26556
- 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>;
26557
26774
  }
26558
26775
 
26559
26776
  /**
@@ -26565,6 +26782,21 @@ declare class PoPageHeaderComponent extends PoPageHeaderBaseComponent {
26565
26782
  static ɵcmp: i0.ɵɵComponentDeclaration<PoPageHeaderComponent, "po-page-header", never, {}, {}, never, ["*"], false, never>;
26566
26783
  }
26567
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
+
26568
26800
  /**
26569
26801
  * @usedBy PoThemeService
26570
26802
  *
@@ -27145,11 +27377,20 @@ interface PoThemeActive {
27145
27377
  /**
27146
27378
  * @description
27147
27379
  *
27148
- * 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.
27386
+ *
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.
27149
27389
  *
27150
- * > 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`.
27390
+ * > Observação: a customização das cores de `feedback` não é recomendada por motivos de acessibilidade e usabilidade.
27151
27391
  *
27152
- * > Obs.: Não está documentado aqui e não indicamos a customização das cores de 'feedback' por motivos de acessibilidade e usabilidade.
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`.
27153
27394
  */
27154
27395
  /**
27155
27396
  * @example
@@ -27178,7 +27419,8 @@ declare class PoThemeService {
27178
27419
  * @param {PoTheme} themeConfig - Configuração de tema a ser aplicada ao componente.
27179
27420
  * @param {PoThemeTypeEnum} [themeType=PoThemeTypeEnum.light] - (Opcional) Tipo de tema, podendo ser 'light' (claro) ou 'dark' (escuro). O tema claro é o padrão.
27180
27421
  * @param {PoThemeA11yEnum} [a11yLevel=PoThemeA11yEnum.AAA] - (Opcional) Nível de acessibilidade dos componentes, podendo ser AA ou AAA. Padrão é AAA.
27181
- * @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.
27182
27424
  */
27183
27425
  setTheme(themeConfig: PoTheme, themeType?: PoThemeTypeEnum, a11yLevel?: PoThemeA11yEnum, persistPreference?: boolean): void;
27184
27426
  private setDataDefaultSizeHTML;
@@ -27189,18 +27431,35 @@ declare class PoThemeService {
27189
27431
  */
27190
27432
  getA11yLevel(): PoThemeA11yEnum;
27191
27433
  /**
27192
- * Define o tamanho `small` como padrão para componentes de formulário que não possuem um tamanho definido.
27193
- * Essa configuração é aplicada globalmente apenas quando o nível de acessibilidade for `AA`.
27194
- * 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`.
27195
27437
  *
27196
27438
  * > Para garantir que o tamanho `small` seja aplicado corretamente a todos os componentes, recomendamos
27197
27439
  * definir esta configuração **junto com o nível de acessibilidade `AA` na inicialização da aplicação**.
27198
27440
  * Se for aplicada em tempo de execução, será necessário recarregar a aplicação (`reload`)
27199
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.
27200
27444
  *
27201
27445
  * @param {boolean} enable Habilita ou desabilita o tamanho `small` globalmente.
27202
27446
  */
27203
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;
27204
27463
  /**
27205
27464
  * @docsPrivate
27206
27465
  * Retorna a preferência global de tamanho dos componentes.
@@ -27282,11 +27541,10 @@ declare class PoThemeService {
27282
27541
  private applyThemeStyles;
27283
27542
  private changeThemeType;
27284
27543
  /**
27285
- * Persiste e define o tema do aplicativo com base nos dados armazenados.
27286
- *
27287
- * Este método recupera os dados do tema armazenados e os aplica ao aplicativo.
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.
27288
27546
  *
27289
- * @returns {PoTheme} Recupera o tema armazenado.
27547
+ * @returns {PoTheme} O tema atualmente aplicado.
27290
27548
  */
27291
27549
  persistThemeActive(): PoTheme;
27292
27550
  private formatTheme;
@@ -27308,6 +27566,7 @@ declare class PoThemeService {
27308
27566
  cleanThemeActive(persistPreference?: boolean): void;
27309
27567
  private getActiveTypeFromTheme;
27310
27568
  private getActiveA11yFromTheme;
27569
+ private isValidA11yLevel;
27311
27570
  /**
27312
27571
  * @docsPrivate
27313
27572
  *
@@ -27483,6 +27742,20 @@ interface PoPageListLiterals {
27483
27742
  *
27484
27743
  * Para facilitar a manipulação e visualização dos filtros aplicados, é possível também utilizar o componente
27485
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)` |
27486
27759
  */
27487
27760
  declare abstract class PoPageListBaseComponent {
27488
27761
  poPageContent: PoPageContentComponent;