@energycap/components 0.46.12 → 0.46.14-highlighting-normalized-pattern.20260701-1417

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@energycap/components",
-  "version": "0.46.12",
+  "version": "0.46.14-highlighting-normalized-pattern.20260701-1417",
   "schematics": "./schematics/collection.json",
   "dependencies": {
     "tslib": "^2.0.0"

package/src/assets/locales/en_US.json

@@ -68,6 +68,7 @@
   "AddCustomItem_TC": "Add {{customItem}}",
   "ClearAllSelections_SC": "Clear all selections",
   "Multiselect_LiveRegion_Status_SC": "{{count}} items selected",
+  "Popover_ShowDetails_AC": "Show details",
   "ItemPicker_RemoveItem_SC": "Remove item",
   "Tooltip_DismissButton_SC": "Dismiss",
   "PageView_CloseDialog_SC": "Close dialog",

package/types/energycap-components.d.ts

@@ -68,6 +68,18 @@ declare class ButtonComponent implements OnInit, OnChanges, AfterViewInit, OnDes
      * Accepts standard ARIA token values: 'menu', 'listbox', 'tree', 'grid', or 'dialog'.
      */
     ariaHaspopup?: string;
+    /**
+     * The id of a descendant element (typically inside an associated popup) that is currently active.
+     * When provided, sets the aria-activedescendant attribute on the native button element.
+     * Use when the button manages keyboard focus over an external popup (menu, listbox) using the
+     * activedescendant pattern rather than moving DOM focus.
+     */
+    ariaActivedescendant?: string | null;
+    /**
+     * The id of an element that this button controls (typically an associated popup).
+     * When provided, sets the aria-controls attribute on the native button element.
+     */
+    ariaControls?: string;
     /**
      * Text to place in a badge to the right of the button
      */
@@ -128,7 +140,7 @@ declare class ButtonComponent implements OnInit, OnChanges, AfterViewInit, OnDes
     private scheduleMissingAccessibleNameCheck;
     private logMissingAccessibleNameErrorIfNeeded;
     static ɵfac: i0.ɵɵFactoryDeclaration<ButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ButtonComponent, "ec-button", never, { "id": { "alias": "id"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "lockButton": { "alias": "lockButton"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "iconColor": { "alias": "iconColor"; "required": false; }; "label": { "alias": "label"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; }; "ariaHaspopup": { "alias": "ariaHaspopup"; "required": false; }; "badge": { "alias": "badge"; "required": false; }; "tabindex": { "alias": "tabindex"; "required": false; }; "type": { "alias": "type"; "required": false; }; "pending": { "alias": "pending"; "required": false; }; "pendingIcon": { "alias": "pendingIcon"; "required": false; }; "customTemplate": { "alias": "customTemplate"; "required": false; }; "isSubmit": { "alias": "isSubmit"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; }, { "clicked": "clicked"; }, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ButtonComponent, "ec-button", never, { "id": { "alias": "id"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "lockButton": { "alias": "lockButton"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "iconColor": { "alias": "iconColor"; "required": false; }; "label": { "alias": "label"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; }; "ariaHaspopup": { "alias": "ariaHaspopup"; "required": false; }; "ariaActivedescendant": { "alias": "ariaActivedescendant"; "required": false; }; "ariaControls": { "alias": "ariaControls"; "required": false; }; "badge": { "alias": "badge"; "required": false; }; "tabindex": { "alias": "tabindex"; "required": false; }; "type": { "alias": "type"; "required": false; }; "pending": { "alias": "pending"; "required": false; }; "pendingIcon": { "alias": "pendingIcon"; "required": false; }; "customTemplate": { "alias": "customTemplate"; "required": false; }; "isSubmit": { "alias": "isSubmit"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; }, { "clicked": "clicked"; }, never, ["*"], false, never>;
 }
 
 interface LinkItem {
@@ -432,11 +444,12 @@ declare class TooltipService {
 }
 
 type PopoverContentPosition = 'top-left' | 'top-right' | 'bottom-right' | 'bottom-left';
-declare class PopoverComponent implements OnDestroy {
+declare class PopoverComponent implements OnDestroy, OnInit {
     private overlay;
     private viewContainerRef;
     private elementRef;
     private tooltipService;
+    private translateService;
     /** An optional icon that, if provided, enables the popover to use it as the anchor element */
     icon?: string;
     /** An optional tag that, if provided, enables the popover to use it as the anchor element */
@@ -445,6 +458,8 @@ declare class PopoverComponent implements OnDestroy {
     tagHoverType?: TagType;
     contentPosition: PopoverContentPosition;
     iconHoverClass: string;
+    /** Accessible label for the popover trigger. If not provided, a default translated label is used. */
+    ariaLabel?: string;
     content: TemplateRef<any>;
     /** In the template, we use an ec-tags element for the pre-hover state and an entirely
      *  separate ec-tags element for our hover state, resulting in two components. To achieve a change
@@ -452,13 +467,18 @@ declare class PopoverComponent implements OnDestroy {
      * second ec-tag element
      */
     hoverTag?: Tag;
+    /** The resolved aria-label for the trigger element. Only set for icon-only triggers or when ariaLabel is explicitly provided. */
+    resolvedAriaLabel: string | null;
+    /** Whether the popover content is currently visible */
+    isVisible: boolean;
+    /** Unique id for the tooltip content, referenced by the trigger's aria-describedby while the popover is visible. */
+    readonly contentId: string;
     private overlayRef?;
     private contentViewRef?;
     private contentRect;
-    private isVisible;
     private mouseOver;
     private interrupt;
-    constructor(overlay: Overlay$1, viewContainerRef: ViewContainerRef, elementRef: ElementRef, tooltipService: TooltipService);
+    constructor(overlay: Overlay$1, viewContainerRef: ViewContainerRef, elementRef: ElementRef, tooltipService: TooltipService, translateService: TranslateService);
     /** When the popover initializes, if a new tagType is provided for the hover state of the popover,
      *  we use it to update the type of our "hoverTag" (which controls background-color of tag)
      */
@@ -467,6 +487,9 @@ declare class PopoverComponent implements OnDestroy {
     private show;
     onMouseOver(): void;
     onLeave(): void;
+    onFocusIn(): void;
+    onFocusOut(event: FocusEvent): void;
+    onTriggerKeydown(event: KeyboardEvent): void;
     /**
      * Hides the popover if the mouse moves outside of the popover content
      */
@@ -475,7 +498,7 @@ declare class PopoverComponent implements OnDestroy {
     private getOverlayConfig;
     private getPosition;
     static ɵfac: i0.ɵɵFactoryDeclaration<PopoverComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PopoverComponent, "ec-popover", never, { "icon": { "alias": "icon"; "required": false; }; "tag": { "alias": "tag"; "required": false; }; "tagHoverType": { "alias": "tagHoverType"; "required": false; }; "contentPosition": { "alias": "contentPosition"; "required": false; }; "iconHoverClass": { "alias": "iconHoverClass"; "required": false; }; }, {}, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PopoverComponent, "ec-popover", never, { "icon": { "alias": "icon"; "required": false; }; "tag": { "alias": "tag"; "required": false; }; "tagHoverType": { "alias": "tagHoverType"; "required": false; }; "contentPosition": { "alias": "contentPosition"; "required": false; }; "iconHoverClass": { "alias": "iconHoverClass"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; }, {}, never, ["*"], false, never>;
 }
 
 type ControlLabelPosition = "top" | "bottom" | "left";
@@ -1552,6 +1575,14 @@ declare class WindowService {
 }
 
 type MenuTemplateType = "label" | "iconAndLabel" | "checkAndLabel" | "iconLabelCaption";
+/**
+ * ARIA role pattern to apply to the menu container and its items.
+ * - `menu` — `<ul role="menu">` + `<li role="menuitem">`. Use for action menus invoked by a button trigger (DropdownComponent).
+ * - `listbox` — `<ul role="listbox">` + `<li role="option">`. Use for value-selection widgets (ComboboxComponent, MultiselectComponent).
+ * - `tree` — `<ul role="tree">` + `<li role="treeitem">`. Use for hierarchical tree navigation (TreeComponent).
+ * - `none` — no role attributes rendered. Default, preserves previous behavior for consumers that have not opted into a specific ARIA pattern.
+ */
+type MenuRolePattern = "menu" | "listbox" | "tree" | "none";
 type MenuHostElementClasses = 'bg-transparent';
 interface MenuItem<TValue = any, SItems = any> extends NavItem {
     label: string;
@@ -1644,6 +1675,25 @@ declare class MenuComponent implements AfterContentInit, OnDestroy, OnChanges {
      * Controls whether keyboard navigation is enabled
      */
     enableKeyNav?: boolean;
+    /**
+     * The ARIA role pattern applied to the menu container and items. Defaults to `none` so
+     * existing consumers (combobox, multiselect, tree) keep their current behavior until they
+     * opt into a specific pattern. DropdownComponent sets this to `menu`.
+     *
+     * @see {@link MenuRolePattern}
+     */
+    rolePattern: MenuRolePattern;
+    /**
+     * Computed role for the `<ul>` items list based on `rolePattern`. Returns `null` when no
+     * pattern is selected so no `role` attribute is rendered.
+     */
+    get listRole(): 'menu' | 'listbox' | 'tree' | null;
+    /**
+     * Returns the appropriate ARIA role for a given item under the current `rolePattern`.
+     * Heading items are always `presentation` so they are not announced as interactive
+     * descendants of the parent role.
+     */
+    getItemRole(item: MenuItem): 'menuitem' | 'option' | 'treeitem' | 'presentation' | null;
     /**
      * Item currently highlighted by keyboard navigation
      */
@@ -1673,6 +1723,13 @@ declare class MenuComponent implements AfterContentInit, OnDestroy, OnChanges {
      * @memberof MenuComponent
      */
     selectedChanged: EventEmitter<MenuItem>;
+    /**
+     * Emitted when the highlighted item changes via keyboard navigation. Enables consumers
+     * (e.g. DropdownComponent) to mirror the highlight state — for example, to set
+     * `aria-activedescendant` on a trigger button so assistive technology can announce the
+     * currently focused menu item.
+     */
+    highlightedItemChange: EventEmitter<MenuItem | null>;
     /**
      * Emitted when the menu has a parent and back is clicked
      * @memberof MenuComponent
@@ -1806,7 +1863,7 @@ declare class MenuComponent implements AfterContentInit, OnDestroy, OnChanges {
      */
     private setItemIds;
     static ɵfac: i0.ɵɵFactoryDeclaration<MenuComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MenuComponent, "ec-menu", never, { "id": { "alias": "id"; "required": false; }; "items": { "alias": "items"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "parent": { "alias": "parent"; "required": false; }; "templateType": { "alias": "templateType"; "required": false; }; "customMenuTemplate": { "alias": "customMenuTemplate"; "required": false; }; "title": { "alias": "title"; "required": false; }; "showNoItems": { "alias": "showNoItems"; "required": false; }; "noDataText": { "alias": "noDataText"; "required": false; }; "enableKeyNav": { "alias": "enableKeyNav"; "required": false; }; "highlightedItem": { "alias": "highlightedItem"; "required": false; }; "maintainSelectedItem": { "alias": "maintainSelectedItem"; "required": false; }; "truncateItems": { "alias": "truncateItems"; "required": false; }; "preserveIconSpace": { "alias": "preserveIconSpace"; "required": false; }; "dropdownToggleButton": { "alias": "dropdownToggleButton"; "required": false; }; }, { "selectedChanged": "selectedChanged"; "menuClosed": "menuClosed"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MenuComponent, "ec-menu", never, { "id": { "alias": "id"; "required": false; }; "items": { "alias": "items"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; "parent": { "alias": "parent"; "required": false; }; "templateType": { "alias": "templateType"; "required": false; }; "customMenuTemplate": { "alias": "customMenuTemplate"; "required": false; }; "title": { "alias": "title"; "required": false; }; "showNoItems": { "alias": "showNoItems"; "required": false; }; "noDataText": { "alias": "noDataText"; "required": false; }; "enableKeyNav": { "alias": "enableKeyNav"; "required": false; }; "rolePattern": { "alias": "rolePattern"; "required": false; }; "highlightedItem": { "alias": "highlightedItem"; "required": false; }; "maintainSelectedItem": { "alias": "maintainSelectedItem"; "required": false; }; "truncateItems": { "alias": "truncateItems"; "required": false; }; "preserveIconSpace": { "alias": "preserveIconSpace"; "required": false; }; "dropdownToggleButton": { "alias": "dropdownToggleButton"; "required": false; }; }, { "selectedChanged": "selectedChanged"; "highlightedItemChange": "highlightedItemChange"; "menuClosed": "menuClosed"; }, never, never, false, never>;
 }
 
 interface PagingInfo {
@@ -2653,6 +2710,12 @@ declare class DropdownComponent implements OnInit, AfterViewInit, OnDestroy {
      * the toggle buttonType is 'icon'
      */
     buttonTitle: string;
+    /**
+     * Accessible label for the dropdown toggle button. Use this to provide an accessible
+     * name when the toggle is icon-only and has no visible label text. The value will be
+     * translated and set as the aria-label attribute on the native button element.
+     */
+    ariaLabel?: string;
     /**
      * The tabindex of the button
      */
@@ -2767,7 +2830,7 @@ declare class DropdownComponent implements OnInit, AfterViewInit, OnDestroy {
      */
     keyNavigate(event: KeyboardEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DropdownComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "ec-dropdown", never, { "id": { "alias": "id"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; "status": { "alias": "status"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "label": { "alias": "label"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "buttonType": { "alias": "buttonType"; "required": false; }; "buttonAlignment": { "alias": "buttonAlignment"; "required": false; }; "buttonTitle": { "alias": "buttonTitle"; "required": false; }; "tabindex": { "alias": "tabindex"; "required": false; }; "showArrow": { "alias": "showArrow"; "required": false; }; "items": { "alias": "items"; "required": false; }; "menuTemplateType": { "alias": "menuTemplateType"; "required": false; }; "menuTitle": { "alias": "menuTitle"; "required": false; }; "menuHeight": { "alias": "menuHeight"; "required": false; }; "menuWidth": { "alias": "menuWidth"; "required": false; }; "menuMinWidth": { "alias": "menuMinWidth"; "required": false; }; "menuPosition": { "alias": "menuPosition"; "required": false; }; "menuFooter": { "alias": "menuFooter"; "required": false; }; "popupFixed": { "alias": "popupFixed"; "required": false; }; "buttonCustomTemplate": { "alias": "buttonCustomTemplate"; "required": false; }; "pending": { "alias": "pending"; "required": false; }; }, { "itemSelected": "itemSelected"; "popupOpened": "popupOpened"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "ec-dropdown", never, { "id": { "alias": "id"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; "status": { "alias": "status"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "label": { "alias": "label"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "buttonType": { "alias": "buttonType"; "required": false; }; "buttonAlignment": { "alias": "buttonAlignment"; "required": false; }; "buttonTitle": { "alias": "buttonTitle"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "tabindex": { "alias": "tabindex"; "required": false; }; "showArrow": { "alias": "showArrow"; "required": false; }; "items": { "alias": "items"; "required": false; }; "menuTemplateType": { "alias": "menuTemplateType"; "required": false; }; "menuTitle": { "alias": "menuTitle"; "required": false; }; "menuHeight": { "alias": "menuHeight"; "required": false; }; "menuWidth": { "alias": "menuWidth"; "required": false; }; "menuMinWidth": { "alias": "menuMinWidth"; "required": false; }; "menuPosition": { "alias": "menuPosition"; "required": false; }; "menuFooter": { "alias": "menuFooter"; "required": false; }; "popupFixed": { "alias": "popupFixed"; "required": false; }; "buttonCustomTemplate": { "alias": "buttonCustomTemplate"; "required": false; }; "pending": { "alias": "pending"; "required": false; }; }, { "itemSelected": "itemSelected"; "popupOpened": "popupOpened"; }, never, never, false, never>;
 }
 
 /**
@@ -5281,7 +5344,8 @@ declare class ResizableComponent extends ResizableBase implements OnInit {
 }
 
 declare class HighlightTextPipe implements PipeTransform {
-    transform(value: string, searchText: string): string;
+    transform(value: string, searchText: string, normalizePattern?: string): string;
+    private transformNormalized;
     private strongWrap;
     private escapeRegex;
     static ɵfac: i0.ɵɵFactoryDeclaration<HighlightTextPipe, never>;
@@ -6743,4 +6807,4 @@ declare class MockTranslationHelperService {
 }
 
 export { AppBarComponent, AvatarComponent, BannerComponent, ButtonComponent, CacheService, Calendar, CalendarComponent, CheckboxComponent, ClickAreaForDirective, CollapsibleToggleComponent, ComboboxComponent, ComponentsModule, ConfirmComponent, ConfirmDialogContext, CopyButtonBaseTestInjectorFactory, CopyButtonDirective, CopyTableButtonDirective, CustomValidators, DateDisplayPipe, DateDisplayPipe2, DateInput, DateInputComponent, DateTimeHelper, DialogCloseDuration, DialogCloseEvent, DialogCloseLatestEvent, DialogComponent, DialogEvent, DialogGroupComponent, DialogOpenDuration, DialogOpenEndEvent, DialogOpenStartEvent, DialogResult, DialogService, DropdownComponent, ErrorService, FileTypeExtensions, FileUploadComponent, FormControlBase, FormControlComponent, FormControlLabelComponent, FormGroupComponent, FormGroupHelper, HelpPopoverComponent, HierarchyBase, HierarchyBaseTestInjectorFactory, HierarchyItem, HierarchyMocks, HierarchyTreeComponent, HighlightTextPipe, IfViewportWidthDirective, ItemDisplayComponent, ItemPickerComponent, ItemPickerSelectableContext, JsonDisplayComponent, JsonHelper, KeyboardNavContainerDirective, LinkButtonComponent, MenuComponent, MockActivatedRoute, MockDateDisplayPipe, MockDialog, MockDialogContent, MockTranslateService, MockTranslationHelperService, MultiselectComponent, NavGroup, NavItemActiveDirective, NumericboxComponent, Overlay, PageBaseComponent, PageBaseComponentTestHelper, PageBaseComponentTestInjectorFactory, PageInitResult, PageStatus, PageStatuses, PageTitleComponent, PageViewComponent, PanelCloseDuration, PanelOpenDuration, PopoverComponent, PopupContainerDirective, RadioButtonComponent, RadioButtonOption, RelativeDatePipe, ResizableBase, ResizableColumnComponent, ResizableComponent, RouterHelper, RowCountPipe, ScrollService, SearchableTableComponent, SelectComponent, SpinnerComponent, SplashComponent, SplashService, SpyFactory, TableComponent, TableLockedColumnComponent, TableMasterHeaderRowComponent, TableMasterRowComponent, TablePaginationComponent, TableSelectableRowComponent, TableSelectableRowContext, TabsComponent, Tag, TagsComponent, TelemetryService, TelemetryTrackerService, TextboxComponent, TimeDisplayPipe, ToastComponent, ToastEvent, ToastService, ToasterComponent, TooltipComponent, TooltipDirective, TooltipService, TreeComponent, UnicodeStrings, UserPreferenceService, ValidationMessageService, ViewOverlayComponent, WindowService, WizardBaseComponent, WizardButtonsComponent, WizardProgressComponent, canadianPostalCodeRegex, clickEvent, dateInputFormatRegex, domainPattern, findAllSpacesPattern, forEachFormControl, getApiError, getControlValue, getDecimalPattern, handleKeyNavigate, integerPattern, isApiError, menuAnimationSpeed, mockRouterFactory, mockRouterHelperFactory, numericboxValidation, orderByIgnoreCase, otherZipCodeRegex, phoneNumberValidationPattern, sortByIgnoreCase, textboxValidation, unitedStatesZipCodeRegex, urlValidationPattern, validateFormGroupValuesAreUnique };
-export type { ApiError, AppSplashEvent, AppSplashOptions, AvatarUser, BannerCacheEntry, BannerStyle, BannerType, ButtonType, CheckboxState, ClickableElement, ComboboxMenuPosition, ComponentsModuleConfig, ControlLabelPosition, CustomActionResult, DateDisplay, DateDisplayPipeOptions, DatePreferenceContainer, DialogAnimationEvent, DialogContent, DialogOptions, DialogSize, DisplayStatus, DisplayValue, FileOutput, FileType, FileUploadFormGroup, FileValidatorCallback, Help, HelpControl, HelpPopoverConfig, InvalidFileError, KeyNavigateHandlers, LinkItem, LinkTarget, MenuHostElementClasses, MenuItem, MenuTemplateType, MultiselectMenuPosition, NavItem, PagingInfo, PickerItem, PopoverContentPosition, PopupPlacement, PopupStatus, RadioButtonDirection, RadioButtonType, RelativeDateOptions, ResizeCacheEntry, RowCountInfo, SearchableTableRefreshOptions, Tab, TableSearchResults, TableSort, TableSortDirection, TagType, TextboxType, TextboxValidatorParameters, ToastAction, ToastItem, ToastSource, ToggledHierarchyItem, TooltipOptions, TooltipPosition, TreeType, ViewStatus, WizardTab };
+export type { ApiError, AppSplashEvent, AppSplashOptions, AvatarUser, BannerCacheEntry, BannerStyle, BannerType, ButtonType, CheckboxState, ClickableElement, ComboboxMenuPosition, ComponentsModuleConfig, ControlLabelPosition, CustomActionResult, DateDisplay, DateDisplayPipeOptions, DatePreferenceContainer, DialogAnimationEvent, DialogContent, DialogOptions, DialogSize, DisplayStatus, DisplayValue, FileOutput, FileType, FileUploadFormGroup, FileValidatorCallback, Help, HelpControl, HelpPopoverConfig, InvalidFileError, KeyNavigateHandlers, LinkItem, LinkTarget, MenuHostElementClasses, MenuItem, MenuRolePattern, MenuTemplateType, MultiselectMenuPosition, NavItem, PagingInfo, PickerItem, PopoverContentPosition, PopupPlacement, PopupStatus, RadioButtonDirection, RadioButtonType, RelativeDateOptions, ResizeCacheEntry, RowCountInfo, SearchableTableRefreshOptions, Tab, TableSearchResults, TableSort, TableSortDirection, TagType, TextboxType, TextboxValidatorParameters, ToastAction, ToastItem, ToastSource, ToggledHierarchyItem, TooltipOptions, TooltipPosition, TreeType, ViewStatus, WizardTab };