@energycap/components 0.47.3 → 0.47.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@energycap/components",
-  "version": "0.47.3",
+  "version": "0.47.4",
   "schematics": "./schematics/collection.json",
   "dependencies": {
     "tslib": "^2.0.0"

package/types/energycap-components.d.ts

@@ -8118,12 +8118,17 @@ export declare class DateDisplayPipe3 implements PipeTransform {
   static ɵpipe: i0.ɵɵPipeDeclaration<DateDisplayPipe3, "dateDisplay3", false>;
 }
 declare namespace multiselect_component_d_exports {
-  export { MultiselectComponent, MultiselectMenuPosition };
+  export { MultiselectComponent, MultiselectCustomItemMapper, MultiselectMenuPosition };
 }
 /**
  * Position of the menu relative to the input
  */
 export type MultiselectMenuPosition = 'top_right' | 'top_left' | 'bottom_left' | 'bottom_right';
+/**
+ * Turns the text a user typed into the custom item(s) to select. Return a single item, several items (for example
+ * a pasted, comma-separated list), or null / an empty array to reject the text.
+ */
+export type MultiselectCustomItemMapper = (text: string) => MenuItem | MenuItem[] | null;
 /**
  * Multiselect component that allows a user to pick multiple items from a dropdown list.
  * Selected items are displayed as dismissable tags inside the input area.
@@ -8182,6 +8187,16 @@ export declare class MultiselectComponent extends FormControlBase implements OnI
    * @default false
    */
   allowCustom: boolean;
+  /**
+   * Optional mapper for custom entries when allowCustom is true, the equivalent of Kendo's `valueNormalizer`.
+   * Receives the trimmed filter text when the user adds it, and returns the item(s) to select instead of the default
+   * `{ label: text, value: text }`. Returning several items adds each as its own tag, so a pasted list can be split.
+   * Each returned item goes through the same rules as a typed one: an item whose label matches an option selects that
+   * option, an item that is already selected is skipped, and maxSelections is respected. When nothing is added the
+   * filter text is kept so the user can correct it.
+   * @default undefined
+   */
+  customItemMapper?: MultiselectCustomItemMapper;
   /**
    * Maximum number of items that can be selected. 0 means no limit.
    * @default 0
@@ -8370,8 +8385,8 @@ export declare class MultiselectComponent extends FormControlBase implements OnI
    */
   onFilterInput(): void;
   /**
-   * Add a custom item from the current filter text and select it.
-   * The item uses the typed text as both label and value.
+   * Add custom item(s) from the current filter text and select them.
+   * Without a customItemMapper the item uses the typed text as both label and value.
    */
   addCustomItem(): void;
   /**
@@ -8517,6 +8532,10 @@ export declare class MultiselectComponent extends FormControlBase implements OnI
       "alias": "allowCustom";
       "required": false;
     };
+    "customItemMapper": {
+      "alias": "customItemMapper";
+      "required": false;
+    };
     "maxSelections": {
       "alias": "maxSelections";
       "required": false;