@po-ui/ng-components 20.6.0 → 20.8.0

package/lib/components/po-listbox/po-listbox.component.d.ts

@@ -1,25 +1,35 @@
-import { AfterViewInit, ElementRef, OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
+import { AfterViewInit, ElementRef, OnChanges, OnDestroy, OnInit, QueryList, SimpleChanges } from '@angular/core';
 import { PoListBoxBaseComponent } from './po-listbox-base.component';
 import { PoItemListOptionGroup } from './po-item-list/interfaces/po-item-list-option-group.interface';
 import { PoItemListOption } from './po-item-list/interfaces/po-item-list-option.interface';
 import { PoSearchListComponent } from './po-search-list/po-search-list.component';
+import { PoDropdownAction } from '../po-dropdown/po-dropdown-action.interface';
 import { Observable } from 'rxjs';
-export declare class PoListBoxComponent extends PoListBoxBaseComponent implements AfterViewInit, OnChanges, OnDestroy {
+export declare class PoListBoxComponent extends PoListBoxBaseComponent implements OnInit, AfterViewInit, OnChanges, OnDestroy {
     element: ElementRef<any>;
+    currentItems: Array<PoDropdownAction>;
+    currentGroup: PoDropdownAction | null;
+    private readonly navigationStack;
     private readonly renderer;
     private readonly router;
     private readonly changeDetector;
     listbox: ElementRef;
     listboxItemList: ElementRef;
+    listboxGroupHeader: ElementRef;
     searchElement: PoSearchListComponent;
     popupHeaderContainer: ElementRef;
+    listboxItems: QueryList<ElementRef>;
     private scrollEvent$;
     private subscriptionScrollEvent;
     constructor();
+    ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnChanges(changes?: SimpleChanges): void;
     ngOnDestroy(): void;
-    onSelectItem(itemListAction: PoItemListOption | PoItemListOptionGroup | any): void | Promise<boolean>;
+    openGroup(group: PoDropdownAction, event?: MouseEvent | KeyboardEvent): void;
+    goBack(event: MouseEvent | KeyboardEvent): void;
+    onKeydownGoBack(event: KeyboardEvent): void;
+    onSelectItem(itemListAction: PoItemListOption | PoItemListOptionGroup | any, event?: MouseEvent | KeyboardEvent): void | Promise<boolean>;
     onSelectAllCheckboxKeyDown(event: KeyboardEvent): void;
     onKeyDown(itemListAction: PoItemListOption | PoItemListOptionGroup | any, event?: KeyboardEvent): void;
     checkboxClicked({ option, selected }: {
@@ -46,6 +56,7 @@ export declare class PoListBoxComponent extends PoListBoxBaseComponent implement
     private includeInfiniteScroll;
     protected returnBooleanValue(itemListAction: any, property: string): any;
     private setListBoxMaxHeight;
+    private setListBoxWidth;
     private openUrl;
     onClickTabs(tab: any): void;
     formatItemList(item: any): string;

package/lib/components/po-loading/po-loading-base.component.d.ts

@@ -15,7 +15,7 @@ export declare const poLoadingLiteralsDefault: {
  * ou aguardando a resposta de alguma requisição.
  */
 export declare class PoLoadingBaseComponent {
-    private languageService;
+    protected languageService: PoLanguageService;
     private _text?;
     private _size?;
     /**
@@ -25,14 +25,17 @@ export declare class PoLoadingBaseComponent {
     get text(): string;
     /**
      * Define o tamanho do ícone.
-     *
-     * @default `lg`
-     *
      * Valores válidos:
      *  - `xs`: 16px
      *  - `sm`: 24px
      *  - `md`: 32px
      *  - `lg`: 80px
+     *
+     * > Em nível de acessibilidade **AA**, caso o valor de `p-size` não seja definido, o valor padrão será `sm`
+     * > quando o valor padrão dos componentes for configurado como `small` no
+     * > [serviço de tema](https://po-ui.io/documentation/po-theme).
+     *
+     * @default `lg`
      */
     set size(value: string);
     get size(): string;

package/lib/components/po-page/interfaces/po-page-action.interface.d.ts

@@ -1,16 +1,17 @@
-import { PoPopupAction } from '../../po-popup/po-popup-action.interface';
+import { PoDropdownAction } from '../../po-dropdown';
 /**
  * @description
  * Interface para as ações dos componentes po-page-default e po-page-list.
  *
- * > As propriedades `selected`, `separator` e `type` serão vistas a partir da terceira ação e somente quando
- * definir quatro ações ou mais.
+ * > Quando o array de actions possui quatro ou mais registros, os dois últimos e os seguintes são automaticamente agrupados no po-dropdown.
+ * 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.
+ * Dessa forma, o uso de subItems (agrupadores dentro do dropdown) só terá efeito quando houver pelo menos quatro ações definidas.
  *
- * @docsExtends PoPopupAction
+ * @docsExtends PoDropdownAction
  *
  * @ignoreExtendedDescription
  *
  * @usedBy PoPageDefaultComponent, PoPageListComponent
  */
-export interface PoPageAction extends PoPopupAction {
+export interface PoPageAction extends PoDropdownAction {
 }

package/lib/components/po-page/po-page-default/po-page-default-base.component.d.ts

@@ -18,14 +18,15 @@ export declare const poPageDefaultLiteralsDefault: {
  *
  * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
  *
- * | Propriedade                            | Descrição                                             | Valor Padrão                                    |
- * |----------------------------------------|-------------------------------------------------------|-------------------------------------------------|
- * | **Default Values**                     |                                                       |                                                 |
- * | `--padding`                            | Espaçamento do componente                             | `var(--spacing-xs) var(--spacing-md)`           |
- * | `--gap`                                | Gap entre o header e o conteúdo                       | `var(--spacing-md)`                             |
- * | `--padding-top-header`                 | Espaçamento do topo do header                         | `var(--color-neutral-light-30)`                 |
- * | `--gap-actions`                        | Gap entre os botões de action                         | `var(--spacing-xs)`                             |
- * | `--padding-content`                    | Espaçamento do conteúdo                               | `var(--spacing-xs) var(--spacing-sm)`           |
+ * | Propriedade         | Descrição                                   | Valor Padrão                          |
+ * |---------------------|---------------------------------------------|---------------------------------------|
+ * | **Header**          |                                             |                                       |
+ * | `--padding`         | Espaçamento do header                       | `var(--spacing-xs) var(--spacing-md)` |
+ * | `--gap`             | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)`                   |
+ * | `--gap-actions`     | Espaçamento entre as ações                  | `var(--spacing-xs)`                   |
+ * | `--font-family`     | Família tipográfica do título               | `var(--font-family-theme)`            |
+ * | **Content**         |                                             |                                       |
+ * | `--padding-content` | Espaçamento do conteúdo                     | `var(--spacing-xs) var(--spacing-sm)` |
  */
 export declare abstract class PoPageDefaultBaseComponent {
     poPageContent: PoPageContentComponent;

package/lib/components/po-page/po-page-detail/po-page-detail-base.component.d.ts

@@ -14,6 +14,20 @@ export declare const poPageDetailLiteralsDefault: {
  *
  * O componente **po-page-detail** é utilizado como container principal para a tela de
  * detalhamento de um registro, tendo a possibilidade de usar as ações de "Voltar", "Editar" e "Remover".
+ *
+ * #### Tokens customizáveis
+ *
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
+ *
+ * | Propriedade         | Descrição                                   | Valor Padrão                          |
+ * |---------------------|---------------------------------------------|---------------------------------------|
+ * | **Header**          |                                             |                                       |
+ * | `--padding`         | Espaçamento do header                       | `var(--spacing-xs) var(--spacing-md)` |
+ * | `--gap`             | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)`                   |
+ * | `--gap-actions`     | Espaçamento entre as ações                  | `var(--spacing-xs)`                   |
+ * | `--font-family`     | Família tipográfica do título               | `var(--font-family-theme)`            |
+ * | **Content**         |                                             |                                       |
+ * | `--padding-content` | Espaçamento do conteúdo                     | `var(--spacing-xs) var(--spacing-sm)` |
  */
 export declare class PoPageDetailBaseComponent {
     poPageContent: PoPageContentComponent;

package/lib/components/po-page/po-page-edit/po-page-edit-base.component.d.ts

@@ -18,6 +18,20 @@ export declare const poPageEditLiteralsDefault: {
  * Os botões "Salvar" e "Salvar e Novo" podem ser habilitados/desabilitados utilizando a propriedade `p-disable-submit`.
  * Esta propriedade pode ser utilizada para desabilitar os botões caso exista um formulário inválido na página ou alguma
  * regra de negócio não tenha sido atendida.
+ *
+ * #### Tokens customizáveis
+ *
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
+ *
+ * | Propriedade         | Descrição                                   | Valor Padrão                          |
+ * |---------------------|---------------------------------------------|---------------------------------------|
+ * | **Header**          |                                             |                                       |
+ * | `--padding`         | Espaçamento do header                       | `var(--spacing-xs) var(--spacing-md)` |
+ * | `--gap`             | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)`                   |
+ * | `--gap-actions`     | Espaçamento entre as ações                  | `var(--spacing-xs)`                   |
+ * | `--font-family`     | Família tipográfica do título               | `var(--font-family-theme)`            |
+ * | **Content**         |                                             |                                       |
+ * | `--padding-content` | Espaçamento do conteúdo                     | `var(--spacing-xs) var(--spacing-sm)` |
  */
 export declare class PoPageEditBaseComponent {
     poPageContent: PoPageContentComponent;

package/lib/components/po-page/po-page-header/po-page-header-base.component.d.ts

@@ -10,6 +10,8 @@ import { PoBreadcrumb } from '../../po-breadcrumb/po-breadcrumb.interface';
 export declare class PoPageHeaderBaseComponent {
     /** Título da página. */
     title: string;
+    /** Define o tamanho dos componentes no header. */
+    size: string;
     /** Subtítulo da página. */
     subtitle: string;
     private _breadcrumb;

package/lib/components/po-page/po-page-list/po-page-list-base.component.d.ts

@@ -23,6 +23,20 @@ export declare const poPageListLiteralsDefault: {
  *
  * Para facilitar a manipulação e visualização dos filtros aplicados, é possível também utilizar o componente
  * [`po-disclaimer-group`](/documentation/po-disclaimer-group).
+ *
+ * #### Tokens customizáveis
+ *
+ * > Para maiores informações, acesse o guia [Personalizando o Tema Padrão com Tokens CSS](https://po-ui.io/guides/theme-customization).
+ *
+ * | Propriedade         | Descrição                                   | Valor Padrão                          |
+ * |---------------------|---------------------------------------------|---------------------------------------|
+ * | **Header**          |                                             |                                       |
+ * | `--padding`         | Espaçamento do header                       | `var(--spacing-xs) var(--spacing-md)` |
+ * | `--gap`             | Espaçamento entre os breadcrumbs e o título | `var(--spacing-md)`                   |
+ * | `--gap-actions`     | Espaçamento entre as ações                  | `var(--spacing-xs)`                   |
+ * | `--font-family`     | Família tipográfica do título               | `var(--font-family-theme)`            |
+ * | **Content**         |                                             |                                       |
+ * | `--padding-content` | Espaçamento do conteúdo                     | `var(--spacing-xs) var(--spacing-sm)` |
  */
 export declare abstract class PoPageListBaseComponent {
     poPageContent: PoPageContentComponent;

package/lib/components/po-popover/po-popover-base.component.d.ts

@@ -140,4 +140,16 @@ export declare class PoPopoverBaseComponent {
      */
     set trigger(value: string);
     get trigger(): string;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     * Permite a inclusão de classes CSS customizadas ao componente.
+     *
+     * Exemplo: `p-custom-classes="minha-classe-1 minha-classe-2"`.
+     *
+     */
+    customClasses: import("@angular/core").InputSignal<string>;
 }

package/lib/components/po-popover/po-popover.component.d.ts

@@ -31,7 +31,10 @@ export declare class PoPopoverComponent extends PoPopoverBaseComponent implement
     timeoutResize: any;
     targetElement: any;
     afterViewInitWasCalled: boolean;
+    private keydownTargetListener?;
+    private keydownPopoverListener?;
     eventListenerFunction: () => void;
+    private readonly tabbableSelector;
     constructor(renderer: Renderer2, poControlPosition: PoControlPositionService, cd: ChangeDetectorRef);
     ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
@@ -49,4 +52,12 @@ export declare class PoPopoverComponent extends PoPopoverBaseComponent implement
     private initEventListenerFunction;
     private removeListeners;
     private setElementsControlPosition;
+    private focusOnTarget;
+    private focusOnFirstFocusable;
+    private attachPopoverKeydown;
+    private isVisible;
+    private getTabbablesIn;
+    private getDocumentTabbables;
+    private focusNextAfterTarget;
+    private focusPrevBeforeTarget;
 }

package/lib/components/po-popup/po-popup-action.interface.d.ts

@@ -7,11 +7,21 @@ import { TemplateRef } from '@angular/core';
  * Interface para lista de ações do componente.
  */
 export interface PoPopupAction {
-    /** Rótulo da ação. */
+    /**
+     * @description
+     *
+     * Rótulo da ação.
+     *
+     * No componente `po-dropdown`, a label também pode representar o agrupador de subitens.
+     */
     label: string;
     /**
+     * @description
+     *
      * Ação que será executada, sendo possível passar o nome ou a referência da função.
      *
+     * No componente `po-dropdown`, a action também pode ser executada para o agrupador de subitens.
+     *
      * > Para que a função seja executada no contexto do elemento filho o mesmo deve ser passado utilizando *bind*.
      *
      * Exemplo: `action: this.myFunction.bind(this)`
@@ -58,12 +68,20 @@ export interface PoPopupAction {
      * ```
      */
     icon?: string | TemplateRef<void>;
-    /** Atribui uma linha separadora acima do item. */
+    /**
+     * @description
+     *
+     * Atribui uma linha separadora acima do item.
+     *
+     * */
     separator?: boolean;
     /**
+     * @description
+     *
      * Função que deve retornar um booleano para habilitar ou desabilitar a ação para o registro selecionado.
      *
      * Também é possível informar diretamente um valor booleano que vai habilitar ou desabilitar a ação para todos os registros.
+     *
      */
     disabled?: boolean | Function;
     /**
@@ -76,9 +94,23 @@ export interface PoPopupAction {
      *  - `danger` - indicado para ações exclusivas (excluir, sair).
      */
     type?: string;
-    /** URL utilizada no redirecionamento das páginas. */
+    /**
+     * @description
+     *
+     * URL utilizada para redirecionamento das páginas.
+     *
+     * No componente `po-dropdown`, a url também pode ser configurada para o agrupador de subitens.
+     * Entretanto, quando a `url` é informada em um agrupador, o clique **não abrirá os subitens**, pois o item será
+     * tratado como um link e o redirecionamento terá prioridade sobre a exibição da lista.
+     *
+     */
     url?: string;
-    /** Define se a ação está selecionada. */
+    /**
+     * @description
+     *
+     * Define se a ação está selecionada.
+     *
+     */
     selected?: boolean;
     /**
      * @description

package/lib/components/po-popup/po-popup-base.component.d.ts

@@ -75,6 +75,7 @@ export declare class PoPopupBaseComponent {
     private _position?;
     private _size?;
     private _target;
+    listboxSubitems: boolean;
     /** Lista de ações que serão exibidas no componente. */
     set actions(value: Array<PoPopupAction>);
     get actions(): Array<PoPopupAction>;

package/lib/components/po-search/po-search-base.component.d.ts

@@ -328,6 +328,22 @@ export declare class PoSearchBaseComponent {
      * > Incompatível com a propriedade `p-search-type` do tipo `locate`.
      */
     filteredItemsChange: EventEmitter<any[]>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento emitido quando o campo de entrada (input) recebe foco.
+     */
+    focusEvent: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     * Evento disparado quando uma tecla é pressionada enquanto o foco está no componente.
+     * Retorna um objeto `KeyboardEvent` com informações sobre a tecla.
+     */
+    keydown: EventEmitter<KeyboardEvent>;
     /**
      * @optional
      *

package/lib/components/po-search/po-search.component.d.ts

@@ -123,7 +123,7 @@ export declare class PoSearchComponent extends PoSearchBaseComponent implements
     getInputValue(): any;
     createDropdownFilterSelect(): void;
     isSelected(filterOption: PoSearchFilterSelect): boolean;
-    changeFilterSelect(filterOption: PoSearchFilterSelect): void;
+    changeFilterSelect(filterOption: PoSearchFilterSelect, focus?: boolean): void;
     handlerFooterActionListbox(): void;
     private openListboxFooterAction;
     private handlerPlaceholderListbox;

package/lib/components/po-table/enums/po-table-spacing.enum.d.ts

@@ -5,7 +5,7 @@
  * Tipos de espaçamento interno (padding) das células (**p-spacing**) do po-table.
  */
 export declare enum PoTableColumnSpacing {
-    /** Espaçamento extra pequeno: 0.25rem (vertical) x 1rem (horizontal). */
+    /** Espaçamento extra pequeno: 0.25rem (vertical) x 0.5rem (horizontal). */
     ExtraSmall = "extraSmall",
     /** Espaçamento pequeno: 0.5rem (vertical) x 1rem (horizontal). */
     Small = "small",

package/lib/components/po-tag/po-tag-base.component.d.ts

@@ -41,6 +41,7 @@ export declare const PoTagLiteralsDefault: {
  * | `--font-size`                          | Tamanho da fonte                                      | `var(--font-size-sm)`                           |
  * | `--line-height`                        | Tamanho da label                                      | `var(---line-height-sm)`                        |
  * | `--border-radius`                      | Contém o valor do raio dos cantos do elemento    | `var(--border-radius-pill)`                     |
+ * | `--gap`                                | Espaçamento entre o label e o value                   | `var(--spacing-xs)`                             |
  * | **Neutral**                            |                                                       |                                                 |
  * | `--color-neutral`                      | Cor principal no estado neutral                       | `var(--color-neutral-light-10)`                 |
  * | `--text-color-positive`                | Cor do texto no estado neutral                        | `var(--color-neutral-dark-80)`                  |

package/lib/enums/po-density-mode.enum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @docsPrivate
+ *
+ * @description
+ *
+ * Define o nível de densidade (espaçamento) aplicado em componentes agrupadores. Pode ser ajustado conforme a
+ * preferência do usuário ou requisitos de acessibilidade.
+ */
+export declare enum PoDensityMode {
+    /** Define espaçamentos mais compactos entre os elementos. */
+    Small = "small",
+    /** Define espaçamentos mais amplos e confortáveis. */
+    Medium = "medium"
+}

package/lib/enums/po-field-size.enum.d.ts

@@ -3,11 +3,13 @@
  *
  * @description
  *
- * Tamanhos da propriedade `p-size`. A medida `small` está disponível apenas para acessibilidade AA.
+ * Define o tamanho padrão utilizado em componentes interativos. Este enum também é usado pelo serviço de tema para
+ * definir a preferência global de tamanho dos componentes. Por padrão, os componentes utilizam o tamanho `medium` por
+ * ser mais acessível (conforme diretrizes WCAG nível AAA).
+ *
+ * > O tamanho `small` está disponível apenas em contextos com acessibilidade AA.
  */
 export declare enum PoFieldSize {
-    /** Define a altura do input como 32px. */
     Small = "small",
-    /** Define a altura do input como 44px. */
     Medium = "medium"
 }

package/lib/services/po-theme/helpers/accessibilities/po-theme-density.constant.d.ts

@@ -0,0 +1,12 @@
+export declare const poThemeDensity: {
+    small: {
+        '--default-spacing-0': string;
+        '--default-spacing-xs': string;
+        '--default-spacing-sm': string;
+        '--default-spacing-md': string;
+        '--default-spacing-lg': string;
+        '--default-spacing-xl': string;
+        '--default-line-height-xs': string;
+        '--default-spacing-squish-xs': string;
+    };
+};

package/lib/services/po-theme/helpers/types/po-theme-dark-defaults-AA.constant.d.ts

@@ -53,6 +53,10 @@ declare const poThemeDefaultDarkValuesAA: {
         'po-select': {
             '--color-hover': string;
         };
+        '.po-listbox-group-header .po-tag': {
+            color: string;
+            'background-color': string;
+        };
     };
     onRoot: {
         '--color-caption-categorical-01': string;

package/lib/services/po-theme/helpers/types/po-theme-dark-defaults.constant.d.ts

@@ -72,6 +72,11 @@ declare const poThemeDefaultDarkValues: {
         'po-select': {
             '--color-hover': string;
         };
+        /** DROPDOWN */
+        '.po-listbox-group-header .po-tag': {
+            color: string;
+            'background-color': string;
+        };
     };
     onRoot: {
         '--color-neutral': string;

package/lib/services/po-theme/po-theme.module.d.ts

@@ -1,5 +1,5 @@
 /**
- * Módulo responsável por fornecer serviços relacionados ao tema PO.
+ * Módulo do serviço PoThemeService.
  */
 export declare class PoThemeModule {
 }

package/lib/services/po-theme/po-theme.service.d.ts

@@ -1,15 +1,25 @@
 import { RendererFactory2 } from '@angular/core';
+import { PoDensityMode } from '../../enums/po-density-mode.enum';
 import { PoThemeA11yEnum } from './enum/po-theme-a11y.enum';
 import { PoThemeTypeEnum } from './enum/po-theme-type.enum';
 import { PoTheme, PoThemeActive } from './interfaces/po-theme.interface';
 /**
  * @description
  *
- * 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.
+ * O serviço `PoThemeService` permite customizar as cores do tema padrão do `PO-UI` e definir o nível de acessibilidade
+ * mais adequado ao projeto.
  *
- * > 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`.
+ * O nível **AAA** (padrão) garante maior contraste, áreas clicáveis amplas e espaçamentos maiores entre os elementos,
+ * enquanto o nível **AA** mantém a conformidade com as diretrizes de acessibilidade, mas com proporções mais equilibradas
+ * e contornos mais sutis.
  *
- * > Obs.: Não está documentado aqui e não indicamos a customização das cores de 'feedback' por motivos de acessibilidade e usabilidade.
+ * O serviço também possibilita configurar a **densidade de espaçamentos**, permitindo ajustar o espaço entre e dentro dos
+ * componentes. Essa configuração pode ser utilizada com qualquer nível de acessibilidade.
+ *
+ * > Observação: a customização das cores de `feedback` não é recomendada por motivos de acessibilidade e usabilidade.
+ *
+ * > Para saber mais sobre como customizar o tema padrão, consulte o item
+ * [Customização de Temas usando o serviço PO-UI](guides/theme-service) na aba `Guias`.
  */
 /**
  * @example
@@ -38,7 +48,8 @@ export declare class PoThemeService {
      * @param {PoTheme} themeConfig - Configuração de tema a ser aplicada ao componente.
      * @param {PoThemeTypeEnum} [themeType=PoThemeTypeEnum.light] - (Opcional) Tipo de tema, podendo ser 'light' (claro) ou 'dark' (escuro). O tema claro é o padrão.
      * @param {PoThemeA11yEnum} [a11yLevel=PoThemeA11yEnum.AAA] - (Opcional) Nível de acessibilidade dos componentes, podendo ser AA ou AAA. Padrão é AAA.
-     * @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.
+     * @param {boolean} [persistPreference=true] - (Opcional) Define se a preferência de tema deve ser salva no
+     * localStorage para persistência. Por padrão é `true`, ou seja, a preferência será salva automaticamente.
      */
     setTheme(themeConfig: PoTheme, themeType?: PoThemeTypeEnum, a11yLevel?: PoThemeA11yEnum, persistPreference?: boolean): void;
     private setDataDefaultSizeHTML;
@@ -49,18 +60,35 @@ export declare class PoThemeService {
      */
     getA11yLevel(): PoThemeA11yEnum;
     /**
-     * Define o tamanho `small` como padrão para componentes de formulário que não possuem um tamanho definido.
-     * Essa configuração é aplicada globalmente apenas quando o nível de acessibilidade for `AA`.
-     * Caso contrário, o tamanho padrão será `medium`.
+     * Define o tamanho `small` como padrão para componentes de formulário que não possuem um tamanho definido. Essa
+     * configuração é aplicada globalmente apenas quando o nível de acessibilidade for `AA`. O valor definido é salvo no
+     * `localStorage` sob a chave `po-default-size`.
      *
      * > Para garantir que o tamanho `small` seja aplicado corretamente a todos os componentes, recomendamos
      * definir esta configuração **junto com o nível de acessibilidade `AA` na inicialização da aplicação**.
      * Se for aplicada em tempo de execução, será necessário recarregar a aplicação (`reload`)
      * para que os estilos sejam aplicados corretamente.
+     * > Para ajustar a densidade visual dos componentes agrupadores (como pages, container, etc.), utilize também
+     * o método `setDensityMode` conforme necessário.
      *
      * @param {boolean} enable Habilita ou desabilita o tamanho `small` globalmente.
      */
     setA11yDefaultSizeSmall(enable: boolean): boolean;
+    /**
+     * Retorna o modo de adensamento dos componentes agrupadores.
+     * Se não estiver configurado, retorna `medium` como padrão.
+     * @returns {PoDensityMode} O modo de adensamento, que pode ser `small` ou `medium`.
+     */
+    getDensityMode(): PoDensityMode;
+    /**
+     * Aplica o modo de adensamento compacto (`small`) ou espaçoso (`medium`) para os componentes agrupadores,
+     * independentemente do nível de acessibilidade. O valor definido é salvo no `localStorage` sob a chave
+     * `po-density-mode`.
+     *
+     * @param {'small' | 'medium'} mode Define o modo de densidade: `small` para compacto, `medium` para espaçoso.
+     * O valor padrão é `medium`.
+     */
+    setDensityMode(mode: string): void;
     /**
      * @docsPrivate
      * Retorna a preferência global de tamanho dos componentes.
@@ -142,11 +170,10 @@ export declare class PoThemeService {
     private applyThemeStyles;
     private changeThemeType;
     /**
-     * Persiste e define o tema do aplicativo com base nos dados armazenados.
-     *
-     * Este método recupera os dados do tema armazenados e os aplica ao aplicativo.
+     * Restaura e aplica as preferências visuais do usuário para o tema da aplicação, garantindo que essas preferências
+     * sejam persistidas no `localStorage` para uso em recarregamentos futuros.
      *
-     * @returns {PoTheme} Recupera o tema armazenado.
+     * @returns {PoTheme} O tema atualmente aplicado.
      */
     persistThemeActive(): PoTheme;
     private formatTheme;
@@ -168,6 +195,7 @@ export declare class PoThemeService {
     cleanThemeActive(persistPreference?: boolean): void;
     private getActiveTypeFromTheme;
     private getActiveA11yFromTheme;
+    private isValidA11yLevel;
     /**
      * @docsPrivate
      *

package/lib/utils/util.d.ts

@@ -1,6 +1,7 @@
-import { PoThemeService } from '../services/po-theme/po-theme.service';
-import { PoThemeA11yEnum } from '../services/po-theme/enum/po-theme-a11y.enum';
+import { PoDensityMode } from '../enums/po-density-mode.enum';
 import { ElementRef } from '@angular/core';
+import { PoThemeA11yEnum } from '../services/po-theme/enum/po-theme-a11y.enum';
+import { PoThemeService } from '../services/po-theme/po-theme.service';
 /**
  * Converte e formata os bytes em formato mais legível para o usuário.
  *
@@ -273,6 +274,12 @@ export declare function getA11yDefaultSize(): string;
  * @returns {PoThemeA11yEnum} O nível de acessibilidade, que pode ser `AA` ou `AAA`.
  */
 export declare function getA11yLevel(): PoThemeA11yEnum;
+/**
+ * Retorna o modo de adensamento dos componentes agrupadores.
+ * Se não estiver configurado, retorna `medium` como padrão.
+ * @returns {PoDensityMode} O modo de adensamento, que pode ser `small` ou `medium`.
+ */
+export declare function getDensityMode(): PoDensityMode;
 /**
  * Realiza a tradução das propriedades de ajuda dos componentes.
  * Type do Helper default é 'help' e size 'medium'.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@po-ui/ng-components",
-  "version": "20.6.0",
+  "version": "20.8.0",
   "description": "PO UI - Components",
   "author": "PO UI",
   "license": "MIT",
@@ -22,8 +22,8 @@
   },
   "dependencies": {
     "@angular/cdk": "~20.0.3",
-    "@po-ui/style": "20.6.0",
-    "@po-ui/ng-schematics": "20.6.0",
+    "@po-ui/style": "20.8.0",
+    "@po-ui/ng-schematics": "20.8.0",
     "echarts": "^5.6.0",
     "tslib": "^2.3.0"
   },
@@ -38,7 +38,7 @@
     "@angular/platform-browser-dynamic": "^20",
     "@angular/router": "^20",
     "@angular-devkit/schematics": "^20",
-    "@po-ui/style": "20.6.0",
+    "@po-ui/style": "20.8.0",
     "rxjs": "~7.8.1",
     "zone.js": "~0.15.0"
   },

package/schematics/ng-add/index.js

@@ -18,7 +18,7 @@ function default_1(options) {
 }
 function addPoPackageAndInstall() {
     return (tree, context) => {
-        (0, package_config_1.addPackageToPackageJson)(tree, '@po-ui/ng-components', '20.6.0');
+        (0, package_config_1.addPackageToPackageJson)(tree, '@po-ui/ng-components', '20.8.0');
         // install packages
         context.addTask(new tasks_1.NodePackageInstallTask());
     };

package/schematics/ng-update/v14/index.js

@@ -6,7 +6,7 @@ const tasks_1 = require("@angular-devkit/schematics/tasks");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('20.6.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('20.8.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {