@po-ui/ng-components 20.6.0 → 20.8.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 (95) hide show
  1. package/fesm2022/po-ui-ng-components.mjs +3523 -2688
  2. package/fesm2022/po-ui-ng-components.mjs.map +1 -1
  3. package/index.d.ts +636 -452
  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-dropdown/po-dropdown-action.interface.d.ts +10 -0
  7. package/lib/components/po-dropdown/po-dropdown.component.d.ts +5 -0
  8. package/lib/components/po-dynamic/po-dynamic-form/interfaces/po-dynamic-form-field.interface.d.ts +10 -5
  9. package/lib/components/po-dynamic/po-dynamic-form/po-dynamic-form.component.d.ts +2 -2
  10. package/lib/components/po-dynamic/po-dynamic-view/po-dynamic-view-base.component.d.ts +15 -0
  11. package/lib/components/po-field/po-checkbox/po-checkbox-base.component.d.ts +6 -8
  12. package/lib/components/po-field/po-checkbox/po-checkbox.component.d.ts +3 -12
  13. package/lib/components/po-field/po-checkbox-group/po-checkbox-group-base.component.d.ts +6 -8
  14. package/lib/components/po-field/po-checkbox-group/po-checkbox-group.component.d.ts +7 -12
  15. package/lib/components/po-field/po-combo/po-combo-base.component.d.ts +6 -8
  16. package/lib/components/po-field/po-combo/po-combo.component.d.ts +5 -12
  17. package/lib/components/po-field/po-datepicker/po-datepicker-base.component.d.ts +5 -7
  18. package/lib/components/po-field/po-datepicker/po-datepicker.component.d.ts +7 -14
  19. package/lib/components/po-field/po-datepicker-range/po-datepicker-range-base.component.d.ts +5 -7
  20. package/lib/components/po-field/po-datepicker-range/po-datepicker-range.component.d.ts +4 -12
  21. package/lib/components/po-field/po-decimal/po-decimal.component.d.ts +3 -4
  22. package/lib/components/po-field/po-email/po-email.component.d.ts +3 -3
  23. package/lib/components/po-field/po-field-container/po-field-container-bottom/po-field-container-bottom.component.d.ts +2 -0
  24. package/lib/components/po-field/po-field-container/po-field-container.component.d.ts +2 -0
  25. package/lib/components/po-field/po-field.model.d.ts +7 -16
  26. package/lib/components/po-field/po-input/po-input-base.component.d.ts +12 -19
  27. package/lib/components/po-field/po-input/po-input.component.d.ts +3 -3
  28. package/lib/components/po-field/po-input-generic/po-input-generic.d.ts +0 -2
  29. package/lib/components/po-field/po-login/po-login.component.d.ts +3 -1
  30. package/lib/components/po-field/po-lookup/po-lookup-base.component.d.ts +6 -8
  31. package/lib/components/po-field/po-lookup/po-lookup-modal/po-lookup-modal.component.d.ts +1 -1
  32. package/lib/components/po-field/po-lookup/po-lookup.component.d.ts +8 -14
  33. package/lib/components/po-field/po-multiselect/po-multiselect-base.component.d.ts +6 -8
  34. package/lib/components/po-field/po-multiselect/po-multiselect.component.d.ts +4 -12
  35. package/lib/components/po-field/po-number/po-number.component.d.ts +3 -2
  36. package/lib/components/po-field/po-password/po-password.component.d.ts +3 -1
  37. package/lib/components/po-field/po-radio/po-radio.component.d.ts +9 -0
  38. package/lib/components/po-field/po-radio-group/po-radio-group-base.component.d.ts +6 -8
  39. package/lib/components/po-field/po-radio-group/po-radio-group.component.d.ts +7 -12
  40. package/lib/components/po-field/po-rich-text/po-rich-text-base.component.d.ts +6 -8
  41. package/lib/components/po-field/po-rich-text/po-rich-text-body/po-rich-text-body.component.d.ts +1 -2
  42. package/lib/components/po-field/po-rich-text/po-rich-text.component.d.ts +4 -10
  43. package/lib/components/po-field/po-select/po-select.component.d.ts +7 -14
  44. package/lib/components/po-field/po-switch/po-switch.component.d.ts +33 -6
  45. package/lib/components/po-field/po-textarea/po-textarea-base.component.d.ts +6 -8
  46. package/lib/components/po-field/po-textarea/po-textarea.component.d.ts +7 -12
  47. package/lib/components/po-field/po-upload/po-upload-base.component.d.ts +6 -8
  48. package/lib/components/po-field/po-upload/po-upload.component.d.ts +5 -11
  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-listbox/interfaces/po-listbox-literals.interface.d.ts +2 -0
  54. package/lib/components/po-listbox/po-item-list/po-item-list-base.component.d.ts +1 -0
  55. package/lib/components/po-listbox/po-listbox-base.component.d.ts +8 -7
  56. package/lib/components/po-listbox/po-listbox.component.d.ts +14 -3
  57. package/lib/components/po-loading/po-loading-base.component.d.ts +7 -4
  58. package/lib/components/po-page/interfaces/po-page-action.interface.d.ts +6 -5
  59. package/lib/components/po-page/po-page-default/po-page-default-base.component.d.ts +9 -8
  60. package/lib/components/po-page/po-page-detail/po-page-detail-base.component.d.ts +14 -0
  61. package/lib/components/po-page/po-page-edit/po-page-edit-base.component.d.ts +14 -0
  62. package/lib/components/po-page/po-page-header/po-page-header-base.component.d.ts +2 -0
  63. package/lib/components/po-page/po-page-list/po-page-list-base.component.d.ts +14 -0
  64. package/lib/components/po-popover/po-popover-base.component.d.ts +12 -0
  65. package/lib/components/po-popover/po-popover.component.d.ts +11 -0
  66. package/lib/components/po-popup/po-popup-action.interface.d.ts +36 -4
  67. package/lib/components/po-popup/po-popup-base.component.d.ts +1 -0
  68. package/lib/components/po-search/po-search-base.component.d.ts +16 -0
  69. package/lib/components/po-search/po-search.component.d.ts +1 -1
  70. package/lib/components/po-table/enums/po-table-spacing.enum.d.ts +1 -1
  71. package/lib/components/po-tag/po-tag-base.component.d.ts +1 -0
  72. package/lib/enums/po-density-mode.enum.d.ts +14 -0
  73. package/lib/enums/po-field-size.enum.d.ts +5 -3
  74. package/lib/services/po-theme/helpers/accessibilities/po-theme-density.constant.d.ts +12 -0
  75. package/lib/services/po-theme/helpers/types/po-theme-dark-defaults-AA.constant.d.ts +4 -0
  76. package/lib/services/po-theme/helpers/types/po-theme-dark-defaults.constant.d.ts +5 -0
  77. package/lib/services/po-theme/po-theme.module.d.ts +1 -1
  78. package/lib/services/po-theme/po-theme.service.d.ts +39 -11
  79. package/lib/utils/util.d.ts +9 -2
  80. package/package.json +4 -4
  81. package/po-ui-ng-components-20.8.0.tgz +0 -0
  82. package/schematics/ng-add/index.js +1 -1
  83. package/schematics/ng-update/v14/index.js +1 -1
  84. package/schematics/ng-update/v15/index.js +1 -1
  85. package/schematics/ng-update/v16/index.js +1 -1
  86. package/schematics/ng-update/v17/index.js +1 -1
  87. package/schematics/ng-update/v18/index.js +2 -2
  88. package/schematics/ng-update/v19/index.js +2 -2
  89. package/schematics/ng-update/v2/index.js +1 -1
  90. package/schematics/ng-update/v20/index.js +2 -2
  91. package/schematics/ng-update/v3/index.js +1 -1
  92. package/schematics/ng-update/v4/index.js +1 -1
  93. package/schematics/ng-update/v5/index.js +1 -1
  94. package/schematics/ng-update/v6/index.js +1 -1
  95. package/po-ui-ng-components-20.6.0.tgz +0 -0
package/index.d.ts CHANGED
@@ -10,7 +10,7 @@ import { Router } from '@angular/router';
10
10
  import * as i3$1 from '@angular/forms';
11
11
  import { ControlValueAccessor, AbstractControl, Validator, ValidationErrors, NgForm } from '@angular/forms';
12
12
  import * as i3 from '@angular/cdk/overlay';
13
- import * as i8 from '@angular/cdk/listbox';
13
+ import * as i9 from '@angular/cdk/listbox';
14
14
  import * as _po_ui_ng_components from '@po-ui/ng-components';
15
15
  import { HttpHeaders, HttpClient, HttpInterceptor, HttpRequest, HttpHandler, HttpEvent, HttpResponse, HttpErrorResponse } from '@angular/common/http';
16
16
  import * as i19 from '@angular/cdk/drag-drop';
