@sumaris-net/ngx-components 1.23.37 → 1.23.40

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sumaris-net/ngx-components",
   "description": "SUMARiS Angular components",
-  "version": "1.23.37",
+  "version": "1.23.40",
   "author": "contact@e-is.pro",
   "license": "AGPL-3.0",
   "readmeFilename": "README.md",

package/src/app/core/form/form.utils.d.ts

@@ -2,7 +2,7 @@ import { AbstractControl, FormArray, FormBuilder, FormGroup, ValidatorFn } from
 import { Entity } from '../services/model/entity.model';
 import { filterNumberInput, selectInputContent } from '../../shared/inputs';
 import { WaitForOptions } from '../../shared/observables';
-import { addValueInArray, clearValueInArray, copyEntity2Form, disableControls, getControlFromPath, getFormErrors, getFormValueFromEntity, logFormErrors, markAllAsTouched, markAsUntouched, removeValueInArray, resizeArray, updateValueAndValidity, waitIdle, waitWhilePending } from '../../shared/forms';
+import { pushValueInArray, clearValueInArray, copyEntity2Form, disableControls, getControlFromPath, getFormErrors, getFormValueFromEntity, logFormErrors, markAllAsTouched, markAsUntouched, removeValueInArray, resizeArray, updateValueAndValidity, waitIdle, waitWhilePending } from '../../shared/forms';
 export declare type IAppFormGetter = () => IAppForm;
 export declare interface OnReady {
     ngOnReady(): any;
@@ -180,22 +180,35 @@ export declare class AppFormProvider<F extends IAppForm = IAppForm> implements I
 export interface FormArrayHelperOptions {
     allowEmptyArray: boolean;
     validators?: ValidatorFn[];
+    helperProperty?: boolean;
 }
 export declare class FormArrayHelper<T = Entity<any>, C extends AbstractControl = AbstractControl> {
     private readonly _formArray;
     private createControl;
     private equals;
     private isEmpty;
+    static FORMA_HELPER_PROPERTY: string;
     static getOrCreateArray(formBuilder: FormBuilder, form: FormGroup, arrayName: string): FormArray;
+    static hasHelper(formArray: FormArray): formArray is FormArray & {
+        _helper: FormArrayHelper<any>;
+    };
     private _allowEmptyArray;
     private readonly _validators;
     get allowEmptyArray(): boolean;
     set allowEmptyArray(value: boolean);
     get formArray(): FormArray;
     constructor(_formArray: FormArray, createControl: (value?: T) => C, equals: (v1: T, v2: T) => boolean, isEmpty: (value: T) => boolean, options?: FormArrayHelperOptions);
+    /**
+     * @param value
+     * @param options
+     * @deprecated Use push() instead
+     */
     add(value?: T, options?: {
         emitEvent: boolean;
     }): boolean;
+    push(value?: T, options?: {
+        emitEvent: boolean;
+    }): boolean;
     removeAt(index: number): boolean;
     resize(length: number): boolean;
     clearAt(index: number): boolean;
@@ -204,21 +217,12 @@ export declare class FormArrayHelper<T = Entity<any>, C extends AbstractControl
     size(): number;
     at(index: number): C;
     /**
-     * Resize the FormArray, then set values
-     * @param values
+     * Patch a FormArray, using default values
+     * @param values default values to apply.
      * @param opts
+     * @return true if form arry has been changed
      */
-    setValue(values: T[], opts?: {
-        emitEvent?: boolean;
-    }): void;
-    /**
-     * Resize the FormArray, then patch values
-     * @param data
-     * @param opts
-     */
-    patchValue(data: T[], opts?: {
-        emitEvent?: boolean;
-    }): void;
+    patchValue(values: T[]): boolean;
     disable(opts?: {
         onlySelf?: boolean;
         emitEvent?: boolean;
@@ -254,7 +258,7 @@ export declare class AppFormUtils {
     static updateValueAndValidity: typeof updateValueAndValidity;
     static getFormErrors: typeof getFormErrors;
     static isForm(object: any): object is IAppForm;
-    static addValueInArray: typeof addValueInArray;
+    static addValueInArray: typeof pushValueInArray;
     static removeValueInArray: typeof removeValueInArray;
     static resizeArray: typeof resizeArray;
     static clearValueInArray: typeof clearValueInArray;

package/src/app/shared/forms.d.ts

@@ -36,9 +36,16 @@ export declare function disableControls(form: FormGroup, paths: string[], opts?:
     onlySelf?: boolean;
     emitEvent?: boolean;
 }): void;
-export declare function addValueInArray(arrayControl: FormArray, createControl: (value?: any) => AbstractControl, equals: (v1: any, v2: any) => boolean, isEmpty: (value: any) => boolean, value: any, options?: {
+export declare function pushValueInArray(arrayControl: FormArray, createControl: (value?: any) => AbstractControl, equals: (v1: any, v2: any) => boolean, isEmpty: (value: any) => boolean, value: any, options?: {
     emitEvent: boolean;
 }): boolean;
+/**
+ * Patch an array using given default values. Each default value will be pass to the 'createControl()' function
+ * @param arrayControl
+ * @param createControl
+ * @param values
+ */
+export declare function patchValueInArray(arrayControl: FormArray, createControl: (value?: any) => AbstractControl, defaultValues: any[]): boolean;
 export declare function resizeArray(arrayControl: FormArray, createControl: () => AbstractControl, length: number): boolean;
 export declare function removeValueInArray(arrayControl: FormArray, isEmpty: (value: any) => boolean, index: number): boolean;
 export declare function clearValueInArray(arrayControl: FormArray, isEmpty: (value: any) => boolean, index: number): boolean;