@po-ui/ng-components 21.31.0 → 21.33.0-beta.1

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

@@ -257,7 +257,9 @@ export declare class PoCalendarBaseComponent {
     set size(value: string);
     get size(): string;
     widthWithPresets?: boolean;
-    yearRangeLimit?: number;
+    set yearRangeLimit(value: number);
+    get yearRangeLimit(): number;
+    private _yearRangeLimit;
     /**
      * @optional
      *

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

@@ -1,3 +1,5 @@
+import { EventEmitter } from '@angular/core';
+import { Observable } from 'rxjs';
 import { PoDropdownAction } from './po-dropdown-action.interface';
 /**
  * @description
@@ -68,9 +70,14 @@ export declare class PoDropdownBaseComponent {
     private _size?;
     private _initialSize?;
     private _position;
-    /** Lista de ações que serão exibidas no componente. */
-    set actions(value: Array<PoDropdownAction>);
-    get actions(): Array<PoDropdownAction>;
+    /**
+     * Lista de ações que serão exibidas no componente.
+     *
+     * Aceita um *array* de `PoDropdownAction` (carregado imediatamente) ou uma função que retorna um
+     * `Observable<Array<PoDropdownAction>>`, carregando o nível raiz de forma assíncrona na abertura.
+     */
+    set actions(value: Array<PoDropdownAction> | (() => Observable<Array<PoDropdownAction>>));
+    get actions(): Array<PoDropdownAction> | (() => Observable<Array<PoDropdownAction>>);
     /**
      * @optional
      *
@@ -125,6 +132,36 @@ export declare class PoDropdownBaseComponent {
      */
     set position(value: string);
     get position(): string;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado a qualquer clique em um item do menu do dropdown.
+     *
+     * Recebe o item clicado (`PoDropdownAction`).
+     */
+    clickItem: EventEmitter<PoDropdownAction>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado no momento em que a requisição assíncrona de um subnível é iniciada
+     * (quando `subItems` é definido como função que retorna um `Observable`).
+     *
+     * Recebe o item agrupador (`PoDropdownAction`) que originou o carregamento.
+     */
+    subItemsLoad: EventEmitter<PoDropdownAction>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Evento disparado no momento em que a requisição assíncrona do nível raiz é iniciada
+     * (quando `p-actions` é definido como função que retorna um `Observable`).
+     */
+    rootItemsLoad: EventEmitter<void>;
     get popupCustomPositions(): Array<string>;
     protected onThemeChange(): void;
     private applySizeBasedOnA11y;

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

@@ -15,6 +15,11 @@ import { PoDropdownBaseComponent } from './po-dropdown-base.component';
  *  <file name="sample-po-dropdown-subitems/sample-po-dropdown-subitems.component.ts"> </file>
  * </example>
  *
+ * <example name="po-dropdown-lazy-subitems" title="PO Dropdown Lazy Subitems" >
+ *  <file name="sample-po-dropdown-lazy-subitems/sample-po-dropdown-lazy-subitems.component.html"> </file>
+ *  <file name="sample-po-dropdown-lazy-subitems/sample-po-dropdown-lazy-subitems.component.ts"> </file>
+ * </example>
+ *
  * <example name="po-dropdown-labs" title="PO Dropdown Labs" >
  *  <file name="sample-po-dropdown-labs/sample-po-dropdown-labs.component.html"> </file>
  *  <file name="sample-po-dropdown-labs/sample-po-dropdown-labs.component.ts"> </file>
@@ -34,6 +39,8 @@ export declare class PoDropdownComponent extends PoDropdownBaseComponent {
     private resizeListener;
     onKeyDown(event: any): void;
     toggleDropdown(): void;
+    onPopupClose(): void;
+    private isEventInsideElement;
     private checkClickArea;
     private hideDropdown;
     private initializeListeners;

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-datepicker/po-datepicker-base.component.d.ts

@@ -103,7 +103,9 @@ export declare abstract class PoDatepickerBaseComponent implements ControlValueA
      *
      * @default 150
      */
-    yearRangeLimit?: number;
+    set yearRangeLimit(value: number);
+    get yearRangeLimit(): number;
+    private _yearRangeLimit;
     /**
      *
      * @deprecated v23.x.x use `p-helper`

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

@@ -68,6 +68,7 @@ export declare class PoDatetimepickerComponent extends PoDatetimepickerBaseCompo
     onInputFocus(): void;
     onPeriodBlur(): void;
     eventOnBlur($event: any): void;
+    private isBlurWithinPicker;
     eventOnButtonKeydown(event: KeyboardEvent): void;
     eventOnClick($event: any): void;
     onFieldClick($event: any): void;

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. */