@stemy/ngx-dynamic-form 19.8.13 → 19.8.15

package/ngx-dynamic-form/common-types.d.ts

@@ -188,6 +188,7 @@ export interface FormFieldConfig<T = FormFieldProps> extends FormlyFieldConfig<T
     serialize?: FormFieldConditionFn;
     serializer?: FormFieldSerializer;
     fieldSet?: string;
+    purposes?: string[];
     asFieldSet?: boolean;
     priority?: number;
     fieldGroup?: FormFieldConfig[];
@@ -230,9 +231,11 @@ export interface IDynamicForm {
     readonly group: Signal<FormGroup>;
     readonly status: Signal<DynamicFormStatus>;
     readonly onSubmit: OutputRef<IDynamicForm>;
-    readonly onChanges: OutputRef<FormFieldChangeEvent>;
+    readonly onFieldChanges: OutputRef<FormFieldChangeEvent>;
+    readonly onValueChanges: OutputRef<FormFieldChangeEvent>;
+    readonly onInit: OutputRef<FormFieldChangeEvent>;
     reset(): void;
-    serialize(validate?: boolean): Promise<any>;
+    serialize(validate?: boolean, ...purposes: string[]): Promise<FormSerializeResult>;
     getField(path: string): FormFieldConfig;
     getControl(path: string): AbstractControl;
 }
@@ -284,6 +287,10 @@ export type FormFieldData = Pick<FormFieldProps, "label" | "labelAlign" | "descr
      * Puts the field in a custom field set
      */
     fieldSet?: string;
+    /**
+     * Gives purpose to a field (can be used as a filter in serialization)
+     */
+    purposes?: string | string[];
     /**
      * Puts the field in a custom order
      */

package/ngx-dynamic-form/components/dynamic-form/dynamic-form.component.d.ts

