@po-ui/ng-components 19.32.0 → 19.33.0

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

@@ -16,7 +16,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?;
     /**
@@ -26,14 +26,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/po-page-default/po-page-default-base.component.d.ts

@@ -19,14 +19,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

@@ -15,6 +15,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

@@ -19,6 +19,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

@@ -11,6 +11,8 @@ import * as i0 from "@angular/core";
 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;
@@ -18,5 +20,5 @@ export declare class PoPageHeaderBaseComponent {
     set breadcrumb(value: PoBreadcrumb);
     get breadcrumb(): PoBreadcrumb;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoPageHeaderBaseComponent, never>;
-    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>;
+    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>;
 }

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

@@ -24,6 +24,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

@@ -141,7 +141,19 @@ 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>;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoPopoverBaseComponent, never>;
-    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>;
+    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>;
     static ngAcceptInputType_appendBox: any;
 }

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

@@ -32,7 +32,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;
@@ -50,6 +53,14 @@ 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;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoPopoverComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PoPopoverComponent, "po-popover", never, {}, {}, never, ["*"], false, never>;
 }

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

@@ -329,6 +329,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
      *
@@ -371,7 +387,7 @@ export declare class PoSearchBaseComponent {
     constructor(languageService: PoLanguageService);
     ensureFilterSelectOption(values: any): any[];
     static ɵfac: i0.ɵɵFactoryDeclaration<PoSearchBaseComponent, never>;
-    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>;
+    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>;
     static ngAcceptInputType_disabled: any;
     static ngAcceptInputType_showListbox: any;
 }

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

@@ -124,7 +124,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

@@ -42,6 +42,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/po-theme.module.d.ts

@@ -1,6 +1,6 @@
 import * as i0 from "@angular/core";
 /**
- * Módulo responsável por fornecer serviços relacionados ao tema PO.
+ * Módulo do serviço PoThemeService.
  */
 export declare class PoThemeModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PoThemeModule, never>;

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

@@ -1,4 +1,5 @@
 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';
@@ -6,11 +7,20 @@ import * as i0 from "@angular/core";
 /**
  * @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
@@ -39,7 +49,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;
@@ -50,18 +61,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.
@@ -143,11 +171,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;
@@ -169,6 +196,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": "19.32.0",
+  "version": "19.33.0",
   "description": "PO UI - Components",
   "author": "PO UI",
   "license": "MIT",
@@ -22,8 +22,8 @@
   },
   "dependencies": {
     "@angular/cdk": "~19.0.3",
-    "@po-ui/style": "19.32.0",
-    "@po-ui/ng-schematics": "19.32.0",
+    "@po-ui/style": "19.33.0",
+    "@po-ui/ng-schematics": "19.33.0",
     "echarts": "^5.6.0",
     "tslib": "^2.6.2"
   },
@@ -38,7 +38,7 @@
     "@angular/platform-browser-dynamic": "^19",
     "@angular/router": "^19",
     "@angular-devkit/schematics": "^19",
-    "@po-ui/style": "19.32.0",
+    "@po-ui/style": "19.33.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', '19.32.0');
+        (0, package_config_1.addPackageToPackageJson)(tree, '@po-ui/ng-components', '19.33.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)('19.32.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

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

@@ -11,7 +11,7 @@ const changes_1 = require("./changes");
 const httpClientModuleName = 'HttpClientModule';
 const httpClientModuleSourcePath = '@angular/common/http';
 function default_1() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.32.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v16/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)('19.32.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v17/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)('19.32.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

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

@@ -40,11 +40,11 @@ function main(options) {
             configureNewIcon.toLowerCase() === 'y' ||
             configureNewIcon.toLowerCase() === 'sim' ||
             configureNewIcon.toLowerCase() === '') {
-            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.32.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('19.32.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion),
                 addImportOnly(options, [IconsDictionaryName, poIconDictionary], poModuleSourcePath),
                 addProviderToAppModule(options, newProviderDictionary),
                 updateAppConfigFileRule(),

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

@@ -40,11 +40,11 @@ function main(options) {
             configureNewIcon.toLowerCase() === 'y' ||
             configureNewIcon.toLowerCase() === 'sim' ||
             configureNewIcon.toLowerCase() === '') {
-            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.32.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+            return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
         }
         else {
             return (0, schematics_1.chain)([
-                (0, package_config_1.updatePackageJson)('19.32.0', changes_1.updateDepedenciesVersion),
+                (0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion),
                 addImportOnly(options, [IconsDictionaryName, poIconDictionary], poModuleSourcePath),
                 addProviderToAppModule(options, newProviderDictionary),
                 updateAppConfigFileRule(),

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

@@ -10,7 +10,7 @@ const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function updateToV2() {
     return (0, schematics_1.chain)([
-        updatePackageJson('19.32.0', changes_1.dependeciesChanges),
+        updatePackageJson('19.33.0', changes_1.dependeciesChanges),
         (0, replace_1.replaceInFile)('tslint.json', changes_1.tsLintReplaces),
         (0, replace_1.replaceInFile)('angular.json', changes_1.angularJsonReplaces),
         createUpgradeRule(),

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

@@ -7,7 +7,7 @@ const project_1 = require("@po-ui/ng-schematics/project");
 const package_config_1 = require("@po-ui/ng-schematics/package-config");
 const changes_1 = require("./changes");
 function updateToV3() {
-    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.32.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

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

@@ -7,7 +7,7 @@ const project_1 = require("@po-ui/ng-schematics/project");
 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)('19.32.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

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

@@ -7,7 +7,7 @@ const project_1 = require("@po-ui/ng-schematics/project");
 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)('19.32.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion), createUpgradeRule(), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {

package/schematics/ng-update/v6/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)('19.32.0', changes_1.updateDepedenciesVersion), postUpdate()]);
+    return (0, schematics_1.chain)([(0, package_config_1.updatePackageJson)('19.33.0', changes_1.updateDepedenciesVersion), postUpdate()]);
 }
 function postUpdate() {
     return (_, context) => {