@energycap/components 0.45.2-multi-select-component.20260303-1245 → 0.45.2-multi-select-component.20260303-1603

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@energycap/components",
-  "version": "0.45.2-multi-select-component.20260303-1245",
+  "version": "0.45.2-multi-select-component.20260303-1603",
   "schematics": "./schematics/collection.json",
   "dependencies": {
     "tslib": "^2.0.0"

package/src/assets/locales/en_US.json

@@ -57,5 +57,6 @@
   "DateInputSelectionMode_range": "Range",
   "DateInput_LatestDataAvailableTitle": "Select most recent data available",
   "DateInput_CalendarCloseButton_Label": "Close",
-  "DateInput_CalendarTodayButton_Label": "Go to today"
+  "DateInput_CalendarTodayButton_Label": "Go to today",
+  "SelectAllMultiSelect_TC": "Select All"
 }

package/src/styles/mixins/_form-control-base.scss

@@ -344,6 +344,18 @@ $checkbox-indicator-size: $form-control-icon-size;
   select:focus {
     outline: none;
   }
+
+  .sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
 }
 
 @mixin checkbox-radio {

package/types/energycap-components.d.ts

@@ -6055,6 +6055,10 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
      * Reference to the filter input element
      */
     filterInput: ElementRef<HTMLInputElement>;
+    /**
+     * Reference to the custom checkbox menu item template
+     */
+    checkboxMenuTemplate: TemplateRef<any>;
     /**
      * Access to the popup directive
      */
@@ -6075,6 +6079,29 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
      * Placeholder to display on the filter input
      */
     effectivePlaceholder: string;
+    /**
+     * The "Select All" menu item, always displayed at the top of the dropdown
+     */
+    selectAllItem: MenuItem;
+    /**
+     * FormControl for the "Select All" checkbox
+     */
+    selectAllFormControl: UntypedFormControl;
+    /**
+     * Group of dependent checkbox FormControls passed to the select all checkbox.
+     * The checkbox component uses this to automatically manage the indeterminate state.
+     */
+    selectAllDependentGroup: {
+        controls: UntypedFormControl[];
+    };
+    /**
+     * Map of MenuItem to its corresponding checkbox FormControl
+     */
+    checkboxFormControls: Map<MenuItem, UntypedFormControl>;
+    /**
+     * Whether all currently visible selectable options are selected
+     */
+    get allSelected(): boolean;
     /**
      * The currently selected items
      */
@@ -6086,13 +6113,21 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
     /**
      * Index of the currently highlighted item for keyboard nav
      */
-    private highlightedItemIndex;
+    highlightedItemIndex: number;
+    /**
+     * The DOM id of the currently highlighted item for aria-activedescendant
+     */
+    get activeDescendantId(): string | null;
     /**
      * Selectable items flattened from the options
      */
-    private selectableItems;
+    selectableItems: MenuItem[];
     /** Placeholder text for 'Choose' */
     private choosePlaceholder;
+    /** Flag to prevent valueChanges subscriptions from reacting during programmatic sync */
+    private ignoreCheckboxChanges;
+    /** Fired when options change to clean up previous item FormControl subscriptions */
+    private resetItemSubscriptions;
     constructor(validationMessageService: ValidationMessageService, formGroupHelper: FormGroupHelper, translate: TranslateService, scrollService: ScrollService);
     /**
      * The angular onChanges lifecycle event
@@ -6130,10 +6165,18 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
      * Mark the form as touched on blur
      */
     onBlur(): void;
+    /**
+     * Toggle select all / deselect all for the currently visible (filtered) items
+     */
+    toggleSelectAll(): void;
     /**
      * Clear all selected items
      */
     clearAll(): void;
+    /**
+     * Get selectable items from the current filtered options, excluding the select-all item
+     */
+    getVisibleSelectableItems(): MenuItem[];
     /**
      * Unfilter options and update selectable items
      */
@@ -6157,7 +6200,7 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
     /**
      * Compare two MenuItems for equality
      */
-    private isSameItem;
+    isSameItem(a: MenuItem, b: MenuItem): boolean;
     /**
      * Update the formModel with current selected items
      */
@@ -6174,6 +6217,21 @@ declare class MultiselectComponent extends FormControlBase implements OnInit, On
      * Recompute the placeholder text
      */
     private updatePlaceholderText;
+    /**
+     * Get or create a FormControl for a menu item's checkbox.
+     * The control value is kept in sync with the item's checked state.
+     */
+    getCheckboxFormControl(item: MenuItem): UntypedFormControl;
+    /**
+     * Synchronize all checkbox FormControls with the current checked state of their menu items.
+     * Guarded so that the valueChanges subscriptions do not re-trigger selection logic.
+     */
+    syncCheckboxFormControls(): void;
+    /**
+     * Build checkbox FormControls for all current options and subscribe to their
+     * valueChanges so that user interactions with checkboxes drive selection state.
+     */
+    private buildCheckboxFormControls;
     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; }; "maxSelections": { "alias": "maxSelections"; "required": false; }; }, { "search": "search"; "selectionChanged": "selectionChanged"; }, never, never, false, never>;
 }
@@ -6193,6 +6251,45 @@ declare class ComponentsModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<ComponentsModule>;
 }
 
+/**
+ * Callbacks for shared keyboard navigation in dropdown-style components.
+ * Override individual handlers to customize behavior per component.
+ */
+interface KeyNavigateHandlers {
+    /** Current popup/menu status */
+    menuStatus: PopupStatus;
+    /** Toggle the popup menu open/closed */
+    toggleMenu: () => void;
+    /** Handle arrow up/down navigation within the menu list */
+    onArrowDownUp: (event: KeyboardEvent) => void;
+    /** Handle Enter key – called after preventDefault */
+    onEnter?: (event: KeyboardEvent) => void;
+    /** Handle Tab key */
+    onTab?: (event: KeyboardEvent) => void;
+    /** Handle Space/Spacebar key */
+    onSpace?: (event: KeyboardEvent) => void;
+    /** Handle Backspace/Delete key – runs before the shared open-menu-if-hidden logic */
+    onBackspaceDelete?: (event: KeyboardEvent) => void;
+    /** Handle Home key */
+    onHome?: (event: KeyboardEvent) => void;
+    /** Handle End key */
+    onEnd?: (event: KeyboardEvent) => void;
+    /** Override default key handler. If not provided, opens the menu when hidden for non-Shift keys. */
+    onDefault?: (event: KeyboardEvent) => void;
+}
+/**
+ * Shared keyboard navigation handler for dropdown-style components (combobox, multiselect).
+ *
+ * Common behavior handled automatically:
+ * - Arrow keys: stop propagation, prevent default, delegate to `onArrowDownUp`
+ * - Escape: close the menu if visible
+ * - Backspace/Delete: run optional `onBackspaceDelete`, then open the menu if hidden
+ * - Default: open the menu if hidden (for non-Shift keys)
+ *
+ * Component-specific behavior is provided via optional handlers.
+ */
+declare function handleKeyNavigate(event: KeyboardEvent, handlers: KeyNavigateHandlers): void;
+
 declare class CustomValidators {
     /**
      * Tests the control using Angular's required validator, except returns
@@ -6538,5 +6635,5 @@ declare class MockTranslationHelperService {
     setLanguage(): void;
 }
 
-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, 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, 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 { 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 };