@po-ui/ng-components 20.5.0 → 20.7.0

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

@@ -21,8 +21,7 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
      * @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.
      *
@@ -34,11 +33,11 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
      *
      * @description
      *
-     * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
+     * Define que o popover (`p-helper` e/ou `p-error-limit`) 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`
      */
@@ -147,10 +146,10 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
      *
      * @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>;
     /**
@@ -175,7 +174,6 @@ export declare abstract class PoRichTextBaseComponent implements ControlValueAcc
      *
      * @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.
      */

package/lib/components/po-field/po-rich-text/po-rich-text-body/po-rich-text-body.component.d.ts

@@ -7,12 +7,11 @@ export declare class PoRichTextBodyComponent implements OnInit, OnDestroy {
     modelValue?: string;
     placeholder?: string;
     readonly?: string;
-    /** Tamanho do fonte */
-    size?: string;
     change: EventEmitter<any>;
     commands: EventEmitter<any>;
     keydown: EventEmitter<KeyboardEvent>;
     selectedLink: EventEmitter<any>;
+    size: string;
     shortcutCommand: EventEmitter<any>;
     value: EventEmitter<any>;
     blur: EventEmitter<any>;

package/lib/components/po-field/po-rich-text/po-rich-text.component.d.ts

@@ -3,6 +3,7 @@ import { PoRichTextToolbarActions } from './enum/po-rich-text-toolbar-actions.en
 import { PoRichTextBaseComponent } from './po-rich-text-base.component';
 import { PoRichTextBodyComponent } from './po-rich-text-body/po-rich-text-body.component';
 import { PoRichTextToolbarComponent } from './po-rich-text-toolbar/po-rich-text-toolbar.component';
+import { PoHelperComponent } from '../../po-helper';
 /**
  * @docsExtends PoRichTextBaseComponent
  *
@@ -28,6 +29,7 @@ export declare class PoRichTextComponent extends PoRichTextBaseComponent impleme
     private element;
     bodyElement: PoRichTextBodyComponent;
     richTextToolbar: PoRichTextToolbarComponent;
+    helperEl?: PoHelperComponent;
     private listener;
     private modelLastUpdate;
     toolbarActions: Array<PoRichTextToolbarActions>;
@@ -59,20 +61,12 @@ export declare class PoRichTextComponent extends PoRichTextBaseComponent impleme
     onChangeValue(value: any): void;
     onKeyDown(event: KeyboardEvent): 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.
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
      *
      * ```
-     * <po-rich-text
-     *  #richtext
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, richtext)"
-     * ></po-rich-text>
-     * ```
-     * ```
      * // Exemplo com p-label e p-helper
      * <po-rich-text
      *  #richtext

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

@@ -3,7 +3,7 @@ import { AbstractControl } from '@angular/forms';
 import { PoFieldValidateModel } from '../po-field-validate.model';
 import { PoSelectOptionGroup } from './po-select-option-group.interface';
 import { PoSelectOption } from './po-select-option.interface';
-import { PoHelperOptions } from '../../po-helper';
+import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
 /**
  * @docsExtends PoFieldValidateModel
  *
@@ -77,6 +77,7 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
     renderer: Renderer2;
     private _iconToken;
     selectElement: ElementRef;
+    helperEl?: PoHelperComponent;
     /**
      * @optional
      *
@@ -213,10 +214,10 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
      *
      * @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>;
     /**
@@ -268,19 +269,11 @@ export declare class PoSelectComponent extends PoFieldValidateModel<any> impleme
     onKeyDown(event: KeyboardEvent): void;
     registerOnTouched(fn: any): 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.
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
      *
-     * ```html
-     * <po-select
-     *  #select
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, select)"
-     * ></po-select>
-     * ```
      * ```
      * //Exemplo com p-label e p-helper
      * <po-select

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

@@ -1,8 +1,8 @@
-import { AfterViewInit, ElementRef, OnDestroy } from '@angular/core';
+import { AfterViewInit, ElementRef, OnDestroy, OnChanges, SimpleChanges } from '@angular/core';
 import { AbstractControl, ValidationErrors, Validator } from '@angular/forms';
 import { PoFieldModel } from '../po-field.model';
 import { PoSwitchLabelPosition } from './po-switch-label-position.enum';
-import { PoHelperOptions } from '../../po-helper';
+import { PoHelperComponent, PoHelperOptions } from '../../po-helper';
 /**
  * @docsExtends PoFieldModel
  *
@@ -76,10 +76,11 @@ import { PoHelperOptions } from '../../po-helper';
  *   <file name="sample-po-switch-order-reactive-form/sample-po-switch-order-reactive-form.component.ts"> </file>
  * </example>
  */
