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

package/types/po-ui-ng-components.d.ts

@@ -2168,40 +2168,46 @@ interface PoPopupAction {
      *
      * @description
      *
-     * Define os subitens de um agrupador, criando menus aninhados.
-     *
-     * Aceita dois formatos:
-     *
-     * **Estático** – um *array* de `PoPopupAction` carregado imediatamente:
+     * Define uma lista de subitens para criação de menus aninhados.
      *
      * ```
      * { label: 'Relatórios', subItems: [{ label: 'Mensal' }, { label: 'Anual' }] }
      * ```
      *
-     * **Assíncrono (lazy loading)** – uma função que recebe o item agrupador e retorna um
-     * `Observable<Array<PoPopupAction>>`. A requisição é disparada **apenas** no momento da expansão
-     * (clique ou atalho de teclado), exibindo placeholders com `po-skeleton` enquanto os dados são carregados:
+     * Ao definir esta propriedade, o item exibirá um ícone indicador de subnível.
+     * Recomenda-se utilizar no máximo três níveis hierárquicos para garantir a usabilidade.
+     *
+     * > As propriedades `disabled`, `type` e `visible` não são aplicadas visualmente ao item agrupador.
+     *
+     * > Quando `url` é informada em um agrupador, o redirecionamento terá prioridade e os subitens não serão abertos.
+     *
+     * > Em subníveis aninhados, o `icon` do agrupador é substituído pelo indicador de navegação (seta).
+     */
+    subItems?: Array<PoPopupAction>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o carregamento assíncrono (lazy loading) dos subitens de um agrupador.
+     *
+     * Recebe o item agrupador e retorna um `Observable<Array<PoPopupAction>>`. A requisição é disparada
+     * **apenas** no momento da expansão (clique ou atalho de teclado), exibindo placeholders com `po-skeleton`
+     * enquanto os dados são carregados:
      *
      * ```
      * {
      *   label: 'Relatórios',
-     *   subItems: (item) => this.reportService.getReports(item)
+     *   subItemsLazy: (item) => this.reportService.getReports(item)
      * }
      * ```
      *
-     * > No formato assíncrono, o resultado é armazenado em cache após o primeiro carregamento bem-sucedido.
+     * > O resultado é armazenado em cache após o primeiro carregamento bem-sucedido.
      * Em caso de falha, é exibida uma mensagem com a opção de tentar novamente.
      *
      * Ao definir esta propriedade, o item exibirá um ícone indicador de subnível.
-     * Recomenda-se utilizar no máximo três níveis hierárquicos para garantir a usabilidade.
-     *
-     * > As propriedades `disabled`, `type` e `visible` não são aplicadas visualmente ao item agrupador.
-     *
-     * > Quando `url` é informada em um agrupador, o redirecionamento terá prioridade e os subitens não serão abertos.
-     *
-     * > Em subníveis aninhados, o `icon` do agrupador é substituído pelo indicador de navegação (seta).
      */
-    subItems?: Array<PoPopupAction> | ((item: PoPopupAction) => Observable<Array<PoPopupAction>>);
+    subItemsLazy?: (item: PoPopupAction) => Observable<Array<PoPopupAction>>;
     $subItemTemplate?: TemplateRef<any>;
 }
 
@@ -2228,6 +2234,7 @@ declare class PoListBoxComponent extends PoListBoxBaseComponent implements OnIni
     readonly subItemsSkeletonPlaceholders: number[];
     rootLazyLoad?: () => Observable<Array<PoDropdownAction>>;
     rootItemsLoad: EventEmitter<void>;
+    contentChange: EventEmitter<void>;
     private readonly loadedSubItems;
     private lastLoadedGroup;
     private rootLoaded;
@@ -2253,6 +2260,7 @@ declare class PoListBoxComponent extends PoListBoxBaseComponent implements OnIni
     ngOnDestroy(): void;
     openGroup(group: PoDropdownAction, event?: MouseEvent | KeyboardEvent): void;
     private loadSubItemsAsync;
+    onRetryKeydown(event: KeyboardEvent, scope: 'root' | 'subItems'): void;
     retrySubItems(event?: MouseEvent | KeyboardEvent): void;
     loadRootItemsAsync(): void;
     retryRootItems(event?: MouseEvent | KeyboardEvent): void;
