@po-ui/ng-components 21.7.0 → 21.9.0

package/lib/components/index.d.ts

@@ -8,6 +8,7 @@ export * from './po-button/index';
 export * from './po-calendar/index';
 export * from './po-chart/index';
 export * from './po-container/index';
+export * from './po-context-menu/index';
 export * from './po-disclaimer-group/index';
 export * from './po-disclaimer/index';
 export * from './po-divider/index';
@@ -49,3 +50,4 @@ export * from './po-search/index';
 export * from './po-skeleton/index';
 export * from './po-toaster/index';
 export * from './po-header/index';
+export * from './po-timer/index';

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

@@ -79,7 +79,7 @@ export declare const poAccordionLiteralsDefault: {
  *
  */
 export declare class PoAccordionBaseComponent {
-    private language;
+    private readonly language;
     private _literals;
     private _size?;
     private _initialSize?;

package/lib/components/po-accordion/po-accordion-item/po-accordion-item.component.d.ts

@@ -32,7 +32,7 @@ import { PoTagType } from '../../po-tag';
  * ```
  */
 export declare class PoAccordionItemComponent implements OnDestroy {
-    private accordionService;
+    private readonly accordionService;
     private _type?;
     /** Título do item. */
     label: string;
@@ -79,8 +79,8 @@ export declare class PoAccordionItemComponent implements OnDestroy {
     collapseEvent: EventEmitter<void>;
     templateRef: TemplateRef<any>;
     expanded: boolean;
-    private expandSubscription;
-    private collapseSubscription;
+    private readonly expandSubscription;
+    private readonly collapseSubscription;
     constructor();
     ngOnDestroy(): void;
     /**

package/lib/components/po-accordion/po-accordion-item-header/po-accordion-item-header.component.d.ts

@@ -1,6 +1,6 @@
 import { ElementRef, EventEmitter } from '@angular/core';
 export declare class PoAccordionItemHeaderComponent {
-    private language;
+    private readonly language;
     accordionElement: ElementRef;
     accordionHeaderElement: ElementRef;
     expanded: boolean;

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

@@ -23,7 +23,7 @@ import { PoAccordionItemComponent } from './po-accordion-item/po-accordion-item.
  * </example>
  */
 export declare class PoAccordionComponent extends PoAccordionBaseComponent implements OnDestroy {
-    private accordionService;
+    private readonly accordionService;
     accordionsHeader: QueryList<PoAccordionItemHeaderComponent>;
     poAccordionItems: QueryList<PoAccordionItemComponent>;
     expandedAllItems: boolean;

package/lib/components/po-accordion/services/po-accordion.service.d.ts

@@ -8,7 +8,7 @@ import { PoAccordionItemComponent } from '../po-accordion-item/po-accordion-item
  * expandido/colapsado.
  */
 export declare class PoAccordionService {
-    private subjectChild;
+    private readonly subjectChild;
     receiveFromChildAccordionClicked(): import("rxjs").Observable<PoAccordionItemComponent>;
     sendToParentAccordionItemClicked(accordionItem: PoAccordionItemComponent): void;
 }

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

@@ -28,7 +28,7 @@ export declare class PoBadgeComponent extends PoBadgeBaseComponent implements On
     literals: PoBadgeLiterals;
     badgeIcon: string;
     isValidValue: boolean;
-    private poLanguageService;
+    private readonly poLanguageService;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     initialize(): void;

package/lib/components/po-breadcrumb/po-breadcrumb-favorite/po-breadcrumb-favorite.component.d.ts

@@ -9,8 +9,8 @@ export declare const PoBreadcrumbLiterals: object;
  * Componente que renderiza o serviço de favoritar do po-breadcrumb.
  */
 export declare class PoBreadcrumbFavoriteComponent implements OnInit, OnDestroy {
-    private service;
-    private languageService;
+    private readonly service;
+    private readonly languageService;
     favoriteService: string;
     itemActive: PoBreadcrumbItem;
     paramsService: object;

package/lib/components/po-breadcrumb/po-breadcrumb-favorite/po-breadcrumb-favorite.service.d.ts

@@ -14,7 +14,7 @@ import { Observable } from 'rxjs';
  *
  */
 export declare class PoBreadcrumbFavoriteService {
-    private http;
+    private readonly http;
     private _url;
     private _bodyParams;
     get url(): string;

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

@@ -20,7 +20,7 @@ export declare const poBreadcrumbLiterals: object;
  * </example>
  */
 export declare class PoBreadcrumbComponent extends PoBreadcrumbBaseComponent implements AfterViewInit, DoCheck, OnDestroy {
-    private element;
+    private readonly element;
     renderer: Renderer2;
     languageService: PoLanguageService;
     breadcrumbElement: ElementRef;
@@ -34,7 +34,7 @@ export declare class PoBreadcrumbComponent extends PoBreadcrumbBaseComponent imp
     hiddenLiteralFavorite: boolean;
     private _breadcrumbItemsLenght;
     private calculatedElement;
-    private differ;
+    private readonly differ;
     private hiddenWithoutResize;
     private initialized;
     private timeoutResize;

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

@@ -67,8 +67,6 @@ import { PoButtonType } from './enums/po-button-type.enum';
  */
 export declare class PoButtonBaseComponent {
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -77,8 +75,6 @@ export declare class PoButtonBaseComponent {
      */
     readonly label: import("@angular/core").InputSignal<string>;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -105,8 +101,6 @@ export declare class PoButtonBaseComponent {
      */
     readonly icon: import("@angular/core").InputSignal<string | TemplateRef<void>>;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -175,8 +169,6 @@ export declare class PoButtonBaseComponent {
     set disabled(value: boolean);
     get disabled(): boolean;
     /**
-     * @Input
-     *
      * @optional
      *
      * @description
@@ -189,6 +181,16 @@ export declare class PoButtonBaseComponent {
      */
     readonly ariaLabel: import("@angular/core").InputSignal<string>;
     ariaExpanded?: boolean;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define o `tabindex` do elemento `<button>` nativo interno.
+     *
+     * Use `[tabindex]="-1"` para remover o botão da ordem de foco do teclado.
+     */
+    tabindex?: number | string;
     /**
      * @optional
      *

package/lib/components/po-button-group/po-button-group-base.component.d.ts

@@ -54,8 +54,6 @@ import { PoButtonGroupItem } from './po-button-group-item.interface';
  */
 export declare class PoButtonGroupBaseComponent {
     /**
-     * @Input
-     *
      * @description
      *
      * Lista de botões.

package/lib/components/po-calendar/constants/po-calendar-range-presets.constant.d.ts

@@ -0,0 +1,2 @@
+import { PoCalendarRangePreset } from '../interfaces/po-calendar-range-preset.interface';
+export declare const PO_CALENDAR_DEFAULT_RANGE_PRESETS: Array<PoCalendarRangePreset>;

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

@@ -1,3 +1,5 @@
 export * from './po-calendar-mode.enum';
 export * from './po-calendar.component';
 export * from './po-calendar.module';
+export * from './interfaces/po-calendar-range-preset.interface';
+export * from './constants/po-calendar-range-presets.constant';

package/lib/components/po-calendar/interfaces/po-calendar-range-preset.interface.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Interface para definir um preset de intervalo de datas no calendário.
+ *
+ * Cada preset possui um rótulo identificador e uma função que calcula
+ * dinamicamente o intervalo de datas com base na data atual.
+ */
+export interface PoCalendarRangePreset {
+    /** Identificador/rótulo de exibição do preset. */
+    label: string;
+    /** Função que calcula dinamicamente o intervalo de datas relativo à data informada. */
+    dateRange: (today: Date) => {
+        start: Date;
+        end: Date;
+    };
+    isDisabled?: boolean;
+}

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

@@ -2,6 +2,7 @@ import { EventEmitter, TemplateRef } from '@angular/core';
 import { PoDateService } from '../../services/po-date';
 import { PoLanguageService } from '../../services/po-language/po-language.service';
 import { PoCalendarMode } from './po-calendar-mode.enum';
+import { PoCalendarRangePreset } from './interfaces/po-calendar-range-preset.interface';
 /**
  * @description
  *
@@ -93,7 +94,7 @@ import { PoCalendarMode } from './po-calendar-mode.enum';
  */
 export declare class PoCalendarBaseComponent {
     poDate: PoDateService;
-    private languageService;
+    private readonly languageService;
     /**
      * @optional
      *
@@ -118,11 +119,12 @@ export declare class PoCalendarBaseComponent {
     changeMonthYear: EventEmitter<any>;
     close: EventEmitter<void>;
     activateDate: any;
+    selectedPresetLabel: string | null;
     value: any;
     protected onTouched: any;
     protected propagateChange: any;
     protected today: Date;
-    private shortLanguage;
+    private readonly shortLanguage;
     private _locale;
     private _maxDate;
     private _minDate;
@@ -206,6 +208,57 @@ export declare class PoCalendarBaseComponent {
     get mode(): PoCalendarMode;
     get isRange(): boolean;
     headerTemplate?: TemplateRef<any>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Habilita a exibição dos presets padrão de intervalos de data no painel lateral do calendário em modo *range*.
+     *
+     * Aceita os seguintes valores:
+     * - `true`: exibe todos os presets padrão (Amanhã, Hoje, Ontem, Últimos 7 dias, Últimos 14 dias, Últimos 30 dias, Últimos 3 meses, Últimos 6 meses).
+     * - `false`: não exibe os presets padrão.
+     * - `Array<string>`: exibe apenas os presets padrão cujos labels estejam no array informado.
+     *   O preset "today" é obrigatório e será incluído automaticamente mesmo que não esteja no array.
+     *
+     * Caso `p-range-preset-options` também seja informado, os presets customizados serão exibidos junto aos presets padrão,
+     * ordenados automaticamente por temporalidade com base na data início (Futuro → Presente → Passado).
+     *
+     * @default `false`
+     */
+    set rangePresets(value: boolean | Array<string> | string);
+    get rangePresets(): boolean | Array<string>;
+    private _rangePresets;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Lista de presets customizados de intervalos de data exibidos no painel lateral do calendário em modo *range*.
+     *
+     * Quando informado sem `p-range-presets`, exibe apenas os presets customizados.
+     * Quando informado junto com `p-range-presets` habilitado, os presets customizados serão exibidos junto aos presets padrão,
+     * ordenados automaticamente por temporalidade com base na data início (Futuro → Presente → Passado).
+     *
+     * Para utilizar presets customizados, informe um array de objetos que implementam a interface `PoCalendarRangePreset`.
+     */
+    rangePresetOptions?: Array<PoCalendarRangePreset>;
+    /**
+     * @optional
+     *
+     * @description
+     *
+     * Define a ordenação dos presets na lista.
+     *
+     * Valores aceitos:
+     * - `'asc'` (padrão): presets mais próximos de hoje aparecem primeiro.
+     * - `'desc'`: presets mais distantes de hoje aparecem primeiro.
+     *
+     * A ordenação é aplicada dentro de cada grupo de temporalidade com base na data início (Futuro → Presente → Passado).
+     *
+     * @default `asc`
+     */
+    rangePresetsOrder: 'asc' | 'desc';
     /**
      * @optional
      *
@@ -220,6 +273,7 @@ export declare class PoCalendarBaseComponent {
      */
     set size(value: string);
     get size(): string;
+    widthWithPresets?: boolean;
     constructor(poDate: PoDateService, languageService: PoLanguageService);
     protected onThemeChange(): void;
     protected setActivateDate(date?: Date | string): void;

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

@@ -0,0 +1,16 @@
+import { EventEmitter } from '@angular/core';
+export declare class PoCalendarFooterComponent {
+    size: string;
+    labelClear: string;
+    labelToday: string;
+    responsive: boolean;
+    todayDisabled: boolean;
+    hideTodayButton: boolean;
+    clear: EventEmitter<void>;
+    selectToday: EventEmitter<void>;
+    closeCalendar: EventEmitter<void>;
+    onClear(): void;
+    onSelectToday(): void;
+    onClearKeydown(event: KeyboardEvent): void;
+    onTodayKeydown(event: KeyboardEvent): void;
+}

package/lib/components/po-calendar/po-calendar-preset-list/po-calendar-preset-list.component.d.ts

@@ -0,0 +1,28 @@
+import { EventEmitter, QueryList } from '@angular/core';
+import { PoCalendarRangePreset } from '../interfaces/po-calendar-range-preset.interface';
+export declare class PoCalendarPresetListComponent {
+    private readonly poCalendarLangService;
+    private _locale;
+    size: string;
+    presets: Array<PoCalendarRangePreset>;
+    selectedPreset: string | null;
+    responsive: boolean;
+    set locale(value: string);
+    get locale(): string;
+    closeCalendar: EventEmitter<void>;
+    selectPreset: EventEmitter<{
+        label: string;
+        start: Date;
+        end: Date;
+    }>;
+    presetButtons: QueryList<HTMLButtonElement>;
+    focusedIndex: number;
+    getDisplayLabel(preset: PoCalendarRangePreset): string;
+    isSelected(preset: PoCalendarRangePreset): boolean;
+    onKeydown(event: KeyboardEvent, index: number): void;
+    resetFocusToFirst(): void;
+    isPresetDisabled(preset: PoCalendarRangePreset): boolean;
+    onPresetClick(preset: PoCalendarRangePreset): void;
+    private focusPreset;
+    private getPresetButtons;
+}

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

@@ -1,9 +1,9 @@
 import { OnChanges, OnInit, EventEmitter, TemplateRef, ChangeDetectorRef, SimpleChanges, ElementRef } from '@angular/core';
 import { Subject } from 'rxjs';
 export declare class PoCalendarWrapperComponent implements OnInit, OnChanges {
-    private poCalendarService;
-    private poCalendarLangService;
-    private poDate;
+    private readonly poCalendarService;
+    private readonly poCalendarLangService;
+    private readonly poDate;
     readonly cdr: ChangeDetectorRef;
     readonly elementRef: ElementRef<any>;
     value: any;
@@ -17,6 +17,8 @@ export declare class PoCalendarWrapperComponent implements OnInit, OnChanges {
     maxDate: any;
     hoverValue: Date;
     size: string;
+    hideTodayButton: boolean;
+    hasPresets: boolean;
     headerTemplate?: TemplateRef<any>;
     private _locale;
     set locale(value: string);
@@ -72,6 +74,12 @@ export declare class PoCalendarWrapperComponent implements OnInit, OnChanges {
     private updateTemplateContext;
     updateDate(year: number, month: number, comboComponent?: any): void;
     onComboBlur(comboComponent?: any): void;
+    private handleComboBlur;
+    private syncInputValue;
+    private applySelectedValue;
+    private ensureValidDisplay;
+    private isMonthInvalid;
+    private isYearInvalid;
     private updateDisplay;
     private setInitialFocusedDay;
     private ensureValidFocusedDay;
@@ -86,11 +94,9 @@ export declare class PoCalendarWrapperComponent implements OnInit, OnChanges {
     onMouseEnter(day: any): void;
     onMouseLeave(): void;
     onSelectToday(): void;
-    onTodayKeydown(event: KeyboardEvent): void;
+    onFooterCloseCalendar(): void;
     onHostKeydown(event: KeyboardEvent): void;
     private restoreOriginalDisplay;
-    onTodayKeydownEnter(event: KeyboardEvent): void;
-    onTodayKeydownSpace(event: KeyboardEvent): void;
     onDayKeydown(event: KeyboardEvent, day: Date, index: number): void;
     private isSelectionKey;
     private handleSelectKey;

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

@@ -1,6 +1,7 @@
-import { OnChanges, OnInit, SimpleChanges } from '@angular/core';
+import { DoCheck, OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
 import { PoCalendarBaseComponent } from './po-calendar-base.component';
+import { PoCalendarRangePreset } from './interfaces/po-calendar-range-preset.interface';
 /**
  * @docsExtends PoCalendarBaseComponent
  *
@@ -11,6 +12,11 @@ import { PoCalendarBaseComponent } from './po-calendar-base.component';
  *  <file name="sample-po-calendar-basic/sample-po-calendar-basic.component.ts"> </file>
  * </example>
  *
+ * <example name="po-calendar-range-presets" title="PO Calendar - Range and Presets" >
+ *  <file name="sample-po-calendar-range-presets/sample-po-calendar-range-presets.component.html"> </file>
+ *  <file name="sample-po-calendar-range-presets/sample-po-calendar-range-presets.component.ts"> </file>
+ * </example>
+ *
  * <example name="po-calendar-labs" title="PO Calendar Labs" >
  *  <file name="sample-po-calendar-labs/sample-po-calendar-labs.component.html"> </file>
  *  <file name="sample-po-calendar-labs/sample-po-calendar-labs.component.ts"> </file>
@@ -21,13 +27,23 @@ import { PoCalendarBaseComponent } from './po-calendar-base.component';
  *  <file name="sample-po-calendar-ticket-sales/sample-po-calendar-ticket-sales.component.ts"> </file>
  * </example>
  */
-export declare class PoCalendarComponent extends PoCalendarBaseComponent implements OnInit, OnChanges {
-    private changeDetector;
+export declare class PoCalendarComponent extends PoCalendarBaseComponent implements OnInit, OnChanges, DoCheck {
+    private readonly changeDetector;
+    private readonly poCalendarLangService;
     hoverValue: Date;
+    displayToClean: string;
+    private readonly _isRange;
+    private readonly _rangePresetsValue;
+    private readonly _rangePresetOptionsValue;
+    private readonly _rangePresetsOrderValue;
+    private readonly _minDateValue;
+    private readonly _maxDateValue;
+    readonly effectivePresets: import("@angular/core").Signal<PoCalendarRangePreset[]>;
     constructor();
-    get isResponsive(): boolean;
+    get isResponsive(): RegExpMatchArray;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    ngDoCheck(): void;
     getActivateDate(partType: any): any;
     getValue(partType: any): any;
     onSelectDate(selectedDate: any, partType?: any): void;
@@ -43,6 +59,15 @@ export declare class PoCalendarComponent extends PoCalendarBaseComponent impleme
         [key: string]: any;
     };
     writeValue(value: any): void;
+    onPresetSelected(event: {
+        label: string;
+        start: Date;
+        end: Date;
+    }): void;
+    private sortPresetsByTemporality;
+    private normalizeDate;
+    private enrichPresetsWithDisabledState;
+    private clampDate;
     private getValidateStartDate;
     private getValueFromSelectedDate;
     private updateActivateDateFromHeaderChange;

package/lib/components/po-calendar/services/po-calendar.lang.service.d.ts

@@ -1,18 +1,19 @@
 export declare class PoCalendarLangService {
     private language;
-    private months;
-    private shortWeekDays;
-    private monthLabel;
-    private yearLabel;
-    private todayLabel;
-    private previousMonthLabel;
-    private nextMonthLabel;
+    private readonly months;
+    private readonly shortWeekDays;
+    private readonly monthLabel;
+    private readonly yearLabel;
+    private readonly todayLabel;
+    private readonly previousMonthLabel;
+    private readonly nextMonthLabel;
     readonly toCleanLabel: {
         pt: string;
         en: string;
         es: string;
         ru: string;
     };
+    private readonly presetLabels;
     getMonth(month: number): any;
     getMonthLabel(): any;
     getMonthsArray(): any[];
@@ -23,5 +24,6 @@ export declare class PoCalendarLangService {
     getPreviousMonthLabel(): any;
     getNextMonthLabel(): any;
     getToCleanLabel(): any;
+    getPresetLabel(key: string): string;
     setLanguage(language: string): void;
 }

package/lib/components/po-context-menu/index.d.ts

@@ -0,0 +1,3 @@
+export * from './po-context-menu-item.interface';
+export * from './po-context-menu.component';
+export * from './po-context-menu.module';

package/lib/components/po-context-menu/po-context-menu-base.component.d.ts

@@ -0,0 +1,92 @@
+import { PoContextMenuItem } from './po-context-menu-item.interface';
+/**
+ * @description
+ *
+ * O componente `po-context-menu` é uma barra lateral de contexto (sidebar) para navegação interna entre contextos.
+ * Inspirado visualmente no `po-menu`, porém independente e focado em navegação contextual.
+ *
+ * No caso de uso do componente `po-page-default` em conjunto, ambos devem estar no mesmo nível
+ * e inseridos em uma div com a classe **po-context-menu-wrapper**.
+ * Esta classe é responsável por fazer os cálculos necessários para o alinhamento dos componentes.
+ *
+ * O uso simultâneo dos componentes `po-menu` e `po-context-menu` não é recomendado.
+ * Porém, se os mesmos forem necessários na mesma interface, certifique-se de que não permaneçam expandidos
+ * simultaneamente para não comprometer a usabilidade.
+ *
+ * #### 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                                    |
+ * |----------------------------------------|--------------------------------------------------------------|-------------------------------------------------|
+ * | **Default Values**                     |                                                              |                                                 |
+ * | `--font-family`                        | Família tipográfica usada                                    | `var(--font-family-theme)`                      |
+ * | `--font-size`                          | Tamanho da fonte dos itens                                   | `var(--font-size-default)`                      |
+ * | `--font-size-context-title`            | Tamanho da fonte do título de contexto                       | `var(--font-size-sm)`                           |
+ * | `--font-size-title`                    | Tamanho da fonte do título principal                         | `var(--font-size-lg)`                           |
+ * | `--line-height`                        | Altura da linha                                              | `var(--line-height-md)`                         |
+ * | `--border-radius`                      | Raio dos cantos dos itens                                    | `var(--border-radius-md)`                       |
+ * | `--border-color`                       | Cor da borda lateral direita do componente                   | `var(--color-neutral-light-20)`                 |
+ * | `--background-color`                   | Cor de fundo do componente                                   | `var(--color-neutral-light-05)`                 |
+ * | `--color`                              | Cor do texto dos itens                                       | `var(--color-action-default)`                   |
+ * | `--color-context-title`                | Cor do texto do título de contexto                           | `var(--color-neutral-mid-40)`                   |
+ * | `--color-title`                        | Cor do texto do título principal                             | `var(--color-neutral-dark-80)`                  |
+ * | `--font-weight`                        | Peso da fonte dos itens                                      | `var(--font-weight-bold)`                       |
+ * | `--font-weight-title`                  | Peso da fonte do título principal                            | `var(--font-weight-bold)`                       |
+ * | `--outline-color-focused`              | Cor do outline no estado de focus                            | `var(--color-action-focus)`                     |
+ * | **Hover**                              |                                                              |                                                 |
+ * | `--color-hover`                        | Cor do texto no estado hover                                 | `var(--color-brand-01-darkest)`                 |
+ * | `--background-color-hover`             | Cor de fundo no estado hover                                 | `var(--color-brand-01-lighter)`                 |
+ * | **Pressed**                            |                                                              |                                                 |
+ * | `--background-color-pressed`           | Cor de fundo no estado pressed                               | `var(--color-brand-01-light)`                   |
+ * | **Active (Selected)**                  |                                                              |                                                 |
+ * | `--background-color-actived`           | Cor de fundo do item selecionado                             | `var(--color-brand-01-lightest)`                |
+ * | `--color-actived`                      | Cor do texto do item selecionado                             | `var(--color-action-pressed)`                   |
+ *
+ */
+export declare class PoContextMenuBaseComponent {
+    /**
+     * Título do contexto superior
+     */
+    contextTitle: import("@angular/core").InputSignal<string>;
+    /**
+     * Título principal do menu
+     */
+    title: import("@angular/core").InputSignal<string>;
+    /**
+     * Lista de itens para renderização.
+     *
+     * > Ao receber os itens, o componente valida que apenas um item pode ter `selected: true`.
+     * > Se mais de um item estiver com `selected: true`, apenas o primeiro será mantido como selecionado.
+     */
+    items: import("@angular/core").InputSignal<PoContextMenuItem[]>;
+    /**
+     * Define se o menu está aberto ou fechado.
+     *
+     * Suporta two-way binding:
+     *
+     * ```html
+     * <po-context-menu
+     *   [(p-expanded)]="expanded"
+     * />
+     * ```
+     *
+     * ou
+     *
+     * ```html
+     * <po-context-menu
+     *   [(p-expanded)]="expanded"
+     *   (p-expandedChange)="handlerExpanded($event)"
+     * />
+     * ```
+     *
+     * @default `true`
+     */
+    expanded: import("@angular/core").ModelSignal<boolean>;
+    /**
+     * Evento emitido ao selecionar um item. Emite o item selecionado.
+     */
+    itemSelected: import("@angular/core").OutputEmitterRef<PoContextMenuItem>;
+}

package/lib/components/po-context-menu/po-context-menu-item.interface.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @usedBy PoContextMenuComponent
+ *
+ * @description
+ *
+ * Interface para os itens do componente po-context-menu.
+ */
+export interface PoContextMenuItem {
+    /** Texto do item de menu. */
+    label: string;
+    /** Ação executada ao clicar no item. */
+    action?: Function;
+    /** Estado de seleção do item. */
+    selected?: boolean;
+}