@energycap/components 0.46.20-trusted-publishing.20260916-1514 → 0.46.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@energycap/components",
-  "version": "0.46.20-trusted-publishing.20260916-1514",
+  "version": "0.46.21",
   "schematics": "./schematics/collection.json",
   "dependencies": {
     "tslib": "^2.0.0"

package/types/energycap-components.d.ts

@@ -2238,6 +2238,13 @@ declare class PopupContainerDirective implements OnInit, OnDestroy, OnInit {
      * @memberof PopupContainerDirective
      */
     private globalCloseSubscription?;
+    /**
+     * Element that had focus immediately before `show()` opened the popup, so it
+     * can be restored on `hide()` if a consumer moved focus into the popup (WCAG 2.4.3).
+     *
+     * @memberof PopupContainerDirective
+     */
+    private previouslyFocusedElement?;
     /**
      * Creates an instance of PopupContainerDirective.
      * @param templateRef Reference to the popup template
@@ -2272,6 +2279,12 @@ declare class PopupContainerDirective implements OnInit, OnDestroy, OnInit {
      * @memberof PopupContainerDirective
      */
     hide(): void;
+    /**
+     * Whether the current `document.activeElement` is contained within the popup's DOM.
+     *
+     * @memberof PopupContainerDirective
+     */
+    private isFocusInsidePopup;
     /**
      * Updates the popup container position
      */
@@ -6223,6 +6236,32 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
      * @default 0
      */
     maxSelections: number;
+    /**
+     * The total number of records available from the datasource. When set and larger than the number of
+     * options currently shown, an "N of M" footer is rendered under the menu so the user knows the list is a
+     * paged subset and can filter to narrow it. Intended for options loaded server-side from the `search` output.
+     */
+    totalRecords?: number;
+    /**
+     * When false, the "Select all" row is left out of the menu. Use it for lists where selecting everything has
+     * no meaning, for example recipients that already offer an explicit "Everyone" entry.
+     * @default true
+     */
+    showSelectAll: boolean;
+    /**
+     * Optional template for the content of each selectable row, rendered to the right of the row's checkbox with the
+     * MenuItem as `$implicit`, in place of the default icon + label. Use it when rows need their own layout,
+     * for example a user group with a muted member count and a "Preview users" link.
+     *
+     * Named after the ec-menu / ec-combobox input it parallels, with one difference: the multiselect always keeps the
+     * checkbox so selection, select all, and max selections keep working. Clicking anywhere in the row still toggles
+     * the item; call `$event.stopPropagation()` on elements that must not (such as a link). Add the
+     * `multiselect-item-hover-only` class to content that should only appear while the row is hovered, highlighted by
+     * keyboard, or holds focus. Select-all and heading rows keep their built-in rendering.
+     */
+    customMenuTemplate?: TemplateRef<{
+        $implicit: MenuItem;
+    }>;
     /**
      * Notify parent when the filter text changes
      */
@@ -6282,6 +6321,15 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
      * Whether the maximum number of selections has been reached
      */
     get maxSelectionsReached(): boolean;
+    /**
+     * Number of options currently shown in the menu, excluding the select-all row. Disabled items count
+     * because they are displayed; this drives the "N of M" footer.
+     */
+    get visibleOptionCount(): number;
+    /**
+     * Whether the "N of M" footer is shown: only when totalRecords is known and exceeds what is displayed
+     */
+    get showTotalRecordsFooter(): boolean;
     /**
      * Whether all currently visible selectable options are selected
      */
@@ -6338,6 +6386,16 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
      * The angular afterViewInit lifecycle hook
      */
     ngAfterViewInit(): void;
+    /**
+     * React to the popup opening or closing. Closing clears the filter so the menu reopens unfiltered.
+     */
+    onPopupStatusChange(event: PopupStatus): void;
+    /**
+     * Clear the filter text and un-filter the options. Consumers that load options from the `search` output only
+     * know about the text the user typed, so when text is being cleared they are told with an empty search too;
+     * otherwise the menu would reopen on their last, still-filtered result set.
+     */
+    private clearFilter;
     /**
      * Show and hide the popup menu
      */
@@ -6376,7 +6434,8 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
      */
     clearAll(): void;
     /**
-     * Get selectable items from the current filtered options, excluding the select-all item
+     * Get selectable items from the current filtered options, excluding the select-all item and any
+     * disabled items. Select all and the allSelected check operate on this set so disabled items are skipped.
      */
     getVisibleSelectableItems(): MenuItem[];
     /**
@@ -6434,9 +6493,15 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
      * When no items are selected, show the provided placeholder or the default 'Search' text.
      */
     private updatePlaceholderText;
+    /**
+     * Keep a checkbox control aligned with the effective disabled state of its MenuItem.
+     * This covers both the raw item.disabled flag and the maxSelections lockout state.
+     */
+    private syncCheckboxDisabledState;
     /**
      * Get or create a FormControl for a menu item's checkbox.
-     * The control value is kept in sync with the item's checked state.
+     * The control value is kept in sync with the item's checked state, and the control is created
+     * disabled when the item itself is disabled so the rendered checkbox cannot be toggled.
      */
     getCheckboxFormControl(item: MenuItem): UntypedFormControl;
     /**
@@ -6453,11 +6518,12 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
      * Enable or disable individual checkbox FormControls based on whether the max selections
      * limit has been reached. When the limit is reached, unselected items are disabled to
      * indicate they cannot be selected. The select all checkbox is always left enabled since
-     * it can be used to deselect items.
+     * it can be used to deselect items. Items flagged `disabled` on the MenuItem stay disabled
+     * regardless of the limit.
      */
     private updateMaxSelectionsDisabledState;
     static ɵfac: i0.ɵɵFactoryDeclaration<MultiselectComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MultiselectComponent, "ec-multiselect", never, { "options": { "alias": "options"; "required": false; }; "menuPosition": { "alias": "menuPosition"; "required": false; }; "popupFixed": { "alias": "popupFixed"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "tagType": { "alias": "tagType"; "required": false; }; "hideNoMatches": { "alias": "hideNoMatches"; "required": false; }; "noMatchesText": { "alias": "noMatchesText"; "required": false; }; "truncateItems": { "alias": "truncateItems"; "required": false; }; "allowCustom": { "alias": "allowCustom"; "required": false; }; "maxSelections": { "alias": "maxSelections"; "required": false; }; }, { "search": "search"; "selectionChanged": "selectionChanged"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MultiselectComponent, "ec-multiselect", never, { "options": { "alias": "options"; "required": false; }; "menuPosition": { "alias": "menuPosition"; "required": false; }; "popupFixed": { "alias": "popupFixed"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "tagType": { "alias": "tagType"; "required": false; }; "hideNoMatches": { "alias": "hideNoMatches"; "required": false; }; "noMatchesText": { "alias": "noMatchesText"; "required": false; }; "truncateItems": { "alias": "truncateItems"; "required": false; }; "allowCustom": { "alias": "allowCustom"; "required": false; }; "maxSelections": { "alias": "maxSelections"; "required": false; }; "totalRecords": { "alias": "totalRecords"; "required": false; }; "showSelectAll": { "alias": "showSelectAll"; "required": false; }; "customMenuTemplate": { "alias": "customMenuTemplate"; "required": false; }; }, { "search": "search"; "selectionChanged": "selectionChanged"; }, never, never, false, never>;
 }
 
 type ComponentsModuleConfig = {