@po-ui/ng-components 19.31.0 → 19.33.0

package/lib/components/po-field/po-upload/po-upload-base.component.d.ts

@@ -1,6 +1,7 @@
 import { ChangeDetectorRef, EventEmitter } from '@angular/core';
 import { AbstractControl, ControlValueAccessor, Validator } from '@angular/forms';
 import { PoLanguageService } from '../../../services/po-language/po-language.service';
+import { PoModalAction } from '../../po-modal';
 import { PoProgressAction } from '../../po-progress';
 import { PoUploadFileRestrictions } from './interfaces/po-upload-file-restriction.interface';
 import { PoUploadLiterals } from './interfaces/po-upload-literals.interface';
@@ -27,6 +28,44 @@ export declare const poUploadLiteralsDefault: {
  *  - Função de sucesso que será disparada quando os arquivos forem enviados com sucesso.
  *  - Função de erro que será disparada quando houver erro no envio dos arquivos.
  *  - Permite habilitar uma área onde os arquivos podem ser arrastados.
+ *
+ * #### Tokens customizáveis
+ *
+ * É possível alterar o estilo do componente usando os seguintes tokens (CSS):
+ *
+ * > 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                                      |
+ * |----------------------------------------|-------------------------------------------------------|---------------------------------------------------|
+ * | **TEXT SUPPORT**                       |                                                       |                                                   |
+ * | `--font-family-text-support`           | Família tipográfica usada no texto de suporte         | `var(--font-family-theme)`                        |
+ * | `--text-color-text-support`            | Cor da fonte no texto de suporte                      | `var(--color-neutral-dark-90)`                    |
+ * | **UPLOAD CONTENT**                     |                                                       |                                                   |
+ * | `--background-color-content`      | Cor de fundo                                          | `var(--color-neutral-light-10)`                   |
+ * | `--border-color-content`               | Cor da borda                                          | `var(--color-neutral-light-20)`                   |
+ * | `--border-radius-content`              | Contém o valor do raio dos cantos do elemento         | `var(--border-radius-md)`                         |
+ * | `--text-color-file-name`               | Cor do texto do nome do arquivo                       | `var(--color-neutral-dark-90)`                    |
+ * | `--font-family-file-name`              | Família tipográfica usada no texto do arquivo         | `var(--font-family-theme)`                        |
+ * | `--text-color-info-bar`                | Cor do texto de informação                            | `var(--color-neutral-mid-60)`                     |
+ * | `--font-family-info-bar`               | Família tipográfica usada no texto de informação      | `var(--font-family-theme)`                        |
+ * | **ERROR STATE**                        |                                                       |                                                   |
+ * | `--background-color-content-error`     | Cor de fundo do container de erro                     | `var(--color-neutral-light-00)`                   |
+ * | `--border-color-content-error`         | Cor da borda do container de erro                     | `var(--color-feedback-negative-base)`             |
+ * | `--text-color-error`                   | Cor do texto do container de erro                     | `var(--color-feedback-negative-dark)`             |
+ * | `--color-icon-error`                   | Cor do ícone no estado de erro                        | `var(--color-feedback-negative-base)`             |
+ * | `--font-family-error`                  | Família tipográfica usada no texto de erro            | `var(--font-family-theme)`                        |
+ * | **UPLOADED STATE**                     |                                                       |                                                   |
+ * | `--background-color-content-uploaded`  | Cor de fundo do container com status de enviado       | `var(--color-neutral-light-00)`                   |
+ * | `--border-color-content-uploaded`      | Cor da borda do container com status de enviado       | `var(--color-neutral-light-20)`                   |
+ * | **INTERACTIVE STATE**                  |                                                       |                                                   |
+ * | `--text-color-file-name-interactive`   | Cor do texto do nome do arquivo quando interativo     | `var(--color-action-default)`                     |
+ * | **THUMBNAIL**                          |                                                       |                                                   |
+ * | `--color-icon-thumbnail`               | Cor do ícone na thumbnail                             | `var(--color-action-default)`                     |
+ * | `--border-width-thumbnail`             | Tamanho da fonte na thumbnail                         | `var(--border-width-sm)`                          |
+ * | `--border-radius-thumbnail`            | Contém o valor do raio dos cantos na thumbnail        | `var(--border-radius-md)`                         |
+ * | `--background-color-thumbnail`         | Cor de fundo na thumbnail                             | `var(--color-neutral-light-05)`                   |
+ * | **Focused**                            |                                                       |                                                   |
+ * | `--outline-color-focused`              | Cor do outline do estado de focus                     | `var(--color-action-focus)`                       |
  */
 export declare abstract class PoUploadBaseComponent implements ControlValueAccessor, Validator {
     protected uploadService: PoUploadService;
@@ -39,8 +78,7 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
      * @optional
      *
      * @description
-     * Exibe um ícone de ajuda adicional ao `p-help`, com o texto desta propriedade no tooltip.
-     * Se o evento `p-additional-help` estiver definido, o tooltip não será exibido.
+     * Exibe um ícone de ajuda adicional, com o texto desta propriedade sendo passado para o popover do componente `po-helper`.
      * **Como boa prática, indica-se utilizar um texto com até 140 caracteres.**
      * > Requer um recuo mínimo de 8px se o componente estiver próximo à lateral da tela.
      *
@@ -52,11 +90,11 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
      *
      * @description
      *
-     * Define que o tooltip (`p-additional-help-tooltip`) será incluído no body da página e não dentro do componente. Essa
+     * Define que o popover (`p-helper`) será incluído no body da página e não dentro do componente. Essa
      * opção pode ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o
      * posicionamento correto do tooltip próximo ao elemento.
      *
-     * > Quando utilizado com `p-additional-help-tooltip`, leitores de tela como o NVDA podem não ler o conteúdo do tooltip.
+     * > Quando utilizado com `p-helper`, leitores de tela como o NVDA podem não ler o conteúdo do popover.
      *
      * @default `false`
      */
@@ -129,6 +167,19 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
      * @default `false`
      */
     optional: boolean;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Exibe a pré-visualização de imagens ao anexá-las.
+     *
+     * > Propriedade funciona apenas em arquivos de formato de imagem (`.png`, `.jpg`, `.jpeg` e `.gif`).
+     * Será ignorada em outros tipos de arquivo.
+     *
+     * @default `true`
+     */
+    showThumbnail: boolean;
     /** Objeto que contém os cabeçalhos que será enviado na requisição dos arquivos. */
     headers: {
         [name: string]: string | Array<string>;
@@ -156,10 +207,10 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
      *
      * @description
      *
-     * Define as opções do componente de ajuda (po-helper) que será exibido ao lado do label.
+     * 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`.
+     * > Para mais informações acesse: https://po-ui.io/documentation/po-helper.
      *
-     * > Caso o `p-label` não esteja definido, o componente po-helper não será exibido.
-     * Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
+     * > Ao configurar esta propriedade, o antigo ícone de ajuda adicional (`p-additional-help-tooltip` e `p-additional-help`) será ignorado.
      */
     poHelperComponent: import("@angular/core").InputSignal<string | PoHelperOptions>;
     /**
@@ -184,7 +235,6 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
      *
      * @description
      * Evento disparado ao clicar no ícone de ajuda adicional.
-     * Este evento ativa automaticamente a exibição do ícone de ajuda adicional ao `p-help`.
      *
      * > 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.
      */
@@ -227,6 +277,38 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
      * ```
      */
     customAction?: PoProgressAction;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define uma ou duas ações personalizadas do modal de pré-visualização, adicionando um botão ou dois botões no canto inferior direito
+     * do modal.
+     *
+     * A ação deve implementar a interface **PoModalAction**, permitindo configurar propriedades como:
+     * - `label`: Texto do botão.
+     * - `action`: Ícone a ser exibido no botão.
+     * - `danger`: Define a propriedade `p-danger` do botão.
+     * - `disabled`: Indica se o botão deve estar desabilitado.
+     * - `visible`: Indica se o botão deve estar visível.
+     *
+     * **Exemplo de uso:**
+     *
+     * ```html
+     * <po-upload
+     *  [p-custom-modal-actions]="customActions"
+     * </po-upload>
+     * ```
+     *
+     * ```typescript
+     * customActions:  Array<PoModalAction> = [
+     *  { label: 'Confirmar', action: this.confirmModal.bind(this) },
+     *  { label: 'Cancelar', action: this.closeModal.bind(this) }
+     *];
+     *
+     * ```
+     */
+    customModalActions?: Array<PoModalAction>;
     /**
      * @optional
      *
@@ -297,6 +379,33 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
      * ```
      */
     onUpload: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento será disparado ao clicar no ícone de fechar.
+     * > Por parâmetro será passado o objeto do arquivo.
+     */
+    onCancel: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento será disparado ao abrir o modal de pré-visualização.
+     * > Por parâmetro será passado o objeto do arquivo.
+     */
+    onOpenModalPreview: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento será disparado ao clicar no ícone de remover.
+     * > Por parâmetro será passado o objeto do arquivo.
+     */
+    onRemove: EventEmitter<any>;
     /**
      * @optional
      *
@@ -548,10 +657,10 @@ export declare abstract class PoUploadBaseComponent implements ControlValueAcces
     private setAllowedExtensions;
     private initRestrictions;
     private updateExistsFileInFiles;
-    abstract sendFeedback(): void;
+    abstract sendFeedback(file?: any): void;
     abstract setDirectoryAttribute(value: boolean): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoUploadBaseComponent, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<PoUploadBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "dragDropHeight": { "alias": "p-drag-drop-height"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "url": { "alias": "p-url"; "required": false; }; "name": { "alias": "name"; "required": false; }; "autoUpload": { "alias": "p-auto-upload"; "required": false; }; "disabledRemoveFile": { "alias": "p-disabled-remove-file"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "headers": { "alias": "p-headers"; "required": false; }; "requiredUrl": { "alias": "p-required-url"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "customAction": { "alias": "p-custom-action"; "required": false; }; "directory": { "alias": "p-directory"; "required": false; }; "dragDrop": { "alias": "p-drag-drop"; "required": false; }; "hideRestrictionsInfo": { "alias": "p-hide-restrictions-info"; "required": false; }; "hideSelectButton": { "alias": "p-hide-select-button"; "required": false; }; "hideSendButton": { "alias": "p-hide-send-button"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "fileRestrictions": { "alias": "p-restrictions"; "required": false; }; "formField": { "alias": "p-form-field"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "isMultiple": { "alias": "p-multiple"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "customActionClick": "p-custom-action-click"; "keydown": "p-keydown"; "onUpload": "p-upload"; "onError": "p-error"; "onSuccess": "p-success"; "ngModelChange": "ngModelChange"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PoUploadBaseComponent, never, never, { "additionalHelpEventTrigger": { "alias": "additionalHelpEventTrigger"; "required": false; }; "additionalHelpTooltip": { "alias": "p-additional-help-tooltip"; "required": false; }; "appendBox": { "alias": "p-append-in-body"; "required": false; }; "autoFocus": { "alias": "p-auto-focus"; "required": false; }; "dragDropHeight": { "alias": "p-drag-drop-height"; "required": false; }; "label": { "alias": "p-label"; "required": false; }; "help": { "alias": "p-help"; "required": false; }; "url": { "alias": "p-url"; "required": false; }; "name": { "alias": "name"; "required": false; }; "autoUpload": { "alias": "p-auto-upload"; "required": false; }; "disabledRemoveFile": { "alias": "p-disabled-remove-file"; "required": false; }; "optional": { "alias": "p-optional"; "required": false; }; "showThumbnail": { "alias": "p-show-thumbnail"; "required": false; }; "headers": { "alias": "p-headers"; "required": false; }; "requiredUrl": { "alias": "p-required-url"; "required": false; }; "poHelperComponent": { "alias": "p-helper"; "required": false; "isSignal": true; }; "labelTextWrap": { "alias": "p-label-text-wrap"; "required": false; "isSignal": true; }; "customAction": { "alias": "p-custom-action"; "required": false; }; "customModalActions": { "alias": "p-custom-modal-actions"; "required": false; }; "directory": { "alias": "p-directory"; "required": false; }; "dragDrop": { "alias": "p-drag-drop"; "required": false; }; "hideRestrictionsInfo": { "alias": "p-hide-restrictions-info"; "required": false; }; "hideSelectButton": { "alias": "p-hide-select-button"; "required": false; }; "hideSendButton": { "alias": "p-hide-send-button"; "required": false; }; "literals": { "alias": "p-literals"; "required": false; }; "fileRestrictions": { "alias": "p-restrictions"; "required": false; }; "formField": { "alias": "p-form-field"; "required": false; }; "disabled": { "alias": "p-disabled"; "required": false; }; "isMultiple": { "alias": "p-multiple"; "required": false; }; "required": { "alias": "p-required"; "required": false; }; "showRequired": { "alias": "p-show-required"; "required": false; }; "size": { "alias": "p-size"; "required": false; }; }, { "additionalHelp": "p-additional-help"; "customActionClick": "p-custom-action-click"; "keydown": "p-keydown"; "onUpload": "p-upload"; "onCancel": "p-cancel"; "onOpenModalPreview": "p-open-modal-preview"; "onRemove": "p-remove"; "onError": "p-error"; "onSuccess": "p-success"; "ngModelChange": "ngModelChange"; }, never, never, true, never>;
     static ngAcceptInputType_appendBox: any;
     static ngAcceptInputType_autoFocus: any;
     static ngAcceptInputType_disabledRemoveFile: any;

package/lib/components/po-field/po-upload/po-upload-file.d.ts

@@ -8,6 +8,12 @@ export declare class PoUploadFile {
     size: number;
     displayName?: string;
     percent?: number;
+    sizeNotAllowed?: boolean;
+    extensionNotAllowed?: boolean;
+    hideDoneContent?: boolean;
+    errorMessage?: string;
+    thumbnailUrl?: string;
+    imageError?: boolean;
     constructor(file: any);
     private getExtension;
     private generateUUID;

package/lib/components/po-field/po-upload/po-upload.component.d.ts

@@ -1,9 +1,11 @@
-import { AfterViewInit, Renderer2 } from '@angular/core';
+import { AfterViewInit, OnChanges, Renderer2, SimpleChanges } from '@angular/core';
 import { PoProgressStatus } from '../../po-progress/enums/po-progress-status.enum';
 import { PoButtonComponent } from './../../po-button/po-button.component';
+import { PoModalAction, PoModalComponent } from '../../po-modal';
 import { PoUploadBaseComponent } from './po-upload-base.component';
 import { PoUploadFile } from './po-upload-file';
 import { PoUploadStatus } from './po-upload-status.enum';
+import { PoHelperComponent } from '../../po-helper';
 import * as i0 from "@angular/core";
 /**
  * @docsExtends PoUploadBaseComponent
@@ -34,14 +36,21 @@ import * as i0 from "@angular/core";
  *   <file name="sample-po-upload-download/sample-po-upload-download.component.html"> </file>
  *   <file name="sample-po-upload-download/sample-po-upload-download.component.ts"> </file>
  * </example>
+ *
+ * <example name="po-upload-preview" title="PO Upload - with Preview">
+ *   <file name="sample-po-upload-preview/sample-po-upload-preview.component.html"> </file>
+ *   <file name="sample-po-upload-preview/sample-po-upload-preview.component.ts"> </file>
+ * </example>
  */
-export declare class PoUploadComponent extends PoUploadBaseComponent implements AfterViewInit {
+export declare class PoUploadComponent extends PoUploadBaseComponent implements AfterViewInit, OnChanges {
     renderer: Renderer2;
     private i18nPipe;
     private notification;
     private inputFile;
     private poUploadDragDropComponent;
     uploadButton: PoButtonComponent;
+    modalComponent: PoModalComponent;
+    helperEl?: PoHelperComponent;
     id: string;
     infoByUploadStatus: {
         [key: string]: {
@@ -54,6 +63,12 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
         2: PoProgressStatus;
     };
     private calledByCleanInputValue;
+    protected modalPrimaryAction: PoModalAction;
+    protected modalSecondaryAction: PoModalAction;
+    protected errorMessage: string;
+    protected tooltipTitle: string;
+    protected modalImageUrl: string;
+    protected errorModalImage: boolean;
     constructor();
     get displayDragDrop(): boolean;
     get displaySendButton(): boolean;
@@ -63,7 +78,8 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
     get hasFileNotUploaded(): boolean;
     get isDisabled(): boolean;
     get maxFiles(): number;
-    cancel(file: PoUploadFile): void;
+    cancel(file: PoUploadFile, keydown?: KeyboardEvent): void;
+    ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
     /** Método responsável por **limpar** o(s) arquivo(s) selecionado(s). */
     clear(): void;
@@ -89,30 +105,27 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
     getAdditionalHelpTooltip(): string;
     hasAnyFileUploading(files: Array<PoUploadFile>): boolean;
     isAllowCancelEvent(status: PoUploadStatus): status is PoUploadStatus.Uploading | PoUploadStatus.Error | PoUploadStatus.None;
-    onBlur(): void;
     onFileChange(event: any): void;
     onFileChangeDragDrop(files: any): void;
     onKeyDown(event: KeyboardEvent): void;
+    /**
+     * Método responsável por fechar o modal.
+     */
+    closeModal(): void;
+    openModal(file: PoUploadFile, keydown?: KeyboardEvent): void;
     removeFile(file: any): void;
     /** Método responsável por **abrir** a janela para seleção de arquivo(s). */
     selectFiles(): void;
-    sendFeedback(): void;
+    sendFeedback(file?: any): void;
     /** Método responsável por **enviar** o(s) arquivo(s) selecionado(s). */
     sendFiles(): void;
     setDirectoryAttribute(canHandleDirectory: boolean): void;
     /**
-     * Método que exibe `p-additionalHelpTooltip` ou executa a ação definida em `p-additionalHelp`.
+     * Método que exibe `p-helper` ou executa a ação definida em `p-helper{eventOnClick}` ou em `p-additionalHelp`.
      * Para isso, será necessário configurar uma tecla de atalho utilizando o evento `p-keydown`.
      *
-     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco e com label visível.
-     * ```
-     * <po-upload
-     *  #upload
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, upload)"
-     * ></po-upload>
-     * ```
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
+     *
      * ```
      * //Exemplo com p-label e p-helper
      * <po-upload
@@ -142,11 +155,16 @@ export declare class PoUploadComponent extends PoUploadBaseComponent implements
         hideAdditionalHelp: boolean;
         helperSettings?: any;
     };
+    protected actionIsDisabled(action: any): any;
+    protected isActionVisible(action: any): boolean;
+    protected onImageError(file: any): void;
+    protected showTooltipText(e: MouseEvent, text: string): void;
     private cleanInputValue;
     private isAdditionalHelpEventTriggered;
     private isUploadButtonFocused;
     private responseHandler;
     private setPipeArguments;
+    private setPrimaryActionModal;
     private stopUploadHandler;
     private updateFiles;
     private updateModel;

package/lib/components/po-field/po-url/po-url.component.d.ts

@@ -1,4 +1,4 @@
-import { AfterViewInit, OnDestroy } from '@angular/core';
+import { AfterViewInit, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoInputGeneric } from '../po-input-generic/po-input-generic';
 import * as i0 from "@angular/core";
@@ -27,7 +27,7 @@ import * as i0 from "@angular/core";
  * </example>
  *
  */
-export declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy {
+export declare class PoUrlComponent extends PoInputGeneric implements AfterViewInit, OnDestroy, OnChanges {
     id: string;
     icon: string;
     type: string;
@@ -37,6 +37,7 @@ export declare class PoUrlComponent extends PoInputGeneric implements AfterViewI
     constructor();
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     extraValidation(c: AbstractControl): {
         [key: string]: any;
     };

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

@@ -106,7 +106,18 @@ export declare class PoHelperBaseComponent {
      * @default `false`
      */
     disabled: import("@angular/core").InputSignal<boolean>;
+    /**
+     * @Input
+     *
+     * @optional
+     *
+     * @description
+     * Define que o popover será inserido no body da página em vez do elemento definido em `p-target`. Essa opção pode
+     * ser necessária em cenários com containers que possuem scroll ou overflow escondido, garantindo o posicionamento
+     * correto do conteúdo próximo ao elemento.
+     */
+    appendBox: import("@angular/core").InputSignal<boolean>;
     private transformHelper;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoHelperBaseComponent, never>;
-    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>;
+    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>;
 }

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

@@ -41,6 +41,7 @@ export declare class PoHelperComponent extends PoHelperBaseComponent implements
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     openHelperPopover(): void;
+    helperIsVisible(): boolean;
     closeHelperPopover(): void;
     emitClick(event: MouseEvent): void;
     onKeyDown(event: KeyboardEvent): void;

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

@@ -16,6 +16,7 @@ export declare class PoInfoBaseComponent {
     readonly poInfoOrientation: typeof PoInfoOrientation;
     private _labelSize;
     private _orientation;
+    private _size?;
     /**
      * @optional
      *
@@ -44,6 +45,20 @@ export declare class PoInfoBaseComponent {
      */
     set orientation(value: PoInfoOrientation);
     get orientation(): PoInfoOrientation;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o tamanho do componente entre `small` ou `medium`.
+     *
+     * > Caso a acessibilidade AA não esteja configurada, o tamanho `medium` será mantido.
+     * Para mais detalhes, consulte a documentação do [po-theme](https://po-ui.io/documentation/po-theme).
+     *
+     * @default `medium`
+     */
+    set size(value: string);
+    get size(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoInfoBaseComponent, never>;
-    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>;
+    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>;
 }

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>;
 }