@sumaris-net/ngx-components 18.0.2-alpha2 → 18.0.2-alpha3

package/package.json

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

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

@@ -1,6 +1,6 @@
 import { PropertiesMap, Property } from '../../../shared/types';
 import { FormFieldDefinition } from '../../../shared/form/field.model';
-import { SuggestFn } from '../../../shared/services/entity-service.class';
+import { EntitiesServiceLoadOptions, SuggestFn } from '../../../shared/services/entity-service.class';
 export declare class AppPropertiesUtils {
     /**
      * Converts an array of `Property` objects into a `PropertiesMap` object.
@@ -25,13 +25,26 @@ export declare class AppPropertiesUtils {
 }
 export declare class AppPropertyUtils {
     static key(source: Property | any): string;
-    static asObject(source: Property | any, def?: FormFieldDefinition): {
+    /**
+     * Converts the given source to an object that contains a key-value pair.
+     *
+     * @param {Property<any> | any} source - The source property or any value to be converted.
+     * @param {FormFieldDefinition} [def] - The form field definition used for serialization.
+     * @param {Object} [opts] - Additional options for serialization.
+     * @param {string} [opts.defaultSerializeAttribute='id'] - The attribute to be used for default serialization.
+     * @return {{ key: string, value: string } | undefined} An object containing the serialized key-value pair, or undefined if the source is not provided.
+     */
+    static asObject(source: Property<any> | any, def?: FormFieldDefinition, opts?: {
+        defaultSerializeAttribute?: string;
+    }): {
         key: string;
         value: string;
     } | undefined;
     static fromObject(source: Property<string>, def: FormFieldDefinition, opts?: {
         defaultSuggestFn: SuggestFn<any, any>;
+        defaultSuggestOptions?: EntitiesServiceLoadOptions;
+        defaultSerializeAttribute?: string;
     }): Property<any> | Promise<Property<any>>;
-    private static valueFromObject;
-    private static resolveValueBySuggest;
+    private static resolveEntity;
+    private static resolveEntityBySuggest;
 }

package/src/app/shared/form/field.model.d.ts

@@ -19,8 +19,6 @@ export declare interface FormFieldDefinition<K = string, T = FormFieldType, E =
     isTransient?: boolean;
     values?: (string | Property)[] | InjectionToken<(string | Property)[]>;
     autocomplete?: MatAutocompleteFieldConfig<E>;
-    deserialize?: (value: string) => E | Promise<E>;
-    serialize?: (value: E) => string;
     disabled?: boolean;
     required?: boolean;
     extra?: {
@@ -30,6 +28,21 @@ export declare interface FormFieldDefinition<K = string, T = FormFieldType, E =
         };
     };
     minProfile?: UserProfileLabel;
+    /**
+     * Use for automatic serialization/deserialization to/from string (eg. using the autocomplete suggestFn).
+     * Default value: 'id'
+     */
+    serializeAttribute?: string;
+    /**
+     * Use to serialize an entity into string (see AppPropertiesUtils.***asObject())
+     * @param value
+     */
+    serialize?: (value: E) => string;
+    /**
+     * Use to deserialize a string into an entity (see AppPropertiesUtils.***fromObject())
+     * @param value
+     */
+    deserialize?: (value: string) => E | Promise<E>;
 }
 export declare type FormFieldDefinitionMap = ObjectMap<FormFieldDefinition>;
 export declare abstract class FormFieldValuesHolder {

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

@@ -16,7 +16,7 @@ export interface InputElement extends FocusableElement {
 }
 export declare function isInputElement(object: any): object is InputElement;
 export declare function asInputElement<T = any>(object: ElementRef<T>): InputElement | undefined;
-export declare function tabindexComparator(a: InputElement, b: InputElement): 0 | 1 | -1;
+export declare function tabindexComparator(a: InputElement, b: InputElement): 1 | 0 | -1;
 export interface CanGainFocusOptions {
     minTabindex?: number;
     maxTabindex?: number;

package/src/app/shared/material/autocomplete/material.autocomplete.config.d.ts

@@ -1,9 +1,9 @@
-import { LoadResult, SuggestService } from '../../services/entity-service.class';
+import { SuggestFn, SuggestService } from '../../services/entity-service.class';
 import { Observable } from 'rxjs';
 import { DisplayFn, EqualsFn } from '../../form/field.model';
 export declare interface MatAutocompleteFieldConfig<T = any, F = any> {
     attributes?: string[];
-    suggestFn?: (value: any, options?: any) => Promise<T[] | LoadResult<T>>;
+    suggestFn?: SuggestFn<T, F>;
     filter?: Partial<F>;
     items?: Observable<T[]> | T[];
     columnSizes?: (number | 'auto' | undefined)[];

package/src/assets/manifest.json

@@ -2,7 +2,7 @@
   "name": "ngx-sumaris-components",
   "short_name": "ngx-sumaris-components",
   "manifest_version": 1,
-  "version": "18.0.2-alpha2",
+  "version": "18.0.2-alpha3",
   "default_locale": "fr",
   "description": "Angular components for building beautiful and responsive Apps",
   "icons": [{