@@ -19,6 +19,8 @@ export declare class DynamicFormComponent implements IDynamicForm {
     readonly data: import("@angular/core").InputSignal<any>;
     readonly fields: import("@angular/core").InputSignal<FormFieldConfig<import("../../common-types").FormFieldProps>[]>;
     readonly fieldChanges: Subject<FormFieldChangeEvent>;
+    readonly init: import("rxjs").Observable<FormFieldChangeEvent>;
+    readonly valueChanges: import("rxjs").Observable<FormFieldChangeEvent>;
     protected readonly language: import("@angular/core").Signal<string>;
     protected readonly enableTranslations: import("@angular/core").Signal<boolean>;
     readonly config: import("@angular/core").Signal<FormFieldConfig<import("../../common-types").FormFieldProps>[]>;
@@ -26,14 +28,16 @@ export declare class DynamicFormComponent implements IDynamicForm {
     protected readonly status$: import("@angular/core").ResourceRef<import("../../common-types").DynamicFormStatus>;
     readonly status: import("@angular/core").Signal<import("../../common-types").DynamicFormStatus>;
     readonly onSubmit: import("@angular/core").OutputEmitterRef<IDynamicForm>;
-    readonly onChanges: import("@angular/core").OutputRef<FormFieldChangeEvent>;
+    readonly onFieldChanges: import("@angular/core").OutputRef<FormFieldChangeEvent>;
+    readonly onValueChanges: import("@angular/core").OutputRef<FormFieldChangeEvent>;
+    readonly onInit: import("@angular/core").OutputRef<FormFieldChangeEvent>;
     readonly options: FormlyFormOptions;
     constructor(forms: DynamicFormService);
     submit(): void;
     reset(): void;
-    serialize(validate?: boolean): Promise<FormSerializeResult>;
+    serialize(validate?: boolean, ...purposes: string[]): Promise<FormSerializeResult>;
     getField(path: string): FormFieldConfig;
     getControl(path: string): AbstractControl;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicFormComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicFormComponent, "dynamic-form", never, { "labelPrefix": { "alias": "labelPrefix"; "required": false; "isSignal": true; }; "labelCustomizer": { "alias": "labelCustomizer"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "useTabs": { "alias": "useTabs"; "required": false; "isSignal": true; }; "legacyLabels": { "alias": "legacyLabels"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; }, { "onSubmit": "onSubmit"; "onChanges": "onChanges"; }, never, ["*"], false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicFormComponent, "dynamic-form", never, { "labelPrefix": { "alias": "labelPrefix"; "required": false; "isSignal": true; }; "labelCustomizer": { "alias": "labelCustomizer"; "required": false; "isSignal": true; }; "testId": { "alias": "testId"; "required": false; "isSignal": true; }; "useTabs": { "alias": "useTabs"; "required": false; "isSignal": true; }; "legacyLabels": { "alias": "legacyLabels"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "fields": { "alias": "fields"; "required": false; "isSignal": true; }; }, { "onSubmit": "onSubmit"; "onFieldChanges": "onFieldChanges"; "onValueChanges": "onValueChanges"; "onInit": "onInit"; }, never, ["*"], false, never>;
 }

package/ngx-dynamic-form/services/dynamic-form.service.d.ts

@@ -15,8 +15,8 @@ export declare class DynamicFormService {
     getFormFieldGroupForSchema(name: string, customizeOrOptions?: CustomizerOrSchemaOptions): Promise<FormFieldConfig>;
     protected getFormFieldGroupBySchemaName(name: string, customizeOrOptions: CustomizerOrSchemaOptions, restrictedMethod: string): Promise<FormFieldConfig>;
     validateForm(form: IDynamicForm, showErrors?: boolean): Promise<any>;
-    serializeForm(form: IDynamicForm, validate?: boolean): Promise<FormSerializeResult>;
-    serialize(fields: FormFieldConfig[]): Promise<FormSerializeResult>;
+    serializeForm(form: IDynamicForm, validate?: boolean, ...purposes: string[]): Promise<FormSerializeResult>;
+    serialize(fields: FormFieldConfig[], purposes?: string[]): Promise<FormSerializeResult>;
     protected showErrorsForGroup(formGroup: FormGroup): void;
     protected showErrorsForControls(controls: AbstractControl[]): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicFormService, never>;

package/ngx-dynamic-form/utils/internal.d.ts

@@ -9,6 +9,7 @@ export interface ConfigForSchemaWrapOptions extends Required<FormBuilderOptionsB
     customize(field: FormFieldConfig, property: OpenApiSchemaProperty, schema: OpenApiSchema): Promise<FormFieldConfig[]>;
 }
 export declare function toWrapOptions(customizeOrOptions: CustomizerOrSchemaOptions | ConfigForSchemaWrapOptions, injector: Injector, schema: OpenApiSchema, errorMsg?: string): Promise<ConfigForSchemaWrapOptions>;
+export declare function toStringArray(value: string | string[]): string[];
 export declare function handleConfigs(configs: MaybeArray<FormFieldConfig>): FormFieldConfig<FormFieldProps>[];
 export declare function arrayItemActionToExpression(actionName: KeysOfType<FormFieldProps, FormFieldArrayItemsAction>): FormFieldExpression;
 export declare function mergeFormFields(formFields: FormFieldConfig[][]): FormFieldConfig[];

package/ngx-dynamic-form/utils/misc.d.ts

@@ -48,6 +48,7 @@ interface SetFormFieldProps extends Omit<FormFieldProps, "min" | "max"> {
 }
 export declare function setFieldProps(field: FormFieldConfig, values: SetFormFieldProps): FormFieldConfig;
 export declare function setFieldProp<P extends keyof SetFormFieldProps, V extends SetFormFieldProps[P]>(field: FormFieldConfig, prop: P, value: V): FormFieldConfig;
+export declare function setFieldSerialize(field: FormFieldConfig, serialize?: FormFieldCondition): void;
 export declare function setFieldHidden(field: FormFieldConfig, hidden?: FormFieldCondition): void;
 export declare function setFieldDisabled(field: FormFieldConfig, disabled?: FormFieldCondition): void;
 export declare function setFieldHooks(field: FormFieldConfig, hooks: FormHookConfig): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stemy/ngx-dynamic-form",
-  "version": "19.8.13",
+  "version": "19.8.15",
   "license": "MIT",
   "public": true,
   "repository": "https://github.com/stemyke/ngx-dynamic-form.git",
@@ -22,8 +22,8 @@
     "ngx-device-detector": "^9.0.0",
     "@floating-ui/dom": "^1.7.1",
     "json5": "^2.2.3",
-    "@stemy/ngx-utils": ">=19.8.10",
-    "@ngx-formly/core": "^7.0.0",
+    "@stemy/ngx-utils": ">=19.8.13",
+    "@ngx-formly/core": "^7.1.0",
     "ngx-mask": "^19.0.7",
     "@angular/material": "^19.2.18"
   },

package/public_api.d.ts

@@ -2,7 +2,7 @@ export { FORM_ROOT_ID, FormFieldKey, FormFieldLabelCustomizer, FormBuilderOption
 export { IFormFieldCustomizer, customizeFormField } from "./ngx-dynamic-form/utils/customizer";
 export { FormInput, FormSelect, FormStatic, FormUpload, FormGroup, FormArray, FormSerializable, FormFieldSet } from "./ngx-dynamic-form/utils/decorators";
 export { addFieldValidators, removeFieldValidators, jsonValidation, requiredValidation, translationValidation, phoneValidation, emailValidation, arrayLengthValidation, minLengthValidation, maxLengthValidation, minValueValidation, maxValueValidation } from "./ngx-dynamic-form/utils/validation";
-export { replaceSpecialChars, controlValues, controlStatus, convertToDateFormat, convertToDate, convertToNumber, getFieldByPath, getFieldsByPredicate, getFieldsByKey, getSelectOptions, replaceFieldArray, clearFieldArray, insertToFieldArray, removeFromFieldArray, setFieldDefault, setFieldValue, setFieldProps, setFieldProp, setFieldHidden, setFieldDisabled, setFieldHooks, isFieldVisible, isFieldHidden, MIN_INPUT_NUM, MAX_INPUT_NUM, EDITOR_FORMATS } from "./ngx-dynamic-form/utils/misc";
+export { replaceSpecialChars, controlValues, controlStatus, convertToDateFormat, convertToDate, convertToNumber, getFieldByPath, getFieldsByPredicate, getFieldsByKey, getSelectOptions, replaceFieldArray, clearFieldArray, insertToFieldArray, removeFromFieldArray, setFieldDefault, setFieldValue, setFieldProps, setFieldProp, setFieldSerialize, setFieldHidden, setFieldDisabled, setFieldHooks, isFieldVisible, isFieldHidden, MIN_INPUT_NUM, MAX_INPUT_NUM, EDITOR_FORMATS } from "./ngx-dynamic-form/utils/misc";
 export { RichTranslationModel } from "./ngx-dynamic-form/models/rich-translation.model";
 export { TranslationModel } from "./ngx-dynamic-form/models/translation.model";
 export { DynamicFormBuilderService } from "./ngx-dynamic-form/services/dynamic-form-builder.service";