@@ -2262,6 +2270,7 @@ declare class PoListBoxComponent extends PoListBoxBaseComponent implements OnIni
     isSubItemsError(group: PoDropdownAction | null): boolean;
     isFunction(value: unknown): boolean;
     isGroupItem(item: PoDropdownAction): boolean;
+    private hasSubItems;
     private getGroupKey;
     private setSubItemsState;
     private clearSubItemsState;
@@ -2307,7 +2316,7 @@ declare class PoListBoxComponent extends PoListBoxBaseComponent implements OnIni
     formatItemList(item: any): string;
     handleFooterActionListbox(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoListBoxComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PoListBoxComponent, "po-listbox", never, { "rootLazyLoad": { "alias": "p-root-lazy-load"; "required": false; }; }, { "rootItemsLoad": "p-root-items-load"; }, never, ["[p-popup-header-template]"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PoListBoxComponent, "po-listbox", never, { "rootLazyLoad": { "alias": "p-root-lazy-load"; "required": false; }; }, { "rootItemsLoad": "p-root-items-load"; "contentChange": "p-content-change"; }, never, ["[p-popup-header-template]"], false, never>;
 }
 
 /**
@@ -4877,9 +4886,7 @@ declare class PoPopupBaseComponent {
     templateIcon: boolean;
     /**
      * Lista de ações que serão exibidas no componente.
-     *
-     * Aceita um *array* de `PoPopupAction` (carregado imediatamente) ou uma função que retorna um
-     * `Observable<Array<PoPopupAction>>`, carregando o nível raiz de forma assíncrona na abertura.
+     * Aceita um *array* de `PoPopupAction`.
      */
     set actions(value: Array<PoPopupAction> | (() => Observable<Array<PoPopupAction>>));
     get actions(): Array<PoPopupAction>;
@@ -5008,13 +5015,6 @@ declare class PoPopupBaseComponent {
      */
     set target(value: any);
     get target(): any;
-    /**
-     * @optional
-     *
-     * @description
-     *
-     * Evento disparado ao fechar o popup.
-     */
     closeEvent: EventEmitter<any>;
     /**
      * @optional
@@ -5022,29 +5022,21 @@ declare class PoPopupBaseComponent {
      * @description
      *
      * Evento disparado a cada clique em um item do menu.
-     *
-     * Recebe o item clicado (`PoPopupAction`).
+     * Retorna o item clicado (`PoDropdownAction`).
      *
      * > Não é disparado para a ação interna de voltar (`goBack`).
      */
-    clickItem: EventEmitter<PoPopupAction>;
-    /**
-     * @optional
-     *
-     * @description
-     *
-     * Evento disparado ao abrir o popup.
-     */
+    clickItem: EventEmitter<any>;
     openEvent: EventEmitter<any>;
     /**
      * @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`).
+     * Evento disparado no momento em que a requisição assíncrona de um subnível é iniciada.
+     * Retorna o item agrupador (`PoPopupAction`) que originou o carregamento.
      *
-     * Recebe o item agrupador (`PoPopupAction`) que originou o carregamento.
+     * > Compatível com a propriedade PoPopupAction.subItemsLazy
      */
     subItemsLoad: EventEmitter<PoPopupAction>;
     /**
@@ -5053,7 +5045,8 @@ declare class PoPopupBaseComponent {
      * @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`).
+     *
+     * > Compatível com a propriedade PoPopupAction.subItemsLazy
      */
     rootItemsLoad: EventEmitter<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoPopupBaseComponent, never>;
@@ -5092,6 +5085,8 @@ declare class PoPopupComponent extends PoPopupBaseComponent implements AfterView
     changeDetector: ChangeDetectorRef;
     popupRef: ElementRef;
     listbox: ElementRef;
+    private readonly popupOffset;
+    private readonly viewportMargin;
     poListBoxRef: PoListBoxComponent;
     ngAfterViewInit(): void;
     /**
@@ -5120,6 +5115,7 @@ declare class PoPopupComponent extends PoPopupBaseComponent implements AfterView
      */
     toggle(param?: any): void;
     onClickItem(item: any): void;
+    onContentChange(): void;
     protected checkAllActionIsInvisible(): boolean;
     private clickedOutDisabledItem;
     private clickedOutHeaderTemplate;
@@ -5134,6 +5130,12 @@ declare class PoPopupComponent extends PoPopupBaseComponent implements AfterView
     private openUrl;
     private removeListeners;
     private setPosition;
+    private resolvePositions;
+    private getVerticalFirstPositions;
+    private clampHeightToViewport;
+    private getScrollableListboxElement;
+    private isOpeningUp;
+    private getStickyPositions;
     private validateInitialContent;
     private focusTarget;
     static ɵfac: i0.ɵɵFactoryDeclaration<PoPopupComponent, never>;
@@ -14446,18 +14448,18 @@ declare class PoDropdownBaseComponent {
     icon: string;
     open: boolean;
     private _actions;
+    private _rootLazyLoad?;
     private _disabled;
     private _size?;
     private _initialSize?;
     private _position;
     /**
      * 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.
+     * Aceita um *array* de `PoDropdownAction`.
      */
     set actions(value: Array<PoDropdownAction> | (() => Observable<Array<PoDropdownAction>>));
-    get actions(): Array<PoDropdownAction> | (() => Observable<Array<PoDropdownAction>>);
+    get actions(): Array<PoDropdownAction>;
+    get popupActions(): Array<PoDropdownAction> | (() => Observable<Array<PoDropdownAction>>);
     /**
      * @optional
      *
@@ -14517,9 +14519,10 @@ declare class PoDropdownBaseComponent {
      *
      * @description
      *
-     * Evento disparado a qualquer clique em um item do menu do dropdown.
+     * Evento disparado a cada clique em um item do menu.
+     * Retorna o item clicado (`PoDropdownAction`).
      *
-     * Recebe o item clicado (`PoDropdownAction`).
+     * > Não é disparado para a ação interna de voltar (`goBack`).
      */
     clickItem: EventEmitter<PoDropdownAction>;
     /**
@@ -14527,10 +14530,10 @@ declare class PoDropdownBaseComponent {
      *
      * @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`).
+     * Evento disparado no momento em que a requisição assíncrona de um subnível é iniciada.
+     * Retorna o item agrupador (`PoDropdownAction`) que originou o carregamento.
      *
-     * Recebe o item agrupador (`PoDropdownAction`) que originou o carregamento.
+     * > Compatível com a propriedade PoPopupAction.subItemsLazy
      */
     subItemsLoad: EventEmitter<PoDropdownAction>;
     /**
@@ -14539,7 +14542,8 @@ declare class PoDropdownBaseComponent {
      * @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`).
+     *
+     * > Compatível com a propriedade PoPopupAction.subItemsLazy
      */
     rootItemsLoad: EventEmitter<void>;
     get popupCustomPositions(): Array<string>;
@@ -14559,16 +14563,6 @@ declare class PoDropdownBaseComponent {
  *  <file name="sample-po-dropdown-basic/sample-po-dropdown-basic.component.ts"> </file>
  * </example>
  *
- * <example name="po-dropdown-subitems" title="PO Dropdown Subitems" >
- *  <file name="sample-po-dropdown-subitems/sample-po-dropdown-subitems.component.html"> </file>
- *  <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>
@@ -14578,6 +14572,16 @@ declare class PoDropdownBaseComponent {
  *  <file name="sample-po-dropdown-social-network/sample-po-dropdown-social-network.component.html"> </file>
  *  <file name="sample-po-dropdown-social-network/sample-po-dropdown-social-network.component.ts"> </file>
  * </example>
+ *
+ * <example name="po-dropdown-subitems" title="PO Dropdown Subitems" >
+ *  <file name="sample-po-dropdown-subitems/sample-po-dropdown-subitems.component.html"> </file>
+ *  <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>
  */
 declare class PoDropdownComponent extends PoDropdownBaseComponent {
     private readonly renderer;
@@ -14594,6 +14598,7 @@ declare class PoDropdownComponent extends PoDropdownBaseComponent {
     private hideDropdown;
     private initializeListeners;
     private readonly onScroll;
+    private isScrollInsidePopup;
     private isDropdownClosed;
     private removeListeners;
     private showDropdown;
@@ -16280,7 +16285,7 @@ declare abstract class PoChartBaseComponent implements OnInit {
      * - Os marcadores (*bullets*) terão seu estilo ajustado.
      * - As outras séries ficarão com opacidade reduzida ao passar o mouse sobre a série ativa.
      *
-     * > Disponível para gráficos do tipo `line` e `radar`.
+     * > Disponível para gráficos do tipo `line`, `area`, `column`, `bar` e `radar`.
      *
      * #### Exemplo de utilização:
      * ```typescript