@messaia/cdk 22.0.1-rc.12 → 22.0.1-rc.14

package/fesm2022/messaia-cdk.mjs

@@ -16130,7 +16130,7 @@ class AbstractSelectFormField extends AbstractMatFormField {
     /**
      * @property _endpoint
      * @description The API endpoint or a function returning the endpoint URL.
-     * @type {string | Function | undefined}
+        * @type {string | URL | Function | undefined}
      */
     _endpoint;
     /**
@@ -16157,6 +16157,12 @@ class AbstractSelectFormField extends AbstractMatFormField {
      * @type {Function | undefined}
      */
     _enumFilter;
+    /**
+     * @property _default
+     * @description A predicate that identifies default option(s) after options are loaded.
+     * @type {((x: any) => boolean) | undefined}
+     */
+    _default;
     /**
      * @property _compareWith
      * @description A function to compare option values with the selected values.
@@ -16303,7 +16309,7 @@ class AbstractSelectFormField extends AbstractMatFormField {
     /**
      * @property endpoint
      * @description The API endpoint or a function returning the endpoint URL.
-     * @type {string | Function | undefined}
+        * @type {string | URL | Function | undefined}
      */
     get endpoint() { return this._endpoint; }
     set endpoint(endpoint) { this._endpoint = endpoint; this.endpointChanged(); }
@@ -16349,6 +16355,16 @@ class AbstractSelectFormField extends AbstractMatFormField {
      */
     get enumFilter() { return this._enumFilter; }
     set enumFilter(enumFilter) { this._enumFilter = enumFilter; this.enumChanged(); }
+    /**
+     * @property default
+     * @description A predicate used to select default option(s) from loaded options.
+     * @type {((x: any) => boolean) | undefined}
+     */
+    get default() { return this._default; }
+    set default(defaultFn) {
+        this._default = defaultFn;
+        this.applyDefaultSelection();
+    }
     /**
      * @property disabled
      * @description Whether the control is disabled.
@@ -16440,7 +16456,8 @@ class AbstractSelectFormField extends AbstractMatFormField {
      */
     ngOnInit() {
         /* Keep filtered options aligned with the initial options input. */
-        this.filteredOptions = this.options;
+        this.filteredOptions = Array.isArray(this.options) ? this.options : [];
+        this.applyDefaultSelection();
         if (this.enum) {
             /* Build initial enum options before wiring reactive refresh subscriptions. */
             this.rebuildEnumOptions();
@@ -16474,12 +16491,15 @@ class AbstractSelectFormField extends AbstractMatFormField {
                 }
                 /* Get endpoint */
                 let endpoint = typeof this.endpoint === 'function' ? this.endpoint(this) : this.endpoint;
+                endpoint = endpoint instanceof URL ? endpoint.toString() : endpoint;
                 if (this._http && endpoint && this.loadData) {
                     /* Resolve remote options and keep emitted item payloads in sync. */
                     this._http.get(endpoint, { params: params, headers: headers })
                         .pipe(map((x) => this.mapper ? this.mapper(x) : x))
                         .subscribe(x => {
-                        this.filteredOptions = this.options = x;
+                        this.filteredOptions = this.options = this.normalizeOptions(x);
+                        /* Auto-select option(s) marked as default when no value is set. */
+                        this.applyDefaultSelection();
                         /* Select the first option by default if applicable */
                         if (this.selectFirst && !this.value && this.options?.length > 0) {
                             this.value = this.multiple ? [this.options[0]] : this.options[0][this.optionValueProperty];
@@ -16531,12 +16551,13 @@ class AbstractSelectFormField extends AbstractMatFormField {
      * @param value
      */
     handleItemSelected(value) {
+        const options = this.normalizeOptions(this.options);
         /* Map selected primitive values back to option model objects. */
         if (this.multiple) {
-            this.onItemSelected.emit(this.options.filter((x) => (value || []).includes(x[this.optionValueProperty])));
+            this.onItemSelected.emit(options.filter((x) => (value || []).includes(x[this.optionValueProperty])));
         }
         else {
-            this.onItemSelected.emit(this.options.filter((x) => x[this.optionValueProperty] == value)[0]);
+            this.onItemSelected.emit(options.filter((x) => x[this.optionValueProperty] == value)[0]);
         }
     }
     /**
@@ -16544,12 +16565,13 @@ class AbstractSelectFormField extends AbstractMatFormField {
      * @param value
      */
     handleItemChange(value) {
+        const options = this.normalizeOptions(this.options);
         /* Emit changed option model objects to keep consumers decoupled from raw ids. */
         if (this.multiple) {
-            this.onItemChange.emit(this.options.filter((x) => (value || []).includes(x[this.optionValueProperty])));
+            this.onItemChange.emit(options.filter((x) => (value || []).includes(x[this.optionValueProperty])));
         }
         else {
-            this.onItemChange.emit(this.options.filter((x) => x[this.optionValueProperty] == value)[0]);
+            this.onItemChange.emit(options.filter((x) => x[this.optionValueProperty] == value)[0]);
         }
     }
     /**
@@ -16557,13 +16579,14 @@ class AbstractSelectFormField extends AbstractMatFormField {
      * @param $event
      */
     handleFilter($event) {
+        const options = this.normalizeOptions(this.options);
         /* Normalize search text and apply the configured option text projection. */
         let searchText = $event?.target?.value ?? '';
         if (this.searchField) {
-            this.filteredOptions = this.options.filter((x) => this.searchField(x)?.toLowerCase().search(searchText.toLowerCase()) > -1);
+            this.filteredOptions = options.filter((x) => this.searchField(x)?.toLowerCase().search(searchText.toLowerCase()) > -1);
         }
         else {
-            this.filteredOptions = this.options.filter((x) => x[this.optionTextProperty]?.toLowerCase().search(searchText.toLowerCase()) > -1);
+            this.filteredOptions = options.filter((x) => x[this.optionTextProperty]?.toLowerCase().search(searchText.toLowerCase()) > -1);
         }
     }
     /**
@@ -16572,13 +16595,69 @@ class AbstractSelectFormField extends AbstractMatFormField {
      * @returns An array of filtered options that match the given value.
      */
     filterValue(value) {
+        const options = this.normalizeOptions(this.options);
         /* Check if a comparison function is defined */
         if (this.compareWith) {
             /* Return options that match any of the provided values using the compareWith function */
-            return this.options?.filter((option) => (value || []).some(val => this.compareWith(option, val)));
+            return options.filter((option) => (value || []).some(val => this.compareWith(option, val)));
         }
         /* If no comparison function is defined, return options that are included in the provided values */
-        return this.options?.filter((option) => (value || []).includes(option[this.optionValueProperty]));
+        return options.filter((option) => (value || []).includes(option[this.optionValueProperty]));
+    }
+    /**
+     * @description Normalizes endpoint payloads to a safe array for template iteration.
+     * @param source Raw payload from endpoint or mapper.
+     * @returns {any[]} Iterable options array.
+     */
+    normalizeOptions(source) {
+        /* Handle different types of source payloads */
+        if (Array.isArray(source)) {
+            return source;
+        }
+        /* If the source is null or undefined, return an empty array immediately */
+        if (source && typeof source === 'object') {
+            /* Attempt to extract a collection from common array-containing properties */
+            const collection = [source.items, source.results, source.data, source.values, source.content, source.rows, source.printers]
+                .find((x) => Array.isArray(x));
+            /* If a collection was found, return it */
+            if (Array.isArray(collection)) {
+                return collection;
+            }
+            /* If the source object contains the option value or text properties, wrap it in an array and return it */
+            if (this.optionValueProperty in source || this.optionTextProperty in source) {
+                return [source];
+            }
+        }
+        return [];
+    }
+    /**
+     * @description Applies default option selection when a default predicate is configured.
+     * @returns {void}
+     */
+    applyDefaultSelection() {
+        /* Skip default selection if no default predicate is defined or a value is already set */
+        if (!this._default || this.value) {
+            return;
+        }
+        /* Normalize the available options before applying default selection */
+        const options = this.normalizeOptions(this.options);
+        if (!options.length) {
+            return;
+        }
+        /* Apply default selection for multiple selection scenario if applicable */
+        if (this.multiple) {
+            this.value = options
+                .filter((option) => this._default(option))
+                .map((option) => option[this.optionValueProperty]);
+        }
+        /* Handle single selection scenario */
+        else {
+            /* Apply default selection for single selection scenario if applicable */
+            const selected = options.filter((option) => this._default(option))[0];
+            if (selected) {
+                this.value = selected[this.optionValueProperty];
+            }
+        }
     }
     /**
      * Trigger endpoint changed
@@ -16603,7 +16682,7 @@ class AbstractSelectFormField extends AbstractMatFormField {
         this.filterable = this.enumMetadata != null;
         /* Rebuild enum options from metadata so dynamic hide and disable callbacks re-run. */
         this.options = this.enumMetadata
-            ? EnumService.applyMetadata(this.enum, this.enumMetadata, this.getEnumContext())
+            ? EnumService.applyMetadata(this.enum, this.enumMetadata, this.context)
             : EnumService.toArray(this.enum, this.prefix);
         /* Apply optional enum-level filter after metadata transformation. */
         if (this._enumFilter && this.options) {
@@ -16611,40 +16690,8 @@ class AbstractSelectFormField extends AbstractMatFormField {
         }
         /* Keep filtered list synchronized with rebuilt options. */
         this.filteredOptions = this.options;
-    }
-    /**
-     * @description Creates an enriched metadata context containing the latest form state.
-     * @returns {any} Metadata context used by EnumMetadata hide and disable callbacks.
-     */
-    getEnumContext() {
-        /* Resolve root form state so metadata callbacks can evaluate against current values. */
-        const rootControl = this.ngControl?.control?.root;
-        const formValue = rootControl?.getRawValue?.() ?? rootControl?.value;
-        /* Fall back to original context when form state or context is unavailable. */
-        if (this.context == null || formValue == null) {
-            return this.context;
-        }
-        /* For primitive contexts, create an explicit wrapper payload with form information. */
-        if (typeof this.context !== 'object' && typeof this.context !== 'function') {
-            return {
-                context: this.context,
-                data: this.context,
-                entity: formValue,
-                formValue: formValue,
-                formGroup: rootControl
-            };
-        }
-        /* Preserve prototype access to context methods while attaching fresh runtime fields. */
-        const enumContext = Object.create(this.context);
-        /* Define own properties to avoid writing to getter-only members on inherited contexts. */
-        Object.defineProperties(enumContext, {
-            context: { value: this.context, enumerable: true, configurable: true, writable: true },
-            data: { value: this.context?.data ?? this.context, enumerable: true, configurable: true, writable: true },
-            entity: { value: formValue, enumerable: true, configurable: true, writable: true },
-            formValue: { value: formValue, enumerable: true, configurable: true, writable: true },
-            formGroup: { value: rootControl, enumerable: true, configurable: true, writable: true }
-        });
-        return enumContext;
+        /* Apply default selection for enum-based option sources as well. */
+        this.applyDefaultSelection();
     }
     /**
      * Log to console
@@ -16655,7 +16702,7 @@ class AbstractSelectFormField extends AbstractMatFormField {
         console.log(message, optionalParams);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: AbstractSelectFormField, deps: "invalid", target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.7", type: AbstractSelectFormField, isStandalone: true, inputs: { enum: "enum", enumMetadata: "enumMetadata", textPrefix: "textPrefix", optionTextProperty: "optionTextProperty", optionValueProperty: "optionValueProperty", matIconKey: "matIconKey", svgIconKey: "svgIconKey", fontSet: "fontSet", prefix: "prefix", options: "options", filteredOptions: "filteredOptions", filterable: "filterable", cache: "cache", selectFirst: "selectFirst", sortBy: "sortBy", mapper: "mapper", optionIcon: "optionIcon", defaultOption: "defaultOption", multiple: "multiple", sorted: "sorted", endpoint: "endpoint", params: "params", projection: "projection", loadData: "loadData", enumFilter: "enumFilter", disabled: "disabled", context: "context", compareWith: "compareWith", searchField: "searchField" }, outputs: { onValueChange: "change", onItemChange: "itemChange", onSelected: "selected", onItemSelected: "itemSelected", onLaunch: "launch" }, usesInheritance: true, ngImport: i0 });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.7", type: AbstractSelectFormField, isStandalone: true, inputs: { enum: "enum", enumMetadata: "enumMetadata", textPrefix: "textPrefix", optionTextProperty: "optionTextProperty", optionValueProperty: "optionValueProperty", matIconKey: "matIconKey", svgIconKey: "svgIconKey", fontSet: "fontSet", prefix: "prefix", options: "options", filteredOptions: "filteredOptions", filterable: "filterable", cache: "cache", selectFirst: "selectFirst", sortBy: "sortBy", mapper: "mapper", optionIcon: "optionIcon", defaultOption: "defaultOption", multiple: "multiple", sorted: "sorted", endpoint: "endpoint", params: "params", projection: "projection", loadData: "loadData", enumFilter: "enumFilter", default: "default", disabled: "disabled", context: "context", compareWith: "compareWith", searchField: "searchField" }, outputs: { onValueChange: "change", onItemChange: "itemChange", onSelected: "selected", onItemSelected: "itemSelected", onLaunch: "launch" }, usesInheritance: true, ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: AbstractSelectFormField, decorators: [{
             type: Directive
@@ -16709,6 +16756,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImpor
                 type: Input
             }], enumFilter: [{
                 type: Input
+            }], default: [{
+                type: Input
             }], disabled: [{
                 type: Input
             }], context: [{
@@ -24349,6 +24398,11 @@ class FormFieldDefinition {
      * Defaults to true.
      */
     defaultOption = true;
+    /**
+     * Predicate used to resolve the default option(s) from loaded options.
+     * Return true for the option(s) that should be preselected.
+     */
+    default;
     /**
      * Template function for rendering options in the selection.
      * @param x The current property value.
@@ -25732,6 +25786,7 @@ class MsaGenericFormMsaListFieldComponent extends MsaGenericFormFieldBaseCompone
                      [loadData]="field.fetchCondition | func:formValue:formGroup:context"
                      [optionValueProperty]="field.optionValueProperty"
                      [optionTextProperty]="field.optionTextProperty"
+                     [default]="field.default"
                      [multiple]="field.multiple"
                      [readonly]="(readonly || (field.readonly && field.readonly(formValue, formGroup, context)))??false"
                      (itemSelected)="field.itemSelect && field.itemSelect($event, formValue, formGroup, context);"
@@ -25770,6 +25825,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImpor
                      [loadData]="field.fetchCondition | func:formValue:formGroup:context"
                      [optionValueProperty]="field.optionValueProperty"
                      [optionTextProperty]="field.optionTextProperty"
+                     [default]="field.default"
                      [multiple]="field.multiple"
                      [readonly]="(readonly || (field.readonly && field.readonly(formValue, formGroup, context)))??false"
                      (itemSelected)="field.itemSelect && field.itemSelect($event, formValue, formGroup, context);"
@@ -25846,6 +25902,7 @@ class MsaGenericFormMsaSelectFieldComponent extends MsaGenericFormFieldBaseCompo
                        [optionValueProperty]="field.optionValueProperty"
                        [optionTextProperty]="field.optionTextProperty"
                        [defaultOption]="field.defaultOption??true"
+                       [default]="field.default"
                        [matIconKey]="field.optionMatIconProperty"
                        [svgIconKey]="field.optionSvgIconProperty"
                        [fontSet]="field.optionIconFontSet"
@@ -25945,6 +26002,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImpor
                        [optionValueProperty]="field.optionValueProperty"
                        [optionTextProperty]="field.optionTextProperty"
                        [defaultOption]="field.defaultOption??true"
+                       [default]="field.default"
                        [matIconKey]="field.optionMatIconProperty"
                        [svgIconKey]="field.optionSvgIconProperty"
                        [fontSet]="field.optionIconFontSet"