-export declare class PoSwitchComponent extends PoFieldModel<any> implements Validator, AfterViewInit, OnDestroy {
+export declare class PoSwitchComponent extends PoFieldModel<any> implements Validator, AfterViewInit, OnDestroy, OnChanges {
     private readonly changeDetector;
     private readonly injector;
     switchContainer: ElementRef;
+    helperEl?: PoHelperComponent;
     id: string;
     value: boolean;
     private _labelOff;
@@ -196,10 +197,10 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
      *
      * @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>;
     /**
@@ -218,6 +219,7 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
     private readonly el;
     private readonly injectOptions;
     private control;
+    ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     /**
      * Função que atribui foco ao componente.
@@ -252,4 +254,29 @@ export declare class PoSwitchComponent extends PoFieldModel<any> implements Vali
         hideAdditionalHelp: boolean;
         helperSettings?: any;
     };
+    /**
+     * 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.
+     *
+     * ```
+     * //Exemplo com p-label e p-helper
+     * <po-switch
+     *  #switch
+     *  ...
+     *  p-label="Label do switch"
+     *  [p-helper]="helperOptions"
+     *  (p-keydown)="onKeyDown($event, switch)"
+     * ></po-switch>
+     * ```
+     * ```typescript
+     * onKeyDown(event: KeyboardEvent, inp: PoSwitchComponent): void {
+     *  if (event.code === 'F9') {
+     *    inp.showAdditionalHelp();
+     *  }
+     * }
+     * ```
+     */
+    showAdditionalHelp(): boolean;
 }

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

@@ -55,8 +55,7 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
      * @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.
      *
@@ -68,11 +67,11 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
      *
      * @description
      *
-     * Define que o tooltip (`p-additional-help-tooltip` e/ou `p-error-limit`) será incluído no body da página e não
+     * Define que o popover (`p-helper` e/ou `p-error-limit`) 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`
      */
@@ -140,10 +139,10 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
      *
      * @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>;
     /**
@@ -168,7 +167,6 @@ export declare abstract class PoTextareaBaseComponent implements ControlValueAcc
      *
      * @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.
      */

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

@@ -1,5 +1,6 @@
-import { AfterViewInit, ElementRef } from '@angular/core';
+import { AfterViewInit, ElementRef, OnChanges, SimpleChanges } from '@angular/core';
 import { PoTextareaBaseComponent } from './po-textarea-base.component';
+import { PoHelperComponent } from '../../po-helper';
 /**
  * @docsExtends PoTextareaBaseComponent
  *
@@ -26,9 +27,10 @@ import { PoTextareaBaseComponent } from './po-textarea-base.component';
  * </example>
  *
  */
-export declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit {
+export declare class PoTextareaComponent extends PoTextareaBaseComponent implements AfterViewInit, OnChanges {
     private el;
     inputEl: ElementRef;
+    helperEl?: PoHelperComponent;
     id: string;
     valueBeforeChange: any;
     fireChange: boolean;
@@ -53,6 +55,7 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
      */
     focus(): void;
     ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     getAdditionalHelpTooltip(): string;
     getErrorPattern(): string;
     hasInvalidClass(): boolean;
@@ -64,20 +67,12 @@ export declare class PoTextareaComponent extends PoTextareaBaseComponent impleme
     controlChangeEmitter(): void;
     onKeyDown(event: KeyboardEvent): 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.
+     * > Exibe ou oculta o conteúdo do componente `po-helper` quando o componente estiver com foco.
      *
      * ```
-     * <po-textarea
-     *  #textarea
-     *  ...
-     *  p-additional-help-tooltip="Mensagem de ajuda complementar"
-     *  (p-keydown)="onKeyDown($event, textarea)"
-     * ></po-textarea>
-     * ```
-     * ```
      * //Exemplo com p-label e p-helper
      * <po-textarea
      *  #textarea

package/lib/components/po-field/po-upload/interfaces/po-upload-literals.interface.d.ts

@@ -42,4 +42,18 @@ export interface PoUploadLiterals {
     errorOccurred?: string;
     /** Texto a ser exibido quando o envio do arquivo for realizado com sucesso. */
     sentWithSuccess?: string;
+    /** Texto a ser exibido no container de informação quando o estado for de sucesso. */
+    doneText?: string;
+    /** Texto a ser exibido no container de informação quando o estado for enviando. */
+    uploadingText?: string;
+    /** Texto de Tente novamente ao ocorrer erro ao enviar. */
+    tryAgain?: string;
+    /** Texto do leitor de tela ao focar no ícone de fechar. */
+    close?: string;
+    /** Título do modal de pré-visualizar. */
+    preview?: string;
+    /** Texto do leitor da miniatura da imagem. */
+    thumbnail?: string;
+    /** Texto do botão padrão do modal de pré-visualizar. */
+    continue?: string;
 }

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';
@@ -26,6 +27,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;
@@ -38,8 +77,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.
      *
@@ -51,11 +89,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`
      */
@@ -128,6 +166,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>;
@@ -155,10 +206,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>;
     /**
@@ -183,7 +234,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.
      */
@@ -226,6 +276,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
      *
@@ -296,6 +378,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
      *
@@ -547,6 +656,6 @@ 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;
 }

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;