@po-ui/ng-components 21.32.0 → 21.33.0

package/lib/components/po-field/index.d.ts

@@ -35,6 +35,7 @@ export * from './po-search-ai/interfaces/po-search-ai-column.interface';
 export * from './po-search-ai/interfaces/po-search-ai.interface';
 export * from './po-search-ai/interfaces/po-search-ai-literals.interface';
 export * from './po-login/po-login.component';
+export * from './po-lookup/interfaces/po-lookup-advanced-filter.interface';
 export * from './po-lookup/interfaces/po-lookup-column.interface';
 export * from './po-lookup/interfaces/po-lookup-filter.interface';
 export * from './po-lookup/interfaces/po-lookup-filtered-items-params.interface';

package/lib/components/po-field/po-lookup/interfaces/po-lookup-advanced-filter.interface.d.ts

@@ -3,6 +3,24 @@ import { PoDynamicFormField } from '../../../po-dynamic/po-dynamic-form/interfac
  * @docsExtends PoDynamicFormField
  *
  * @usedBy PoLookupComponent
+ *
+ * @ignoreExtendedDescription
+ *
+ * @description
+ *
+ * Interface para definição das propriedades dos campos de entrada que serão criados dinamicamente na busca avançada.
  */
 export interface PoLookupAdvancedFilter extends PoDynamicFormField {
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define um valor inicial para um filtro de busca avançada.
+     *
+     * O valor será atribuído ao campo correspondente à propriedade `property` na primeira abertura da janela de
+     * busca avançada. Após o usuário aplicar o filtro, os campos passam a ser preenchidos com os valores filtrados,
+     * preservando as alterações realizadas.
+     */
+    initValue?: any;
 }

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