@@ -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 {
@@ -1779,6 +1795,7 @@ declare class PoItemListBaseComponent {
1779
1795
  * Define um ícone que será exibido ao lado esquerdo do rótulo.
1780
1796
  */
1781
1797
  icon: string | TemplateRef<void>;
1798
+ iconPosition: 'left' | 'right';
1782
1799
  /**
1783
1800
  * @optional
1784
1801
  *
@@ -1809,7 +1826,7 @@ declare class PoItemListBaseComponent {
1809
1826
  keysLabel?: Array<string>;
1810
1827
  protected emitActiveTabs(tab: any): void;
1811
1828
  static ɵfac: i0.ɵɵFactoryDeclaration<PoItemListBaseComponent, never>;
1812
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoItemListBaseComponent, never, never, { "type": { "alias": "p-type"; "required": false; }; "visible": { "alias": "p-visible"; "required": false; }; "item": { "alias": "p-item"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; "danger": { "alias": "p-danger"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "selected": { "alias": "p-selected"; "required": false; }; "separator": { "alias": "p-separator"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "checkboxValue": { "alias": "p-checkbox-value"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "template": { "alias": "p-template"; "required": false; }; "templateContext": { "alias": "p-template-context"; "required": false; }; "searchValue": { "alias": "p-search-value"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "isFiltering": { "alias": "p-filtering"; "required": false; }; "shouldMarkLetters": { "alias": "p-should-mark-letter"; "required": false; }; "compareCache": { "alias": "p-compare-cache"; "required": false; }; "comboService": { "alias": "p-combo-service"; "required": false; }; "isTabs": { "alias": "p-is-tabs"; "required": false; }; "tabHide": { "alias": "p-tab-hide"; "required": false; }; "activeTabs": { "alias": "p-active-tabs"; "required": false; }; "keysLabel": { "alias": "p-keys-label"; "required": false; }; }, { "clickItem": "p-click-item"; "checkboxItem": "p-selectcheckbox-item"; "comboItem": "p-selectcombo-item"; "tabsItem": "p-emit-item-tabs"; "activatedTab": "p-activated-tabs"; }, never, never, true, never>;
1829
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoItemListBaseComponent, never, never, { "type": { "alias": "p-type"; "required": false; }; "visible": { "alias": "p-visible"; "required": false; }; "item": { "alias": "p-item"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; "danger": { "alias": "p-danger"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "selected": { "alias": "p-selected"; "required": false; }; "separator": { "alias": "p-separator"; "required": false; }; "icon": { "alias": "p-icon"; "required": false; }; "iconPosition": { "alias": "p-icon-position"; "required": false; }; "checkboxValue": { "alias": "p-checkbox-value"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "template": { "alias": "p-template"; "required": false; }; "templateContext": { "alias": "p-template-context"; "required": false; }; "searchValue": { "alias": "p-search-value"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "isFiltering": { "alias": "p-filtering"; "required": false; }; "shouldMarkLetters": { "alias": "p-should-mark-letter"; "required": false; }; "compareCache": { "alias": "p-compare-cache"; "required": false; }; "comboService": { "alias": "p-combo-service"; "required": false; }; "isTabs": { "alias": "p-is-tabs"; "required": false; }; "tabHide": { "alias": "p-tab-hide"; "required": false; }; "activeTabs": { "alias": "p-active-tabs"; "required": false; }; "keysLabel": { "alias": "p-keys-label"; "required": false; }; }, { "clickItem": "p-click-item"; "checkboxItem": "p-selectcheckbox-item"; "comboItem": "p-selectcombo-item"; "tabsItem": "p-emit-item-tabs"; "activatedTab": "p-activated-tabs"; }, never, never, true, never>;
1813
1830
  static ngAcceptInputType_danger: any;
1814
1831
  static ngAcceptInputType_selected: any;
1815
1832
  static ngAcceptInputType_separator: any;
@@ -1843,6 +1860,8 @@ declare class PoItemListComponent extends PoItemListBaseComponent implements OnC
1843
1860
  * Interface para definição de literais utilizadas no `po-listbox`
1844
1861
  */
1845
1862
  interface PoListBoxLiterals {
1863
+ /** Texto do botão para voltar ao agrupador anterior. */
1864
+ backToPreviousGroup?: string;
1846
1865
  /** Texto exibido quando não houver itens na lista */
1847
1866
  noItems?: string;
1848
1867
  /** Texto do *placeholder* do campo de busca. */
@@ -1906,6 +1925,7 @@ declare class PoListBoxBaseComponent {
1906
1925
  private _literals;
1907
1926
  private language;
1908
1927
  private _size?;
1928
+ listboxSubitems: boolean;
1909
1929
  visible: boolean;
1910
1930
  set type(value: string);
1911
1931
  get type(): PoItemListType;
@@ -1916,18 +1936,11 @@ declare class PoListBoxBaseComponent {
1916
1936
  get isItemListGroup(): boolean;
1917
1937
  isTabs: boolean;
1918
1938
  param?: any;
1919
- selectItem: EventEmitter<any>;
1920
- closeEvent: EventEmitter<any>;
1921
- change: EventEmitter<any>;
1922
- selectCombo: EventEmitter<any>;
1923
- changeAll: EventEmitter<any>;
1924
- UpdateInfiniteScroll: EventEmitter<any>;
1925
1939
  checkboxAllValue: any;
1926
1940
  selectedOptions: Array<any>;
1927
1941
  selectedOption?: any;
1928
1942
  fieldValue: string;
1929
1943
  fieldLabel: string;
1930
- changeSearch: EventEmitter<any>;
1931
1944
  literalSearch?: any;
1932
1945
  fieldValueSearch: string;
1933
1946
  hideSearch?: boolean;
@@ -1953,6 +1966,13 @@ declare class PoListBoxBaseComponent {
1953
1966
  footerActionListbox: boolean;
1954
1967
  placeholderListbox: string;
1955
1968
  separator: boolean;
1969
+ changeSearch: EventEmitter<any>;
1970
+ selectItem: EventEmitter<any>;
1971
+ closeEvent: EventEmitter<any>;
1972
+ change: EventEmitter<any>;
1973
+ selectCombo: EventEmitter<any>;
1974
+ changeAll: EventEmitter<any>;
1975
+ UpdateInfiniteScroll: EventEmitter<any>;
1956
1976
  activatedTab: EventEmitter<any>;
1957
1977
  clickTab: EventEmitter<any>;
1958
1978
  changeStateTabs: EventEmitter<any>;
@@ -1960,7 +1980,7 @@ declare class PoListBoxBaseComponent {
1960
1980
  footerActionListboxEvent: EventEmitter<any>;
1961
1981
  constructor(languageService: PoLanguageService);
1962
1982
  static ɵfac: i0.ɵɵFactoryDeclaration<PoListBoxBaseComponent, never>;
1963
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoListBoxBaseComponent, never, never, { "visible": { "alias": "p-visible"; "required": false; }; "type": { "alias": "p-type"; "required": false; }; "items": { "alias": "p-items"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "isTabs": { "alias": "p-is-tabs"; "required": false; }; "param": { "alias": "p-param"; "required": false; }; "checkboxAllValue": { "alias": "p-checkboxAllValue"; "required": false; }; "selectedOptions": { "alias": "p-selected-options"; "required": false; }; "selectedOption": { "alias": "p-selected-option"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "literalSearch": { "alias": "p-literal-search"; "required": false; }; "fieldValueSearch": { "alias": "p-field-value-search"; "required": false; }; "hideSearch": { "alias": "p-hide-search"; "required": false; }; "hideSelectAll": { "alias": "p-hide-select-all"; "required": false; }; "multiselectTemplate": { "alias": "p-multiselect-template"; "required": false; }; "template": { "alias": "p-template"; "required": false; }; "placeholderSearch": { "alias": "p-placeholder-search"; "required": false; }; "searchValue": { "alias": "p-search-value"; "required": false; }; "isServerSearching": { "alias": "p-is-searching"; "required": false; }; "infiniteLoading": { "alias": "p-infinite-loading"; "required": false; }; "infiniteScroll": { "alias": "p-infinite-scroll"; "required": false; }; "cache": { "alias": "p-cache"; "required": false; }; "infiniteScrollDistance": { "alias": "p-infinite-scroll-distance"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "isFiltering": { "alias": "p-filtering"; "required": false; }; "shouldMarkLetters": { "alias": "p-should-mark-letter"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "compareCache": { "alias": "p-compare-cache"; "required": false; }; "comboService": { "alias": "p-combo-service"; "required": false; }; "containerWidth": { "alias": "p-container-width"; "required": false; }; "keysLabel": { "alias": "p-keys-label"; "required": false; }; "footerActionListbox": { "alias": "p-footer-action-listbox"; "required": false; }; "placeholderListbox": { "alias": "p-placeholder-listbox"; "required": false; }; "separator": { "alias": "p-separator"; "required": false; }; }, { "selectItem": "p-select-item"; "closeEvent": "p-close"; "change": "p-change"; "selectCombo": "p-selectcombo-item"; "changeAll": "p-change-all"; "UpdateInfiniteScroll": "p-update-infinite-scroll"; "changeSearch": "p-change-search"; "activatedTab": "p-activated-tabs"; "clickTab": "p-click-tabs"; "changeStateTabs": "p-change-state-tabs"; "clickItem": "p-click-item"; "footerActionListboxEvent": "p-footer-action-listbox-event"; }, never, never, true, never>;
1983
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoListBoxBaseComponent, never, never, { "listboxSubitems": { "alias": "p-listbox-subitems"; "required": false; }; "visible": { "alias": "p-visible"; "required": false; }; "type": { "alias": "p-type"; "required": false; }; "items": { "alias": "p-items"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "isTabs": { "alias": "p-is-tabs"; "required": false; }; "param": { "alias": "p-param"; "required": false; }; "checkboxAllValue": { "alias": "p-checkboxAllValue"; "required": false; }; "selectedOptions": { "alias": "p-selected-options"; "required": false; }; "selectedOption": { "alias": "p-selected-option"; "required": false; }; "fieldValue": { "alias": "p-field-value"; "required": false; }; "fieldLabel": { "alias": "p-field-label"; "required": false; }; "literalSearch": { "alias": "p-literal-search"; "required": false; }; "fieldValueSearch": { "alias": "p-field-value-search"; "required": false; }; "hideSearch": { "alias": "p-hide-search"; "required": false; }; "hideSelectAll": { "alias": "p-hide-select-all"; "required": false; }; "multiselectTemplate": { "alias": "p-multiselect-template"; "required": false; }; "template": { "alias": "p-template"; "required": false; }; "placeholderSearch": { "alias": "p-placeholder-search"; "required": false; }; "searchValue": { "alias": "p-search-value"; "required": false; }; "isServerSearching": { "alias": "p-is-searching"; "required": false; }; "infiniteLoading": { "alias": "p-infinite-loading"; "required": false; }; "infiniteScroll": { "alias": "p-infinite-scroll"; "required": false; }; "cache": { "alias": "p-cache"; "required": false; }; "infiniteScrollDistance": { "alias": "p-infinite-scroll-distance"; "required": false; }; "filterMode": { "alias": "p-filter-mode"; "required": false; }; "isFiltering": { "alias": "p-filtering"; "required": false; }; "shouldMarkLetters": { "alias": "p-should-mark-letter"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "compareCache": { "alias": "p-compare-cache"; "required": false; }; "comboService": { "alias": "p-combo-service"; "required": false; }; "containerWidth": { "alias": "p-container-width"; "required": false; }; "keysLabel": { "alias": "p-keys-label"; "required": false; }; "footerActionListbox": { "alias": "p-footer-action-listbox"; "required": false; }; "placeholderListbox": { "alias": "p-placeholder-listbox"; "required": false; }; "separator": { "alias": "p-separator"; "required": false; }; }, { "changeSearch": "p-change-search"; "selectItem": "p-select-item"; "closeEvent": "p-close"; "change": "p-change"; "selectCombo": "p-selectcombo-item"; "changeAll": "p-change-all"; "UpdateInfiniteScroll": "p-update-infinite-scroll"; "activatedTab": "p-activated-tabs"; "clickTab": "p-click-tabs"; "changeStateTabs": "p-change-state-tabs"; "clickItem": "p-click-item"; "footerActionListboxEvent": "p-footer-action-listbox-event"; }, never, never, true, never>;
1964
1984
  static ngAcceptInputType_visible: any;
1965
1985
  static ngAcceptInputType_isTabs: any;
1966
1986
  static ngAcceptInputType_isServerSearching: any;
@@ -1969,22 +1989,183 @@ declare class PoListBoxBaseComponent {
1969
1989
  static ngAcceptInputType_cache: any;
1970
1990
  }
1971
1991
 
1972
- declare class PoListBoxComponent extends PoListBoxBaseComponent implements AfterViewInit, OnChanges, OnDestroy {
1992
+ /**
1993
+ * @usedBy PoPopupComponent, PoWidgetComponent
1994
+ *
1995
+ * @description
1996
+ *
1997
+ * Interface para lista de ações do componente.
1998
+ */
1999
+ interface PoPopupAction {
2000
+ /**
2001
+ * @description
2002
+ *
2003
+ * Rótulo da ação.
2004
+ *
2005
+ * No componente `po-dropdown`, a label também pode representar o agrupador de subitens.
2006
+ */
2007
+ label: string;
2008
+ /**
2009
+ * @description
2010
+ *
2011
+ * Ação que será executada, sendo possível passar o nome ou a referência da função.
2012
+ *
2013
+ * No componente `po-dropdown`, a action também pode ser executada para o agrupador de subitens.
2014
+ *
2015
+ * > Para que a função seja executada no contexto do elemento filho o mesmo deve ser passado utilizando *bind*.
2016
+ *
2017
+ * Exemplo: `action: this.myFunction.bind(this)`
2018
+ */
2019
+ action?: Function;
2020
+ /**
2021
+ * @description
2022
+ *
2023
+ * Define um ícone que será exibido ao lado esquerdo do rótulo.
2024
+ *
2025
+ * É possível usar qualquer um dos ícones da [Biblioteca de ícones](https://po-ui.io/icons). conforme exemplo abaixo:
2026
+ * ```
2027
+ * <po-component
2028
+ * [p-property]="[{ label: 'PHOSPHOR ICON', icon: 'an an-newspaper' }]">
2029
+ * </po-component>
2030
+ * ```
2031
+ *
2032
+ * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca Font Awesome, da seguinte forma:
2033
+ * ```
2034
+ * <po-component
2035
+ * [p-property]="[{ label: 'FA ICON', icon: 'fa fa-icon-podcast' }]">
2036
+ * </po-component>
2037
+ * ```
2038
+ *
2039
+ * Outra opção seria a customização do ícone através do `TemplateRef`, conforme exemplo abaixo:
2040
+ * component.html:
2041
+ * ```
2042
+ * <ng-template #iconTemplate>
2043
+ * <ion-icon name="heart"></ion-icon>
2044
+ * </ng-template>
2045
+ *
2046
+ * <po-component [p-property]="myProperty"></po-component>
2047
+ * ```
2048
+ * component.ts:
2049
+ * ```
2050
+ * @ViewChild('iconTemplate', { static: true } ) iconTemplate : TemplateRef<void>;
2051
+ *
2052
+ * myProperty = [
2053
+ * {
2054
+ * label: 'FA ICON',
2055
+ * icon: this.iconTemplate
2056
+ * }
2057
+ * ];
2058
+ * ```
2059
+ */
2060
+ icon?: string | TemplateRef<void>;
2061
+ /**
2062
+ * @description
2063
+ *
2064
+ * Atribui uma linha separadora acima do item.
2065
+ *
2066
+ * */
2067
+ separator?: boolean;
2068
+ /**
2069
+ * @description
2070
+ *
2071
+ * Função que deve retornar um booleano para habilitar ou desabilitar a ação para o registro selecionado.
2072
+ *
2073
+ * Também é possível informar diretamente um valor booleano que vai habilitar ou desabilitar a ação para todos os registros.
2074
+ *
2075
+ */
2076
+ disabled?: boolean | Function;
2077
+ /**
2078
+ * @description
2079
+ *
2080
+ * Define a cor do item, sendo `default` o padrão.
2081
+ *
2082
+ * Valores válidos:
2083
+ * - `default`
2084
+ * - `danger` - indicado para ações exclusivas (excluir, sair).
2085
+ */
2086
+ type?: string;
2087
+ /**
2088
+ * @description
2089
+ *
2090
+ * URL utilizada para redirecionamento das páginas.
2091
+ *
2092
+ * No componente `po-dropdown`, a url também pode ser configurada para o agrupador de subitens.
2093
+ * Entretanto, quando a `url` é informada em um agrupador, o clique **não abrirá os subitens**, pois o item será
2094
+ * tratado como um link e o redirecionamento terá prioridade sobre a exibição da lista.
2095
+ *
2096
+ */
2097
+ url?: string;
2098
+ /**
2099
+ * @description
2100
+ *
2101
+ * Define se a ação está selecionada.
2102
+ *
2103
+ */
2104
+ selected?: boolean;
2105
+ /**
2106
+ * @description
2107
+ *
2108
+ * Define se a ação será visível.
2109
+ *
2110
+ * > Caso o valor não seja especificado a ação será visível.
2111
+ *
2112
+ * Opções para tornar a ação visível ou não:
2113
+ *
2114
+ * - Função que deve retornar um booleano.
2115
+ *
2116
+ * - Informar diretamente um valor booleano.
2117
+ *
2118
+ */
2119
+ visible?: boolean | Function;
2120
+ $id?: string;
2121
+ }
2122
+
2123
+ /**
2124
+ * @description
2125
+ * Interface do componente po-dropdown
2126
+ *
2127
+ * @docsExtends PoPopupAction
2128
+ *
2129
+ * @usedBy PoDropdownComponent
2130
+ */
2131
+ interface PoDropdownAction extends PoPopupAction {
2132
+ /**
2133
+ * Array de ações (`PoDropdownAction`) usado para criar agrupadores de subitens.
2134
+ *
2135
+ * - Permite a criação de menus aninhados (submenus).
2136
+ *
2137
+ * > Boas práticas de desenvolvimento:
2138
+ * Recomenda-se limitar a navegação a, no máximo, três níveis hierárquicos.
2139
+ * Isso evita sobrecarga cognitiva, facilita a memorização da estrutura e garante uma melhor experiência de uso.
2140
+ */
2141
+ subItems?: Array<PoDropdownAction>;
2142
+ }
2143
+
2144
+ declare class PoListBoxComponent extends PoListBoxBaseComponent implements OnInit, AfterViewInit, OnChanges, OnDestroy {
1973
2145
  element: ElementRef<any>;
2146
+ currentItems: Array<PoDropdownAction>;
2147
+ currentGroup: PoDropdownAction | null;
2148
+ private readonly navigationStack;
1974
2149
  private readonly renderer;
1975
2150
  private readonly router;
1976
2151
  private readonly changeDetector;
1977
2152
  listbox: ElementRef;
1978
2153
  listboxItemList: ElementRef;
2154
+ listboxGroupHeader: ElementRef;
1979
2155
  searchElement: PoSearchListComponent;
1980
2156
  popupHeaderContainer: ElementRef;
2157
+ listboxItems: QueryList<ElementRef>;
1981
2158
  private scrollEvent$;
1982
2159
  private subscriptionScrollEvent;
1983
2160
  constructor();
2161
+ ngOnInit(): void;
1984
2162
  ngAfterViewInit(): void;
1985
2163
  ngOnChanges(changes?: SimpleChanges): void;
1986
2164
  ngOnDestroy(): void;
1987
- onSelectItem(itemListAction: PoItemListOption | PoItemListOptionGroup | any): void | Promise<boolean>;
2165
+ openGroup(group: PoDropdownAction, event?: MouseEvent | KeyboardEvent): void;
2166
+ goBack(event: MouseEvent | KeyboardEvent): void;
2167
+ onKeydownGoBack(event: KeyboardEvent): void;
2168
+ onSelectItem(itemListAction: PoItemListOption | PoItemListOptionGroup | any, event?: MouseEvent | KeyboardEvent): void | Promise<boolean>;
1988
2169
  onSelectAllCheckboxKeyDown(event: KeyboardEvent): void;
1989
2170
  onKeyDown(itemListAction: PoItemListOption | PoItemListOptionGroup | any, event?: KeyboardEvent): void;
1990
2171
  checkboxClicked({ option, selected }: {
@@ -2011,6 +2192,7 @@ declare class PoListBoxComponent extends PoListBoxBaseComponent implements After
2011
2192
  private includeInfiniteScroll;
2012
2193
  protected returnBooleanValue(itemListAction: any, property: string): any;
2013
2194
  private setListBoxMaxHeight;
2195
+ private setListBoxWidth;
2014
2196
  private openUrl;
2015
2197
  onClickTabs(tab: any): void;
2016
2198
  formatItemList(item: any): string;
@@ -2213,9 +2395,20 @@ declare class PoHelperBaseComponent {
2213
2395
  * @default `false`
2214
2396
  */
2215
2397
  disabled: i0.InputSignal<boolean>;
2398
+ /**
2399
+ * @Input
2400
+ *
2401
+ * @optional
2402
+ *
2403
+ * @description
2404
+ * Define que o popover será inserido no body da página em vez do elemento definido em `p-target`. Essa opção pode
2405
+ * ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o posicionamento
2406
+ * correto do conteúdo próximo ao elemento.
2407
+ */
2408
+ appendBox: i0.InputSignal<boolean>;
2216
2409
  private transformHelper;
2217
2410
  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>;
2411
+ 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
2412
  }
2220
2413
 
2221
2414
  /**
@@ -2359,8 +2552,20 @@ declare class PoPopoverBaseComponent {
2359
2552
  */
2360
2553
  set trigger(value: string);
2361
2554
  get trigger(): string;
2555
+ /**
2556
+ * @Input
2557
+ *
2558
+ * @optional
2559
+ *
2560
+ * @description
2561
+ * Permite a inclusão de classes CSS customizadas ao componente.
2562
+ *
2563
+ * Exemplo: `p-custom-classes="minha-classe-1 minha-classe-2"`.
2564
+ *
2565
+ */
2566
+ customClasses: i0.InputSignal<string>;
2362
2567
  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>;
2568
+ 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
2569
  static ngAcceptInputType_appendBox: any;
2365
2570
  }
2366
2571
 
@@ -2394,7 +2599,10 @@ declare class PoPopoverComponent extends PoPopoverBaseComponent implements After
2394
2599
  timeoutResize: any;
2395
2600
  targetElement: any;
2396
2601
  afterViewInitWasCalled: boolean;
2602
+ private keydownTargetListener?;
2603
+ private keydownPopoverListener?;
2397
2604
  eventListenerFunction: () => void;
2605
+ private readonly tabbableSelector;
2398
2606
  constructor(renderer: Renderer2, poControlPosition: PoControlPositionService, cd: ChangeDetectorRef);
2399
2607
  ngOnChanges(changes: SimpleChanges): void;
2400
2608
  ngAfterViewInit(): void;
@@ -2412,6 +2620,14 @@ declare class PoPopoverComponent extends PoPopoverBaseComponent implements After
2412
2620
  private initEventListenerFunction;
2413
2621
  private removeListeners;
2414
2622
  private setElementsControlPosition;
2623
+ private focusOnTarget;
2624
+ private focusOnFirstFocusable;
2625
+ private attachPopoverKeydown;
2626
+ private isVisible;
2627
+ private getTabbablesIn;
2628
+ private getDocumentTabbables;
2629
+ private focusNextAfterTarget;
2630
+ private focusPrevBeforeTarget;
2415
2631
  static ɵfac: i0.ɵɵFactoryDeclaration<PoPopoverComponent, never>;
2416
2632
  static ɵcmp: i0.ɵɵComponentDeclaration<PoPopoverComponent, "po-popover", never, {}, {}, never, ["*"], false, never>;
2417
2633
  }
@@ -2716,7 +2932,7 @@ declare class PoButtonComponent extends PoButtonBaseComponent {
2716
2932
  * ou aguardando a resposta de alguma requisição.
2717
2933
  */
2718
2934
  declare class PoLoadingBaseComponent {
2719
- private languageService;
2935
+ protected languageService: PoLanguageService;
2720
2936
  private _text?;
2721
2937
  private _size?;
2722
2938
  /**
@@ -2726,14 +2942,17 @@ declare class PoLoadingBaseComponent {
2726
2942
  get text(): string;
2727
2943
  /**
2728
2944
  * Define o tamanho do ícone.
2729
- *
2730
- * @default `lg`
2731
- *
2732
2945
  * Valores válidos:
2733
2946
  * - `xs`: 16px
2734
2947
  * - `sm`: 24px
2735
2948
  * - `md`: 32px
2736
2949
  * - `lg`: 80px
2950
+ *
2951
+ * > Em nível de acessibilidade **AA**, caso o valor de `p-size` não seja definido, o valor padrão será `sm`
2952
+ * > quando o valor padrão dos componentes for configurado como `small` no
2953
+ * > [serviço de tema](https://po-ui.io/documentation/po-theme).
2954
+ *
2955
+ * @default `lg`
2737
2956
  */
2738
2957
  set size(value: string);
2739
2958
  get size(): string;
@@ -3061,6 +3280,7 @@ declare class PoHelperComponent extends PoHelperBaseComponent implements AfterVi
3061
3280
  ngOnChanges(changes: SimpleChanges): void;
3062
3281
  ngOnDestroy(): void;
3063
3282
  openHelperPopover(): void;
3283
+ helperIsVisible(): boolean;
3064
3284
  closeHelperPopover(): void;
3065
3285
  emitClick(event: MouseEvent): void;
3066
3286
  onKeyDown(event: KeyboardEvent): void;
@@ -3243,8 +3463,7 @@ declare abstract class PoCheckboxBaseComponent implements ControlValueAccessor {
3243
3463
  * @optional
3244
3464
  *
3245
3465
  * @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.
3466
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
3248
3467
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
3249
3468
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
3250
3469
  *
@@ -3256,11 +3475,11 @@ declare abstract class PoCheckboxBaseComponent implements ControlValueAccessor {
3256
3475
  *
3257
3476
  * @description
3258
3477
  *
3259
- * Define que o tooltip (`p-additional-help-tooltip`) será incluído no body da página e não dentro do componente. Essa
3478
+ * Define que o popover (`p-helper`) será incluído no body da página e não dentro do componente. Essa
3260
3479
  * opção pode ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o
3261
3480
  * posicionamento correto do tooltip próximo ao elemento.
3262
3481
  *
3263
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
3482
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
3264
3483
  *
3265
3484
  * @default `false`
3266
3485
  */
@@ -3295,7 +3514,6 @@ declare abstract class PoCheckboxBaseComponent implements ControlValueAccessor {
3295
3514
  *
3296
3515
  * @description
3297
3516
  * 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
3517
  *
3300
3518
  * > 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
3519
  */
@@ -3368,10 +3586,10 @@ declare abstract class PoCheckboxBaseComponent implements ControlValueAccessor {
3368
3586
  *
3369
3587
  * @description
3370
3588
  *
3371
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
3589
+ * 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`.
3590
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
3372
3591
  *
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.
3592
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
3375
3593
  */
3376
3594
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
3377
3595
  /**
@@ -3428,7 +3646,6 @@ declare abstract class PoCheckboxBaseComponent implements ControlValueAccessor {
3428
3646
  declare class PoCheckboxComponent extends PoCheckboxBaseComponent implements AfterViewInit, OnChanges, OnInit {
3429
3647
  private readonly changeDetector;
3430
3648
  private _iconToken;
3431
- helperSettings: PoHelperOptions;
3432
3649
  showTip: boolean;
3433
3650
  checkboxLabel: ElementRef;
3434
3651
  labelEl: ElementRef<HTMLElement>;
@@ -3462,20 +3679,12 @@ declare class PoCheckboxComponent extends PoCheckboxBaseComponent implements Aft
3462
3679
  getAdditionalHelpTooltip(): string;
3463
3680
  onKeyDown(event: KeyboardEvent, value: boolean | string): void;
3464
3681
  /**
3465
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
3682
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
3466
3683
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
3467
3684
  *
3468
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
3685
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
3469
3686
  *
3470
3687
  * ```
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
3688
  * //Exemplo com label e p-helper
3480
3689
  * <po-checkbox
3481
3690
  * #checkbox
@@ -3603,6 +3812,8 @@ declare class PoFieldContainerBottomComponent implements OnChanges {
3603
3812
  showAdditionalHelp: boolean;
3604
3813
  /** Exibe o ícone de ajuda adicional. */
3605
3814
  showAdditionalHelpIcon: boolean;
3815
+ /** Define o tamanho do componente. */
3816
+ size?: string;
3606
3817
  /** Evento disparado ao clicar no ícone de ajuda adicional. */
3607
3818
  /** @deprecated v23.x.x */
3608
3819
  additionalHelp: EventEmitter<any>;
@@ -3613,7 +3824,7 @@ declare class PoFieldContainerBottomComponent implements OnChanges {
3613
3824
  private isInitialChange;
3614
3825
  ngOnChanges(changes: SimpleChanges): void;
3615
3826
  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>;
3827
+ 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
3828
  static ngAcceptInputType_appendBox: any;
3618
3829
  }
3619
3830
 
@@ -3661,13 +3872,15 @@ declare class PoFieldContainerComponent implements OnInit, OnChanges {
3661
3872
  get required(): boolean;
3662
3873
  /** Define se a indicação de campo obrigatório será exibida. */
3663
3874
  showRequired: boolean;
3875
+ /** Define o tamanho do componente. */
3876
+ size?: string;
3664
3877
  constructor(cdr: ChangeDetectorRef);
3665
3878
  ngOnInit(): void;
3666
3879
  ngOnChanges(changes: SimpleChanges): void;
3667
3880
  private setRequirement;
3668
3881
  handleLabelTooltip(): void;
3669
3882
  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>;
3883
+ 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
3884
  }
3672
3885
 
3673
3886
  /**
@@ -3686,110 +3899,11 @@ declare class PoCheckboxModule {
3686
3899
  static ɵmod: i0.ɵɵNgModuleDeclaration<PoCheckboxModule, [typeof PoCheckboxComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoLabelModule, typeof PoFieldContainerModule, typeof PoHelperModule, typeof PoTooltipModule], [typeof PoCheckboxComponent]>;
3687
3900
  static ɵinj: i0.ɵɵInjectorDeclaration<PoCheckboxModule>;
3688
3901
  }
3689
-
3690
- declare class PoListBoxModule {
3691
- static ɵfac: i0.ɵɵFactoryDeclaration<PoListBoxModule, never>;
3692
- static ɵmod: i0.ɵɵNgModuleDeclaration<PoListBoxModule, [typeof PoListBoxComponent, typeof PoItemListComponent, typeof PoSearchListComponent], [typeof i2.CommonModule, typeof PoCheckboxModule, typeof PoIconModule, typeof PoLoadingModule, typeof i8.CdkListboxModule], [typeof PoListBoxComponent]>;
3693
- static ɵinj: i0.ɵɵInjectorDeclaration<PoListBoxModule>;
3694
- }
3695
-
3696
- /**
3697
- * @usedBy PoPopupComponent, PoWidgetComponent
3698
- *
3699
- * @description
3700
- *
3701
- * Interface para lista de ações do componente.
3702
- */
3703
- interface PoPopupAction {
3704
- /** Rótulo da ação. */
3705
- label: string;
3706
- /**
3707
- * Ação que será executada, sendo possível passar o nome ou a referência da função.
3708
- *
3709
- * > Para que a função seja executada no contexto do elemento filho o mesmo deve ser passado utilizando *bind*.
3710
- *
3711
- * Exemplo: `action: this.myFunction.bind(this)`
3712
- */
3713
- action?: Function;
3714
- /**
3715
- * @description
3716
- *
3717
- * Define um ícone que será exibido ao lado esquerdo do rótulo.
3718
- *
3719
- * É possível usar qualquer um dos ícones da [Biblioteca de ícones](https://po-ui.io/icons). conforme exemplo abaixo:
3720
- * ```
3721
- * <po-component
3722
- * [p-property]="[{ label: 'PHOSPHOR ICON', icon: 'an an-newspaper' }]">
3723
- * </po-component>
3724
- * ```
3725
- *
3726
- * Também é possível utilizar outras fontes de ícones, por exemplo a biblioteca Font Awesome, da seguinte forma:
3727
- * ```
3728
- * <po-component
3729
- * [p-property]="[{ label: 'FA ICON', icon: 'fa fa-icon-podcast' }]">
3730
- * </po-component>
3731
- * ```
3732
- *
3733
- * Outra opção seria a customização do ícone através do `TemplateRef`, conforme exemplo abaixo:
3734
- * component.html:
3735
- * ```
3736
- * <ng-template #iconTemplate>
3737
- * <ion-icon name="heart"></ion-icon>
3738
- * </ng-template>
3739
- *
3740
- * <po-component [p-property]="myProperty"></po-component>
3741
- * ```
3742
- * component.ts:
3743
- * ```
3744
- * @ViewChild('iconTemplate', { static: true } ) iconTemplate : TemplateRef<void>;
3745
- *
3746
- * myProperty = [
3747
- * {
3748
- * label: 'FA ICON',
3749
- * icon: this.iconTemplate
3750
- * }
3751
- * ];
3752
- * ```
3753
- */
3754
- icon?: string | TemplateRef<void>;
3755
- /** Atribui uma linha separadora acima do item. */
3756
- separator?: boolean;
3757
- /**
3758
- * Função que deve retornar um booleano para habilitar ou desabilitar a ação para o registro selecionado.
3759
- *
3760
- * Também é possível informar diretamente um valor booleano que vai habilitar ou desabilitar a ação para todos os registros.
3761
- */
3762
- disabled?: boolean | Function;
3763
- /**
3764
- * @description
3765
- *
3766
- * Define a cor do item, sendo `default` o padrão.
3767
- *
3768
- * Valores válidos:
3769
- * - `default`
3770
- * - `danger` - indicado para ações exclusivas (excluir, sair).
3771
- */
3772
- type?: string;
3773
- /** URL utilizada no redirecionamento das páginas. */
3774
- url?: string;
3775
- /** Define se a ação está selecionada. */
3776
- selected?: boolean;
3777
- /**
3778
- * @description
3779
- *
3780
- * Define se a ação será visível.
3781
- *
3782
- * > Caso o valor não seja especificado a ação será visível.
3783
- *
3784
- * Opções para tornar a ação visível ou não:
3785
- *
3786
- * - Função que deve retornar um booleano.
3787
- *
3788
- * - Informar diretamente um valor booleano.
3789
- *
3790
- */
3791
- visible?: boolean | Function;
3792
- $id?: string;
3902
+
3903
+ declare class PoListBoxModule {
3904
+ static ɵfac: i0.ɵɵFactoryDeclaration<PoListBoxModule, never>;
3905
+ static ɵmod: i0.ɵɵNgModuleDeclaration<PoListBoxModule, [typeof PoListBoxComponent, typeof PoItemListComponent, typeof PoSearchListComponent], [typeof i2.CommonModule, typeof PoCheckboxModule, typeof PoIconModule, typeof PoLoadingModule, typeof PoTagModule, typeof i9.CdkListboxModule], [typeof PoListBoxComponent]>;
3906
+ static ɵinj: i0.ɵɵInjectorDeclaration<PoListBoxModule>;
3793
3907
  }
3794
3908
 
3795
3909
  /**
@@ -3867,6 +3981,7 @@ declare class PoPopupBaseComponent {
3867
3981
  private _position?;
3868
3982
  private _size?;
3869
3983
  private _target;
3984
+ listboxSubitems: boolean;
3870
3985
  /** Lista de ações que serão exibidas no componente. */
3871
3986
  set actions(value: Array<PoPopupAction>);
3872
3987
  get actions(): Array<PoPopupAction>;
@@ -3998,7 +4113,7 @@ declare class PoPopupBaseComponent {
3998
4113
  closeEvent: EventEmitter<any>;
3999
4114
  clickItem: EventEmitter<any>;
4000
4115
  static ɵfac: i0.ɵɵFactoryDeclaration<PoPopupBaseComponent, never>;
4001
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoPopupBaseComponent, never, never, { "actions": { "alias": "p-actions"; "required": false; }; "hideArrow": { "alias": "p-hide-arrow"; "required": false; }; "isCornerAlign": { "alias": "p-is-corner-align"; "required": false; }; "position": { "alias": "p-position"; "required": false; }; "customPositions": { "alias": "p-custom-positions"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "target": { "alias": "p-target"; "required": false; }; }, { "closeEvent": "p-close"; "clickItem": "p-click-item"; }, never, never, true, never>;
4116
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoPopupBaseComponent, never, never, { "listboxSubitems": { "alias": "p-listbox-subitems"; "required": false; }; "actions": { "alias": "p-actions"; "required": false; }; "hideArrow": { "alias": "p-hide-arrow"; "required": false; }; "isCornerAlign": { "alias": "p-is-corner-align"; "required": false; }; "position": { "alias": "p-position"; "required": false; }; "customPositions": { "alias": "p-custom-positions"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "target": { "alias": "p-target"; "required": false; }; }, { "closeEvent": "p-close"; "clickItem": "p-click-item"; }, never, never, true, never>;
4002
4117
  }
4003
4118
 
4004
4119
  /**
@@ -5068,7 +5183,7 @@ declare enum PoTableRowTemplateArrowDirection {
5068
5183
  * Tipos de espaçamento interno (padding) das células (**p-spacing**) do po-table.
5069
5184
  */
5070
5185
  declare enum PoTableColumnSpacing {
5071
- /** Espaçamento extra pequeno: 0.25rem (vertical) x 1rem (horizontal). */
5186
+ /** Espaçamento extra pequeno: 0.25rem (vertical) x 0.5rem (horizontal). */
5072
5187
  ExtraSmall = "extraSmall",
5073
5188
  /** Espaçamento pequeno: 0.5rem (vertical) x 1rem (horizontal). */
5074
5189
  Small = "small",
@@ -8228,8 +8343,7 @@ declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Vali
8228
8343
  * @optional
8229
8344
  *
8230
8345
  * @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.
8346
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
8233
8347
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
8234
8348
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
8235
8349
  *
@@ -8241,11 +8355,11 @@ declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Vali
8241
8355
  *
8242
8356
  * @description
8243
8357
  *
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
8358
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
8245
8359
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
8246
8360
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
8247
8361
  *
8248
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
8362
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
8249
8363
  *
8250
8364
  * @default `false`
8251
8365
  */
@@ -8313,10 +8427,10 @@ declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Vali
8313
8427
  *
8314
8428
  * @description
8315
8429
  *
8316
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
8430
+ * 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`.
8431
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
8317
8432
  *
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.
8433
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
8320
8434
  */
8321
8435
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
8322
8436
  /**
@@ -8355,7 +8469,6 @@ declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Vali
8355
8469
  *
8356
8470
  * @description
8357
8471
  * 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
8472
  *
8360
8473
  * > 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
8474
  */
@@ -8521,10 +8634,12 @@ declare class PoCheckboxGroupBaseComponent implements ControlValueAccessor, Vali
8521
8634
  * <file name="sample-po-checkbox-group-password-policy/sample-po-checkbox-group-password-policy.component.ts"> </file>
8522
8635
  * </example>
8523
8636
  */
8524
- declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseComponent implements AfterViewChecked, AfterViewInit {
8637
+ declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseComponent implements AfterViewChecked, AfterViewInit, OnChanges {
8525
8638
  private changeDetector;
8526
8639
  checkboxLabels: QueryList<PoCheckboxComponent>;
8640
+ helperEl?: PoHelperComponent;
8527
8641
  private el;
8642
+ ngOnChanges(changes: SimpleChanges): void;
8528
8643
  ngAfterViewChecked(): void;
8529
8644
  ngAfterViewInit(): void;
8530
8645
  onBlur(checkbox: PoCheckboxComponent): void;
@@ -8552,20 +8667,12 @@ declare class PoCheckboxGroupComponent extends PoCheckboxGroupBaseComponent impl
8552
8667
  hasInvalidClass(): any;
8553
8668
  onKeyDown(event: KeyboardEvent, option: PoCheckboxGroupOption, checkbox?: PoCheckboxComponent): void;
8554
8669
  /**
8555
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
8670
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
8556
8671
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
8557
8672
  *
8558
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
8673
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
8559
8674
  *
8560
8675
  * ```
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
8676
  * //Exemplo com p-label e p-helper
8570
8677
  * <po-checkbox-group
8571
8678
  * #checkboxGroup
@@ -8822,7 +8929,7 @@ declare class PoTableSubtitleFooterComponent implements AfterViewInit, DoCheck,
8822
8929
  */
8823
8930
  declare class PoCheckboxGroupModule {
8824
8931
  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]>;
8932
+ static ɵmod: i0.ɵɵNgModuleDeclaration<PoCheckboxGroupModule, [typeof PoCheckboxGroupComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof PoCheckboxModule, typeof PoHelperModule], [typeof PoCheckboxGroupComponent]>;
8826
8933
  static ɵinj: i0.ɵɵInjectorDeclaration<PoCheckboxGroupModule>;
8827
8934
  }
8828
8935
 
@@ -8982,8 +9089,7 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
8982
9089
  * @optional
8983
9090
  *
8984
9091
  * @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.
9092
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
8987
9093
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
8988
9094
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
8989
9095
  *
@@ -8995,11 +9101,11 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
8995
9101
  *
8996
9102
  * @description
8997
9103
  *
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
9104
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
8999
9105
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
9000
9106
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
9001
9107
  *
9002
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
9108
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
9003
9109
  *
9004
9110
  * @default `false`
9005
9111
  */
@@ -9028,7 +9134,6 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
9028
9134
  *
9029
9135
  * @description
9030
9136
  * 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
9137
  *
9033
9138
  * > 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
9139
  */
@@ -9062,20 +9167,12 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
9062
9167
  emitChange(value: any): void;
9063
9168
  getAdditionalHelpTooltip(): string;
9064
9169
  /**
9065
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
9170
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
9066
9171
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
9067
9172
  *
9068
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
9173
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
9069
9174
  *
9070
9175
  * ```
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
9176
  * // Exemplo com p-label e p-helper
9080
9177
  * <po-nome-component
9081
9178
  * #component
@@ -9094,7 +9191,7 @@ declare abstract class PoFieldModel<T> implements ControlValueAccessor {
9094
9191
  * }
9095
9192
  * ```
9096
9193
  */
9097
- showAdditionalHelp(): boolean;
9194
+ showAdditionalHelp(helperHtmlElement?: PoHelperComponent, poHelperComponent?: string | PoHelperOptions): boolean;
9098
9195
  showAdditionalHelpIcon(): boolean;
9099
9196
  protected isAdditionalHelpEventTriggered(): boolean;
9100
9197
  protected updateModel(value: T): void;
@@ -9118,6 +9215,15 @@ declare class PoRadioComponent extends PoFieldModel<boolean> {
9118
9215
  set size(value: string);
9119
9216
  get size(): string;
9120
9217
  required?: boolean;
9218
+ /**
9219
+ *
9220
+ * Habilita a quebra automática do texto da propriedade `p-label`. Quando `p-label-text-wrap` for verdadeiro, o texto que excede
9221
+ * o espaço disponível é transferido para a próxima linha em pontos apropriados para uma
9222
+ * leitura clara.
9223
+ *
9224
+ * @default `false`
9225
+ */
9226
+ labelTextWrap?: boolean;
9121
9227
  /** Define o status do *radio* */
9122
9228
  checked: boolean;
9123
9229
  blur: EventEmitter<any>;
@@ -9152,8 +9258,9 @@ declare class PoRadioComponent extends PoFieldModel<boolean> {
9152
9258
  onKeyup(): void;
9153
9259
  onKeydown(): void;
9154
9260
  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>;
9261
+ 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
9262
  static ngAcceptInputType_required: any;
9263
+ static ngAcceptInputType_labelTextWrap: any;
9157
9264
  }
9158
9265
 
9159
9266
  declare class PoRadioModule {
@@ -9249,10 +9356,11 @@ declare enum PoSwitchLabelPosition {
9249
9356
  * <file name="sample-po-switch-order-reactive-form/sample-po-switch-order-reactive-form.component.ts"> </file>
9250
9357
  * </example>
9251
9358
  */
9252
- declare class PoSwitchComponent extends PoFieldModel<any> implements Validator, AfterViewInit, OnDestroy {
9359
+ declare class PoSwitchComponent extends PoFieldModel<any> implements Validator, AfterViewInit, OnDestroy, OnChanges {
9253
9360
  private readonly changeDetector;
9254
9361
  private readonly injector;
9255
9362
  switchContainer: ElementRef;
9363
+ helperEl?: PoHelperComponent;
9256
9364
  id: string;
9257
9365
  value: boolean;
9258
9366
  private _labelOff;
@@ -9369,10 +9477,10 @@ declare class PoSwitchComponent extends PoFieldModel<any> implements Validator,
9369
9477
  *
9370
9478
  * @description
9371
9479
  *
9372
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
9480
+ * 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`.
9481
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
9373
9482
  *
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.
9483
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
9376
9484
  */
9377
9485
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
9378
9486
  /**
@@ -9391,6 +9499,7 @@ declare class PoSwitchComponent extends PoFieldModel<any> implements Validator,
9391
9499
  private readonly el;
9392
9500
  private readonly injectOptions;
9393
9501
  private control;
9502
+ ngOnChanges(changes: SimpleChanges): void;
9394
9503
  ngOnDestroy(): void;
9395
9504
  /**
9396
9505
  * Função que atribui foco ao componente.
@@ -9425,6 +9534,31 @@ declare class PoSwitchComponent extends PoFieldModel<any> implements Validator,
9425
9534
  hideAdditionalHelp: boolean;
9426
9535
  helperSettings?: any;
9427
9536
  };
9537
+ /**
9538
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
9539
+ * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
9540
+ *
9541
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
9542
+ *
9543
+ * ```
9544
+ * //Exemplo com p-label e p-helper
9545
+ * <po-switch
9546
+ * #switch
9547
+ * ...
9548
+ * p-label="Label do switch"
9549
+ * [p-helper]="helperOptions"
9550
+ * (p-keydown)="onKeyDown($event, switch)"
9551
+ * ></po-switch>
9552
+ * ```
9553
+ * ```typescript
9554
+ * onKeyDown(event: KeyboardEvent, inp: PoSwitchComponent): void {
9555
+ * if (event.code === 'F9') {
9556
+ * inp.showAdditionalHelp();
9557
+ * }
9558
+ * }
9559
+ * ```
9560
+ */
9561
+ showAdditionalHelp(): boolean;
9428
9562
  static ɵfac: i0.ɵɵFactoryDeclaration<PoSwitchComponent, never>;
9429
9563
  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
9564
  static ngAcceptInputType_value: any;
@@ -9438,17 +9572,6 @@ declare class PoSwitchModule {
9438
9572
  static ɵinj: i0.ɵɵInjectorDeclaration<PoSwitchModule>;
9439
9573
  }
9440
9574
 
9441
- /**
9442
- * @description
9443
- * Interface do componente po-dropdown
9444
- *
9445
- * @docsExtends PoPopupAction
9446
- *
9447
- * @usedBy PoDropdownComponent
9448
- */
9449
- interface PoDropdownAction extends PoPopupAction {
9450
- }
9451
-
9452
9575
  /**
9453
9576
  * @description
9454
9577
  *
@@ -9560,6 +9683,11 @@ declare class PoDropdownBaseComponent {
9560
9683
  * <file name="sample-po-dropdown-basic/sample-po-dropdown-basic.component.ts"> </file>
9561
9684
  * </example>
9562
9685
  *
9686
+ * <example name="po-dropdown-subitems" title="PO Dropdown Subitems" >
9687
+ * <file name="sample-po-dropdown-subitems/sample-po-dropdown-subitems.component.html"> </file>
9688
+ * <file name="sample-po-dropdown-subitems/sample-po-dropdown-subitems.component.ts"> </file>
9689
+ * </example>
9690
+ *
9563
9691
  * <example name="po-dropdown-labs" title="PO Dropdown Labs" >
9564
9692
  * <file name="sample-po-dropdown-labs/sample-po-dropdown-labs.component.html"> </file>
9565
9693
  * <file name="sample-po-dropdown-labs/sample-po-dropdown-labs.component.ts"> </file>
@@ -10027,6 +10155,22 @@ declare class PoSearchBaseComponent {
10027
10155
  * > Incompatível com a propriedade `p-search-type` do tipo `locate`.
10028
10156
  */
10029
10157
  filteredItemsChange: EventEmitter<any[]>;
10158
+ /**
10159
+ * @optional
10160
+ *
10161
+ * @description
10162
+ *
10163
+ * Evento emitido quando o campo de entrada (input) recebe foco.
10164
+ */
10165
+ focusEvent: EventEmitter<any>;
10166
+ /**
10167
+ * @optional
10168
+ *
10169
+ * @description
10170
+ * Evento disparado quando uma tecla é pressionada enquanto o foco está no componente.
10171
+ * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
10172
+ */
10173
+ keydown: EventEmitter<KeyboardEvent>;
10030
10174
  /**
10031
10175
  * @optional
10032
10176
  *
@@ -10069,7 +10213,7 @@ declare class PoSearchBaseComponent {
10069
10213
  constructor(languageService: PoLanguageService);
10070
10214
  ensureFilterSelectOption(values: any): any[];
10071
10215
  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>;
10216
+ 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
10217
  static ngAcceptInputType_disabled: any;
10074
10218
  static ngAcceptInputType_showListbox: any;
10075
10219
  }
@@ -10191,7 +10335,7 @@ declare class PoSearchComponent extends PoSearchBaseComponent implements OnInit,
10191
10335
  getInputValue(): any;
10192
10336
  createDropdownFilterSelect(): void;
10193
10337
  isSelected(filterOption: PoSearchFilterSelect): boolean;
10194
- changeFilterSelect(filterOption: PoSearchFilterSelect): void;
10338
+ changeFilterSelect(filterOption: PoSearchFilterSelect, focus?: boolean): void;
10195
10339
  handlerFooterActionListbox(): void;
10196
10340
  private openListboxFooterAction;
10197
10341
  private handlerPlaceholderListbox;
@@ -10872,9 +11016,10 @@ interface PoChartSerie {
10872
11016
  * @description
10873
11017
  *
10874
11018
  * 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)`
11019
+ * * Hexadecimal, por exemplo `#c64840`;
11020
+ * * RGB, por exemplo `rgb(0, 0, 165)`
10877
11021
  * * O nome da cor, por exemplo `blue`;
11022
+ * * Variáveis CSS, por exemplo `var(--color-01)`;
10878
11023
  * * Usando uma das cores do tema do PO:
10879
11024
  * Valores válidos:
10880
11025
  * - <span class="dot po-color-01"></span> `color-01`
@@ -11978,8 +12123,7 @@ declare abstract class PoComboBaseComponent implements ControlValueAccessor, OnI
11978
12123
  * @optional
11979
12124
  *
11980
12125
  * @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.
12126
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
11983
12127
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
11984
12128
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
11985
12129
  *
@@ -12153,7 +12297,6 @@ declare abstract class PoComboBaseComponent implements ControlValueAccessor, OnI
12153
12297
  *
12154
12298
  * @description
12155
12299
  * 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
12300
  *
12158
12301
  * > 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
12302
  */
@@ -12240,10 +12383,10 @@ declare abstract class PoComboBaseComponent implements ControlValueAccessor, OnI
12240
12383
  *
12241
12384
  * @description
12242
12385
  *
12243
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
12386
+ * 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`.
12387
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
12244
12388
  *
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.
12389
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
12247
12390
  */
12248
12391
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
12249
12392
  /**
@@ -12509,11 +12652,11 @@ declare abstract class PoComboBaseComponent implements ControlValueAccessor, OnI
12509
12652
  *
12510
12653
  * @description
12511
12654
  *
12512
- * Define que o `listbox` e/ou tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) serão incluídos no body da
12655
+ * Define que o `listbox` e/ou popover (`p-helper` e/ou `p-error-limit`) serão incluídos no body da
12513
12656
  * 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
12657
  * overflow escondido,garantindo o posicionamento correto de ambos próximo ao elemento.
12515
12658
  *
12516
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
12659
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
12517
12660
  *
12518
12661
  * @default `false`
12519
12662
  */
@@ -12642,6 +12785,7 @@ declare class PoComboComponent extends PoComboBaseComponent implements AfterView
12642
12785
  iconElement: ElementRef;
12643
12786
  inputEl: ElementRef;
12644
12787
  poListbox: PoListBoxComponent;
12788
+ helperEl?: PoHelperComponent;
12645
12789
  comboIcon: string;
12646
12790
  comboOpen: boolean;
12647
12791
  differ: any;
@@ -12651,7 +12795,6 @@ declare class PoComboComponent extends PoComboBaseComponent implements AfterView
12651
12795
  shouldMarkLetters: boolean;
12652
12796
  infiniteLoading: boolean;
12653
12797
  containerWidth: number;
12654
- helperSettings: PoHelperOptions;
12655
12798
  private _isServerSearching;
12656
12799
  private lastKey;
12657
12800
  private clickoutListener;
@@ -12707,18 +12850,11 @@ declare class PoComboComponent extends PoComboBaseComponent implements AfterView
12707
12850
  getInputValue(): any;
12708
12851
  setInputValue(value: string): void;
12709
12852
  /**
12710
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
12853
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
12711
12854
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
12712
12855
  *
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
- * ```
12856
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
12857
+ *
12722
12858
  * ```
12723
12859
  * // Exemplo com p-label e p-helper
12724
12860
  * <po-combo
@@ -12923,8 +13059,7 @@ declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor
12923
13059
  * @optional
12924
13060
  *
12925
13061
  * @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.
13062
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
12928
13063
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
12929
13064
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
12930
13065
  *
@@ -13011,7 +13146,6 @@ declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor
13011
13146
  *
13012
13147
  * @description
13013
13148
  * 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
13149
  *
13016
13150
  * > 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
13151
  */
@@ -13047,10 +13181,10 @@ declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor
13047
13181
  *
13048
13182
  * @description
13049
13183
  *
13050
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
13184
+ * 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`.
13185
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
13051
13186
  *
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.
13187
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
13054
13188
  */
13055
13189
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
13056
13190
  /**
@@ -13217,7 +13351,7 @@ declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor
13217
13351
  * 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
13352
  * overflow escondido, garantindo o posicionamento correto de ambos próximo ao elemento.
13219
13353
  *
13220
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
13354
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
13221
13355
  *
13222
13356
  * @default `false`
13223
13357
  */
@@ -13274,13 +13408,14 @@ declare abstract class PoDatepickerBaseComponent implements ControlValueAccessor
13274
13408
  * <file name="sample-po-datepicker-airfare-reactive-form/sample-po-datepicker-airfare-reactive-form.component.ts"> </file>
13275
13409
  * </example>
13276
13410
  */
13277
- declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements AfterViewInit, OnDestroy {
13411
+ declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements AfterViewInit, OnDestroy, OnChanges {
13278
13412
  private controlPosition;
13279
13413
  private renderer;
13280
13414
  calendar: PoCalendarComponent;
13281
13415
  dialogPicker: ElementRef;
13282
13416
  iconDatepicker: PoButtonComponent;
13283
13417
  inputEl: ElementRef;
13418
+ helperEl?: PoHelperComponent;
13284
13419
  /** Rótulo do campo. */
13285
13420
  label?: string;
13286
13421
  /** Texto de apoio do campo. */
@@ -13291,7 +13426,6 @@ declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements
13291
13426
  id: string;
13292
13427
  visible: boolean;
13293
13428
  literals: any;
13294
- helperSettings: PoHelperOptions;
13295
13429
  eventListenerFunction: () => void;
13296
13430
  eventResizeListener: () => void;
13297
13431
  private clickListener;
@@ -13305,6 +13439,7 @@ declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements
13305
13439
  onKeyup($event: any): void;
13306
13440
  onKeydown($event?: any): void;
13307
13441
  ngAfterViewInit(): void;
13442
+ ngOnChanges(changes: SimpleChanges): void;
13308
13443
  ngOnDestroy(): void;
13309
13444
  emitAdditionalHelp(): void;
13310
13445
  /**
@@ -13339,20 +13474,12 @@ declare class PoDatepickerComponent extends PoDatepickerBaseComponent implements
13339
13474
  formatToDate(value: Date): string;
13340
13475
  refreshValue(value: Date): void;
13341
13476
  /**
13342
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
13477
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
13343
13478
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
13344
13479
  *
13345
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
13480
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
13346
13481
  *
13347
13482
  * ```
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
13483
  * // Exemplo com p-label e p-helper
13357
13484
  * <po-datepicker
13358
13485
  * #datepicker
@@ -13489,8 +13616,7 @@ declare abstract class PoDatepickerRangeBaseComponent implements ControlValueAcc
13489
13616
  * @optional
13490
13617
  *
13491
13618
  * @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.
13619
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
13494
13620
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
13495
13621
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
13496
13622
  *
@@ -13506,7 +13632,7 @@ declare abstract class PoDatepickerRangeBaseComponent implements ControlValueAcc
13506
13632
  * 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
13633
  * overflow escondido, garantindo o posicionamento correto de ambos próximo ao elemento.
13508
13634
  *
13509
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
13635
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
13510
13636
  *
13511
13637
  * @default `false`
13512
13638
  */
@@ -13572,7 +13698,6 @@ declare abstract class PoDatepickerRangeBaseComponent implements ControlValueAcc
13572
13698
  *
13573
13699
  * @description
13574
13700
  * 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
13701
  *
13577
13702
  * > 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
13703
  */
@@ -13597,10 +13722,10 @@ declare abstract class PoDatepickerRangeBaseComponent implements ControlValueAcc
13597
13722
  *
13598
13723
  * @description
13599
13724
  *
13600
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
13725
+ * 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`.
13726
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
13601
13727
  *
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.
13728
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
13604
13729
  */
13605
13730
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
13606
13731
  /**
@@ -13887,8 +14012,8 @@ declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseComponent
13887
14012
  startDateInput: ElementRef;
13888
14013
  iconCalendar: ElementRef;
13889
14014
  calendarPicker: ElementRef;
14015
+ helperEl?: PoHelperComponent;
13890
14016
  isCalendarVisible: boolean;
13891
- helperSettings: PoHelperOptions;
13892
14017
  private clickListener;
13893
14018
  private eventResizeListener;
13894
14019
  private poDatepickerRangeElement;
@@ -13942,20 +14067,12 @@ declare class PoDatepickerRangeComponent extends PoDatepickerRangeBaseComponent
13942
14067
  resetDateRangeInputValidation(): void;
13943
14068
  showAdditionalHelpIcon(): boolean;
13944
14069
  /**
13945
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
14070
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
13946
14071
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
13947
14072
  *
13948
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
14073
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
13949
14074
  *
13950
14075
  * ```
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
14076
  * // Exemplo com p-label e p-helper
13960
14077
  * <po-datepicker-range
13961
14078
  * #datepickerRange
@@ -14094,6 +14211,7 @@ interface ErrorAsyncProperties {
14094
14211
  declare abstract class PoInputBaseComponent implements ControlValueAccessor, Validator, OnDestroy {
14095
14212
  protected cd?: ChangeDetectorRef;
14096
14213
  fieldContainer?: PoFieldContainerComponent;
14214
+ helperEl?: PoHelperComponent;
14097
14215
  additionalHelpEventTrigger: string | undefined;
14098
14216
  /**
14099
14217
  *
@@ -14102,8 +14220,7 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14102
14220
  * @optional
14103
14221
  *
14104
14222
  * @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.
14223
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
14107
14224
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
14108
14225
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
14109
14226
  *
@@ -14115,11 +14232,11 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14115
14232
  *
14116
14233
  * @description
14117
14234
  *
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
14235
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
14119
14236
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
14120
14237
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
14121
14238
  *
14122
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
14239
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
14123
14240
  *
14124
14241
  * @default `false`
14125
14242
  */
@@ -14277,7 +14394,6 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14277
14394
  *
14278
14395
  * @description
14279
14396
  * 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
14397
  *
14282
14398
  * > 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
14399
  */
@@ -14468,10 +14584,10 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14468
14584
  *
14469
14585
  * @description
14470
14586
  *
14471
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
14587
+ * 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`.
14588
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
14472
14589
  *
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.
14590
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
14475
14591
  */
14476
14592
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
14477
14593
  /**
@@ -14501,18 +14617,11 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14501
14617
  registerOnValidatorChange(fn: () => void): void;
14502
14618
  showAdditionalHelpIcon(): boolean;
14503
14619
  /**
14504
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
14620
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
14505
14621
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
14506
14622
  *
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
- * ```
14623
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
14624
+ *
14516
14625
  * ```
14517
14626
  * // Exemplo com p-label e p-helper
14518
14627
  * <po-nome-component
@@ -14523,6 +14632,7 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14523
14632
  * (p-keydown)="onKeyDown($event, component)"
14524
14633
  * ></po-nome-component>
14525
14634
  * ```
14635
+ *
14526
14636
  * ```
14527
14637
  * ...
14528
14638
  * onKeyDown(event: KeyboardEvent, inp: PoNomeDoComponente): void {
@@ -14611,7 +14721,7 @@ declare abstract class PoInputBaseComponent implements ControlValueAccessor, Val
14611
14721
  * <file name="sample-po-decimal-hourly-wage-reactive-form/sample-po-decimal-hourly-wage-reactive-form.component.ts"> </file>
14612
14722
  * </example>
14613
14723
  */
14614
- declare class PoDecimalComponent extends PoInputBaseComponent implements AfterViewInit, OnInit, OnDestroy {
14724
+ declare class PoDecimalComponent extends PoInputBaseComponent implements AfterViewInit, OnInit, OnDestroy, OnChanges {
14615
14725
  private el;
14616
14726
  private poLanguageService;
14617
14727
  inputEl: ElementRef;
@@ -14629,7 +14739,6 @@ declare class PoDecimalComponent extends PoInputBaseComponent implements AfterVi
14629
14739
  private thousandSeparator;
14630
14740
  private valueBeforeChange;
14631
14741
  private subscriptionValidator;
14632
- helperSettings: PoHelperOptions;
14633
14742
  private regex;
14634
14743
  get autocomplete(): "on" | "off";
14635
14744
  /**
@@ -14697,6 +14806,7 @@ declare class PoDecimalComponent extends PoInputBaseComponent implements AfterVi
14697
14806
  get max(): number;
14698
14807
  constructor();
14699
14808
  ngOnInit(): void;
14809
+ ngOnChanges(changes: SimpleChanges): void;
14700
14810
  setNumbersSeparators(): void;
14701
14811
  ngAfterViewInit(): void;
14702
14812
  ngOnDestroy(): void;
@@ -14766,7 +14876,6 @@ declare abstract class PoInputGeneric extends PoInputBaseComponent implements Af
14766
14876
  el: ElementRef;
14767
14877
  valueBeforeChange: any;
14768
14878
  timeoutChange: any;
14769
- helperSettings: PoHelperOptions;
14770
14879
  private subscriptionValidator;
14771
14880
  get autocomplete(): string;
14772
14881
  constructor(el: ElementRef, cd?: ChangeDetectorRef);
@@ -14829,7 +14938,7 @@ declare abstract class PoInputGeneric extends PoInputBaseComponent implements Af
14829
14938
  * <file name="sample-po-email-newsletter/sample-po-email-newsletter.component.ts"> </file>
14830
14939
  * </example>
14831
14940
  */
14832
- declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnInit {
14941
+ declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnChanges {
14833
14942
  id: string;
14834
14943
  icon: string;
14835
14944
  type: string;
@@ -14837,7 +14946,7 @@ declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit,
14837
14946
  mask: string;
14838
14947
  private listener;
14839
14948
  constructor();
14840
- ngOnInit(): void;
14949
+ ngOnChanges(changes: SimpleChanges): void;
14841
14950
  ngAfterViewInit(): void;
14842
14951
  ngOnDestroy(): void;
14843
14952
  extraValidation(c: AbstractControl): {
@@ -14867,11 +14976,11 @@ declare class PoEmailComponent extends PoInputGeneric implements AfterViewInit,
14867
14976
  * <file name="sample-po-input-reactive-form/sample-po-input-reactive-form.component.ts"> </file>
14868
14977
  * </example>
14869
14978
  */
14870
- declare class PoInputComponent extends PoInputGeneric implements OnInit {
14979
+ declare class PoInputComponent extends PoInputGeneric implements OnChanges {
14871
14980
  inp: ElementRef;
14872
14981
  id: string;
14873
14982
  constructor();
14874
- ngOnInit(): void;
14983
+ ngOnChanges(changes: SimpleChanges): void;
14875
14984
  extraValidation(c: AbstractControl): {
14876
14985
  [key: string]: any;
14877
14986
  };
@@ -14903,7 +15012,7 @@ declare class PoInputComponent extends PoInputGeneric implements OnInit {
14903
15012
  * </example>
14904
15013
  *
14905
15014
  */
14906
- declare class PoLoginComponent extends PoInputGeneric {
15015
+ declare class PoLoginComponent extends PoInputGeneric implements OnChanges {
14907
15016
  id: string;
14908
15017
  type: string;
14909
15018
  private _noAutocompleteLogin?;
@@ -14911,6 +15020,7 @@ declare class PoLoginComponent extends PoInputGeneric {
14911
15020
  get noAutocomplete(): boolean;
14912
15021
  get autocomplete(): string;
14913
15022
  constructor();
15023
+ ngOnChanges(changes: SimpleChanges): void;
14914
15024
  extraValidation(c: AbstractControl): {
14915
15025
  [key: string]: any;
14916
15026
  };
@@ -15473,8 +15583,7 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
15473
15583
  * @optional
15474
15584
  *
15475
15585
  * @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.
15586
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
15478
15587
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
15479
15588
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
15480
15589
  *
@@ -15486,11 +15595,11 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
15486
15595
  *
15487
15596
  * @description
15488
15597
  *
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
15598
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
15490
15599
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
15491
15600
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
15492
15601
  *
15493
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
15602
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
15494
15603
  *
15495
15604
  * @default `false`
15496
15605
  */
@@ -15799,10 +15908,10 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
15799
15908
  *
15800
15909
  * @description
15801
15910
  *
15802
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
15911
+ * 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`.
15912
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
15803
15913
  *
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.
15914
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
15806
15915
  */
15807
15916
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
15808
15917
  /**
@@ -15827,7 +15936,6 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
15827
15936
  *
15828
15937
  * @description
15829
15938
  * 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
15939
  *
15832
15940
  * > 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
15941
  */
@@ -16135,11 +16243,12 @@ declare abstract class PoLookupBaseComponent implements ControlValueAccessor, On
16135
16243
  * <file name="sample-po-lookup-multiple/sample-po-lookup-multiple.service.ts"> </file>
16136
16244
  * </example>
16137
16245
  */
16138
- declare class PoLookupComponent extends PoLookupBaseComponent implements AfterViewInit, OnDestroy, OnInit, DoCheck {
16246
+ declare class PoLookupComponent extends PoLookupBaseComponent implements AfterViewInit, OnDestroy, OnInit, DoCheck, OnChanges {
16139
16247
  private renderer;
16140
16248
  private cd;
16141
16249
  private el;
16142
16250
  inputEl: ElementRef;
16251
+ helperEl?: PoHelperComponent;
16143
16252
  initialized: boolean;
16144
16253
  timeoutResize: any;
16145
16254
  visibleElement: boolean;
@@ -16147,7 +16256,6 @@ declare class PoLookupComponent extends PoLookupBaseComponent implements AfterVi
16147
16256
  disclaimers: any[];
16148
16257
  visibleDisclaimers: any[];
16149
16258
  id: string;
16150
- helperSettings: PoHelperOptions;
16151
16259
  private modalSubscription;
16152
16260
  private isCalculateVisibleItems;
16153
16261
  get autocomplete(): "on" | "off";
@@ -16156,6 +16264,7 @@ declare class PoLookupComponent extends PoLookupBaseComponent implements AfterVi
16156
16264
  ngDoCheck(): void;
16157
16265
  ngOnDestroy(): void;
16158
16266
  ngOnInit(): void;
16267
+ ngOnChanges(changes: SimpleChanges): void;
16159
16268
  /**
16160
16269
  * Função que atribui foco ao componente.
16161
16270
  *
@@ -16195,18 +16304,11 @@ declare class PoLookupComponent extends PoLookupBaseComponent implements AfterVi
16195
16304
  onKeyDown(event: KeyboardEvent): void;
16196
16305
  /**
16197
16306
  *
16198
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
16307
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
16199
16308
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
16200
16309
  *
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
- * ```
16310
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
16311
+ *
16210
16312
  * ```
16211
16313
  * // Exemplo com p-label e p-helper
16212
16314
  * <po-lookup
@@ -16437,8 +16539,7 @@ declare abstract class PoMultiselectBaseComponent implements ControlValueAccesso
16437
16539
  * @optional
16438
16540
  *
16439
16541
  * @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.
16542
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
16442
16543
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
16443
16544
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
16444
16545
  *
@@ -16539,7 +16640,6 @@ declare abstract class PoMultiselectBaseComponent implements ControlValueAccesso
16539
16640
  *
16540
16641
  * @description
16541
16642
  * 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
16643
  *
16544
16644
  * > 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
16645
  */
@@ -16565,11 +16665,11 @@ declare abstract class PoMultiselectBaseComponent implements ControlValueAccesso
16565
16665
  *
16566
16666
  * @description
16567
16667
  *
16568
- * Define que o `listbox` e/ou tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) serão incluídos no body da
16668
+ * Define que o `listbox` e/ou popover (`p-helper` e/ou `p-error-limit`) serão incluídos no body da
16569
16669
  * 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
16670
  * overflow escondido, garantindo o posicionamento correto de ambos próximo ao elemento.
16571
16671
  *
16572
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
16672
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
16573
16673
  *
16574
16674
  * @default `false`
16575
16675
  */
@@ -16600,10 +16700,10 @@ declare abstract class PoMultiselectBaseComponent implements ControlValueAccesso
16600
16700
  *
16601
16701
  * @description
16602
16702
  *
16603
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
16703
+ * 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`.
16704
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
16604
16705
  *
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.
16706
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
16607
16707
  */
16608
16708
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
16609
16709
  /**
@@ -16978,6 +17078,7 @@ declare class PoMultiselectComponent extends PoMultiselectBaseComponent implemen
16978
17078
  iconElement: ElementRef;
16979
17079
  inputElement: ElementRef;
16980
17080
  outerContainer: ElementRef;
17081
+ helperEl?: PoHelperComponent;
16981
17082
  literalsTag: any;
16982
17083
  dropdownIcon: string;
16983
17084
  dropdownOpen: boolean;
@@ -16986,7 +17087,6 @@ declare class PoMultiselectComponent extends PoMultiselectBaseComponent implemen
16986
17087
  timeoutResize: any;
16987
17088
  visibleElement: boolean;
16988
17089
  containerWidth: number;
16989
- helperSettings: PoHelperOptions;
16990
17090
  private subscription;
16991
17091
  private enterCloseTag;
16992
17092
  private initCalculateItems;
@@ -17038,20 +17138,12 @@ declare class PoMultiselectComponent extends PoMultiselectBaseComponent implemen
17038
17138
  focusOnFirstItem(): void;
17039
17139
  closeTag(value: any, event: any): void;
17040
17140
  /**
17041
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
17141
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
17042
17142
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
17043
17143
  *
17044
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
17144
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
17045
17145
  *
17046
17146
  * ```
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
17147
  * // Exemplo com p-label e p-helper
17056
17148
  * <po-multiselect
17057
17149
  * #multiselect
@@ -17146,7 +17238,7 @@ declare abstract class PoNumberBaseComponent extends PoInputGeneric {
17146
17238
  * <file name="sample-po-number-calculate/sample-po-number-calculate.component.ts"> </file>
17147
17239
  * </example>
17148
17240
  */
17149
- declare class PoNumberComponent extends PoNumberBaseComponent implements AfterViewInit {
17241
+ declare class PoNumberComponent extends PoNumberBaseComponent implements AfterViewInit, OnChanges {
17150
17242
  /**
17151
17243
  * @optional
17152
17244
  *
@@ -17173,6 +17265,7 @@ declare class PoNumberComponent extends PoNumberBaseComponent implements AfterVi
17173
17265
  constructor();
17174
17266
  onWheel(event: Event): void;
17175
17267
  ngAfterViewInit(): void;
17268
+ ngOnChanges(changes: SimpleChanges): void;
17176
17269
  extraValidation(abstractControl: AbstractControl): {
17177
17270
  [key: string]: any;
17178
17271
  };
@@ -17205,7 +17298,7 @@ declare class PoNumberComponent extends PoNumberBaseComponent implements AfterVi
17205
17298
  * <file name="sample-po-password-reset/sample-po-password-reset.component.ts"> </file>
17206
17299
  * </example>
17207
17300
  */
17208
- declare class PoPasswordComponent extends PoInputGeneric {
17301
+ declare class PoPasswordComponent extends PoInputGeneric implements OnChanges {
17209
17302
  id: string;
17210
17303
  type: string;
17211
17304
  visiblePassword: boolean;
@@ -17226,6 +17319,7 @@ declare class PoPasswordComponent extends PoInputGeneric {
17226
17319
  get hidePasswordPeek(): boolean;
17227
17320
  get autocomplete(): string;
17228
17321
  constructor();
17322
+ ngOnChanges(changes: SimpleChanges): void;
17229
17323
  extraValidation(c: AbstractControl): {
17230
17324
  [key: string]: any;
17231
17325
  };
@@ -17307,8 +17401,7 @@ declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor
17307
17401
  * @optional
17308
17402
  *
17309
17403
  * @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.
17404
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
17312
17405
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
17313
17406
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
17314
17407
  *
@@ -17320,11 +17413,11 @@ declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor
17320
17413
  *
17321
17414
  * @description
17322
17415
  *
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
17416
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
17324
17417
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
17325
17418
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
17326
17419
  *
17327
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
17420
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
17328
17421
  *
17329
17422
  * @default `false`
17330
17423
  */
@@ -17388,10 +17481,10 @@ declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor
17388
17481
  *
17389
17482
  * @description
17390
17483
  *
17391
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
17484
+ * 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`.
17485
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
17392
17486
  *
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.
17487
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
17395
17488
  */
17396
17489
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
17397
17490
  /**
@@ -17416,7 +17509,6 @@ declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor
17416
17509
  *
17417
17510
  * @description
17418
17511
  * 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
17512
  *
17421
17513
  * > 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
17514
  */
@@ -17562,7 +17654,7 @@ declare abstract class PoRadioGroupBaseComponent implements ControlValueAccessor
17562
17654
  * </example>
17563
17655
  *
17564
17656
  */
17565
- declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements AfterViewInit, DoCheck {
17657
+ declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements AfterViewInit, DoCheck, OnChanges {
17566
17658
  private el;
17567
17659
  private cd;
17568
17660
  /** Label do campo. */
@@ -17571,10 +17663,12 @@ declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements
17571
17663
  help?: string;
17572
17664
  inputEl: ElementRef;
17573
17665
  radioLabels: QueryList<PoRadioComponent>;
17666
+ helperEl?: PoHelperComponent;
17574
17667
  differ: any;
17575
17668
  constructor();
17576
17669
  ngAfterViewInit(): void;
17577
17670
  ngDoCheck(): void;
17671
+ ngOnChanges(changes: SimpleChanges): void;
17578
17672
  emitAdditionalHelp(): void;
17579
17673
  eventClick(value: any, disabled: any): void;
17580
17674
  /**
@@ -17604,20 +17698,12 @@ declare class PoRadioGroupComponent extends PoRadioGroupBaseComponent implements
17604
17698
  onKeyUp(event: KeyboardEvent, value: any): void;
17605
17699
  /**
17606
17700
  *
17607
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
17701
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
17608
17702
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
17609
17703
  *
17610
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
17704
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
17611
17705
  *
17612
17706
  * ```
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
17707
  * // Exemplo com p-label e p-helper
17622
17708
  * <po-radio-group
17623
17709
  * #radioGroup
@@ -17710,8 +17796,7 @@ declare abstract class PoRichTextBaseComponent implements ControlValueAccessor,
17710
17796
  * @optional
17711
17797
  *
17712
17798
  * @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.
17799
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
17715
17800
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
17716
17801
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
17717
17802
  *
@@ -17723,11 +17808,11 @@ declare abstract class PoRichTextBaseComponent implements ControlValueAccessor,
17723
17808
  *
17724
17809
  * @description
17725
17810
  *
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
17811
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
17727
17812
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
17728
17813
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
17729
17814
  *
17730
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
17815
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
17731
17816
  *
17732
17817
  * @default `false`
17733
17818
  */
@@ -17836,10 +17921,10 @@ declare abstract class PoRichTextBaseComponent implements ControlValueAccessor,
17836
17921
  *
17837
17922
  * @description
17838
17923
  *
17839
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
17924
+ * 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`.
17925
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
17840
17926
  *
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.
17927
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
17843
17928
  */
17844
17929
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
17845
17930
  /**
@@ -17864,7 +17949,6 @@ declare abstract class PoRichTextBaseComponent implements ControlValueAccessor,
17864
17949
  *
17865
17950
  * @description
17866
17951
  * 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
17952
  *
17869
17953
  * > 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
17954
  */
@@ -17996,12 +18080,11 @@ declare class PoRichTextBodyComponent implements OnInit, OnDestroy {
17996
18080
  modelValue?: string;
17997
18081
  placeholder?: string;
17998
18082
  readonly?: string;
17999
- /** Tamanho do fonte */
18000
- size?: string;
18001
18083
  change: EventEmitter<any>;
18002
18084
  commands: EventEmitter<any>;
18003
18085
  keydown: EventEmitter<KeyboardEvent>;
18004
18086
  selectedLink: EventEmitter<any>;
18087
+ size: string;
18005
18088
  shortcutCommand: EventEmitter<any>;
18006
18089
  value: EventEmitter<any>;
18007
18090
  blur: EventEmitter<any>;
@@ -18718,8 +18801,7 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18718
18801
  * @optional
18719
18802
  *
18720
18803
  * @description
18721
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
18722
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
18804
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
18723
18805
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
18724
18806
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
18725
18807
  *
@@ -18731,11 +18813,11 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18731
18813
  *
18732
18814
  * @description
18733
18815
  *
18734
- * Define que o tooltip (`p-additional-help-tooltip`) será incluído no body da página e não dentro do componente. Essa
18816
+ * Define que o popover (`p-helper`) será incluído no body da página e não dentro do componente. Essa
18735
18817
  * opção pode ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o
18736
18818
  * posicionamento correto do tooltip próximo ao elemento.
18737
18819
  *
18738
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
18820
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
18739
18821
  *
18740
18822
  * @default `false`
18741
18823
  */
@@ -18848,10 +18930,10 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18848
18930
  *
18849
18931
  * @description
18850
18932
  *
18851
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
18933
+ * 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`.
18934
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
18852
18935
  *
18853
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
18854
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
18936
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
18855
18937
  */
18856
18938
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
18857
18939
  /**
@@ -18876,7 +18958,6 @@ declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Va
18876
18958
  *
18877
18959
  * @description
18878
18960
  * Evento disparado ao clicar no ícone de ajuda adicional.
18879
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
18880
18961
  *
18881
18962
  * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
18882
18963
  */
@@ -19352,6 +19433,7 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
19352
19433
  private poUploadDragDropComponent;
19353
19434
  uploadButton: PoButtonComponent;
19354
19435
  modalComponent: PoModalComponent;
19436
+ helperEl?: PoHelperComponent;
19355
19437
  id: string;
19356
19438
  infoByUploadStatus: {
19357
19439
  [key: string]: {
@@ -19406,7 +19488,6 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
19406
19488
  getAdditionalHelpTooltip(): string;
19407
19489
  hasAnyFileUploading(files: Array<PoUploadFile>): boolean;
19408
19490
  isAllowCancelEvent(status: PoUploadStatus): status is PoUploadStatus.Uploading | PoUploadStatus.Error | PoUploadStatus.None;
19409
- onBlur(): void;
19410
19491
  onFileChange(event: any): void;
19411
19492
  onFileChangeDragDrop(files: any): void;
19412
19493
  onKeyDown(event: KeyboardEvent): void;
@@ -19423,18 +19504,11 @@ declare class PoUploadComponent extends PoUploadBaseComponent implements AfterVi
19423
19504
  sendFiles(): void;
19424
19505
  setDirectoryAttribute(canHandleDirectory: boolean): void;
19425
19506
  /**
19426
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
19507
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
19427
19508
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
19428
19509
  *
19429
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
19430
- * ```
19431
- * <po-upload
19432
- * #upload
19433
- * ...
19434
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
19435
- * (p-keydown)="onKeyDown($event, upload)"
19436
- * ></po-upload>
19437
- * ```
19510
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
19511
+ *
19438
19512
  * ```
19439
19513
  * //Exemplo com p-label e p-helper
19440
19514
  * <po-upload
@@ -19659,6 +19733,7 @@ declare class PoRichTextComponent extends PoRichTextBaseComponent implements Aft
19659
19733
  private element;
19660
19734
  bodyElement: PoRichTextBodyComponent;
19661
19735
  richTextToolbar: PoRichTextToolbarComponent;
19736
+ helperEl?: PoHelperComponent;
19662
19737
  private listener;
19663
19738
  private modelLastUpdate;
19664
19739
  toolbarActions: Array<PoRichTextToolbarActions>;
@@ -19690,20 +19765,12 @@ declare class PoRichTextComponent extends PoRichTextBaseComponent implements Aft
19690
19765
  onChangeValue(value: any): void;
19691
19766
  onKeyDown(event: KeyboardEvent): void;
19692
19767
  /**
19693
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
19768
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
19694
19769
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
19695
19770
  *
19696
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
19771
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
19697
19772
  *
19698
19773
  * ```
19699
- * <po-rich-text
19700
- * #richtext
19701
- * ...
19702
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
19703
- * (p-keydown)="onKeyDown($event, richtext)"
19704
- * ></po-rich-text>
19705
- * ```
19706
- * ```
19707
19774
  * // Exemplo com p-label e p-helper
19708
19775
  * <po-rich-text
19709
19776
  * #richtext
@@ -19914,6 +19981,7 @@ declare class PoSelectComponent extends PoFieldValidateModel<any> implements Aft
19914
19981
  renderer: Renderer2;
19915
19982
  private _iconToken;
19916
19983
  selectElement: ElementRef;
19984
+ helperEl?: PoHelperComponent;
19917
19985
  /**
19918
19986
  * @optional
19919
19987
  *
@@ -20050,10 +20118,10 @@ declare class PoSelectComponent extends PoFieldValidateModel<any> implements Aft
20050
20118
  *
20051
20119
  * @description
20052
20120
  *
20053
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
20121
+ * 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`.
20122
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
20054
20123
  *
20055
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
20056
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
20124
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
20057
20125
  */
20058
20126
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
20059
20127
  /**
@@ -20105,19 +20173,11 @@ declare class PoSelectComponent extends PoFieldValidateModel<any> implements Aft
20105
20173
  onKeyDown(event: KeyboardEvent): void;
20106
20174
  registerOnTouched(fn: any): void;
20107
20175
  /**
20108
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
20176
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
20109
20177
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
20110
20178
  *
20111
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
20179
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
20112
20180
  *
20113
- * ```html
20114
- * <po-select
20115
- * #select
20116
- * ...
20117
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
20118
- * (p-keydown)="onKeyDown($event, select)"
20119
- * ></po-select>
20120
- * ```
20121
20181
  * ```
20122
20182
  * //Exemplo com p-label e p-helper
20123
20183
  * <po-select
@@ -20208,8 +20268,7 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20208
20268
  * @optional
20209
20269
  *
20210
20270
  * @description
20211
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
20212
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
20271
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
20213
20272
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
20214
20273
  * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
20215
20274
  *
@@ -20221,11 +20280,11 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20221
20280
  *
20222
20281
  * @description
20223
20282
  *
20224
- * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
20283
+ * Define que o popover (`p-helper` e/ou `p-error-limit`) será incluído no body da página e não
20225
20284
  * dentro do componente. Essa opção pode ser necessária em cenários com containers que possuem scroll ou overflow
20226
20285
  * escondido, garantindo o posicionamento correto do tooltip próximo ao elemento.
20227
20286
  *
20228
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
20287
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
20229
20288
  *
20230
20289
  * @default `false`
20231
20290
  */
@@ -20293,10 +20352,10 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20293
20352
  *
20294
20353
  * @description
20295
20354
  *
20296
- * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
20355
+ * 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`.
20356
+ * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
20297
20357
  *
20298
- * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
20299
- * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
20358
+ * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
20300
20359
  */
20301
20360
  poHelperComponent: i0.InputSignal<string | PoHelperOptions>;
20302
20361
  /**
@@ -20321,7 +20380,6 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20321
20380
  *
20322
20381
  * @description
20323
20382
  * Evento disparado ao clicar no ícone de ajuda adicional.
20324
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
20325
20383
  *
20326
20384
  * > Essa propriedade está **depreciada** e será removida na versão `23.x.x`. Recomendamos utilizar a propriedade `p-helper` que oferece mais recursos e flexibilidade.
20327
20385
  */
@@ -20514,9 +20572,10 @@ declare abstract class PoTextareaBaseComponent implements ControlValueAccessor,
20514
20572
  * </example>
20515
20573
  *
20516
20574
  */
20517
- declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit {
20575
+ declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit, OnChanges {
20518
20576
  private el;
20519
20577
  inputEl: ElementRef;
20578
+ helperEl?: PoHelperComponent;
20520
20579
  id: string;
20521
20580
  valueBeforeChange: any;
20522
20581
  fireChange: boolean;
@@ -20541,6 +20600,7 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
20541
20600
  */
20542
20601
  focus(): void;
20543
20602
  ngAfterViewInit(): void;
20603
+ ngOnChanges(changes: SimpleChanges): void;
20544
20604
  getAdditionalHelpTooltip(): string;
20545
20605
  getErrorPattern(): string;
20546
20606
  hasInvalidClass(): boolean;
@@ -20552,20 +20612,12 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
20552
20612
  controlChangeEmitter(): void;
20553
20613
  onKeyDown(event: KeyboardEvent): void;
20554
20614
  /**
20555
- * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
20615
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
20556
20616
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
20557
20617
  *
20558
- * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
20618
+ * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
20559
20619
  *
20560
20620
  * ```
20561
- * <po-textarea
20562
- * #textarea
20563
- * ...
20564
- * p-additional-help-tooltip="Mensagem de ajuda complementar"
20565
- * (p-keydown)="onKeyDown($event, textarea)"
20566
- * ></po-textarea>
20567
- * ```
20568
- * ```
20569
20621
  * //Exemplo com p-label e p-helper
20570
20622
  * <po-textarea
20571
20623
  * #textarea
@@ -20620,7 +20672,7 @@ declare class PoTextareaComponent extends PoTextareaBaseComponent implements Aft
20620
20672
  * </example>
20621
20673
  *
20622
20674
  */
20623
- declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy {
20675
+ declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnChanges {
20624
20676
  id: string;
20625
20677
  icon: string;
20626
20678
  type: string;
@@ -20630,6 +20682,7 @@ declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, On
20630
20682
  constructor();
20631
20683
  ngAfterViewInit(): void;
20632
20684
  ngOnDestroy(): void;
20685
+ ngOnChanges(changes: SimpleChanges): void;
20633
20686
  extraValidation(c: AbstractControl): {
20634
20687
  [key: string]: any;
20635
20688
  };
@@ -20644,7 +20697,7 @@ declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, On
20644
20697
  */
20645
20698
  declare class PoDatepickerModule {
20646
20699
  static ɵfac: i0.ɵɵFactoryDeclaration<PoDatepickerModule, never>;
20647
- static ɵmod: i0.ɵɵNgModuleDeclaration<PoDatepickerModule, [typeof PoDatepickerComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof i3.OverlayModule, typeof PoCleanModule, typeof PoCalendarModule, typeof PoButtonModule], [typeof PoDatepickerComponent]>;
20700
+ static ɵmod: i0.ɵɵNgModuleDeclaration<PoDatepickerModule, [typeof PoDatepickerComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof i3.OverlayModule, typeof PoCleanModule, typeof PoCalendarModule, typeof PoButtonModule, typeof PoHelperModule], [typeof PoDatepickerComponent]>;
20648
20701
  static ɵinj: i0.ɵɵInjectorDeclaration<PoDatepickerModule>;
20649
20702
  }
20650
20703
 
@@ -20655,7 +20708,7 @@ declare class PoDatepickerModule {
20655
20708
  */
20656
20709
  declare class PoRadioGroupModule {
20657
20710
  static ɵfac: i0.ɵɵFactoryDeclaration<PoRadioGroupModule, never>;
20658
- static ɵmod: i0.ɵɵNgModuleDeclaration<PoRadioGroupModule, [typeof PoRadioGroupComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof PoRadioModule], [typeof PoRadioGroupComponent]>;
20711
+ static ɵmod: i0.ɵɵNgModuleDeclaration<PoRadioGroupModule, [typeof PoRadioGroupComponent], [typeof i2.CommonModule, typeof i3$1.FormsModule, typeof PoFieldContainerModule, typeof PoRadioModule, typeof PoHelperModule], [typeof PoRadioGroupComponent]>;
20659
20712
  static ɵinj: i0.ɵɵInjectorDeclaration<PoRadioGroupModule>;
20660
20713
  }
20661
20714
 
@@ -21092,7 +21145,7 @@ declare class PoMediaQueryModule {
21092
21145
  }
21093
21146
 
21094
21147
  /**
21095
- * Módulo responsável por fornecer serviços relacionados ao tema PO.
21148
+ * Módulo do serviço PoThemeService.
21096
21149
  */
21097
21150
  declare class PoThemeModule {
21098
21151
  static ɵfac: i0.ɵɵFactoryDeclaration<PoThemeModule, never>;
@@ -21371,21 +21424,23 @@ interface PoDynamicField {
21371
21424
  interface PoDynamicFormField extends PoDynamicField {
21372
21425
  /**
21373
21426
  * Evento disparado ao clicar no ícone de ajuda adicional.
21374
- * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
21427
+ *
21428
+ * > Essa propriedade está depreciada e será removida na versão 23.x.x. Recomendamos utilizar a propriedade p-helper que oferece mais recursos e flexibilidade.
21375
21429
  */
21376
21430
  additionalHelp?: Function;
21377
21431
  /**
21378
- * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
21379
- * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
21432
+ * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
21380
21433
  * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
21434
+ *
21435
+ * > Essa propriedade está depreciada e será removida na versão 23.x.x. Recomendamos utilizar a propriedade p-helper que oferece mais recursos e flexibilidade.
21381
21436
  */
21382
21437
  additionalHelpTooltip?: string;
21383
21438
  /**
21384
- * Define que o `listbox` e/ou tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) serão incluídos no body da
21439
+ * Define que o `listbox` e/ou popover (`p-helper` e/ou `p-error-limit`) serão incluídos no body da
21385
21440
  * página e não dentro do componente. Essa opção é necessária para cenários com containers que possuem scroll ou
21386
21441
  * overflow escondido, garantindo o posicionamento correto de ambos próximo ao elemento.
21387
21442
  *
21388
- * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
21443
+ * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
21389
21444
  */
21390
21445
  appendBox?: boolean;
21391
21446
  /**
@@ -21506,6 +21561,8 @@ interface PoDynamicFormField extends PoDynamicField {
21506
21561
  disabled?: boolean;
21507
21562
  /** Texto de ajuda. */
21508
21563
  help?: string;
21564
+ /** Texto simples que será apresentado como auxílio ao campo ou objeto com as definições do po-helper. */
21565
+ helper?: string | PoHelperOptions;
21509
21566
  /** Texto exibido quando o valor do componente for *true*. */
21510
21567
  booleanTrue?: string;
21511
21568
  /** Texto exibido quando o valor do componente for *false*. */
@@ -22520,7 +22577,7 @@ declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent implemen
22520
22577
  getObjectValue(): Observable<any>;
22521
22578
  sendObjectValue(objectValue: any): void;
22522
22579
  /**
22523
- * Método que exibe `additionalHelpTooltip` ou executa a ação definida em `additionalHelp`.
22580
+ * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
22524
22581
  * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `keydown`.
22525
22582
  *
22526
22583
  * ```
@@ -22533,7 +22590,7 @@ declare class PoDynamicFormComponent extends PoDynamicFormBaseComponent implemen
22533
22590
  * property: 'name',
22534
22591
  * ...
22535
22592
  * help: 'Mensagem de ajuda.',
22536
- * additionalHelpTooltip: 'Mensagem de ajuda complementar.',
22593
+ * helper: 'Mensagem de ajuda complementar com o componente po-helper implementado.',
22537
22594
  * keydown: this.onKeyDown.bind(this, 'name')
22538
22595
  * },
22539
22596
  * ]
@@ -23012,9 +23069,24 @@ declare class PoDynamicViewBaseComponent extends PoDynamicSharedBase {
23012
23069
  */
23013
23070
  load: string | Function;
23014
23071
  service: any;
23072
+ private _componentsSize?;
23015
23073
  private _fields;
23016
23074
  private _showAllValue;
23017
23075
  private _value;
23076
+ /**
23077
+ * @optional
23078
+ *
23079
+ * @description
23080
+ *
23081
+ * Define o tamanho dos componentes no template entre `small` ou `medium`.
23082
+ *
23083
+ * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido.
23084
+ * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme).
23085
+ *
23086
+ * @default `medium`
23087
+ */
23088
+ set componentsSize(value: string);
23089
+ get componentsSize(): string;
23018
23090
  /**
23019
23091
  * @optional
23020
23092
  *
@@ -23144,7 +23216,7 @@ declare class PoDynamicViewBaseComponent extends PoDynamicSharedBase {
23144
23216
  private transformValue;
23145
23217
  private formatField;
23146
23218
  static ɵfac: i0.ɵɵFactoryDeclaration<PoDynamicViewBaseComponent, never>;
23147
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoDynamicViewBaseComponent, never, never, { "load": { "alias": "p-load"; "required": false; }; "fields": { "alias": "p-fields"; "required": false; }; "showAllValue": { "alias": "p-show-all-value"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; }, {}, never, never, true, never>;
23219
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoDynamicViewBaseComponent, never, never, { "load": { "alias": "p-load"; "required": false; }; "componentsSize": { "alias": "p-components-size"; "required": false; }; "fields": { "alias": "p-fields"; "required": false; }; "showAllValue": { "alias": "p-show-all-value"; "required": false; }; "textWrap": { "alias": "p-text-wrap"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; }, {}, never, never, true, never>;
23148
23220
  }
23149
23221
 
23150
23222
  /**
@@ -23227,6 +23299,7 @@ declare class PoInfoBaseComponent {
23227
23299
  readonly poInfoOrientation: typeof PoInfoOrientation;
23228
23300
  private _labelSize;
23229
23301
  private _orientation;
23302
+ private _size?;
23230
23303
  /**
23231
23304
  * @optional
23232
23305
  *
@@ -23255,8 +23328,22 @@ declare class PoInfoBaseComponent {
23255
23328
  */
23256
23329
  set orientation(value: PoInfoOrientation);
23257
23330
  get orientation(): PoInfoOrientation;
23331
+ /**
23332
+ * @optional
23333
+ *
23334
+ * @description
23335
+ *
23336
+ * Define o tamanho do componente entre `small` ou `medium`.
23337
+ *
23338
+ * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido.
23339
+ * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme).
23340
+ *
23341
+ * @default `medium`
23342
+ */
23343
+ set size(value: string);
23344
+ get size(): string;
23258
23345
  static ɵfac: i0.ɵɵFactoryDeclaration<PoInfoBaseComponent, never>;
23259
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoInfoBaseComponent, never, never, { "label": { "alias": "p-label"; "required": false; }; "url": { "alias": "p-url"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; "labelSize": { "alias": "p-label-size"; "required": false; }; "orientation": { "alias": "p-orientation"; "required": false; }; }, {}, never, never, true, never>;
23346
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoInfoBaseComponent, never, never, { "label": { "alias": "p-label"; "required": false; }; "url": { "alias": "p-url"; "required": false; }; "value": { "alias": "p-value"; "required": false; }; "labelSize": { "alias": "p-label-size"; "required": false; }; "orientation": { "alias": "p-orientation"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, {}, never, never, true, never>;
23260
23347
  }
23261
23348
 
23262
23349
  /**
@@ -26146,16 +26233,17 @@ declare class PoPageContentComponent extends PoPageContentBaseComponent implemen
26146
26233
  * @description
26147
26234
  * Interface para as ações dos componentes po-page-default e po-page-list.
26148
26235
  *
26149
- * > As propriedades `selected`, `separator` e `type` serão vistas a partir da terceira ação e somente quando
26150
- * definir quatro ações ou mais.
26236
+ * > Quando o array de actions possui quatro ou mais registros, os dois últimos e os seguintes são automaticamente agrupados no po-dropdown.
26237
+ * A partir desse ponto, as propriedades `selected`, `separator`, `type` e `subItems` passam a ter efeito apenas nas ações exibidas dentro do dropdown, ou seja, a partir da terceira ação.
26238
+ * Dessa forma, o uso de subItems (agrupadores dentro do dropdown) só terá efeito quando houver pelo menos quatro ações definidas.
26151
26239
  *
26152
- * @docsExtends PoPopupAction
26240
+ * @docsExtends PoDropdownAction
26153
26241
  *
26154
26242
  * @ignoreExtendedDescription
26155
26243
  *
26156
26244
  * @usedBy PoPageDefaultComponent, PoPageListComponent
26157
26245
  */
26158
- interface PoPageAction extends PoPopupAction {
26246
+ interface PoPageAction extends PoDropdownAction {
26159
26247
  }
26160
26248
 
26161
26249
  /**
@@ -26221,14 +26309,15 @@ interface PoPageDefaultLiterals {
26221
26309
  *
26222
26310
  * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
26223
26311
  *
26224
- * | Propriedade | Descrição | Valor Padrão |
26225
- * |----------------------------------------|-------------------------------------------------------|-------------------------------------------------|
26226
- * | **Default Values** | | |
26227
- * | `--padding` | Espaçamento do componente | `var(--spacing-xs) var(--spacing-md)` |
26228
- * | `--gap` | Gap entre o header e o conteúdo | `var(--spacing-md)` |
26229
- * | `--padding-top-header` | Espaçamento do topo do header | `var(--color-neutral-light-30)` |
26230
- * | `--gap-actions` | Gap entre os botões de action | `var(--spacing-xs)` |
26231
- * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
26312
+ * | Propriedade | Descrição | Valor Padrão |
26313
+ * |---------------------|---------------------------------------------|---------------------------------------|
26314
+ * | **Header** | | |
26315
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
26316
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
26317
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
26318
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
26319
+ * | **Content** | | |
26320
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
26232
26321
  */
26233
26322
  declare abstract class PoPageDefaultBaseComponent {
26234
26323
  poPageContent: PoPageContentComponent;
@@ -26384,6 +26473,20 @@ interface PoPageDetailLiterals {
26384
26473
  *
26385
26474
  * O componente **po-page-detail** é utilizado como container principal para a tela de
26386
26475
  * detalhamento de um registro, tendo a possibilidade de usar as ações de "Voltar", "Editar" e "Remover".
26476
+ *
26477
+ * #### Tokens customizáveis
26478
+ *
26479
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
26480
+ *
26481
+ * | Propriedade | Descrição | Valor Padrão |
26482
+ * |---------------------|---------------------------------------------|---------------------------------------|
26483
+ * | **Header** | | |
26484
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
26485
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
26486
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
26487
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
26488
+ * | **Content** | | |
26489
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
26387
26490
  */
26388
26491
  declare class PoPageDetailBaseComponent {
26389
26492
  poPageContent: PoPageContentComponent;
@@ -26551,6 +26654,20 @@ interface PoPageEditLiterals {
26551
26654
  * Os botões "Salvar" e "Salvar e Novo" podem ser habilitados/desabilitados utilizando a propriedade `p-disable-submit`.
26552
26655
  * Esta propriedade pode ser utilizada para desabilitar os botões caso exista um formulário inválido na página ou alguma
26553
26656
  * regra de negócio não tenha sido atendida.
26657
+ *
26658
+ * #### Tokens customizáveis
26659
+ *
26660
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
26661
+ *
26662
+ * | Propriedade | Descrição | Valor Padrão |
26663
+ * |---------------------|---------------------------------------------|---------------------------------------|
26664
+ * | **Header** | | |
26665
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
26666
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
26667
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
26668
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
26669
+ * | **Content** | | |
26670
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
26554
26671
  */
26555
26672
  declare class PoPageEditBaseComponent {
26556
26673
  poPageContent: PoPageContentComponent;
@@ -26707,6 +26824,8 @@ declare class PoPageEditComponent extends PoPageEditBaseComponent {
26707
26824
  declare class PoPageHeaderBaseComponent {
26708
26825
  /** Título da página. */
26709
26826
  title: string;
26827
+ /** Define o tamanho dos componentes no header. */
26828
+ size: string;
26710
26829
  /** Subtítulo da página. */
26711
26830
  subtitle: string;
26712
26831
  private _breadcrumb;
@@ -26714,7 +26833,7 @@ declare class PoPageHeaderBaseComponent {
26714
26833
  set breadcrumb(value: PoBreadcrumb);
26715
26834
  get breadcrumb(): PoBreadcrumb;
26716
26835
  static ɵfac: i0.ɵɵFactoryDeclaration<PoPageHeaderBaseComponent, never>;
26717
- static ɵdir: i0.ɵɵDirectiveDeclaration<PoPageHeaderBaseComponent, never, never, { "title": { "alias": "p-title"; "required": false; }; "subtitle": { "alias": "p-subtitle"; "required": false; }; "breadcrumb": { "alias": "p-breadcrumb"; "required": false; }; }, {}, never, never, true, never>;
26836
+ static ɵdir: i0.ɵɵDirectiveDeclaration<PoPageHeaderBaseComponent, never, never, { "title": { "alias": "p-title"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; "subtitle": { "alias": "p-subtitle"; "required": false; }; "breadcrumb": { "alias": "p-breadcrumb"; "required": false; }; }, {}, never, never, true, never>;
26718
26837
  }
26719
26838
 
26720
26839
  /**
@@ -26726,6 +26845,21 @@ declare class PoPageHeaderComponent extends PoPageHeaderBaseComponent {
26726
26845
  static ɵcmp: i0.ɵɵComponentDeclaration<PoPageHeaderComponent, "po-page-header", never, {}, {}, never, ["*"], false, never>;
26727
26846
  }
26728
26847
 
26848
+ /**
26849
+ * @docsPrivate
26850
+ *
26851
+ * @description
26852
+ *
26853
+ * Define o nível de densidade (espaçamento) aplicado em componentes agrupadores. Pode ser ajustado conforme a
26854
+ * preferência do usuário ou requisitos de acessibilidade.
26855
+ */
26856
+ declare enum PoDensityMode {
26857
+ /** Define espaçamentos mais compactos entre os elementos. */
26858
+ Small = "small",
26859
+ /** Define espaçamentos mais amplos e confortáveis. */
26860
+ Medium = "medium"
26861
+ }
26862
+
26729
26863
  /**
26730
26864
  * @usedBy PoThemeService
26731
26865
  *
@@ -27306,11 +27440,20 @@ interface PoThemeActive {
27306
27440
  /**
27307
27441
  * @description
27308
27442
  *
27309
- * O `PoThemeService` possibilita a personalização das cores do tema padrão do `PO-UI`, permitindo a alteração dos valores das variáveis de estilo usadas no CSS padrão.
27443
+ * O serviço `PoThemeService` permite customizar as cores do tema padrão do `PO-UI` e definir o nível de acessibilidade
27444
+ * mais adequado ao projeto.
27445
+ *
27446
+ * O nível **AAA** (padrão) garante maior contraste, áreas clicáveis amplas e espaçamentos maiores entre os elementos,
27447
+ * enquanto o nível **AA** mantém a conformidade com as diretrizes de acessibilidade, mas com proporções mais equilibradas
27448
+ * e contornos mais sutis.
27310
27449
  *
27311
- * > Para saber mais sobre como customizar o tema padrão verifique o item [Customização de Temas usando o serviço PO-UI](guides/theme-service) na aba `Guias`.
27450
+ * O serviço também possibilita configurar a **densidade de espaçamentos**, permitindo ajustar o espaço entre e dentro dos
27451
+ * componentes. Essa configuração pode ser utilizada com qualquer nível de acessibilidade.
27312
27452
  *
27313
- * > Obs.: Não está documentado aqui e não indicamos a customização das cores de 'feedback' por motivos de acessibilidade e usabilidade.
27453
+ * > Observação: a customização das cores de `feedback` não é recomendada por motivos de acessibilidade e usabilidade.
27454
+ *
27455
+ * > Para saber mais sobre como customizar o tema padrão, consulte o item
27456
+ * [Customização de Temas usando o serviço PO-UI](guides/theme-service) na aba `Guias`.
27314
27457
  */
27315
27458
  /**
27316
27459
  * @example
@@ -27339,7 +27482,8 @@ declare class PoThemeService {
27339
27482
  * @param {PoTheme} themeConfig - Configuração de tema a ser aplicada ao componente.
27340
27483
  * @param {PoThemeTypeEnum} [themeType=PoThemeTypeEnum.light] - (Opcional) Tipo de tema, podendo ser 'light' (claro) ou 'dark' (escuro). O tema claro é o padrão.
27341
27484
  * @param {PoThemeA11yEnum} [a11yLevel=PoThemeA11yEnum.AAA] - (Opcional) Nível de acessibilidade dos componentes, podendo ser AA ou AAA. Padrão é AAA.
27342
- * @param {boolean} [persistPreference=true] - (Opcional) Define se a preferência de tema deve ser salva no localStorage para persistência. `true` para salvar, `false` para não salvar.
27485
+ * @param {boolean} [persistPreference=true] - (Opcional) Define se a preferência de tema deve ser salva no
27486
+ * localStorage para persistência. Por padrão é `true`, ou seja, a preferência será salva automaticamente.
27343
27487
  */
27344
27488
  setTheme(themeConfig: PoTheme, themeType?: PoThemeTypeEnum, a11yLevel?: PoThemeA11yEnum, persistPreference?: boolean): void;
27345
27489
  private setDataDefaultSizeHTML;
@@ -27350,18 +27494,35 @@ declare class PoThemeService {
27350
27494
  */
27351
27495
  getA11yLevel(): PoThemeA11yEnum;
27352
27496
  /**
27353
- * Define o tamanho `small` como padrão para componentes de formulário que não possuem um tamanho definido.
27354
- * Essa configuração é aplicada globalmente apenas quando o nível de acessibilidade for `AA`.
27355
- * Caso contrário, o tamanho padrão será `medium`.
27497
+ * Define o tamanho `small` como padrão para componentes de formulário que não possuem um tamanho definido. Essa
27498
+ * configuração é aplicada globalmente apenas quando o nível de acessibilidade for `AA`. O valor definido é salvo no
27499
+ * `localStorage` sob a chave `po-default-size`.
27356
27500
  *
27357
27501
  * > Para garantir que o tamanho `small` seja aplicado corretamente a todos os componentes, recomendamos
27358
27502
  * definir esta configuração **junto com o nível de acessibilidade `AA` na inicialização da aplicação**.
27359
27503
  * Se for aplicada em tempo de execução, será necessário recarregar a aplicação (`reload`)
27360
27504
  * para que os estilos sejam aplicados corretamente.
27505
+ * > Para ajustar a densidade visual dos componentes agrupadores (como pages, container, etc.), utilize também
27506
+ * o método `setDensityMode` conforme necessário.
27361
27507
  *
27362
27508
  * @param {boolean} enable Habilita ou desabilita o tamanho `small` globalmente.
27363
27509
  */
27364
27510
  setA11yDefaultSizeSmall(enable: boolean): boolean;
27511
+ /**
27512
+ * Retorna o modo de adensamento dos componentes agrupadores.
27513
+ * Se não estiver configurado, retorna `medium` como padrão.
27514
+ * @returns {PoDensityMode} O modo de adensamento, que pode ser `small` ou `medium`.
27515
+ */
27516
+ getDensityMode(): PoDensityMode;
27517
+ /**
27518
+ * Aplica o modo de adensamento compacto (`small`) ou espaçoso (`medium`) para os componentes agrupadores,
27519
+ * independentemente do nível de acessibilidade. O valor definido é salvo no `localStorage` sob a chave
27520
+ * `po-density-mode`.
27521
+ *
27522
+ * @param {'small' | 'medium'} mode Define o modo de densidade: `small` para compacto, `medium` para espaçoso.
27523
+ * O valor padrão é `medium`.
27524
+ */
27525
+ setDensityMode(mode: string): void;
27365
27526
  /**
27366
27527
  * @docsPrivate
27367
27528
  * Retorna a preferência global de tamanho dos componentes.
@@ -27443,11 +27604,10 @@ declare class PoThemeService {
27443
27604
  private applyThemeStyles;
27444
27605
  private changeThemeType;
27445
27606
  /**
27446
- * Persiste e define o tema do aplicativo com base nos dados armazenados.
27607
+ * Restaura e aplica as preferências visuais do usuário para o tema da aplicação, garantindo que essas preferências
27608
+ * sejam persistidas no `localStorage` para uso em recarregamentos futuros.
27447
27609
  *
27448
- * Este método recupera os dados do tema armazenados e os aplica ao aplicativo.
27449
- *
27450
- * @returns {PoTheme} Recupera o tema armazenado.
27610
+ * @returns {PoTheme} O tema atualmente aplicado.
27451
27611
  */
27452
27612
  persistThemeActive(): PoTheme;
27453
27613
  private formatTheme;
@@ -27469,6 +27629,7 @@ declare class PoThemeService {
27469
27629
  cleanThemeActive(persistPreference?: boolean): void;
27470
27630
  private getActiveTypeFromTheme;
27471
27631
  private getActiveA11yFromTheme;
27632
+ private isValidA11yLevel;
27472
27633
  /**
27473
27634
  * @docsPrivate
27474
27635
  *
@@ -27644,6 +27805,20 @@ interface PoPageListLiterals {
27644
27805
  *
27645
27806
  * Para facilitar a manipulação e visualização dos filtros aplicados, é possível também utilizar o componente
27646
27807
  * [`po-disclaimer-group`](/documentation/po-disclaimer-group).
27808
+ *
27809
+ * #### Tokens customizáveis
27810
+ *
27811
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
27812
+ *
27813
+ * | Propriedade | Descrição | Valor Padrão |
27814
+ * |---------------------|---------------------------------------------|---------------------------------------|
27815
+ * | **Header** | | |
27816
+ * | `--padding` | Espaçamento do header | `var(--spacing-xs) var(--spacing-md)` |
27817
+ * | `--gap` | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)` |
27818
+ * | `--gap-actions` | Espaçamento entre as ações | `var(--spacing-xs)` |
27819
+ * | `--font-family` | Família tipográfica do título | `var(--font-family-theme)` |
27820
+ * | **Content** | | |
27821
+ * | `--padding-content` | Espaçamento do conteúdo | `var(--spacing-xs) var(--spacing-sm)` |
27647
27822
  */
27648
27823
  declare abstract class PoPageListBaseComponent {
27649
27824
  poPageContent: PoPageContentComponent;
@@ -30930,6 +31105,11 @@ declare const poThemeDefaultDarkValues: {
30930
31105
  'po-select': {
30931
31106
  '--color-hover': string;
30932
31107
  };
31108
+ /** DROPDOWN */
31109
+ '.po-listbox-group-header .po-tag': {
31110
+ color: string;
31111
+ 'background-color': string;
31112
+ };
30933
31113
  };
30934
31114
  onRoot: {
30935
31115
  '--color-neutral': string;
@@ -31030,6 +31210,10 @@ declare const poThemeDefaultDarkValuesAA: {
31030
31210
  'po-select': {
31031
31211
  '--color-hover': string;
31032
31212
  };
31213
+ '.po-listbox-group-header .po-tag': {
31214
+ color: string;
31215
+ 'background-color': string;
31216
+ };
31033
31217
  };
31034
31218
  onRoot: {
31035
31219
  '--color-caption-categorical-01': string;