@messaia/cdk 21.1.0-rc.32 → 21.1.0-rc.33

package/fesm2022/messaia-cdk.mjs

@@ -3969,31 +3969,31 @@ function getNestedOptions(controlName, options) {
 }
 
 /**
- * Function to provide an instance of a given function with optional entity object.
+ * Provides an instance container for a given model function and optional entity object.
  * @param instanceFunc The function to provide an instance of.
  * @param entityObject Optional entity object.
  * @returns An instance container.
  */
 function instanceProvider(instanceFunc, entityObject) {
-    /* Getting an instance from the defaultContainer */
+    /* Get the instance container from defaultContainer */
     let instance = defaultContainer.get(instanceFunc);
-    /* Setting the prototype based on the entityObject or instanceFunc */
+    /* Determine the prototype from entityObject or a temporary instance */
     let prototype = entityObject ? entityObject.__proto__ : getInstance(instanceFunc, []).__proto__;
-    /* Checking if prototype's prototype exists */
+    /* Continue while parent prototypes exist */
     if (prototype.__proto__) {
-        /* Initializing loop flag */
+        /* Initialize loop flag */
         let isLoop = false;
         do {
-            /* Checking if prototype's prototype is not Object */
+            /* Continue until Object is reached in the prototype chain */
             isLoop = prototype.__proto__.constructor != Object;
             if (isLoop) {
-                /* Getting extendClassInstance from defaultContainer */
+                /* Get parent class instance container from defaultContainer */
                 let extendClassInstance = defaultContainer.get(prototype.__proto__.constructor);
-                /* Cloning instance */
+                /* Clone current instance */
                 var instanceClone = clone(instance);
-                /* Cloning extendClassInstance */
+                /* Clone parent instance */
                 var extendClassInstanceClone = clone(extendClassInstance);
-                /* Start: Removing properties from extendClassInstanceClone.properties that exist in instanceClone.properties */
+                /* Remove duplicated properties already defined in the child instance */
                 instanceClone.properties?.forEach((property) => {
                     /* Find the index of the property in extendClassInstanceClone */
                     const index = extendClassInstanceClone.properties?.findIndex((p) => p.name === property.name);
@@ -4002,7 +4002,7 @@ function instanceProvider(instanceFunc, entityObject) {
                         extendClassInstanceClone.properties?.splice(index, 1);
                     }
                 });
-                /* Merge instanceClone with modified extendClassInstanceClone */
+                /* Merge child and filtered parent instance containers */
                 instance = merge(instanceClone, extendClassInstanceClone);
                 prototype = prototype.__proto__;
             }
@@ -4011,7 +4011,7 @@ function instanceProvider(instanceFunc, entityObject) {
     return instance;
 }
 /**
- * Function to get an instance of a model with object arguments.
+ * Creates an instance of a model using the provided constructor arguments.
  * @param model The model to instantiate.
  * @param objectArguments Arguments for the model instantiation.
  * @returns The instantiated class instance.
@@ -10100,7 +10100,38 @@ class RxFormBuilder extends BaseFormBuilder {
      */
     isNestedBinding = false;
     /**
-     * Private method: Gets the instance container based on the instance function and entity object.
+     * Private method: Resolves effective validators for a property.
+     *
+     * If the same annotation type appears multiple times (for example, inherited + overridden),
+     * only the first occurrence is kept and later duplicates are ignored.
+     *
+     * @param propertyValidators The complete list of validator decorator configurations.
+     * @param isAsync Indicates whether async or sync validators should be resolved.
+     * @returns The effective validator decorator configurations for the requested validator kind.
+     */
+    getEffectivePropertyValidators(propertyValidators, isAsync) {
+        /* Initialize result containers for effective validators and seen annotation types */
+        const effectiveValidators = [];
+        const seenAnnotationTypes = new Set();
+        /* Iterate through the provided property validators */
+        for (const propertyValidator of propertyValidators ?? []) {
+            /* Skip validators that do not match the requested async/sync kind */
+            if (!!propertyValidator.isAsync !== isAsync) {
+                continue;
+            }
+            /* Skip duplicate annotation types, keeping only the first occurrence */
+            const annotationType = propertyValidator.annotationType;
+            if (seenAnnotationTypes.has(annotationType)) {
+                continue;
+            }
+            /* Mark the annotation type as seen and keep the validator */
+            seenAnnotationTypes.add(annotationType);
+            effectiveValidators.push(propertyValidator);
+        }
+        return effectiveValidators;
+    }
+    /**
+     * Private method: Gets the instance container for the given instance function and entity object.
      *
      * @param instanceFunc The function to provide an instance from.
      * @param entityObject The entity object to use.
@@ -10123,7 +10154,7 @@ class RxFormBuilder extends BaseFormBuilder {
         if (formBuilderConfiguration && formBuilderConfiguration.dynamicValidation) {
             for (var property in formBuilderConfiguration.dynamicValidation) {
                 for (var decorator in formBuilderConfiguration.dynamicValidation[property]) {
-                    /* Checks if a conditional expression exists for the current decorator */
+                    /* Checks whether a conditional expression exists for the current decorator */
                     if (formBuilderConfiguration.dynamicValidation[property][decorator].conditionalExpression) {
                         /* Extract columns from the conditional expression */
                         let columns = Linq.expressionColumns(formBuilderConfiguration.dynamicValidation[property][decorator].conditionalExpression);
@@ -10144,16 +10175,13 @@ class RxFormBuilder extends BaseFormBuilder {
      * @returns An array of async validators.
      */
     addAsyncValidation(property, propertyValidators, propValidationConfig) {
-        /* Collects async validators from property validators and validation configuration */
+        /* Collect async validators from property validators and validation configuration */
         let asyncValidators = [];
         if (propertyValidators) {
-            /* Iterate through property validators */
-            for (let propertyValidator of propertyValidators) {
-                /* Check if the validator is async */
-                if (propertyValidator.isAsync) {
-                    /* Push each async validator into the asyncValidators array */
-                    propertyValidator.config.forEach((t) => { asyncValidators.push(t); });
-                }
+            /* Iterate through effective async property validators */
+            for (let propertyValidator of this.getEffectivePropertyValidators(propertyValidators, true)) {
+                /* Push each async validator into the asyncValidators array */
+                propertyValidator.config.forEach((t) => { asyncValidators.push(t); });
             }
         }
         if (propValidationConfig && propValidationConfig[ASYNC]) {
@@ -10175,30 +10203,30 @@ class RxFormBuilder extends BaseFormBuilder {
     addFormControl(property, propertyValidators, propValidationConfig, instance, entity) {
         let validators = [];
         let columns = [];
-        /* Check if conditional validation props are defined either in instance or conditionalValidationInstance */
+        /* Check whether conditional validation properties exist in either source */
         if ((instance.conditionalValidationProps && instance.conditionalValidationProps[property.name]) || (this.conditionalValidationInstance.conditionalValidationProps && this.conditionalValidationInstance.conditionalValidationProps[property.name])) {
-            /* Collects conditional validation properties from instance and conditionalValidationInstance and adds conditional change validator */
+            /* Collect conditional validation properties and add a conditional change validator */
             let props = [];
-            /* Check if conditionalValidationProps are defined in instance for the property */
+            /* Check whether instance has conditionalValidationProps for the property */
             if ((instance.conditionalValidationProps && instance.conditionalValidationProps[property.name])) {
                 instance.conditionalValidationProps[property.name].forEach(t => props.push(t));
             }
-            /* Check if conditionalValidationProps are defined in conditionalValidationInstance for the property */
+            /* Check whether conditionalValidationInstance has conditionalValidationProps for the property */
             if (this.conditionalValidationInstance.conditionalValidationProps && this.conditionalValidationInstance.conditionalValidationProps[property.name]) {
                 this.conditionalValidationInstance.conditionalValidationProps[property.name].forEach((t) => props.push(t));
             }
             /* Add conditional change validator */
             validators.push(conditionalChangeValidator(props));
         }
-        /* Check if conditionalObjectProps or builderConfigurationConditionalObjectProps are defined */
+        /* Check whether conditional object properties are present */
         if (this.conditionalObjectProps.length > 0 || this.builderConfigurationConditionalObjectProps.length > 0) {
             let propConditions = [];
-            /* Check if conditionalObjectProps is defined */
+            /* Check whether conditionalObjectProps is defined */
             if (this.conditionalObjectProps) {
                 /* Filter conditionalObjectProps for properties matching the current property name */
                 propConditions = this.conditionalObjectProps.filter(t => t.propName == property.name);
             }
-            /* Check if builderConfigurationConditionalObjectProps is defined */
+            /* Check whether builderConfigurationConditionalObjectProps is defined */
             if (this.builderConfigurationConditionalObjectProps) {
                 /* Filter builderConfigurationConditionalObjectProps for properties matching the current property name */
                 this.builderConfigurationConditionalObjectProps.filter(t => t.propName == property.name).forEach(t => propConditions.push(t));
@@ -10214,25 +10242,23 @@ class RxFormBuilder extends BaseFormBuilder {
                 validators.push(conditionalChangeValidator(columns));
             }
         }
-        /* Iterate through property validators */
-        for (let propertyValidator of propertyValidators) {
-            if (!propertyValidator.isAsync) {
-                switch (propertyValidator.annotationType) {
-                    /* Add rule validator */
-                    case AnnotationTypes["rule"]:
-                        validators.push(APP_VALIDATORS[propertyValidator.annotationType](propertyValidator.config, entity));
-                        break;
-                    /* Add logical validator */
-                    case AnnotationTypes["and"]:
-                    case AnnotationTypes["or"]:
-                    case AnnotationTypes["not"]:
-                        validators.push(LOGICAL_VALIDATORS[propertyValidator.annotationType](propertyValidator.config));
-                        break;
-                    /* Add custom validator */
-                    default:
-                        validators.push(APP_VALIDATORS[propertyValidator.annotationType](propertyValidator.config));
-                        break;
-                }
+        /* Iterate through effective sync property validators */
+        for (let propertyValidator of this.getEffectivePropertyValidators(propertyValidators, false)) {
+            switch (propertyValidator.annotationType) {
+                /* Add rule validator */
+                case AnnotationTypes["rule"]:
+                    validators.push(APP_VALIDATORS[propertyValidator.annotationType](propertyValidator.config, entity));
+                    break;
+                /* Add logical validator */
+                case AnnotationTypes["and"]:
+                case AnnotationTypes["or"]:
+                case AnnotationTypes["not"]:
+                    validators.push(LOGICAL_VALIDATORS[propertyValidator.annotationType](propertyValidator.config));
+                    break;
+                /* Add custom validator */
+                default:
+                    validators.push(APP_VALIDATORS[propertyValidator.annotationType](propertyValidator.config));
+                    break;
             }
         }
         /* Additional validation from propValidationConfig */
@@ -10253,12 +10279,12 @@ class RxFormBuilder extends BaseFormBuilder {
      */
     additionalValidation(validations, propValidationConfig) {
         for (var col in AnnotationTypes) {
-            /* Check if the validation configuration for the current annotation type exists and it's not a custom validator */
+            /* Check whether the validation configuration for the current annotation type exists and is not a custom validator */
             if (propValidationConfig[AnnotationTypes[col]] && col != "custom") {
                 /* Add validator from APP_VALIDATORS */
                 validations.push(APP_VALIDATORS[AnnotationTypes[col]](propValidationConfig[AnnotationTypes[col]]));
             }
-            /* Check if the current annotation type is custom and the custom validator exists in the validation configuration */
+            /* Check whether the current annotation type is custom and exists in the validation configuration */
             else if (col == AnnotationTypes["custom"] && propValidationConfig[AnnotationTypes[col]]) {
                 /* Add custom validator */
                 validations.push(propValidationConfig[col]);
@@ -10275,7 +10301,7 @@ class RxFormBuilder extends BaseFormBuilder {
      * @returns The entity type.
      */
     getEntity(object, formBuilderConfiguration, propertyName, isSameObjectConstructor = false) {
-        /* Check if the entity type is defined in the form builder configuration */
+        /* Check whether the entity type is defined in the form builder configuration */
         if (formBuilderConfiguration && formBuilderConfiguration.genericEntities && formBuilderConfiguration.genericEntities[propertyName]) {
             /* Return the entity type from formBuilderConfiguration if available */
             return formBuilderConfiguration.genericEntities[propertyName];
@@ -10292,12 +10318,12 @@ class RxFormBuilder extends BaseFormBuilder {
      * @returns The constructor of the object property instance.
      */
     getObjectPropertyInstance(object, propertyInfo, formBuilderConfiguration) {
-        /* Check if the property type is OBJECT_PROPERTY and the property exists in the object */
+        /* Check whether the property type is OBJECT_PROPERTY and the property exists in the object */
         if (propertyInfo.propertyType == OBJECT_PROPERTY && object[propertyInfo.name]) {
             /* Return the constructor of the object property if it exists */
             return object[propertyInfo.name].constructor;
         }
-        /* Check if the property type is ARRAY_PROPERTY and the property exists and contains items in the object */
+        /* Check whether the property type is ARRAY_PROPERTY and the property exists and contains items in the object */
         else if (propertyInfo.propertyType == ARRAY_PROPERTY && object[propertyInfo.name] && object[propertyInfo.name].length > 0) {
             /* Return the constructor of the first item in the array property if it exists */
             return object[propertyInfo.name][0].constructor;
@@ -10323,7 +10349,7 @@ class RxFormBuilder extends BaseFormBuilder {
                 entity = this.getObjectPropertyInstance(object, t, formBuilderConfiguration);
             if (entity) {
                 let instance = this.getInstanceContainer(entity, null);
-                /* Check if instance exists and has conditional validation properties */
+                /* Check whether the instance exists and has conditional validation properties */
                 if (instance && instance.conditionalValidationProps) {
                     for (var key in instance.conditionalValidationProps) {
                         var prop = instanceContainer.properties?.filter(t => t.name == key)[0];
@@ -10359,24 +10385,24 @@ class RxFormBuilder extends BaseFormBuilder {
     getObject(model, entityObject, formBuilderConfiguration) {
         /* Initializes an empty object to store the JSON representation */
         let json = {};
-        /* Checks if the model is a function */
+        /* Checks whether the model is a function */
         if (typeof model == FUNCTION_STRING) {
             json["model"] = model;
         }
-        /* Checks if the model is a function and entityObject is an instance of FormBuilderConfiguration */
+        /* Checks whether the model is a function and entityObject is an instance of FormBuilderConfiguration */
         if (typeof model == FUNCTION_STRING && (entityObject instanceof FormBuilderConfiguration)) {
             /* Creates the entity object using createClassObject method */
             json["entityObject"] = this.createClassObject(json["model"], entityObject);
         }
-        /* Checks if entityObject exists and is not an instance of FormBuilderConfiguration */
+        /* Checks whether entityObject exists and is not an instance of FormBuilderConfiguration */
         if (entityObject && !(entityObject instanceof FormBuilderConfiguration)) {
             json["entityObject"] = entityObject;
         }
-        /* Checks if entityObject is an instance of FormBuilderConfiguration and formBuilderConfiguration is not provided */
+        /* Checks whether entityObject is an instance of FormBuilderConfiguration and formBuilderConfiguration is not provided */
         if (entityObject instanceof FormBuilderConfiguration && !formBuilderConfiguration) {
             json["formBuilderConfiguration"] = entityObject;
         }
-        /* Checks if entityObject is not an instance of FormBuilderConfiguration and formBuilderConfiguration is provided */
+        /* Checks whether entityObject is not an instance of FormBuilderConfiguration and formBuilderConfiguration is provided */
         else if (!(entityObject instanceof FormBuilderConfiguration) && formBuilderConfiguration) {
             /* Sets the formBuilderConfiguration in the JSON */
             json["formBuilderConfiguration"] = formBuilderConfiguration;
@@ -10385,7 +10411,7 @@ class RxFormBuilder extends BaseFormBuilder {
         }
         /* If entityObject does not exist */
         if (!entityObject) {
-            /* Checks if the model is an object */
+            /* Checks whether the model is an object */
             if (typeof model == OBJECT_STRING) {
                 /* Stores the constructor of the model */
                 json["model"] = model.constructor;
@@ -10472,19 +10498,19 @@ class RxFormBuilder extends BaseFormBuilder {
      * @param modelInstance The instance of the model.
      */
     applyAllPropValidator(propName, validatorConfig, modelInstance) {
-        /* Check if the validator configuration and applyAllProps array exist */
+        /* Check whether the validator configuration and applyAllProps array exist */
         if (validatorConfig && validatorConfig.applyAllProps) {
-            /* Check if the excludeProps array exists and if the propName is not in the excludeProps array */
+            /* Check whether the excludeProps array exists and propName should be included */
             if (!(validatorConfig.excludeProps && validatorConfig.excludeProps.length > 0 && validatorConfig.excludeProps.indexOf(propName) == -1)) {
                 /* Iterate through each item in the applyAllProps array */
                 validatorConfig.applyAllProps.forEach((t) => {
-                    /* Check if the validator function is an RxWeb validator */
+                    /* Check whether the validator function is an RxWeb validator */
                     if (t.name == RX_WEB_VALIDATOR) {
                         /* Apply RxWeb validator to the propName with the modelInstance */
                         t(propName, modelInstance);
                     }
                     else {
-                        /* Check if the currentFormGroupPropOtherValidator has an entry for the propName */
+                        /* Check whether currentFormGroupPropOtherValidator has an entry for propName */
                         if (!this.currentFormGroupPropOtherValidator[propName]) {
                             /* If not, create an empty array for the propName */
                             this.currentFormGroupPropOtherValidator[propName] = [];
@@ -10497,7 +10523,7 @@ class RxFormBuilder extends BaseFormBuilder {
         }
     }
     /**
-      * Checks if dynamic validation should be applied to a property.
+    * Checks whether dynamic validation should be applied to a property.
       *
       * @param propName The name of the property to check.
       * @param validatorConfig The configuration for property validation.
@@ -10507,7 +10533,7 @@ class RxFormBuilder extends BaseFormBuilder {
         return (validatorConfig == undefined) ? true : (!validatorConfig.dynamicValidationConfigurationPropertyName) ? true : validatorConfig.dynamicValidationConfigurationPropertyName == propName ? false : true;
     }
     /**
-     * Checks if the given value is not an object.
+    * Checks whether the given value is not an object.
      *
      * @param value The value to check.
      * @returns A boolean indicating whether the value is not an object.
@@ -10527,7 +10553,7 @@ class RxFormBuilder extends BaseFormBuilder {
         /* Iterates over each property in the groupObject to create form controls and apply validators. */
         for (var propName in groupObject) {
             var prop = groupObject[propName];
-            /* Check if the property is an array and needs validation */
+            /* Check whether the property is an array and needs validation */
             if (prop instanceof Array && prop.length > 0 && this.isNotObject(prop[0])) {
                 let propValidators = (prop.length > 1 && prop[1] instanceof Array) ? prop[1] : (prop.length == 2) ? [prop[1]] : [];
                 let propertyAdded = false;
@@ -10615,7 +10641,7 @@ class RxFormBuilder extends BaseFormBuilder {
                         entityObject[propName] = {};
                         entityObject[propName].constructor = propModelInstance.constructor;
                         defaultContainer.initPropertyObject(propName, OBJECT_PROPERTY, entityObject[propName].constructor, modelInstance.constructor == Function ? { constructor: modelInstance } : modelInstance);
-                        /* Get the validation configuration for the property */
+                        /* Retrieve the validation configuration for the property */
                         let objectValidationConfig = this.getValidatorConfig(validatorConfig, groupObject, propName + ".");
                         /* Recursively create the validator form group for the property */
                         this.createValidatorFormGroup(groupObject[propName], entityObject[propName], entityObject[propName].constructor, objectValidationConfig);
@@ -10658,7 +10684,7 @@ class RxFormBuilder extends BaseFormBuilder {
         let excludeProps = [];
         let includeProps = [];
         let ignoreUndefinedProps = [];
-        /* Check if the validatorConfig exists */
+        /* Check whether validatorConfig exists */
         if (!validatorConfig)
             return {};
         /* Retrieve validation properties and abstract control options */
@@ -10728,7 +10754,7 @@ class RxFormBuilder extends BaseFormBuilder {
         let props = [];
         /* Iterate through the properties */
         for (let prop of properties) {
-            /* Check if the property contains the rootPropertyName */
+            /* Check whether the property contains rootPropertyName */
             if (prop.indexOf(rootPropertyName) != -1) {
                 let splitProps = prop.split(".");
                 /* If the property has two parts, add the second part to the props array */
@@ -10762,7 +10788,7 @@ class RxFormBuilder extends BaseFormBuilder {
         model = json["model"];
         entityObject = json["entityObject"];
         /*
-         * If the entity object's constructor differs from the model's constructor and formGroup is not previously called,
+         * If the entity object's constructor differs from the model's constructor and formGroup was not called previously,
          * update the entity object to match the model.
          */
         if (entityObject.constructor != model && !this.isGroupCalled) {
@@ -10773,7 +10799,7 @@ class RxFormBuilder extends BaseFormBuilder {
         if (formBuilderConfiguration) {
             this.extractExpressions(formBuilderConfiguration);
         }
-        /* Get the container for instances based on the model and entity object. */
+        /* Retrieve the instance container based on the model and entity object. */
         let instanceContainer = this.getInstanceContainer(model, entityObject);
         /* Check and apply additional validation for object properties. */
         this.checkObjectPropAdditionalValidation(instanceContainer, entityObject, formBuilderConfiguration);
@@ -10784,21 +10810,21 @@ class RxFormBuilder extends BaseFormBuilder {
         /* Iterate through properties defined in the instance container. */
         instanceContainer.properties?.forEach(property => {
             let isIncludeProp = true;
-            /* Check if the property should be included based on form builder configuration. */
+            /* Check whether the property should be included based on form builder configuration. */
             if (formBuilderConfiguration) {
-                /* Check if the property should be excluded based on form builder configuration. */
+                /* Check whether the property should be excluded based on form builder configuration. */
                 if (formBuilderConfiguration.excludeProps && formBuilderConfiguration.excludeProps.length > 0) {
                     isIncludeProp = formBuilderConfiguration.excludeProps.indexOf(property.name) == -1;
                 }
-                /* Check if dynamic validation is provided in the form builder configuration. */
+                /* Check whether dynamic validation is provided in the form builder configuration. */
                 if (formBuilderConfiguration.dynamicValidation) {
                     additionalValidations = formBuilderConfiguration.dynamicValidation;
                 }
-                /* Check if the property should be included based on form builder configuration. */
+                /* Check whether the property should be included based on form builder configuration. */
                 if (formBuilderConfiguration.includeProps && formBuilderConfiguration.includeProps.length > 0) {
                     isIncludeProp = formBuilderConfiguration.includeProps.indexOf(property.name) != -1;
                 }
-                /* Check if undefined properties should be ignored based on form builder configuration. */
+                /* Check whether undefined properties should be ignored based on form builder configuration. */
                 if (formBuilderConfiguration.ignoreUndefinedProps && formBuilderConfiguration.ignoreUndefinedProps.length > 0) {
                     isIncludeProp = !(property.propertyType == PROPERTY &&
                         !RegexValidator.isNotBlank(json["entityObject"][property.name]) &&
@@ -10976,7 +11002,7 @@ class RxFormBuilder extends BaseFormBuilder {
             json["entityObject"]["formGroup"] = formGroup;
             this.overrideProperties(formGroup, json["entityObject"], extendedProperties);
         }
-        /* If not in nested binding mode and formGroup is not previously called, refresh disable status of the form group. */
+        /* If not in nested binding mode and formGroup was not called previously, refresh disable status of the form group. */
         if (!this.isNestedBinding && !this.isGroupCalled) {
             formGroup.refreshDisable();
         }
@@ -11004,7 +11030,7 @@ class RxFormBuilder extends BaseFormBuilder {
         if (formBuilderConfiguration && formBuilderConfiguration.abstractControlOptions && formBuilderConfiguration.abstractControlOptions[name]) {
             abstractControlOptions.updateOn = formBuilderConfiguration.abstractControlOptions[name];
         }
-        /* Check if controlOptions are defined in formBuilderConfiguration */
+        /* Check whether controlOptions are defined in formBuilderConfiguration */
         const controlOptions = formBuilderConfiguration ? formBuilderConfiguration.baseAbstractControlOptions : null;
         if (controlOptions && controlOptions[name]) {
             /* Update updateOn option from controlOptions if defined */
@@ -11044,7 +11070,7 @@ class RxFormBuilder extends BaseFormBuilder {
      * @param formGroup The RxFormGroup associated with the entity object.
      */
     overrideProp(entityObject, propName, formGroup) {
-        /* Get the property descriptor and current value */
+        /* Retrieve the property descriptor and current value */
         let descriptor = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(entityObject), propName);
         let value = entityObject[propName];
         let oldValue = null;
@@ -11055,7 +11081,7 @@ class RxFormBuilder extends BaseFormBuilder {
             /* Custom setter */
             set: (v) => {
                 value = v;
-                /* Check if value has changed */
+                /* Check whether the value has changed */
                 if (oldValue != v) {
                     /* Call the original setter if defined */
                     if (descriptor) {
@@ -12403,9 +12429,10 @@ var Salutation;
 })(Salutation || (Salutation = {}));
 
 /**
- * Property decorator to add display name to a property
- * @param name
- * @returns
+ * Property decorator to define a display name for a class property.
+ * This decorator can be applied to a class property to specify its display name, which can be used in UI components or other contexts.
+ * @param name The display name to associate with the property.
+ * @returns A property decorator function.
  */
 function Display(name) {
     return function (target, propertyKey) {
@@ -12413,9 +12440,10 @@ function Display(name) {
     };
 }
 /**
- * Class decorator to add endpoint to an entity
- * @param endpoint
- * @returns
+ * Class decorator to define an API endpoint for a given class.
+ * This decorator can be applied to a class to specify the API endpoint associated with it, which can be used for data retrieval or other operations.
+ * @param endpoint The API endpoint to associate with the class.
+ * @returns A class decorator function.
  */
 function Api(endpoint) {
     return function (target) {
@@ -22076,8 +22104,13 @@ class VdChipsComponent extends AbstractMatFormField {
     set params(params) {
         /* Remove empty parameters */
         Utils.cleanObject(params);
+        /* Update parameters if they have changed */
         if (!Utils.equals(this._params, params)) {
             this._params = params;
+            /* Clear the current chips and reset the control state */
+            if (this._params?.projection) {
+                this._params.projection = parseProjectionString(this._params.projection);
+            }
         }
     }
     /**
@@ -22089,7 +22122,7 @@ class VdChipsComponent extends AbstractMatFormField {
      */
     get projection() { return this._projection; }
     set projection(projection) {
-        this._projection = projection;
+        this._projection = parseProjectionString(projection);
         this.clear();
     }
     /**
@@ -24180,7 +24213,7 @@ class VdGenericFormComponent {
             }
         };
         /* Update dynamic properties for each field and subscribe to form value changes */
-        this.fields?.forEach(x => {
+        fields?.forEach(x => {
             const orgField = this.fields?.find(y => y.name == x.name);
             if (orgField) {
                 updateFormField(orgField, x);
@@ -25273,9 +25306,95 @@ class FormFieldDefinition {
 
 const unwarppedFormFields = [FormFieldType.Checkbox, FormFieldType.Editor, FormFieldType.Code, FormFieldType.File, FormFieldType.Custom];
 /**
- * Class decorator to create a form
- * @param formDefinition
- * @returns
+ * Creates a form field definition based on the provided target, property key, and arguments.
+ * @param target The target object containing the property.
+ * @param propertyKey The key of the property for which the form field is being defined.
+ * @param args Partial arguments to customize the form field definition.
+ * @returns A FormFieldDefinition object representing the form field.
+ */
+function createFormFieldDefinition(target, propertyKey, args) {
+    /* Get property type */
+    var propertyType = Reflect.getMetadata("design:type", target, propertyKey)?.name;
+    /* Get label from args, metadata, or property key */
+    var label = args.label || Reflect.getMetadata(headerMetadataKey, target, propertyKey) || propertyKey;
+    /* Create table column */
+    var formField = new FormFieldDefinition(Object.assign(args, {
+        name: args.name || propertyKey,
+        label: label,
+        autocompleteTemplate: args.autocompleteTemplate || ((option) => option[formField.autocompleteText ?? '']),
+        chipTemplate: args.chipTemplate || ((chip) => (args.customValue ? chip : chip[formField.chipText ?? '']))
+    }));
+    /* Type enum */
+    if (formField.enumType) {
+        formField.type ||= FormFieldType.Enum;
+    }
+    /* Type VdSelect */
+    else if (formField.endpoint) {
+        formField.type ||= FormFieldType.VdSelect;
+    }
+    /* Type Select */
+    else if (formField.options) {
+        formField.type ||= FormFieldType.Select;
+    }
+    /* Type TextArea */
+    else if (formField.rows) {
+        formField.type ||= FormFieldType.TextArea;
+    }
+    /* Type File */
+    else if (formField.filePath) {
+        formField.type ||= FormFieldType.File;
+    }
+    /* Other types */
+    else {
+        switch (propertyType?.toLowerCase()) {
+            case 'number':
+                formField.type ||= FormFieldType.Text;
+                formField.inputType ||= 'number';
+                break;
+            case 'date':
+                formField.type ||= FormFieldType.Date;
+                break;
+            case 'boolean':
+                formField.type ||= FormFieldType.Checkbox;
+                break;
+            default:
+                formField.type ||= FormFieldType.Text;
+                break;
+        }
+    }
+    /* Set wrapped to false, if the field cant be wrapped in the <mat-form-field> */
+    if (formField.type && unwarppedFormFields?.includes(formField.type)) {
+        formField.wrapped = false;
+    }
+    /* Add class multiline to the form field */
+    if (formField.multiline) {
+        formField.cssClass += ' multiline';
+        formField.cssClass = formField.cssClass?.trim();
+    }
+    /**
+     * If the 'numbersOnly' flag is set to true and no custom pattern is defined,
+     * set the pattern to allow only numbers after the optional prefix.
+     */
+    if (formField.numbersOnly && !formField.pattern) {
+        /* Get the prefix */
+        const prefix = formField.prefix ?? '';
+        /* Set pattern to allow only numbers after the prefix */
+        if (prefix) {
+            formField.pattern = new RegExp(`^${prefix}[0-9]*$`);
+        }
+        /* No prefix case */
+        else {
+            formField.pattern = /^[0-9]*$/;
+        }
+    }
+    return formField;
+}
+
+/**
+ * Class decorator to define a form definition for a given class.
+ * This decorator can be applied to a class to specify its form configuration, including endpoint, projection, actions, and field groups.
+ * @param formDefinition Optional partial configuration to customize the resulting FormDefinition.
+ * @returns A class decorator function.
  */
 function Form(formDefinition) {
     return function (target) {
@@ -25284,88 +25403,26 @@ function Form(formDefinition) {
     };
 }
 /**
- * Property decorator to create form fields
- * @param args
- * @returns
+ * Property decorator to create and register form fields.
+ * This decorator can be applied to a class property to automatically generate and register form fields based on the provided arguments.
+ * @param args Partial arguments to customize the resulting FormFieldDefinition.
+ * @returns A property decorator function.
  */
 function FormField(args) {
     return function (target, propertyKey) {
         /* Get property name */
         var propertyName = args.name || propertyKey;
-        /* Get property type */
-        var propertyType = Reflect.getMetadata("design:type", target, propertyKey)?.name;
-        /* Create table column */
-        var formField = new FormFieldDefinition(Object.assign(args, {
-            name: args.name || propertyKey,
-            label: args.label || Reflect.getMetadata(headerMetadataKey, target, propertyKey) || propertyName,
-            autocompleteTemplate: args.autocompleteTemplate || ((option) => option[formField.autocompleteText ?? '']),
-            chipTemplate: args.chipTemplate || ((chip) => (args.customValue ? chip : chip[formField.chipText ?? '']))
-        }));
-        /* Type enum */
-        if (formField.enumType) {
-            formField.type ||= FormFieldType.Enum;
-        }
-        /* Type VdSelect */
-        else if (formField.endpoint) {
-            formField.type ||= FormFieldType.VdSelect;
-        }
-        /* Type Select */
-        else if (formField.options) {
-            formField.type ||= FormFieldType.Select;
-        }
-        /* Type TextArea */
-        else if (formField.rows) {
-            formField.type ||= FormFieldType.TextArea;
-        }
-        /* Type File */
-        else if (formField.filePath) {
-            formField.type ||= FormFieldType.File;
-        }
-        /* Other types */
-        else {
-            switch (propertyType?.toLowerCase()) {
-                case 'number':
-                    formField.type ||= FormFieldType.Text;
-                    formField.inputType ||= 'number';
-                    break;
-                case 'date':
-                    formField.type ||= FormFieldType.Date;
-                    break;
-                case 'boolean':
-                    formField.type ||= FormFieldType.Checkbox;
-                    break;
-                default:
-                    formField.type ||= FormFieldType.Text;
-                    break;
-            }
-        }
-        /* Set wrapped to false, if the field cant be wrapped in the <mat-form-field> */
-        if (formField.type && unwarppedFormFields?.includes(formField.type)) {
-            formField.wrapped = false;
-        }
-        /* Add class multiline to the form field */
-        if (formField.multiline) {
-            formField.cssClass += ' multiline';
-            formField.cssClass = formField.cssClass?.trim();
-        }
-        /**
-         * If the 'numbersOnly' flag is set to true and no custom pattern is defined,
-         * set the pattern to allow only numbers after the optional prefix.
-         */
-        if (formField.numbersOnly && !formField.pattern) {
-            /* Get the prefix */
-            const prefix = formField.prefix ?? '';
-            /* Set pattern to allow only numbers after the prefix */
-            if (prefix) {
-                formField.pattern = new RegExp(`^${prefix}[0-9]*$`);
-            }
-            /* No prefix case */
-            else {
-                formField.pattern = /^[0-9]*$/;
-            }
-        }
         /* Get old form fields */
         let previousFormFields = Reflect.getMetadata(formFieldsMetadataKey, target);
+        /* Override the field with the args, if exists */
+        const previousFormField = previousFormFields?.find(x => x.name == propertyName);
+        const formFieldArgs = previousFormField
+            ? Object.assign({}, previousFormField, args, {
+                label: args.label || Reflect.getMetadata(headerMetadataKey, target, propertyKey) || propertyKey
+            })
+            : args;
+        /* Create a new form field definition */
+        var formField = createFormFieldDefinition(target, propertyKey, formFieldArgs);
         /* Override the field, if exists */
         previousFormFields = previousFormFields?.filter(x => x.name != formField.name);
         /* Create a copy of the result */
@@ -25387,8 +25444,6 @@ function FormField(args) {
  */
 function FormFieldGroup(type, args, context) {
     return function (target, propertyKey) {
-        /* Create an instance of the group object */
-        var instance = Reflect.construct(type, []);
         /* Retrieve form groups from the type, passing args and context */
         var groups = getFormGroups(undefined, type, args, context);
         /* Get the header of the groups or create one using the property name */