@@ -238,6 +238,20 @@ export declare abstract class PoLookupBaseComponent implements ControlValueAcces
      * url + ?page=1&pageSize=20&name=Tony%20Stark,Peter%20Parker,Gohan
      * ```
      *
+     * Também é possível definir um valor inicial para os campos da busca avançada através da propriedade `initValue`,
+     * que será atribuído ao campo na primeira abertura da janela de busca avançada. Após o usuário aplicar o filtro,
+     * os campos são preenchidos com os valores filtrados:
+     *
+     * ```
+     * advancedFilters: Array<PoLookupAdvancedFilter> = [
+     *   { property: 'nickname', label: 'Apelido' },
+     *   { property: 'active', label: 'Ativo', initValue: false, options: [
+     *     { label: 'Sim', value: true },
+     *     { label: 'Não', value: false }
+     *   ]}
+     * ];
+     * ```
+     *
      */
     advancedFilters: Array<PoLookupAdvancedFilter>;
     /**

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

@@ -130,6 +130,7 @@ export declare abstract class PoLookupModalBaseComponent implements OnDestroy, O
     disclaimer: PoDisclaimer;
     disclaimerGroup: PoDisclaimerGroup;
     isAdvancedFilter: boolean;
+    isAdvancedFilterApplied: boolean;
     primaryActionAdvancedFilter: PoModalAction;
     secondaryActionAdvancedFilter: PoModalAction;
     selecteds: Array<any>;

package/lib/components/po-field/po-lookup/po-lookup-modal/po-lookup-modal.component.d.ts

@@ -29,5 +29,7 @@ export declare class PoLookupModalComponent extends PoLookupModalBaseComponent i
     onAdvancedFilter(): void;
     private setTableHeight;
     private setupModalAdvancedFilter;
+    private getInitialValuesFromFilter;
+    private getValuesFromDisclaimers;
     private createDynamicForm;
 }

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

@@ -94,6 +94,12 @@ import { PoHelperComponent } from '../../po-helper';
  *  <file name="sample-po-lookup.service.ts"> </file>
  * </example>
  *
+ * <example name="po-lookup-advanced-filter" title="PO Lookup - Advanced Filter">
+ *  <file name="sample-po-lookup-advanced-filter/sample-po-lookup-advanced-filter.component.html"> </file>
+ *  <file name="sample-po-lookup-advanced-filter/sample-po-lookup-advanced-filter.component.ts"> </file>
+ *  <file name="sample-po-lookup.service.ts"> </file>
+ * </example>
+ *
  * <example name="po-lookup-sw-films" title="PO Lookup - Star Wars films">
  *  <file name="sample-po-lookup-sw-films/sample-po-lookup-sw-films.component.html"> </file>
  *  <file name="sample-po-lookup-sw-films/sample-po-lookup-sw-films.component.ts"> </file>

package/lib/components/po-list-view/enums/po-list-view-detail-display.enum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @usedBy PoListViewComponent
+ *
+ * @description
+ *
+ * Define o modo de exibição do detalhe do item do `po-list-view`, utilizado em conjunto com a
+ * diretiva [`p-list-view-detail-template`](/documentation/po-list-view-detail-template).
+ */
+export declare enum PoListViewDetailDisplay {
+    /** Expande os detalhes abaixo do item (padrão). */
+    Inline = "inline",
+    /** Exibe os detalhes dentro de um `po-modal`. */
+    Modal = "modal"
+}

package/lib/components/po-list-view/index.d.ts

@@ -1,4 +1,6 @@
+export * from './enums/po-list-view-detail-display.enum';
 export * from './interfaces/po-list-view-action.interface';
+export * from './interfaces/po-list-view-field-properties.interface';
 export * from './interfaces/po-list-view-literals.interface';
 export * from './po-list-view-content-template/po-list-view-content-template.directive';
 export * from './po-list-view-detail-template/po-list-view-detail-template.directive';

package/lib/components/po-list-view/interfaces/po-list-view-field-properties.interface.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @usedBy PoListViewComponent
+ *
+ * @description
+ *
+ * Mapeia as chaves do objeto dos itens (`p-items`) para as áreas visuais do componente.
+ */
+export interface PoListViewFieldProperties {
+    /** Chave com o título do item. */
+    title?: string;
+    /** Chave com o subtítulo do item.  */
+    subtitle?: string;
+    /**
+     * Chave com o *link* do título do item.
+     *
+     * > Compatível com a propriedade `title`. Incompatível com o evento `p-item-click`.
+     */
+    link?: string;
+    /**
+     * Chave correspondente ao avatar do item.
+     *
+     * O valor mapeado suporta quatro formatos distintos:
+     *
+     * - **String (URL):** Renderiza o `po-avatar` com a imagem especificada.
+     * ```
+     * { avatar: '[https://url-da-imagem.png](https://url-da-imagem.png)' }
+     * ```
+     *
+     * - **Objeto com `icon`:** Renderiza um ícone circular com tamanho fixo. Aceita as seguintes propriedades:
+     *   - `icon` (obrigatória).
+     *   - `color` e `backgroundColor`: aceitam qualquer formato de cor CSS (Hex, RGB, nomes, etc.).
+     * ```
+     * { avatar: { icon: 'an an-shield-warning', color: '#dc2626', backgroundColor: '#fee2e2' } }
+     * ```
+     *
+     * - **Objeto com `progress`:** Renderiza o `po-progress-circle`. Aceita as seguintes propriedades:
+     *   - `progress` (number): Valor de 0 a 100.
+     *   - `indeterminate` (boolean): Animação de carregamento contínuo (ignora `progress`).
+     *   - `showPercentage` (boolean): Exibe a porcentagem centralizada.
+     *   - `status` (string): `'default'`, `'success'` ou `'error'`.
+     *   - `size` (string) e `radius` (number): `'medium'`, `'large'` ou medida exata do raio em *pixels*.
+     *   - `ariaLabel` (string): Rótulo para acessibilidade.
+     * ```
+     * { avatar: { progress: 65, showPercentage: true, size: 'large', radius: 40 } }
+     * ```
+     *
+     * - **Objeto com `customTemplate`:** Renderiza um fragmento customizado referenciado via `TemplateRef`.
+     * ```
+     * { avatar: { customTemplate: myTemplateRef } }
+     * ```
+     */
+    avatar?: string;
+    /** Chave booleana que aplica destaque visual ao item. */
+    highlighted?: string;
+    /**
+     * Objeto da `tag` do item.
+     *
+     * Aceita as seguintes propriedades:
+     *
+     * - **`value`** (string): Chave com o texto da *tag*.
+     * - **`type`** (string): Chave com o tipo da *tag* (`success`, `warning`, `danger`, `info`, `neutral`). Caso não informado, utiliza `success` como padrão.
+     *
+     * ```
+     * { tag: { value: 'status', type: 'statusType' } }
+     * ```
+     */
+    tag?: {
+        value?: string;
+        type?: string;
+    };
+}

package/lib/components/po-list-view/interfaces/po-list-view-literals.interface.d.ts

@@ -6,6 +6,8 @@
  * Interface para definição das literais usadas no `po-list-view`.
  */
 export interface PoListViewLiterals {
+    /** Título padrão do `po-modal` de detalhes, exibido quando `p-detail-display` é `modal`. */
+    detailModalTitle?: string;
     /** Rótulo do botão que oculta os detalhes do item. */
     hideDetails?: string;
     /** Rótulo do botão que deve carregar mais resultados. */

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

@@ -1,7 +1,16 @@
 import { EventEmitter } from '@angular/core';
 import { PoLanguageService } from '../../services/po-language/po-language.service';
+import { PoListViewDetailDisplay } from './enums/po-list-view-detail-display.enum';
 import { PoListViewAction } from './interfaces/po-list-view-action.interface';
+import { PoListViewFieldProperties } from './interfaces/po-list-view-field-properties.interface';
 import { PoListViewLiterals } from './interfaces/po-list-view-literals.interface';
+/**
+ * @docsPrivate
+ *
+ * Valida o valor recebido pela propriedade `p-detail-display`, retornando `inline` como padrão
+ * quando o valor informado não pertencer ao enum `PoListViewDetailDisplay`.
+ */
+export declare function convertToDetailDisplay(value: string | PoListViewDetailDisplay): PoListViewDetailDisplay;
 export declare const poListViewLiteralsDefault: {
     en: PoListViewLiterals;
     es: PoListViewLiterals;
@@ -11,27 +20,104 @@ export declare const poListViewLiteralsDefault: {
 /**
  * @description
  *
- * Componente de lista que recebe um array de objetos e renderiza de forma dinâmica os dados de
- * acordo com a necessidade de cada tela e deve ser utilizado em conjunto com as diretivas de *templates*
- *  **[p-list-view-content-template](/documentation/po-list-view-content-template)** e
- * **[p-list-view-detail-template](/documentation/po-list-view-detail-template)**.
+ * O componente `po-list-view` é responsável por renderizar de forma dinâmica uma lista de dados baseada em um *array* de
+ * objetos, adaptando-se às necessidades visuais de cada interface.
+ *
+ * Cada item da lista é construído internamente utilizando a estrutura de um `po-widget`, assegurando consistência visual.
+ * Para layouts complexos, o componente oferece flexibilidade através das diretivas
+ * de templates **[p-list-view-content-template](/documentation/po-list-view-content-template)** e
+ * **[p-list-view-detail-template](/documentation/po-list-view-detail-template)** para customização do conteúdo e exibição
+ * de informações adicionais.
+ *
+ * A interação com o componente pode ser realizada com o *mouse* ou pelo teclado. A navegação entre os elementos
+ * interativos é feita utilizando a tecla `TAB`. Os elementos que recebem foco ao navegar incluem:
+ * - O próprio item (quando a propriedade de clique estiver ativa);
+ * - Título do item (quando configurado como *link*);
+ * - Ações do item configuradas em `p-actions`;
+ * - Botão de controle de detalhes (para expandir ou abrir modal);
+ * - Colunas de seleção (única ou múltipla);
+ * - Botão de carregar mais resultados (`p-show-more`).
+ *
+ * A execução das ações focadas ou a marcação de itens nas colunas de seleção é realizada com as teclas `Enter` ou
+ * `Espaço`.
+ *
+ * #### 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                                                 |
+ * |------------------------------------------------|--------------------------------------------------------|--------------------------------------------------------------|
+ * | **Título**                                     |                                                        |                                                              |
+ * | `--title-color`                                | Cor do título do item                                  | `var(--title-color)`                                         |
+ * | `--title-font-family`                          | Família tipográfica do título                          | `var(--font-family-theme)`                                   |
+ * | `--title-font-size`                            | Tamanho da fonte do título                             | `var(--font-size-default)`                                   |
+ * | `--title-line-height`                          | Altura da linha do título                              | `var(--line-height-md)`                                      |
+ * | `--title-color-hover`                          | Cor do título no estado hover                          | `var(--color-action-hover)`                                  |
+ * | `--title-color-selected`                       | Cor do título quando o item está selecionado           | `var(--color-action-focus)`                                  |
+ * | **Subtítulo (Support Message)**                |                                                        |                                                              |
+ * | `--support-message-color`                      | Cor da mensagem de apoio                               | `var(--color-neutral-dark-80)`                               |
+ * | `--support-message-font-family`                | Família tipográfica da mensagem de apoio               | `var(--font-family-theme)`                                   |
+ * | `--support-message-font-size`                  | Tamanho da fonte da mensagem de apoio                  | `var(--font-size-sm)`                                        |
+ * | `--support-message-line-height`                | Altura da linha da mensagem de apoio                   | `var(--line-height-none)`                                    |
+ * | `--support-message-color-selected`             | Cor da mensagem de apoio quando o item está selecionado| `var(--color-action-focus)`                                  |
+ * | **Item - Normal**                              |                                                        |                                                              |
+ * | `--list-item-background`                       | Cor de fundo do item                                   | `var(--list-item-background)`                                |
+ * | `--list-item-border-color`                     | Cor da borda do item                                   | `var(--list-item-border-color)`                              |
+ * | `--list-item-border-width`                     | Largura da borda do item                               | `var(--border-width-sm)`                                     |
+ * | `--list-item-border-radius`                    | Raio de arredondamento dos cantos do item              | `var(--border-radius-md)`                                    |
+ * | `--list-item-shadow`                           | Sombra base do item                                    | `var(--shadow-md)`                                           |
+ * | **Item - Selecionado**                         |                                                        |                                                              |
+ * | `--list-item-background-selected`              | Cor de fundo do item selecionado                       | `var(--color-brand-01-lightest)`                             |
+ * | `--list-item-border-color-selected`            | Cor da borda do item selecionado                       | `var(--color-action-default)`                                |
+ * | **Item - Hover**                               |                                                        |                                                              |
+ * | `--list-item-border-color-hover`               | Cor da borda do item no estado hover                   | `var(--color-action-hover)`                                  |
+ * | `--list-item-shadow-hover`                     | Sombra do item no estado hover                         | `var(--shadow-lg)`                                           |
+ * | **Item - Focus**                               |                                                        |                                                              |
+ * | `--list-item-color-focused`                    | Cor da borda do item no estado focus                   | `var(--color-action-default)`                                |
+ * | `--list-item-outline-color-focused`            | Cor do outline do item no estado focus                 | `var(--color-action-focus)`                                  |
+ * | **Destaque (Highlighted)**                     |                                                        |                                                              |
+ * | `--list-item-background-highlighted`           | Cor de fundo do item destacado                         | `var(--color-brand-01-lightest)`                             |
+ * | **Motion**                                     |                                                        |                                                              |
+ * | `--list-item-transition-duration`              | Duração da transição do item                           | `var(--duration-normal)`                                     |
+ * | `--list-item-transition-property`              | Propriedades CSS animadas                              | `all`                                                        |
+ * | `--list-item-transition-timing`                | Curva de aceleração da transição                       | `var(--timing-standard, var(--timing-standart, ease))`       |
  *
- * O componente disponibiliza uma área específica para exibição informações adicionais,
- * através da diretiva **[p-list-view-detail-template](/documentation/po-list-view-detail-template)**.
  */
 export declare class PoListViewBaseComponent {
-    /** Recebe uma propriedade que será utilizada para recuperar o valor do objeto que será usado como link para o título. */
+    /**
+     * @deprecated v23.x.x use `p-field-properties`
+     *
+     * @optional
+     *
+     * @description
+     *
+     * Chave do objeto (`p-items`) com o *link* do título do item.
+     *
+     * > Essa propriedade está depreciada e será removida na versão 23.x.x. Recomendamos utilizar a propriedade
+     * `p-field-properties`.
+     */
     propertyLink?: string;
-    /** Recebe uma propriedade que será utilizada para recuperar o valor do objeto que será exibido como o título de cada item. */
-    propertyTitle?: string;
     /**
+     * @deprecated v23.x.x use `p-field-properties`
+     *
      * @optional
      *
      * @description
      *
-     * Recebe uma ação, que será executada quando clicar no botão "Carregar mais resultados".
+     * Chave do objeto (`p-items`) com o título do item.
+     *
+     * > Essa propriedade está depreciada e será removida na versão 23.x.x. Recomendamos utilizar a propriedade
+     * `p-field-properties`.
+     */
+    propertyTitle?: string;
+    /**
+     * @optional
+     *
+     * @description
      *
-     * > Caso nenhuma ação for definida o mesmo não ficará visível.
+     * Ação executada ao clicar no botão de carregar mais resultados.
      */
     showMore: EventEmitter<any>;
     /**
@@ -40,8 +126,12 @@ export declare class PoListViewBaseComponent {
      * @description
      *
      * Ação que será executada ao clicar no título.
+     * Retorna o item da lista clicado.
+     *
+     * > Compatível com o título configurado como *link* (`PoListViewFieldProperties.link` ou `p-property-link`):
+     * ao clicar, o evento é emitido e, havendo *link*, a navegação também é realizada.
      *
-     * Ao ser disparado, o método inserido na ação irá receber como parâmetro o item da lista clicado.
+     * > Incompatível com o evento `p-item-click`.
      */
     titleAction: EventEmitter<any>;
     /**
@@ -49,11 +139,23 @@ export declare class PoListViewBaseComponent {
      *
      * @description
      *
-     * Ação que será executada ao clicar no botão exibir detalhes.
+     * Ação que será executada ao expandir os detalhes do item.
+     * Retorna o item da lista clicado.
      *
-     * Ao ser disparado, o método passa como parâmetros os detalhes que serão exibidos.
+     * > Incompatível com o evento `p-item-click`.
      */
     showDetail: EventEmitter<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Ação que será executada ao clicar no item da lista. Quando definida, torna o item clicável.
+     * Retorna o item da lista clicado.
+     *
+     * > O evento é desabilitado caso o item possua duas ou mais ações visíveis (`p-actions`).
+     */
+    itemClick: EventEmitter<any>;
     popupTarget: any;
     selectAll: boolean;
     showHeader: boolean;
@@ -66,6 +168,7 @@ export declare class PoListViewBaseComponent {
     private _literals;
     private _select;
     private _showMoreDisabled;
+    private _singleSelect;
     private readonly language;
     /**
      * @optional
@@ -73,6 +176,7 @@ export declare class PoListViewBaseComponent {
      * @description
      *
      * Lista de ações que serão exibidas no componente.
+     * As propriedades das ações seguem a interface `PoPopupAction`.
      */
     set actions(value: Array<PoListViewAction>);
     get actions(): Array<PoListViewAction>;
@@ -81,7 +185,7 @@ export declare class PoListViewBaseComponent {
      *
      * @description
      *
-     * Define o tamanho dos componentes de formulário no template:
+     * Define o dimensionamento geral dos elementos no template.
      * - `small`: aplica a medida small de cada componente (disponível apenas para acessibilidade AA).
      * - `medium`: aplica a medida medium de cada componente.
      *
@@ -97,20 +201,65 @@ export declare class PoListViewBaseComponent {
      *
      * @description
      *
-     * Define a altura do `po-list-view` em *pixels*.
+     * Define a altura da lista em *px*, desconsiderando o espaço do botão `p-show-more`.
+     *
+     * > Caso não seja informado valor, a propriedade irá assumir o tamanho do conteúdo.
      */
     set height(height: number);
     get height(): number;
     /**
+     * @optional
+     *
      * @description
      *
-     * Esconde o *checkbox* para seleção de todos os itens.
+     * Habilita a seleção de itens na lista.
+     *
+     * Por padrão, renderiza um *checkbox* para seleção múltipla. Caso a propriedade `p-single-select` esteja habilitada,
+     * renderiza um botão *radio* para seleção única.
+     *
+     * Ao utilizar esta propriedade, todos os itens recebem a propriedade dinâmica `$selected` para identificar o seu estado
+     * de seleção. Por exemplo:
+     *
+     * ```
+     *  item.$selected
+     *
+     *  // ou
+     *
+     *  item['$selected']
+     * ```
      *
      * @default `false`
      */
     set hideSelectAll(hideSelectAll: boolean);
     get hideSelectAll(): boolean;
-    /** Lista de itens que serão exibidos no componente. */
+    /**
+     * @description
+     *
+     * Lista de itens que serão exibidos no componente.
+     *
+     * A renderização dos dados depende do mapeamento das chaves dos objetos através da propriedade `p-field-properties`.
+     *
+     * Exemplo de uso:
+     *
+     * ```
+     *  const listItems = [
+     *    { name: 'John Doe', job: 'Developer' },
+     *    { name: 'Jane Smith', job: 'Designer' }
+     *  ];
+     *
+     *  const listMapping = {
+     *    title: 'name',
+     *    subtitle: 'job'
+     *  };
+     * ```
+     *
+     * ```
+     *  <po-list-view
+     *    [p-items]="listItems"
+     *    [p-field-properties]="listMapping">
+     *  </po-list-view>
+     * ```
+     */
     set items(value: Array<any>);
     get items(): Array<any>;
     /**
@@ -118,9 +267,9 @@ export declare class PoListViewBaseComponent {
      *
      * @description
      *
-     * Objeto com as literais usadas no `po-list-view`.
+     * Objeto com as literais usadas no po-list-view, permitindo personalizar os textos exibidos no componente.
      *
-     * Existem duas maneiras de customizar o componente, passando um objeto com todas as literais disponíveis:
+     * Exemplo de uso:
      *
      * ```
      *  const customLiterals: PoListViewLiterals = {
@@ -131,16 +280,6 @@ export declare class PoListViewBaseComponent {
      *  };
      * ```
      *
-     * Ou passando apenas as literais que deseja customizar:
-     *
-     * ```
-     *  const customLiterals: PoListViewLiterals = {
-     *    showDetail: 'Mostrar mais detalhes'
-     *  };
-     * ```
-     *
-     * E para carregar as literais customizadas, basta apenas passar o objeto para o componente.
-     *
      * ```
      * <po-list-view
      *   [p-literals]="customLiterals">
@@ -157,8 +296,8 @@ export declare class PoListViewBaseComponent {
      *
      * @description
      *
-     * Habilita um *checkbox* para cada item da lista. Todos os items possuem a propriedade dinâmica `$selected` para identificar se o
-     * item está selecionado, por exemplo:
+     * Habilita um *checkbox* para cada item da lista. Todos os items possuem a propriedade dinâmica `$selected` para
+     * identificar se o item está selecionado, por exemplo:
      *
      * ```
      *  item.$selected
@@ -177,7 +316,110 @@ export declare class PoListViewBaseComponent {
      *
      * @description
      *
-     * Indica que o botão `Carregar Mais Resultados` será desabilitado.
+     * Define que somente um item da lista pode ser selecionado quando a seleção estiver habilitada
+     * através da propriedade `p-select`.
+     *
+     * > Quando habilitado, a opção "Selecionar todos" é ocultada.
+     *
+     * @default `false`
+     */
+    set singleSelect(value: boolean);
+    get singleSelect(): boolean;
+    get isSingleSelection(): boolean;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define como o detalhe do item (diretiva `p-list-view-detail-template`) será exibido:
+     * A utilização desta propriedade renderiza um botão de ação (como "Exibir detalhes" ou "Ver detalhes") no rodapé do item
+     * para controlar a visualização do conteúdo.
+     *
+     * Valores válidos:
+     * - `inline`: expande o conteúdo do detalhe abaixo do item.
+     * - `modal`: exibe o conteúdo do detalhe no corpo de um `po-modal`.
+     *
+     * > Incompatível com o evento `p-item-click`.
+     *
+     * @default `inline`
+     */
+    detailDisplay: import("@angular/core").InputSignalWithTransform<PoListViewDetailDisplay, string>;
+    get isDetailModal(): boolean;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o posicionamento da *tag* (`PoListViewFieldProperties.tag.value`) em relação ao título dentro do item:
+     * - `right`: ao lado direito do título.
+     * - `top`: acima do título.
+     * - `bottom`: abaixo do título.
+     *
+     * @default `bottom`
+     */
+    tagPosition: import("@angular/core").InputSignal<string>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Consolida, em um único objeto tipado ([`PoListViewFieldProperties`](/documentation/po-list-view#fieldProperties)),
+     * o mapeamento entre as propriedades do item e as áreas visuais do componente (título, subtítulo,
+     * link, avatar, destaque e tag).
+     *
+     * ```
+     * <po-list-view
+     *   [p-field-properties]="{
+     *     title: 'name',
+     *     subtitle: 'jobDescription',
+     *     link: 'url',
+     *     avatar: 'avatar',
+     *     highlighted: 'unread',
+     *     tag: { value: 'hireStatus', type: 'hireTagType' }
+     *   }">
+     * </po-list-view>
+     * ```
+     */
+    fieldProperties: import("@angular/core").InputSignal<PoListViewFieldProperties>;
+    protected get resolvedPropertyTitle(): string;
+    protected get resolvedPropertyLink(): string;
+    protected get resolvedPropertySubtitle(): string;
+    protected get resolvedPropertyHighlighted(): string;
+    protected get resolvedPropertyAvatar(): string;
+    protected get resolvedPropertyTag(): string;
+    protected get resolvedPropertyTagType(): string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o tamanho do avatar do tipo **imagem** (URL).
+     *
+     * Valores válidos:
+     *  - `xs` (24x24)
+     *  - `sm` (32x32)
+     *  - `md` (64x64)
+     *  - `lg` (96x96)
+     *  - `xl` (144x144)
+     *
+     * > Incompatível com os demais tipos de avatar (icon, progress, customTemplate).
+     *
+     * @default `md`
+     */
+    avatarSize: import("@angular/core").InputSignal<string>;
+    /**
+     * @docsPrivate
+     *
+     * Aplica a classe de host `po-list-view-widget-mode` permanentemente, habilitando via CSS (po-style) o visual do
+     * componente.
+     */
+    readonly widgetModeVisualClass = true;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Indica que o botão *Carregar Mais Resultados* (`p-show-more`) será desabilitado.
      */
     set showMoreDisabled(value: boolean);
     get showMoreDisabled(): boolean;
@@ -189,7 +431,7 @@ export declare class PoListViewBaseComponent {
     selectListItem(row: any): void;
     protected onThemeChange(): void;
     private applySizeBasedOnA11y;
-    private deleteInternalAttrs;
+    protected deleteInternalAttrs(item: any): any;
     private checkIfItemsAreSelected;
     private showMainHeader;
 }

package/lib/components/po-list-view/po-list-view-detail-template/po-list-view-detail-template.directive.d.ts

@@ -43,6 +43,12 @@ import { TemplateRef } from '@angular/core';
  * ...
  *
  * ```
+ *
+ * > O modo de exibição do detalhe é definido pela propriedade
+ * [`p-detail-display`](/documentation/po-list-view) do `po-list-view`, que utiliza os valores do
+ * enum `PoListViewDetailDisplay`:
+ *  - `inline`: expande o conteúdo do detalhe abaixo do item (padrão);
+ *  - `modal`: exibe o conteúdo do detalhe no corpo de um `po-modal`.
  */
 export declare class PoListViewDetailTemplateDirective {
     templateRef: TemplateRef<any>;