@sumaris-net/ngx-components 18.2.31-alpha-3 → 18.2.32

package/doc/changelog.md

@@ -1,1028 +1,1031 @@
-# Change log
-
-## 0.1.7
-
-- enh: Menu: Allow dynamic insertion, using a new config options (see 'CORE_CONFIG_OPTIONS.MENU_ITEMS')
-  * Example: 
-  ```js
-    const options = [
-      // Insert before'MENU.HOME'
-      {title: "Item #1", path: "/settings", icon: "people", before: "MENU.HOME"},
-  
-      // Insert after 'MENU.HOME'
-      {title: "Item #2", path: "/settings", icon: "people", after: "MENU.HOME"}
-    ];
-    config.properties[CORE_CONFIG_OPTIONS.MENU_ITEMS.key] = JSON.stringify(items); 
-  ```
-  Values of 'after' and 'before' will be compared with `title` of existing items.
-
-## 0.3.3
-
-- enh: CSS `.filter-panel` should be used with `.filter-panel-floating` to enable floating position
-
-## 0.3.4
-
-- fix: Users table: use floating filter panel
-
-## 0.3.5
-
-- enh: Add new pipe `arrayFilter` to be able to filter an array, in HTML templates
-
-## 0.4.0
-
-- enh: CSS: change style of error row (use warning color)
-- enh: CSS: new class '.visible-dirty' (e.g. `<ion-icon name="star" class="visible-dirty"></ion-icon>` in the `actions` column)
-- enh: ValidatorService: add function getI18nErrors(control)
-- enh: AppTable: add outputs 'onDirty', 'onError'
-- enh: AppTable: 
-
-## 0.4.1
-
-- enh: Add new component 'app-actions-columns'
-
-## 0.4.2
-
-- enh: LoadResult class: Add a `fetchMore()` function
-- enh: Autocomplete field: Add infinite scroll, using `LoadResult.fetchMore()`
-
-## 0.4.3
-
-- enh: AppTable: add `options` (with property `interactive`) in `deleteRow()` and `deleteRows()`
-  Used to avoid user confirmation, when deletion has been confirmed elsewhere
-
-## 0.4.4
-
-- enh: Rename `<form-buttons-bar>` into `<app-form-buttons-bar>`
-- enh: Export more CSS variables: `--app-paginator-height`, `app-form-buttons-bar-height`
-
-## 0.5.0
-
-- enh: Table: allow keyboard navigation, using `<app-actions-column>` and function `table.confirmAndBackward()` and `table.confirmAndForward()`
-
-## 0.7.10
-
-- enh: Table: no more border-left, on dirty rows (because of sticky columns nightmare !)
-
-## 0.9.0
-
-- enh: Autocomplete field: add config option `suggestLengthThreshold` to suggest after typing more than x characters 
-- enh: Autocomplete field: add config option `debounceTime` 
-
-## 0.10.0
-
-- enh: Add EntityClasses class: use it to get an entity class by name (need to use @EntityClass decorator on the class)  
-
-## 0.11.4
-
-- fix: Autocomplete field: when focus out, move caret to start (fix firefox bug, when `input[type=text]` content is too long)
-
-## 0.11.5
-
-- enh: Decorator @Entity now generate the static class function `asObject(source: any, opts?: any): any`
-
-## 0.15.0
-
-- enh: Add IAppForm.loading (optional)
-- enh: Add AppForm.waitIdle()
-- enh: IAppForm, AppForm, AppTabEditor: Add markAsLoading() and markAsLoaded()
-
-## 0.18.0
-
-- enh: Add AppTable.updateView(): Promise
-- enh: Add AppTableDatasource: rename $busy into loadingSubject
-- fix: Fix InMemoryTable setValue
-- fix: AppTable: after save, refactor code to select previously edited row
-
-## 0.19.0
-
-- fix: refactor AppFormUtils.copyEntityToForm() for multiple values (split on the character '|' )
-- fix: remove AppFormUtils.copyForm2Entity() - same a form.value
-
-## 0.20.0
-
-- fix: remove functions `isArray()` (please use `Array.isArray()` instead)
-- enh: Add `AccountService.onChange: Subject` to listen account settings changes
-- fix: Account model: use minify option to serialize as a POD object
-- fix: AccountService: change some internal function's visibility, to protected 
-- fix: InMemoryService: fix equals() default implementation (avoid infinite loop)
-- fix: SCSS: Set mat-select-column to width: 50px, to make it compatible with sticky <mat-table>
-- enh: Add ComponentDirtyGuard to public API
-
-## 0.20.0
-
-- fix: AppEntityEditor: remove confirmation before backClick (use ComponentDirtyGuard instead)
-- fix: AppEntityEditor: cancel() will not ask a confirmation, because called by dirty guard). 
-
-## 0.23.0
-- fix: MatAutocompleteField: when escape event, close the panel and stop event's propagation
-- fix: AppFormButtonsBar: when escape event, make sure preventDefault!=false before emit a back event
-
-## 0.24.0
-
-- fix: AppInstallUpgradeCard: use Cordova Downloader plugin, to download APK file correctly 
-
-## 0.25.0
-
-- enh: Add FormErrorAdapter service, configurable using an injection token APP_FORM_ERROR_I18N_KEYS
-- enh: Add pipe 'translateFormError' to translate form error in HTML template
-
-
-## 0.26.0
-
-- enh: Rename FormErrorAdapter into FormErrorTranslator
-- enh: Add FormErrorTranslator to AppForm
-- enh: Add directives [matBadgeIcon] and [ionBadgeIcon] to use icon within a matBadge
-
-## 0.27.0
-
-- enh: Split `AppTabEditor` into `AppEditor` and `AppTabEditor`
-- enh: Add `markAsReady()` to base components (`IAppForm`, `AppForm`, `AppTable`, `AppEditor`)
-- enh: Add `ready() => Promise` to base components (`IAppForm`, `AppForm`, `AppTable`, `AppEditor`)
-- enh: `AppEntityEditor`: wait components is ready, before calling `setValue()`
-- enh: `waitFor()` now return a `Promise<void>` (instead of a `Promise<any>`)
-
-## 1.0.0
-
-- enh: Store local settings remotely 
-- fix: Fix suggestFromArray when items is null
-- fix: Fix parsing error, in GraphQL service (e.g error from Oracle database)
-
-## 1.2.5
-
-- fix: Install/Upgrade component: can now download file, on Android devices
-
-## 1.5.1
-
-- enh: MatAutocompleteField: set header position has sticky, in CSS
-- enh: MatAutocompleteField: if mobile, set autocomplete panel's position to 'above' (instead of 'auto') because keyboard should open at the bottom
-- fix: AppForm: add method 'unregisterSubscription()'
-- fix: Account: disable form when offline
-
-# 1.5.6
-
-- enh: Add observables.waitForTrue() function
-- enh: Editor: apply ready() opts (timeout, dueTime)
-- fix: suggestFromArray: fix sorting
-
-# 1.5.8
-
-fix: When deleting rows selection, make sure to confirm edited row first
-
-# 1.6.4
-
-enh: EntitiesTableDateSource: Add 'fetchMore()' function (usable when dataService fill LoadResult.fetchMore)
-fix: Auth modal: show error (e.g. when bad credentials)
-fix: MatChipsField: rename 'compareWith' in 'equals'
-enh: MatChipsField: Allow setup chips color
-fix: MatSwipeField: rename 'compareWith' in 'equals'
-
-# 1.6.5
-
-fix: MatChipsField: Fix 'focusOut' then 'focusIn' behavior
-fix: MatAutocompleteField: Fix 'focusOut' then 'focusIn' behavior
-
-# 1.6.18
-fix: MatDateTimeField: Fix when no Keyboard plugin
-
-# 1.7.0
-
-enh: Add directive `*ngVar` - see https://stackoverflow.com/questions/38582293/how-to-declare-a-variable-in-a-template-in-angular
-
-# 1.8.1
-
-enh: IEntityService: add new function `canUserWrite()`
-enh: AppEntityEditor: add a default implementation of `canUserWrite()`
-
-# 1.9.5
-
-enh: AppTable: Add injector in constructor
-fix: Platform: detect window touchscreen as NOT mobile
-fix: AppEntityEditor: make sure to unsubscribe listen remote changes, when destroy
-fix: Home: fix layout, of card close button, in history items
-fix: Make sure to use LocalSettingsServicesettings.mobile instead of PlatformService.mobile
-enh: Account: auto start listen changes on pod, during the user session
-
-# 1.10.1
-
-fix: AppTable: Fix table row deletion, when editedRow is invalid and not saved yet - fix issue IMAGINE-669
-
-# 1.10.9
-
-fix: AppTable: Fix table when calling save with options : `keepEditing=false`
-
-# 1.11.0
-
-enh: Add component UploadFilePopover
-enh: Add component TextPopover
-enh: Upgrade to @apollo/client 3.5.10
-
-# 1.12.1
-
-fix: searchTextFilter: escape special characters to avoid RegExp parse exception
-enh: Autocomplete: Move result count in footer
-
-# 1.12.4
-
-fix: AppTable: Avoid deleting a row twice, when deleting an invalid row BUT not editing 
-
-# 1.12.13
-enh: Add pipes formGet, formGetControl and formGetArray, to get a form controls
-enh: Add pipe strIncludes
-
-# 1.13.0
-enh: Add utility class SharedAsyncValidators
-enh: Add SharedAsyncValidators.registerAsyncValidator() to add long during validation job
-fix: BaseEntityService: listenChanges() now return an empty observable, when not implemented, instead of error
-fix: InstallUpgradeCard: do not show install link, on Windows touch screen
-
-# 1.14.0
-enh: Platform: auto reload web browser's page, if a new version is detected at startup
-# 1.14.2
-enh: Add DateUtils.resetTime(date, tz?: string) 
-
-# 1.15.0
-fix: MateDateField: make sure to display errors
-fix: MateDateField: Allow to show matPrefix (e.g. icon)
-fix: MateDateField: Better management of mat-error
-fix: MateDateTimeField: Add error for dateIsBefore
-enh: SharedValidators: add new validator 'dateIsBefore'
-
-# 1.15.1
-fix: MateDateField: Add a timezone to serialize/deserialize date value
-
-# 1.15.4
-enh: MateDateField: Add an input 'datePickerFiler' to filter dates in picker
-enh: MateDateTimeField: Add an input 'datePickerFiler' to filter dates in picker
-
-# 1.15.9
-fix: Editor listenChanges() should not update the cache, but call reload() when changes detected.
-      This will allow fetching partial graph in subscriptions
-enh: Editor: show a toast when remote changes are detected
-fix: Cache: minor fix
-
-# 1.15.13
-fix: File upload component: fix file/event management
-enh: Add new pipe 'formGetGroup:<name>'
-
-# 1.16.0
-enh: Refactor JobUtils functions: 'progression' is now optional, and hold by options
-
-# 1.17.0
-fix: GraphQL: set NetworkStatus.error on error object in order to throw corresponding exception
-
-# 1.17.1
-fix: Hotkeys: Prevent global hotkeys when popover component exists
-
-# 1.18.0
-enh: Autocomplete field: Add search bar on mobile
-fix: Autocomplete field: Fix style when multiple=true
-fix: Autocomplete field: Fix default displayWith when multiple=true (manage array value)
-fix: Exclude Windows from the platform mobile detection 
-
-# 1.18.4
-fix: Autocomplete: fix search in mobile searchbar
-enh: Material field components: allow to set 'required' as empty tag, and not only '[required]=true'
-
-# 1.18.4
-fix: Autocomplete: fix panel width, on small screens
-
-# 1.18.7
-fix: fix DateUtils.min() and DateUtils.max() 
-
-# 1.19.0
-enh: Add a MessageModal, to compose message to users (internal or email messages)
-fix: MatDateField: if not required, manually set a date will not apply the value to formControl
-
-# 1.19.1
-fix: Platform detection failed (infinite loop) on MacBook
-
-# 1.19.2
-fix: Platform detection cache
-
-# 1.19.3
-enh: AppForm now wait form not pending, before emitting onSubmit event
-
-# 1.19.6
-fix: Fix toolbar back button
-fix: Autocomplete: Fix multiple values (displayValue was no shown)
-fix: Autocomplete: avoid to many call to suggest, on mobile
-fix: Autocomplete: use mat-option for searchbar, to have selected option is visible
-fix: Install APK: make sure to have '.apk' at end of filename
-fix: Auth modal: keep modal into loading, when waiting server response
-enh: Create a specific card for offline mode update 
-fix: Entity storage: do NOT set skipIfPristine to false, when storage keep non local entities (e.g. OperationVO)
-enh: Entity storage: persist() has a new option skipIfPristine, to be able to force all data to be stored, even if not dirty
-
-# 1.19.7
-enh: Add pipe 'formGetValue' that will listen value changes (from a form or a control)
-
-# 1.19.16
-fix: Date and Date Short field: optimize <mat-error> with a switch/case
-fix: Lat/Long pipes: remove provider in root (not need on a pipe)
-fix: SharedValidators: rename 'double' validator into 'decimal'. Now return an error 'decimal' when opts.maxDecimals is nil  
-
-# 1.19.18
-fix: Add a workaround to patch <html> class to 'plt-desktop', on Windows touch screen (fix sumaris-app issue #346)
-enh: EntitiesStorage: detect platform pause, to force saving the storage
-
-# 1.19.23
-fix: Menu: avoid to many call of onLogin() function (add a distinctUntilChanged() filter)
-fix: MateDateTime: set required validator using template, and no more by overriding formControl.validator (allow to change the required value)
-fix: EntityEditor: wait end of saving, in waitIdle() function
-fix: EntityEditor: add debug log when changing/updating route
-fix: EntityEditor.load(): rename the unused options 'updateTabAndRoute' into 'updateRoute'
-fix: EntityEditor.load(): allow to reset to the first tab (e.g. when load another entity into an existing editor)
-
-# 1.19.23
-fix: Editor: allow to skip page history (computePageHistory can return 'undefined')
-
-# 1.19.25
-fix: Home: translate 'Loading...' message
-
-# 1.19.28
-enh: Add function escapeRegExp() to escape all special regexp characters
-
-# 1.19.30
-enh: Add argument to pipe 'formGetValue' to listen status change (e.g. to force update, when emitEvent: false) 
-
-# 1.20.0
-
-enh: Menu: allow to enable/disable menu
-enh: Menu: rename MenuService.menuVisible$ into MenuService.splitPaneWhen
-
-# 1.20.2
-
-enh: Material fields: add @Input() appearance 
-
-# 1.20.3
-enh: css-variables-to-root-mobile() will expose variables '--mat-tab-link-height' and '--mat-tab-bar-height' 
-
-# 1.20.4
-enh: Add helper class CsvUtils
-enh: Add pipe formatProperty
-enh: Add directive [appAutoTitle] for <ion-label> or <mat-label>
-
-# 1.20.5
-enh: formatProperty pipe: when type is 'boolean', display a translated Yes/No  
-
-# 1.20.7
-enh: add function FileUtils.writeTextToFile()
-
-# 1.20.11
-enh: add function FileUtils.downloadUri()
-
-# 1.20.13
-fix: fix SharedValidators.decimal() when maxDecimals = 3 (cached regexp was wrong)
-
-# 1.20.14
-fix: Menu: Force menu update when config changed
-
-# 1.20.16
-fix: MatChipsField: fix chip height
-
-# 1.20.17
-fix: Add module ResizableModule, for MatTable column resize
-
-# 1.20.18
-fix: PlatformService.download() now useFileUtils.download(), that create a temp download (not need browser permission to open popup) 
-
-# 1.20.19
-enh: Add new abstract class AppEntityEditorModal, that can managed many forms and tables
-
-# 1.20.20
-fix: SCSS: remove `user-select: text !important` applied on body, because of modals ViewEncapsulation.None (e.g. physical gear modal) where Tab label were becomes focusable
-
-# 1.20.21
-fix: Fix mat latlong field: was broken since v1.19.13
-
-# 1.20.21
-fix: Fix MatDateField mat-error display (was too large)
-
-# 1.20.24
-fix: Revert change on LatLongField (SCSS file was removed ??)
-
-# 1.20.25
-fix: MatBooleanField: set indeterminate=true, when value is null
-
-# 1.20.27
-
-fix: Mat***Field: add `@Input() appearance` 
-
-# 1.20.30
-fix: Add InMemoryDataService.hiddenCount 
-
-# 1.20.33
-fix: MatAutocompleteField: reload items when cleaning text, and no suggestLengthThreshold
-
-# 1.20.34
-fix: AppTable: remove 'opts.skipIfLoading' on delete functions, to use only 'opts.interactive' to force deletion when table is busy. 
-
-# 1.21.0
-enh: AppForm: use public behavior subjects: readySubject, loadingSubject, errorSubject
-
-# 1.22.0
-enh: Add social components: UserEventNotification and JobProgression
-
-# 1.22.1
-enh: Menu: add APP_MENU_OPTIONS token, to configure menu (e.g. show notification icon in the left menu header)
-
-# 1.22.9
-enh: Remove <app-user-events-table> (move to specific sub projects that use ngx-components)
-
-# 1.22.11
-enh: Rename <app-user-event-notification-component> into <app-user-event-notification-icon>
-
-# 1.22.12
-enh: Can mark a Moment without time, allowing empty time field in MatDateTime
-
-# 1.23.6
-fix: Many fix in table. Upgrade to ngx-material-table 0.12.0
-enh: Table, Form and Editor: Add a destroySubject
-enh: Observables functions first***Promise() : add more options (timeout or stop notifier)
-
-# 1.23.10
-enh: Autocomplete: add a 'title' property on each option, on desktop screen 
-
-# 1.23.11
-fix: Memory Data service: now implement IStartableService
-enh: StartableService: use a stopSubject, to stop waitFor promise
-enh: remove unused class EntitiesService. Use IEntitiesService instead 
-
-# 1.23.26
-enh: Add new pipe 'arrayJoin'
-enh: 'arrayPluck' pipe: allow to use string[] for path
-enh: getPropertyByPath() function now allow to use string[] as path
-
-# 1.23.29
-enh: FormArrayHelper: add setValue() to resize the FormArray, then set value 
-
-# 1.23.30
-fix: InMemoryDataService: do NOT apply default sortReplacement id -> rankOrder 
-
-# 1.23.31
-fix: InMemoryDataService: change 'dirtySubject' as public property 
-
-# 1.23.39
-enh: Add FormArrayHelper.patchValue() : clear array, then push each value
-fix: StartableService: avoid to log error when stopped 
-
-# 1.23.41
-enh: AppEditor: Add 'loaded' getter 
-
-# 1.23.44
-enh: Referential model: add a 'icon' property (IconRef)  
-
-# 1.23.46
-enh: Add `ColorScale.getValueColor(): Color`  
-enh: EntityEditorModal: rename input `isNewData` into `isNew` 
-
-# 1.23.51
-Observables: function `waitFor()`, `waitForTrue()`, `watForFalse()`, `firstNotNilPromise()`
- - fix: Make sure `takeUntil` is always the last operator (avoid memory leak) 
- - enh: Observables: Allow set option.stopError with custom error message
- - enh: Observables: Create the Error outside the observable, to keep the original stack trace readable  
-
-# 1.23.61
-- fix: Boolean field: fix button layout
-
-# 1.23.65
-- enh: Add pipes: isNotNil and isNotNilOrNaN
-
-# 1.23.67
- - fix: Rename DateFormatPipe into DateFormatService (DateFormatPipe is no more a provider)
- - fix: Fix patterns in DateFormatPipe/Service : add a fallback when translate service is not started - fix issue sar-app #28
-
-# 2.0.0
- - enh: Migration to 
-   - Angular 14.2
-   - Ionic 6.2
-   - Angular Material Table 0.14.4 (allow to use async validator for rows)
-   - Apollo 3, graph-ws 5 
- - enh: Add <app-debug> component
-
-# 2.1.0
- - enh: Add new class AppFormArray with all functions of FormArrayHelper
- 
-# 2.2.1
- - fix: FormArrayHelper and AppFormArray: Apply the parent disabled state, in added controls, when calling resize() or patchValue()
- - fix: FormArrayHelper.getOrCreateArray(): Apply the parent form disabled state, in added FormArray
- - fix: MatChipsField: fix loading spinner freeze
-
-# 2.2.3
-- enh: Test Geolocation.getCurrentPosition() in the lat/long field test page
-
-# 2.2.4
-- fix: Fix DateUtils.isSame(), when first argument is nil, but the second not
-- enh: AppTable: allow to call deleteSelection with opts (e.g `{interactive: false}`)
-
-# 2.2.6
-- fix: Refresh menu on any account changes (login changes - eg. when account updated) 
-
-# 2.2.8
-- fix: Table actions column: add CSS variable to set column width, min-width and max-width
-
-# 2.3.7
-- fix: Mat form field: use inherit font size (do not force font-size, in the theme) 
-- fix: MatDateShort: fix behaviour for Angular 14
-
-# 2.4.0
-- Breaking change: ProgressBarService and HTTP_INTERCEPTORS no longer provided in SharedModule (see: AppModule)
-- enh: Make ProgressBarService fully optional (InjectionToken: APP_PROGRESS_BAR_SERVICE)
-- enh: Settings: the settings object is now stored in json format
-
-# 2.4.1
-- fix: AppFormArray: do not resize the array when patchValue() receive `undefined` value (e.g. useful when called by parent, recursively, without value)
-- fix: AppAsyncTable: optimize markAsUntouched()
-
-# 2.4.2
-- enh: Graphql service: add new token `APP_GRAPHQL_FRAGMENTS` to register fragments, and avoid redeclaration in queries (see https://github.com/apollographql/apollo-client/pull/9764#issuecomment-1329857853)
-
-# 2.4.3
-- fix: AppFormArray: do not resize the array when patchValue() receive `null` or `undefined` value (same behavior as official `FormArray.patchValue()`)
-
-# 2.4.4
-- fix: Applying environment defaultLocale, when settings data has no locale (merge some code from lpecquot, that was in a branch)
-
-# 2.4.9
-- fix: Settings: allow to store settings as string (like < 2.4.0) using an injection token
-
-# 2.4.10
-- fix: When detecting a app update, stop the check timer to avoid to many toast to be displayed
-
-# 2.4.14
-- enh: add function `setPropertyByPath()`
-- fix: Implement `EntityUtils.getPropertyByPath()` using generic shared function `getPropertyByPath()` 
-
-# 2.4.15
-- fix: Fix pipes formGetControl, formGetValue, formGetGroup : when using a path, return nil if control not found, and NOT the form itself 
-
-# 2.4.16
-- fix: `SharedModule.forRoot()`:  make environment optional, to be defined it in the `app.module.ts` (need by Quadrige App)
-
-# 2.4.17
-- fix: MatLatLongField: remove strict character regexp, in degrees part, to be able to set only one digit (e.g. `9°`)
-
-# 2.4.18
-- fix: MatDateShortField: fix control validation, in desktop mode
-
-# 2.4.19
-- fix: MatAutocompleteField: revert the cdk overlay position, when closing the mat-select panel
-
-# 2.4.23
-- enh: Add DateUtils.markTime(), to reset the 'no time' marker
-- enh: Add DateUtilsEntityEditor: simplify updateTabAndRoute()
-- enh: Add DateUtilsEntityEditor: updateRoute() now manage queryParams change, before /new to /:id transition 
-- enh: Toolbar: goBack() return a boolean
-
-# 2.4.25
-- enh: Environment: add a boolean option 'sameUrlPeer', to force network to start on peer at the same URL
-- enh: EntityEditor: allow to listen changes on local entity
-- enh: add functions collectByProperty() to split an array in a map of array
-
-# 2.4.26
-- fix: Rename pipe 'isNotOnField' by 'isOnDesk'
-
-# 2.4.28
-- enh: TranslateContext: allow to translate many keys (string[])
-- fix: Force ngx-quicklink to 0.3.0
-
-# 2.4.31
-- enh: Add JsonUtils.parseFile()
-
-# 2.4.33
-- enh: Add AppPropertiesForm.length
-
-# 2.4.48
-- fix: Fix highlight pipe (used by autocomplete field)
-
-# 2.4.50
-- enh: Add type 'enums' for AppFormField
-
-# 2.4.54
-- enh: Use NavController by default, instead of Angular router. This will use the default animation style of the OS
-
-# 2.4.55
-- fix: Editor: Disable animation, when reloading same page after saving
-
-# 2.4.58
-- enh: Add storage explorer (with log preview)
-- enh: Add debug service (to send debug data to server)
-- enh: Add logging service
-
-# 2.4.61
-- enh: Add logger on network service
-
-# 2.4.67
-fix: Minor fix (add missing i18n)
-fix: GeolocationUtils: add many useful functions, and detect Capacitor errors (from message)
-fix: Fix some issues in storage explorer
-
-# 2.4.74
-enh: LocalSettingsService: save changes in local storage, when calling setProperty()
-
-# 2.4.75
-enh: SharedValidator: add a precision validator
-
-# 2.4.79
-fix: ImageGallery: fix add button icon (center alignement)
-
-
-# 2.4.81
-fix: AppToolbar: allow to use ion-segment in app-toolbar
-
-# 2.4.82
-enh: Migrate to Ionic 7
-fix: Form field: show the clear button, when clearable=true, on types 'integer', 'double', 'string', 'date' and 'date-time'
-
-# 2.4.82
-enh: AppEntityEditor: add get/set for autoOpenNextTab
-
-# 2.4.87
-fix: AppEntityEditor: When reload the editor, force the fetch policy to 'network-only' 
-
-# 2.4.88
-fix: AppInstallUpgradeCard: Installation APK link are not visible - fix issue [sumaris-app#445](https://gitlab.ifremer.fr/sih-public/sumaris/sumaris-app/-/issues/445) 
-
-# 2.4.88
-enh: Add protected BaseEntityService.getLoadQueryNames()
-
-# 2.4.89
-fix: Fix Autocomplete searchbar value trigger, after ionic 7 update
-
-# 2.4.90
-fix: AppEntityEditor: when catch error in save(), set the selectedTabIndex=0 before calling setError()
-This will allow subclasses to override the default selectedTabIndex after an error occur, inside the overridden setError()
-
-# 2.4.91
-enh: functions: allow to use sort(array) without the 'attribute' argument (e.g. allow to sort a string[]) 
-
-# 2.4.95
-fix: Platform: avoid error at startup, because of StatusBar in web mode
-enh: MatBooleanField: display value when disabled, instead of 'empty' 
-
-# 2.4.112
-enh: AppBadge: allow to set a text or number content
-
-# 2.4.114
-enh: Menu: allow to add sub menu item
-
-# 2.4.158
-enh: Environment: add useHash property to configure Angular router to use hash URL (need by web-ext)
-
-# 2.5.0
-- enh: Add token APP_USER_SETTINGS_OPTIONS of type UserSettingsOptions to add user properties table in AccountPage
-- fix: MatBooleanField: in checkbox style, the placeholder can be shown as expected
-
-# 2.6.0
-- enh: Account: Add User tokens (table and modal)
-
-# 2.6.23
-- fix: Fix Configuration.getPropertyAsNumbers() when no value (avoid to get an array with an unique NaN value)
-
-# 2.6.25
-- enh: Upgrade to nodejs 18
-- fix: Menu: hide spacer divider ion-label (hide the skeleton)
-
-# 2.6.28
-- fix: ImageGallery: Change image's title background color
-
-# 2.6.31
-- fix: ImageGallery: Add output event when after editing title
-
-# 2.6.32
-- fix: AppFormArray: Avoid an infinite loop, when calling resize(0) if options.allowEmptyArray=false
-- fix: Table, Form, Editor: fix error when markAsLoaded() on closed BehaviorSubject
-- fix: Table, Form, Editor: Make sure waitIdle() will stop, when component is destroyed (force default opts) 
-
-# 2.6.34
-- enh: functions: add a static function `underscoreToChangeCase()` 
-
-# 2.6.35
-- fix: Settings: Add type for property `OfflineFeature.filter`, then use it to in `LocalSettingsService.getOfflineFeatures()`
-
-# 2.6.38
-- fix: Fix mapGet pipe, when key is zero (0)
-
-# 2.6.39
-- enh: table: Add an input `style: 'table'|mat-table` into `<app-actions-column>`, to be usable inside a `<table mat-table>` (using `<td>`) or `<mat-table>` (using `<mat-cell>`) 
-
-# 2.8.0
-- enh: `IAppForm<T>` : add a type `<T=any>`
-- enh: `IAppForm` : add optional functions `setValue()`, `patchValue()`, `resetValue()` and `getValue()`
-- fix: `AppForm` and `AppEditor`: Remove unused and deprecated properties `_loading`, `_$ready`, `_$loading`
-- fix: `AppForm` : rename `_enable` as `enabled` to avoid confusion with `enable()`
-- enh: Add abstract class `AppFormContainer` to manage many `IAppForm` - and use it as a super class of `AppEditor`
-- enh: Add new pipes for SelectionModel : 
-  - `isSelected`: e.g. `selection | isSelected: row`,
-  - `isEmptySelection`: e.g. `selection | isEmptySelection`
-  - `isNotEmptySelection`: e.g. `selection | isNotEmptySelection`
-  - `selectionLength`: e.g. `selection | selectionLength`,
-  - `isMultipleSelection`: e.g. `selection | isMultipleSelection`,
-- enh: Add new pipes for table :
-  - `isAllSelected`: e.g. `table | isAllSelected`,
-  - `isNotAllSelected`: e.g. `table | isNotAllSelected` 
-
-# 2.8.1
-- enh: Add a pipe `badgeNumber` to limit badge content when > `99` (will display `99+`) 
-- enh: function setPropertyByPath() now return the input obj
-- fix: Referential: fix `asObject()`
-- enh: Add options: 
-  - `sumaris.defaultLatLongFormat.enabled` to show/hide default Lat/Lon setting in account page (default is true)
-  - `sumaris.auth.api.token.scope.enabled` to show/hide scopes in API token table (default is false)
-  - `sumaris.auth.api.token.scope.default` set the default scope for new API token, mandatory if `sumaris.auth.api.token.scope.enabled` if false (default is 'read_api')
-- enh: Add AppRowField component: wrap an AppFormField into a table column
-- enh: Add pipe `valueFormat` to format a value with a FormFieldDefinition (equivalent to pipe `propertyFormat`)
-- fix: `UploadFileComponent` Refactored 
-- enh: Add new config options to override the form field background color (active, focus or disabled)
-- enh: Add new pipe `booleanFormat`
-- enh: Update pipe `propertyFormat` to use complex path (using `getPropertyByPath()`)
-- enh: Add static functions `CsvUtils.getLocalizedEncoding()` and `CsvUtils.getLocalizedSeparator()`
-- enh: Add static function `JsonUtils.getLocalizedEncoding()`
-
-# 2.8.2
-- enh: Function `getPropertyByPath` now handles the optional chaining operator `(?.)`
-- enh: Add `AccountService.onWillLogout` emitter
-- fix: Table: Call `emitRefresh()` instead of `onRefresh.emit()` to safely emit to an opened Observable 
-
-# 2.8.3
-- enh: Add support of `<mat-hint>` in MatDateTime, MatDate, MatDateShort, MatAutocompleteField and MatLatLongField
-- enh: Add `DateUtils.compare` to be able to sort dates (using Array `sort()`)
-- enh: Add function `resizeArray(T[], size): T[]`
-- fix: NamedFilter: Abort import if callback returns null or undefined
-- fix: DataSource: Allow to refresh datasource (using `watchAll()`) when having dirty row 
-
-# 2.8.4
-- enh: MatBooleanField: add `@Input() clearable` (default to `false`)
-- fix: MatBooleanField: when resetting value, hide radio buttons
-
-# 2.8.11
-- fix: MatBooleanField: hide checkbox's placeholder when floatLabel=never 
-
-# 2.8.12
-- enh: Pipe `referentialToString`: add new option `propertySeparator` to override the default ' - ' separator  
-
-# 2.8.13
-- enh: AsyncTable: make `setFilter()` async
-
-# 2.8.14
-- enh: Upgrade to ngx-material-table 17.2.1 (add options to TableElement `delete()`, `cancelOrDelete()` and `confirmEditCreate()`)
-
-# 2.9.0
-- enh: Upgrade to Angular 17.3
-- fix: Replace zone.js `setTimeout()`, by rx-angular zone-less
-- fix: IFormControlPathTranslator : Rename interface IFormControlPathTranslator into IFormPathTranslator, and rename property `controlPathTranslator` into `pathTranslator`
-- fix: Remove deprecated validator `SharedValidators.double` (was renamed into `SharedValidators.decimal`)
-- fix: AppAsyncTable: re add `@Input() get filter`
-- fix: AppTable: clear selection when opening a row (like AppAsyncTable)
-- fix: MatAutocompleteField: Add `@Input() panelClass` (same as `class`)
-- fix: MatAutocompleteField: Allow boolean inputs from string (using `@Input({transform: booleanAttribute})`) 
-- fix: MatAutocompleteField: add `panelWidth` and `panelClass` to `MatAutocompleteFieldConfig`
-
-# 2.9.1
-- fix: MatAutocompleteField: revert `applyImplicitValue` default value `true`
-- fix: MatChipsField: fix usage of `suggestLengthThreshold` 
-- enh: MatChipsField: add `applyImplicitValue` (default: false)
-
-# 2.9.2
-- fix: Notification list: add an ion-text-wrap to the notification message
-
-# 2.9.3
-- fix: Home: Add a call to `markForCheck()` after removing a page history item
-
-# 2.9.4
-- fix: Form: reduce line height of row label (form-container > ion-row > ion-col > ion-label) 
-
-# 2.9.6
-- fix: MatAutocompleteField: Remove animation in searchbar (bad icon position in iOS) 
-
-# 2.9.7
-- fix: Form: fix field label position (form-container > ion-row > ion-col > ion-label) 
-
-# 2.9.8
-- enh: Add AppFormUtils.filterErrorsByPrefix() and AppFormUtils.filterErrors()
-
-# 2.9.13
-- fix: Home: when removing a page history, force settings to update
-
-# 2.9.17
-- fix: MatSelectPanel: add `--min-width: fit-content` to class `mat-select-panel-fit-content`
-
-# 2.9.20
-- enh: NamedFilterSelector: add `filterCleared` event
-
-# 2.9.22
-- enh(deps): Minor update to Angular 17.3.12
-- enh(theme): Dark theme: Move dark theme toggle into the settings form
-- enh(theme): Dark theme: Fix toggle field style, in dark theme
-- enh(settings): Add icons on each form fields
-- fix(config): When saving the remote config, do not return to the editor config's inherited properties
-
-# 2.9.23
-- fix(boolean-field): fix click on radio button 'no', when field has no value
-
-# 2.11.1
-- enh(deps): Upgrade to apollo-angular 7.1.2 and apollo 3.11 (+ fix breaking changes in graphql.service.ts)
-- fix(css): Dark theme: fix checkbox style, and autocomplete panel
-
-# 2.11.2
-- enh(app-text-form): Add new inputs `appearance` and `subscriptSizing` 
-- fix(css): Dark theme: fix style for outline field
-
-# 2.11.3
-- fix(app-text-form): Input `autoHeight` is now deprecated (use `autoSize` instead)
-- enh(app-text-form): Add new inputs `autoSizeMinRows` and `autoSizeMaxRows`
-
-# 2.11.7
-- fix(css): Dark theme: fix style
-
-# 2.11.8
-- enh(form-error): Add options to `IFormPathTranslator.translateFormPath()` 
-
-# 2.12.0
-- enh(form-error): Remove deprecated interface `IFormControlPathTranslator` 
-
-# 2.12.4
-- fix(date): Update formControl (and datePicker) when textControl value changes, and clean text input by regexp  
-- fix(date-time): Keep control as invalid is time is empty
-- enh(date-time): Add new `@Input() allowNoTime` to make time optional
-- fix(lat-long): Fix deletion, when press delete key
-
-# 2.12.7
-- fix: addShortcut handler use `KeyboardEvent` instead of a simple 'EVent'
-
-# 2.12.8
-- enh: function `toNumber()` will now return the default value, when input is `NaN`
-
-# 2.12.9
-- fix(paginator): Fix paginator style on mobile screen (align to the left, and hide page size, like before the Angular 17 migration)
-
-# 2.12.10
-- fix(autocomplete): Compute the panel width if not set (in mobile) - workaround for an issue in mat-select panel
-
-# 2.12.12
-- fix(theme): add all dark colors from material theme
-- fix(autocomplete): in mobile device, add a text-wrap and a max-height in mat-option
-
-# 2.12.13
-- fix(config): New option `sumaris.account.latLongFormat.enable` to replace the deprecated option `sumaris.defaultLatLongFormat.enabled` (key was not well named) 
-
-# 2.12.16
-- fix(autocomplete): Reload items when `showAllOnFocus = true`
-- fix(autocomplete): Use `??` operator, instead of `toBoolean()`, `toNumber()` etc.
-- enh(autocomplete): Add option `applyImplicitValue` to config
-- enh(pipe): add a `asBoolean` pipe, with an optional predicate function as option (e.g. to test any value)
-- enh(account): Allow to change password, if auth token is `token` (will update the pubkey)
-- fix(lat-long): Refactor component (remove maskito placeholder use)
-- enh(table): Add new component `<nav-actions-column>`
-
-# 2.12.19
-- fix(nav-actions-column): Fix when inside a `AppAsyncTable`
-
-# 2.12.26
-- enh(app-async-table): declare property `readonly cd: ChangeDetectorRef`
-- enh(app-async-table): implement `markForCheck()` and `detectCHanges()`
-- enh(app-table): declare property `readonly cd: ChangeDetectorRef`
-- fix(app-table): call `detectChanges()` inside `editRow()`, `addRowToTable()` and `toggleSelectRow()` - need by SUMARiS (e.g. samples tables)
-- fix(app-table): `toggleSelectRow()` should not call `event.preventDefault()` otherwise checkbox will not be checked
-
-# 2.12.27
-- enh(app-table): implement `markForCheck()` and `detectChanges()`
-
-# 2.12.29
-- fix(new-token-modal): Add a full form and fix save issue
-
-# 2.12.30
-- enh(platform): Add copy to clipboard return state
-
-# 2.12.29
-- fix(new-token-modal): Add a full form and fix save issue
-
-# 18.0.0
-- enh(deps) Upgrade to Angular 18.2.8 and Ionic 8.3
-- enh(deps) Remove zone.js (enable experimental zone-less config)
-- enh(app-properties-form): Use an autocomplete field to select an option, instead of a simple mat-select 
-- enh(app-properties-form): Add `@Input() showHintKey: boolean` to show option key (has a hint)
-- enh(network-service): Avoid to restart the service if peer has not changed
-- enh(AppFormArray): allow to use AppFormArray on any type (and not only Entity has before)
-- enh(AppFormUtils) add useful static functions to enable/disable control(s)
-- enh(mat-autocomplete-field): add option `selectInputContentOnFocus` to option, to select the input content on focus in
-- enh(app-named-filter-selector): Add `@Input() buttonsPosition: 'matSuffix'|'after'` to let user defined button position (inside the field, or after)
-- fix(AppForm and AppFormContainer) log error using the child path (if defined using `addForm()`)
-- fix(graphql) Fix pod error in JSON format, before parsing it (e.g. Oracle can return error on multiple lines) 
-- fix(nav-actions-column): Use `OnPush` changeDetection
-- fix(app-form-field): Emit `(keyup.enter)` event, when field's type is `double`
-
-# 18.0.5
-- enh(mat-autocomplete-field): 
-  - Change type of `MatAutocompleteFieldConfig.suggestFn` to use SuggestFn<T, F> (allow to pass more options - e.g. used to resolve entity in AppPropertiesUtils)
-  - Add `@Input() label`
-  - Add `@Input() hideRequiredMarker`
-- enh(app-form-field):
-  - Add `@Input() hideRequiredMarker`
-  - Fix the style when readonly and type `enum`
-  - interface `FormFieldDefinition`: Add property `serializeAttribute?: string` (instead of using autocomplete.filer.joinAttribute)
-  - add a static function `FormFieldDefinitionUtils.prepareDefinitions()` to resolve enum values, by `InjectionToken`
-- enh(app-properties-form): 
-  - Entity/Entities are now resolved from helper class AppPropertiesUtils
-  - Allow to change add button title
-  - Resolve enum item, when using InjectionToken for values
-- enh(shared) Add decorators `@RxStateRegister()` `@RxStateSelect()` and `@RxStateProperty()` to connect property to a `RxState`
-- fix(properties-utils): Add `opts?: {keepOrphan?: boolean}` to `AppPropertiesUtils.arrayFromObject` to be able to remove property without definition (`keepOrphan` is `true` by default)
-- fix(token-table): Fix error when no scopes defined (InjectToken `APP_USER_TOKEN_SCOPES` should be optional) 
-
-# 18.0.6
-- fix(scss): set flex-wrap to nowrap
-- enh(autocomplete-test): add test case with a button
-- fix(logout) Logout should be done AFTER home redirection, because of cache clearing - see issue #5
-
-# 18.0.7
-- fix(hotkeys) Fix default platform control key ('meta' on iOS)
-
-# 18.0.8
-- fix(hotkeys) Avoid to open many help modal
-- fix(hotkeys) Skip open help modal, if nothing to display
-- fix(form-buttons-bar) Fix shortcuts for iOS
-- fix(modal-toolbar) Fix shortcut for iOS
-
-# 18.0.9
-- fix(mat-latlong-field) Mark control as dirty, when text control changed
-- fix(about) Fix missing markdown module, to display config description
-- enh(about) Allow to override the "report an issue" link, using a config option `sumaris.reportIssue.url` 
-
-# 18.0.10
-- enh(utils) Add static functions `isFirefox()`, `isSafari()` and `isEdge()` to test user agent
-- enh(utils) Add static functions `EntityUtils.collectIds()` and `EntityUtils.splitById()`
-- fix(utils) Mark function `EntityUtils.collectById()` as deprecated (in flavor of `EntityUtils.splitById()`)
-
-# 18.1.0
-- enh(deps) Upgrade to angular 18.2.11 and other deps
-- fix(deps) move maildev library into dev dependencies
-
-# 18.1.1
-- enh(deps) Update angular-eslint to 18.4.0
-
-# 18.1.2
-- enh(deps) Revert to Ionic 7.8.6
-
-# 18.1.3
-- fix(settings) Add static function `isOnFieldMode()`
-- fix(menu) Make unpinned menu works, when reload app (F5) with a pinned menu 
-
-# 18.1.4
-- fix(tab) Keep default tab label style (e.g. min-width) when stretch tabs is enabled
-- fix(tab) Reduce tab label padding, on small screen
-
-# 18.1.7
-- enh(AppFormArray) Add `clone()` function
-
-# 18.2.0
-- enh(base-entity-service) Allow opts.toEntity to be a function (e.g. to be able to transform each element, also when fetching more items)
-- fix(graphql-service) Allow `opts.update` to use new Apollo type `MutationUpdaterFunction` (type `MutationUpdaterFn` is deprecated)
-
-# 18.2.6
-- fix(autocomplete-field) Fix arrow drop icon position, when mobile
-- fix(autocomplete-field) Use desktop arrow drop icon, when multiple and desktop
-- fix(BaseEntityService) simplify functions `fromObject()` and `fromObjects()` (move `toEntity` argument into `options`)
-- enh(services) Allow `suggestFromArray()` to search using `?` as wildcard (=match one character) in the search text
-- enh(HighlightPipe) Allow to use the character `?` as wildcard (=match one character) in the search text
-- enh(functions) Allow `suggestFromStringArray()` to search using `?` as wildcard (=match one character) in the search text
-- enh(shared) New helper class `RegExpUtils`
-
-# 18.2.7
-- enh(autocomplete-field) Add `@Input() selectInputContentOnFocusDelay` - workaround when input text selection is overridden by another event (e.g. see in SUMARiS, in the calendar component)
-
-# 18.2.9
-- enh(autocomplete-field): Add `@Input() reloadItemsOnFocus` : Reload items when focused, necessary if filtered items depends on an external source (e.g. see in SUMARiS, in the calendar component)
-
-# 18.2.11
-- enh(DateUtils): Add `DateUtils.diffAbs()` to compute duration between two dates
-
-# 18.2.19
-- enh(timepicker) MatDateTime : Migrate timepicker to new library Ngx Mat TimePicker (fix animation, cancel button, Angular 17 compatibility, etc.)
-
-# 18.2.21
-- enh(functions) Rename `selectInputContent` into `selectInputContentFromEvent`, and make `selectInputContent` that only use an <input> as argument
-- enh(autocomplete-field) Add `@Input() clearInvalidValueOnBlur: boolean` to reset the field when typing invalid search text (no match or no many matches)
-- fix(swipe-field) Fix swiper previous/next arrows
-
-# 18.2.23
-- enh(validators) add option skipIfNoTime to dateRange
-
-# 18.2.24
-- enh(pipe) add new pipe `isValidDate` with option `requiredTime` (to test date with noTime flag)
-
-# 18.2.26
-- enh(select-peer-modal) Allow to search on peers modal
-- enh(select-peer-modal) Allow to select peer by features (aka programs) - should set `enableSelectPeerByFeature: true` in the environment token (disabled by default)
-
-# 18.2.28
-- fix(mat-boolean-field) Small refactoring + simplify blur detection, using standard Angular outputs
-- enh(mat-latlong-field) Refactor the component, to use separate inputs (instead of using Maskito)
-- fix(entity-store) setEntities() should mark all entities as dirty, when id mode is enabled (because an optimization in `persist()` that skip pristine entities)
-
-# 18.2.29
-- enh(validators) add opts to dateMaxDuration to skip date with NoTime
-- fix(mat-boolean-field) Fix buttons layout (padding) to be same as sumaris QV pmfm buttons
-
-# 18.2.30
-- fix(forms) Fix error `TypeError: Cannot read properties of undefined (reading 'setControlEnabled')`
+# Change log
+
+## 0.1.7
+
+- enh: Menu: Allow dynamic insertion, using a new config options (see 'CORE_CONFIG_OPTIONS.MENU_ITEMS')
+  * Example: 
+  ```js
+    const options = [
+      // Insert before'MENU.HOME'
+      {title: "Item #1", path: "/settings", icon: "people", before: "MENU.HOME"},
+  
+      // Insert after 'MENU.HOME'
+      {title: "Item #2", path: "/settings", icon: "people", after: "MENU.HOME"}
+    ];
+    config.properties[CORE_CONFIG_OPTIONS.MENU_ITEMS.key] = JSON.stringify(items); 
+  ```
+  Values of 'after' and 'before' will be compared with `title` of existing items.
+
+## 0.3.3
+
+- enh: CSS `.filter-panel` should be used with `.filter-panel-floating` to enable floating position
+
+## 0.3.4
+
+- fix: Users table: use floating filter panel
+
+## 0.3.5
+
+- enh: Add new pipe `arrayFilter` to be able to filter an array, in HTML templates
+
+## 0.4.0
+
+- enh: CSS: change style of error row (use warning color)
+- enh: CSS: new class '.visible-dirty' (e.g. `<ion-icon name="star" class="visible-dirty"></ion-icon>` in the `actions` column)
+- enh: ValidatorService: add function getI18nErrors(control)
+- enh: AppTable: add outputs 'onDirty', 'onError'
+- enh: AppTable: 
+
+## 0.4.1
+
+- enh: Add new component 'app-actions-columns'
+
+## 0.4.2
+
+- enh: LoadResult class: Add a `fetchMore()` function
+- enh: Autocomplete field: Add infinite scroll, using `LoadResult.fetchMore()`
+
+## 0.4.3
+
+- enh: AppTable: add `options` (with property `interactive`) in `deleteRow()` and `deleteRows()`
+  Used to avoid user confirmation, when deletion has been confirmed elsewhere
+
+## 0.4.4
+
+- enh: Rename `<form-buttons-bar>` into `<app-form-buttons-bar>`
+- enh: Export more CSS variables: `--app-paginator-height`, `app-form-buttons-bar-height`
+
+## 0.5.0
+
+- enh: Table: allow keyboard navigation, using `<app-actions-column>` and function `table.confirmAndBackward()` and `table.confirmAndForward()`
+
+## 0.7.10
+
+- enh: Table: no more border-left, on dirty rows (because of sticky columns nightmare !)
+
+## 0.9.0
+
+- enh: Autocomplete field: add config option `suggestLengthThreshold` to suggest after typing more than x characters 
+- enh: Autocomplete field: add config option `debounceTime` 
+
+## 0.10.0
+
+- enh: Add EntityClasses class: use it to get an entity class by name (need to use @EntityClass decorator on the class)  
+
+## 0.11.4
+
+- fix: Autocomplete field: when focus out, move caret to start (fix firefox bug, when `input[type=text]` content is too long)
+
+## 0.11.5
+
+- enh: Decorator @Entity now generate the static class function `asObject(source: any, opts?: any): any`
+
+## 0.15.0
+
+- enh: Add IAppForm.loading (optional)
+- enh: Add AppForm.waitIdle()
+- enh: IAppForm, AppForm, AppTabEditor: Add markAsLoading() and markAsLoaded()
+
+## 0.18.0
+
+- enh: Add AppTable.updateView(): Promise
+- enh: Add AppTableDatasource: rename $busy into loadingSubject
+- fix: Fix InMemoryTable setValue
+- fix: AppTable: after save, refactor code to select previously edited row
+
+## 0.19.0
+
+- fix: refactor AppFormUtils.copyEntityToForm() for multiple values (split on the character '|' )
+- fix: remove AppFormUtils.copyForm2Entity() - same a form.value
+
+## 0.20.0
+
+- fix: remove functions `isArray()` (please use `Array.isArray()` instead)
+- enh: Add `AccountService.onChange: Subject` to listen account settings changes
+- fix: Account model: use minify option to serialize as a POD object
+- fix: AccountService: change some internal function's visibility, to protected 
+- fix: InMemoryService: fix equals() default implementation (avoid infinite loop)
+- fix: SCSS: Set mat-select-column to width: 50px, to make it compatible with sticky <mat-table>
+- enh: Add ComponentDirtyGuard to public API
+
+## 0.20.0
+
+- fix: AppEntityEditor: remove confirmation before backClick (use ComponentDirtyGuard instead)
+- fix: AppEntityEditor: cancel() will not ask a confirmation, because called by dirty guard). 
+
+## 0.23.0
+- fix: MatAutocompleteField: when escape event, close the panel and stop event's propagation
+- fix: AppFormButtonsBar: when escape event, make sure preventDefault!=false before emit a back event
+
+## 0.24.0
+
+- fix: AppInstallUpgradeCard: use Cordova Downloader plugin, to download APK file correctly 
+
+## 0.25.0
+
+- enh: Add FormErrorAdapter service, configurable using an injection token APP_FORM_ERROR_I18N_KEYS
+- enh: Add pipe 'translateFormError' to translate form error in HTML template
+
+
+## 0.26.0
+
+- enh: Rename FormErrorAdapter into FormErrorTranslator
+- enh: Add FormErrorTranslator to AppForm
+- enh: Add directives [matBadgeIcon] and [ionBadgeIcon] to use icon within a matBadge
+
+## 0.27.0
+
+- enh: Split `AppTabEditor` into `AppEditor` and `AppTabEditor`
+- enh: Add `markAsReady()` to base components (`IAppForm`, `AppForm`, `AppTable`, `AppEditor`)
+- enh: Add `ready() => Promise` to base components (`IAppForm`, `AppForm`, `AppTable`, `AppEditor`)
+- enh: `AppEntityEditor`: wait components is ready, before calling `setValue()`
+- enh: `waitFor()` now return a `Promise<void>` (instead of a `Promise<any>`)
+
+## 1.0.0
+
+- enh: Store local settings remotely 
+- fix: Fix suggestFromArray when items is null
+- fix: Fix parsing error, in GraphQL service (e.g error from Oracle database)
+
+## 1.2.5
+
+- fix: Install/Upgrade component: can now download file, on Android devices
+
+## 1.5.1
+
+- enh: MatAutocompleteField: set header position has sticky, in CSS
+- enh: MatAutocompleteField: if mobile, set autocomplete panel's position to 'above' (instead of 'auto') because keyboard should open at the bottom
+- fix: AppForm: add method 'unregisterSubscription()'
+- fix: Account: disable form when offline
+
+# 1.5.6
+
+- enh: Add observables.waitForTrue() function
+- enh: Editor: apply ready() opts (timeout, dueTime)
+- fix: suggestFromArray: fix sorting
+
+# 1.5.8
+
+fix: When deleting rows selection, make sure to confirm edited row first
+
+# 1.6.4
+
+enh: EntitiesTableDateSource: Add 'fetchMore()' function (usable when dataService fill LoadResult.fetchMore)
+fix: Auth modal: show error (e.g. when bad credentials)
+fix: MatChipsField: rename 'compareWith' in 'equals'
+enh: MatChipsField: Allow setup chips color
+fix: MatSwipeField: rename 'compareWith' in 'equals'
+
+# 1.6.5
+
+fix: MatChipsField: Fix 'focusOut' then 'focusIn' behavior
+fix: MatAutocompleteField: Fix 'focusOut' then 'focusIn' behavior
+
+# 1.6.18
+fix: MatDateTimeField: Fix when no Keyboard plugin
+
+# 1.7.0
+
+enh: Add directive `*ngVar` - see https://stackoverflow.com/questions/38582293/how-to-declare-a-variable-in-a-template-in-angular
+
+# 1.8.1
+
+enh: IEntityService: add new function `canUserWrite()`
+enh: AppEntityEditor: add a default implementation of `canUserWrite()`
+
+# 1.9.5
+
+enh: AppTable: Add injector in constructor
+fix: Platform: detect window touchscreen as NOT mobile
+fix: AppEntityEditor: make sure to unsubscribe listen remote changes, when destroy
+fix: Home: fix layout, of card close button, in history items
+fix: Make sure to use LocalSettingsServicesettings.mobile instead of PlatformService.mobile
+enh: Account: auto start listen changes on pod, during the user session
+
+# 1.10.1
+
+fix: AppTable: Fix table row deletion, when editedRow is invalid and not saved yet - fix issue IMAGINE-669
+
+# 1.10.9
+
+fix: AppTable: Fix table when calling save with options : `keepEditing=false`
+
+# 1.11.0
+
+enh: Add component UploadFilePopover
+enh: Add component TextPopover
+enh: Upgrade to @apollo/client 3.5.10
+
+# 1.12.1
+
+fix: searchTextFilter: escape special characters to avoid RegExp parse exception
+enh: Autocomplete: Move result count in footer
+
+# 1.12.4
+
+fix: AppTable: Avoid deleting a row twice, when deleting an invalid row BUT not editing 
+
+# 1.12.13
+enh: Add pipes formGet, formGetControl and formGetArray, to get a form controls
+enh: Add pipe strIncludes
+
+# 1.13.0
+enh: Add utility class SharedAsyncValidators
+enh: Add SharedAsyncValidators.registerAsyncValidator() to add long during validation job
+fix: BaseEntityService: listenChanges() now return an empty observable, when not implemented, instead of error
+fix: InstallUpgradeCard: do not show install link, on Windows touch screen
+
+# 1.14.0
+enh: Platform: auto reload web browser's page, if a new version is detected at startup
+# 1.14.2
+enh: Add DateUtils.resetTime(date, tz?: string) 
+
+# 1.15.0
+fix: MateDateField: make sure to display errors
+fix: MateDateField: Allow to show matPrefix (e.g. icon)
+fix: MateDateField: Better management of mat-error
+fix: MateDateTimeField: Add error for dateIsBefore
+enh: SharedValidators: add new validator 'dateIsBefore'
+
+# 1.15.1
+fix: MateDateField: Add a timezone to serialize/deserialize date value
+
+# 1.15.4
+enh: MateDateField: Add an input 'datePickerFiler' to filter dates in picker
+enh: MateDateTimeField: Add an input 'datePickerFiler' to filter dates in picker
+
+# 1.15.9
+fix: Editor listenChanges() should not update the cache, but call reload() when changes detected.
+      This will allow fetching partial graph in subscriptions
+enh: Editor: show a toast when remote changes are detected
+fix: Cache: minor fix
+
+# 1.15.13
+fix: File upload component: fix file/event management
+enh: Add new pipe 'formGetGroup:<name>'
+
+# 1.16.0
+enh: Refactor JobUtils functions: 'progression' is now optional, and hold by options
+
+# 1.17.0
+fix: GraphQL: set NetworkStatus.error on error object in order to throw corresponding exception
+
+# 1.17.1
+fix: Hotkeys: Prevent global hotkeys when popover component exists
+
+# 1.18.0
+enh: Autocomplete field: Add search bar on mobile
+fix: Autocomplete field: Fix style when multiple=true
+fix: Autocomplete field: Fix default displayWith when multiple=true (manage array value)
+fix: Exclude Windows from the platform mobile detection 
+
+# 1.18.4
+fix: Autocomplete: fix search in mobile searchbar
+enh: Material field components: allow to set 'required' as empty tag, and not only '[required]=true'
+
+# 1.18.4
+fix: Autocomplete: fix panel width, on small screens
+
+# 1.18.7
+fix: fix DateUtils.min() and DateUtils.max() 
+
+# 1.19.0
+enh: Add a MessageModal, to compose message to users (internal or email messages)
+fix: MatDateField: if not required, manually set a date will not apply the value to formControl
+
+# 1.19.1
+fix: Platform detection failed (infinite loop) on MacBook
+
+# 1.19.2
+fix: Platform detection cache
+
+# 1.19.3
+enh: AppForm now wait form not pending, before emitting onSubmit event
+
+# 1.19.6
+fix: Fix toolbar back button
+fix: Autocomplete: Fix multiple values (displayValue was no shown)
+fix: Autocomplete: avoid to many call to suggest, on mobile
+fix: Autocomplete: use mat-option for searchbar, to have selected option is visible
+fix: Install APK: make sure to have '.apk' at end of filename
+fix: Auth modal: keep modal into loading, when waiting server response
+enh: Create a specific card for offline mode update 
+fix: Entity storage: do NOT set skipIfPristine to false, when storage keep non local entities (e.g. OperationVO)
+enh: Entity storage: persist() has a new option skipIfPristine, to be able to force all data to be stored, even if not dirty
+
+# 1.19.7
+enh: Add pipe 'formGetValue' that will listen value changes (from a form or a control)
+
+# 1.19.16
+fix: Date and Date Short field: optimize <mat-error> with a switch/case
+fix: Lat/Long pipes: remove provider in root (not need on a pipe)
+fix: SharedValidators: rename 'double' validator into 'decimal'. Now return an error 'decimal' when opts.maxDecimals is nil  
+
+# 1.19.18
+fix: Add a workaround to patch <html> class to 'plt-desktop', on Windows touch screen (fix sumaris-app issue #346)
+enh: EntitiesStorage: detect platform pause, to force saving the storage
+
+# 1.19.23
+fix: Menu: avoid to many call of onLogin() function (add a distinctUntilChanged() filter)
+fix: MateDateTime: set required validator using template, and no more by overriding formControl.validator (allow to change the required value)
+fix: EntityEditor: wait end of saving, in waitIdle() function
+fix: EntityEditor: add debug log when changing/updating route
+fix: EntityEditor.load(): rename the unused options 'updateTabAndRoute' into 'updateRoute'
+fix: EntityEditor.load(): allow to reset to the first tab (e.g. when load another entity into an existing editor)
+
+# 1.19.23
+fix: Editor: allow to skip page history (computePageHistory can return 'undefined')
+
+# 1.19.25
+fix: Home: translate 'Loading...' message
+
+# 1.19.28
+enh: Add function escapeRegExp() to escape all special regexp characters
+
+# 1.19.30
+enh: Add argument to pipe 'formGetValue' to listen status change (e.g. to force update, when emitEvent: false) 
+
+# 1.20.0
+
+enh: Menu: allow to enable/disable menu
+enh: Menu: rename MenuService.menuVisible$ into MenuService.splitPaneWhen
+
+# 1.20.2
+
+enh: Material fields: add @Input() appearance 
+
+# 1.20.3
+enh: css-variables-to-root-mobile() will expose variables '--mat-tab-link-height' and '--mat-tab-bar-height' 
+
+# 1.20.4
+enh: Add helper class CsvUtils
+enh: Add pipe formatProperty
+enh: Add directive [appAutoTitle] for <ion-label> or <mat-label>
+
+# 1.20.5
+enh: formatProperty pipe: when type is 'boolean', display a translated Yes/No  
+
+# 1.20.7
+enh: add function FileUtils.writeTextToFile()
+
+# 1.20.11
+enh: add function FileUtils.downloadUri()
+
+# 1.20.13
+fix: fix SharedValidators.decimal() when maxDecimals = 3 (cached regexp was wrong)
+
+# 1.20.14
+fix: Menu: Force menu update when config changed
+
+# 1.20.16
+fix: MatChipsField: fix chip height
+
+# 1.20.17
+fix: Add module ResizableModule, for MatTable column resize
+
+# 1.20.18
+fix: PlatformService.download() now useFileUtils.download(), that create a temp download (not need browser permission to open popup) 
+
+# 1.20.19
+enh: Add new abstract class AppEntityEditorModal, that can managed many forms and tables
+
+# 1.20.20
+fix: SCSS: remove `user-select: text !important` applied on body, because of modals ViewEncapsulation.None (e.g. physical gear modal) where Tab label were becomes focusable
+
+# 1.20.21
+fix: Fix mat latlong field: was broken since v1.19.13
+
+# 1.20.21
+fix: Fix MatDateField mat-error display (was too large)
+
+# 1.20.24
+fix: Revert change on LatLongField (SCSS file was removed ??)
+
+# 1.20.25
+fix: MatBooleanField: set indeterminate=true, when value is null
+
+# 1.20.27
+
+fix: Mat***Field: add `@Input() appearance` 
+
+# 1.20.30
+fix: Add InMemoryDataService.hiddenCount 
+
+# 1.20.33
+fix: MatAutocompleteField: reload items when cleaning text, and no suggestLengthThreshold
+
+# 1.20.34
+fix: AppTable: remove 'opts.skipIfLoading' on delete functions, to use only 'opts.interactive' to force deletion when table is busy. 
+
+# 1.21.0
+enh: AppForm: use public behavior subjects: readySubject, loadingSubject, errorSubject
+
+# 1.22.0
+enh: Add social components: UserEventNotification and JobProgression
+
+# 1.22.1
+enh: Menu: add APP_MENU_OPTIONS token, to configure menu (e.g. show notification icon in the left menu header)
+
+# 1.22.9
+enh: Remove <app-user-events-table> (move to specific sub projects that use ngx-components)
+
+# 1.22.11
+enh: Rename <app-user-event-notification-component> into <app-user-event-notification-icon>
+
+# 1.22.12
+enh: Can mark a Moment without time, allowing empty time field in MatDateTime
+
+# 1.23.6
+fix: Many fix in table. Upgrade to ngx-material-table 0.12.0
+enh: Table, Form and Editor: Add a destroySubject
+enh: Observables functions first***Promise() : add more options (timeout or stop notifier)
+
+# 1.23.10
+enh: Autocomplete: add a 'title' property on each option, on desktop screen 
+
+# 1.23.11
+fix: Memory Data service: now implement IStartableService
+enh: StartableService: use a stopSubject, to stop waitFor promise
+enh: remove unused class EntitiesService. Use IEntitiesService instead 
+
+# 1.23.26
+enh: Add new pipe 'arrayJoin'
+enh: 'arrayPluck' pipe: allow to use string[] for path
+enh: getPropertyByPath() function now allow to use string[] as path
+
+# 1.23.29
+enh: FormArrayHelper: add setValue() to resize the FormArray, then set value 
+
+# 1.23.30
+fix: InMemoryDataService: do NOT apply default sortReplacement id -> rankOrder 
+
+# 1.23.31
+fix: InMemoryDataService: change 'dirtySubject' as public property 
+
+# 1.23.39
+enh: Add FormArrayHelper.patchValue() : clear array, then push each value
+fix: StartableService: avoid to log error when stopped 
+
+# 1.23.41
+enh: AppEditor: Add 'loaded' getter 
+
+# 1.23.44
+enh: Referential model: add a 'icon' property (IconRef)  
+
+# 1.23.46
+enh: Add `ColorScale.getValueColor(): Color`  
+enh: EntityEditorModal: rename input `isNewData` into `isNew` 
+
+# 1.23.51
+Observables: function `waitFor()`, `waitForTrue()`, `watForFalse()`, `firstNotNilPromise()`
+ - fix: Make sure `takeUntil` is always the last operator (avoid memory leak) 
+ - enh: Observables: Allow set option.stopError with custom error message
+ - enh: Observables: Create the Error outside the observable, to keep the original stack trace readable  
+
+# 1.23.61
+- fix: Boolean field: fix button layout
+
+# 1.23.65
+- enh: Add pipes: isNotNil and isNotNilOrNaN
+
+# 1.23.67
+ - fix: Rename DateFormatPipe into DateFormatService (DateFormatPipe is no more a provider)
+ - fix: Fix patterns in DateFormatPipe/Service : add a fallback when translate service is not started - fix issue sar-app #28
+
+# 2.0.0
+ - enh: Migration to 
+   - Angular 14.2
+   - Ionic 6.2
+   - Angular Material Table 0.14.4 (allow to use async validator for rows)
+   - Apollo 3, graph-ws 5 
+ - enh: Add <app-debug> component
+
+# 2.1.0
+ - enh: Add new class AppFormArray with all functions of FormArrayHelper
+ 
+# 2.2.1
+ - fix: FormArrayHelper and AppFormArray: Apply the parent disabled state, in added controls, when calling resize() or patchValue()
+ - fix: FormArrayHelper.getOrCreateArray(): Apply the parent form disabled state, in added FormArray
+ - fix: MatChipsField: fix loading spinner freeze
+
+# 2.2.3
+- enh: Test Geolocation.getCurrentPosition() in the lat/long field test page
+
+# 2.2.4
+- fix: Fix DateUtils.isSame(), when first argument is nil, but the second not
+- enh: AppTable: allow to call deleteSelection with opts (e.g `{interactive: false}`)
+
+# 2.2.6
+- fix: Refresh menu on any account changes (login changes - eg. when account updated) 
+
+# 2.2.8
+- fix: Table actions column: add CSS variable to set column width, min-width and max-width
+
+# 2.3.7
+- fix: Mat form field: use inherit font size (do not force font-size, in the theme) 
+- fix: MatDateShort: fix behaviour for Angular 14
+
+# 2.4.0
+- Breaking change: ProgressBarService and HTTP_INTERCEPTORS no longer provided in SharedModule (see: AppModule)
+- enh: Make ProgressBarService fully optional (InjectionToken: APP_PROGRESS_BAR_SERVICE)
+- enh: Settings: the settings object is now stored in json format
+
+# 2.4.1
+- fix: AppFormArray: do not resize the array when patchValue() receive `undefined` value (e.g. useful when called by parent, recursively, without value)
+- fix: AppAsyncTable: optimize markAsUntouched()
+
+# 2.4.2
+- enh: Graphql service: add new token `APP_GRAPHQL_FRAGMENTS` to register fragments, and avoid redeclaration in queries (see https://github.com/apollographql/apollo-client/pull/9764#issuecomment-1329857853)
+
+# 2.4.3
+- fix: AppFormArray: do not resize the array when patchValue() receive `null` or `undefined` value (same behavior as official `FormArray.patchValue()`)
+
+# 2.4.4
+- fix: Applying environment defaultLocale, when settings data has no locale (merge some code from lpecquot, that was in a branch)
+
+# 2.4.9
+- fix: Settings: allow to store settings as string (like < 2.4.0) using an injection token
+
+# 2.4.10
+- fix: When detecting a app update, stop the check timer to avoid to many toast to be displayed
+
+# 2.4.14
+- enh: add function `setPropertyByPath()`
+- fix: Implement `EntityUtils.getPropertyByPath()` using generic shared function `getPropertyByPath()` 
+
+# 2.4.15
+- fix: Fix pipes formGetControl, formGetValue, formGetGroup : when using a path, return nil if control not found, and NOT the form itself 
+
+# 2.4.16
+- fix: `SharedModule.forRoot()`:  make environment optional, to be defined it in the `app.module.ts` (need by Quadrige App)
+
+# 2.4.17
+- fix: MatLatLongField: remove strict character regexp, in degrees part, to be able to set only one digit (e.g. `9°`)
+
+# 2.4.18
+- fix: MatDateShortField: fix control validation, in desktop mode
+
+# 2.4.19
+- fix: MatAutocompleteField: revert the cdk overlay position, when closing the mat-select panel
+
+# 2.4.23
+- enh: Add DateUtils.markTime(), to reset the 'no time' marker
+- enh: Add DateUtilsEntityEditor: simplify updateTabAndRoute()
+- enh: Add DateUtilsEntityEditor: updateRoute() now manage queryParams change, before /new to /:id transition 
+- enh: Toolbar: goBack() return a boolean
+
+# 2.4.25
+- enh: Environment: add a boolean option 'sameUrlPeer', to force network to start on peer at the same URL
+- enh: EntityEditor: allow to listen changes on local entity
+- enh: add functions collectByProperty() to split an array in a map of array
+
+# 2.4.26
+- fix: Rename pipe 'isNotOnField' by 'isOnDesk'
+
+# 2.4.28
+- enh: TranslateContext: allow to translate many keys (string[])
+- fix: Force ngx-quicklink to 0.3.0
+
+# 2.4.31
+- enh: Add JsonUtils.parseFile()
+
+# 2.4.33
+- enh: Add AppPropertiesForm.length
+
+# 2.4.48
+- fix: Fix highlight pipe (used by autocomplete field)
+
+# 2.4.50
+- enh: Add type 'enums' for AppFormField
+
+# 2.4.54
+- enh: Use NavController by default, instead of Angular router. This will use the default animation style of the OS
+
+# 2.4.55
+- fix: Editor: Disable animation, when reloading same page after saving
+
+# 2.4.58
+- enh: Add storage explorer (with log preview)
+- enh: Add debug service (to send debug data to server)
+- enh: Add logging service
+
+# 2.4.61
+- enh: Add logger on network service
+
+# 2.4.67
+fix: Minor fix (add missing i18n)
+fix: GeolocationUtils: add many useful functions, and detect Capacitor errors (from message)
+fix: Fix some issues in storage explorer
+
+# 2.4.74
+enh: LocalSettingsService: save changes in local storage, when calling setProperty()
+
+# 2.4.75
+enh: SharedValidator: add a precision validator
+
+# 2.4.79
+fix: ImageGallery: fix add button icon (center alignement)
+
+
+# 2.4.81
+fix: AppToolbar: allow to use ion-segment in app-toolbar
+
+# 2.4.82
+enh: Migrate to Ionic 7
+fix: Form field: show the clear button, when clearable=true, on types 'integer', 'double', 'string', 'date' and 'date-time'
+
+# 2.4.82
+enh: AppEntityEditor: add get/set for autoOpenNextTab
+
+# 2.4.87
+fix: AppEntityEditor: When reload the editor, force the fetch policy to 'network-only' 
+
+# 2.4.88
+fix: AppInstallUpgradeCard: Installation APK link are not visible - fix issue [sumaris-app#445](https://gitlab.ifremer.fr/sih-public/sumaris/sumaris-app/-/issues/445) 
+
+# 2.4.88
+enh: Add protected BaseEntityService.getLoadQueryNames()
+
+# 2.4.89
+fix: Fix Autocomplete searchbar value trigger, after ionic 7 update
+
+# 2.4.90
+fix: AppEntityEditor: when catch error in save(), set the selectedTabIndex=0 before calling setError()
+This will allow subclasses to override the default selectedTabIndex after an error occur, inside the overridden setError()
+
+# 2.4.91
+enh: functions: allow to use sort(array) without the 'attribute' argument (e.g. allow to sort a string[]) 
+
+# 2.4.95
+fix: Platform: avoid error at startup, because of StatusBar in web mode
+enh: MatBooleanField: display value when disabled, instead of 'empty' 
+
+# 2.4.112
+enh: AppBadge: allow to set a text or number content
+
+# 2.4.114
+enh: Menu: allow to add sub menu item
+
+# 2.4.158
+enh: Environment: add useHash property to configure Angular router to use hash URL (need by web-ext)
+
+# 2.5.0
+- enh: Add token APP_USER_SETTINGS_OPTIONS of type UserSettingsOptions to add user properties table in AccountPage
+- fix: MatBooleanField: in checkbox style, the placeholder can be shown as expected
+
+# 2.6.0
+- enh: Account: Add User tokens (table and modal)
+
+# 2.6.23
+- fix: Fix Configuration.getPropertyAsNumbers() when no value (avoid to get an array with an unique NaN value)
+
+# 2.6.25
+- enh: Upgrade to nodejs 18
+- fix: Menu: hide spacer divider ion-label (hide the skeleton)
+
+# 2.6.28
+- fix: ImageGallery: Change image's title background color
+
+# 2.6.31
+- fix: ImageGallery: Add output event when after editing title
+
+# 2.6.32
+- fix: AppFormArray: Avoid an infinite loop, when calling resize(0) if options.allowEmptyArray=false
+- fix: Table, Form, Editor: fix error when markAsLoaded() on closed BehaviorSubject
+- fix: Table, Form, Editor: Make sure waitIdle() will stop, when component is destroyed (force default opts) 
+
+# 2.6.34
+- enh: functions: add a static function `underscoreToChangeCase()` 
+
+# 2.6.35
+- fix: Settings: Add type for property `OfflineFeature.filter`, then use it to in `LocalSettingsService.getOfflineFeatures()`
+
+# 2.6.38
+- fix: Fix mapGet pipe, when key is zero (0)
+
+# 2.6.39
+- enh: table: Add an input `style: 'table'|mat-table` into `<app-actions-column>`, to be usable inside a `<table mat-table>` (using `<td>`) or `<mat-table>` (using `<mat-cell>`) 
+
+# 2.8.0
+- enh: `IAppForm<T>` : add a type `<T=any>`
+- enh: `IAppForm` : add optional functions `setValue()`, `patchValue()`, `resetValue()` and `getValue()`
+- fix: `AppForm` and `AppEditor`: Remove unused and deprecated properties `_loading`, `_$ready`, `_$loading`
+- fix: `AppForm` : rename `_enable` as `enabled` to avoid confusion with `enable()`
+- enh: Add abstract class `AppFormContainer` to manage many `IAppForm` - and use it as a super class of `AppEditor`
+- enh: Add new pipes for SelectionModel : 
+  - `isSelected`: e.g. `selection | isSelected: row`,
+  - `isEmptySelection`: e.g. `selection | isEmptySelection`
+  - `isNotEmptySelection`: e.g. `selection | isNotEmptySelection`
+  - `selectionLength`: e.g. `selection | selectionLength`,
+  - `isMultipleSelection`: e.g. `selection | isMultipleSelection`,
+- enh: Add new pipes for table :
+  - `isAllSelected`: e.g. `table | isAllSelected`,
+  - `isNotAllSelected`: e.g. `table | isNotAllSelected` 
+
+# 2.8.1
+- enh: Add a pipe `badgeNumber` to limit badge content when > `99` (will display `99+`) 
+- enh: function setPropertyByPath() now return the input obj
+- fix: Referential: fix `asObject()`
+- enh: Add options: 
+  - `sumaris.defaultLatLongFormat.enabled` to show/hide default Lat/Lon setting in account page (default is true)
+  - `sumaris.auth.api.token.scope.enabled` to show/hide scopes in API token table (default is false)
+  - `sumaris.auth.api.token.scope.default` set the default scope for new API token, mandatory if `sumaris.auth.api.token.scope.enabled` if false (default is 'read_api')
+- enh: Add AppRowField component: wrap an AppFormField into a table column
+- enh: Add pipe `valueFormat` to format a value with a FormFieldDefinition (equivalent to pipe `propertyFormat`)
+- fix: `UploadFileComponent` Refactored 
+- enh: Add new config options to override the form field background color (active, focus or disabled)
+- enh: Add new pipe `booleanFormat`
+- enh: Update pipe `propertyFormat` to use complex path (using `getPropertyByPath()`)
+- enh: Add static functions `CsvUtils.getLocalizedEncoding()` and `CsvUtils.getLocalizedSeparator()`
+- enh: Add static function `JsonUtils.getLocalizedEncoding()`
+
+# 2.8.2
+- enh: Function `getPropertyByPath` now handles the optional chaining operator `(?.)`
+- enh: Add `AccountService.onWillLogout` emitter
+- fix: Table: Call `emitRefresh()` instead of `onRefresh.emit()` to safely emit to an opened Observable 
+
+# 2.8.3
+- enh: Add support of `<mat-hint>` in MatDateTime, MatDate, MatDateShort, MatAutocompleteField and MatLatLongField
+- enh: Add `DateUtils.compare` to be able to sort dates (using Array `sort()`)
+- enh: Add function `resizeArray(T[], size): T[]`
+- fix: NamedFilter: Abort import if callback returns null or undefined
+- fix: DataSource: Allow to refresh datasource (using `watchAll()`) when having dirty row 
+
+# 2.8.4
+- enh: MatBooleanField: add `@Input() clearable` (default to `false`)
+- fix: MatBooleanField: when resetting value, hide radio buttons
+
+# 2.8.11
+- fix: MatBooleanField: hide checkbox's placeholder when floatLabel=never 
+
+# 2.8.12
+- enh: Pipe `referentialToString`: add new option `propertySeparator` to override the default ' - ' separator  
+
+# 2.8.13
+- enh: AsyncTable: make `setFilter()` async
+
+# 2.8.14
+- enh: Upgrade to ngx-material-table 17.2.1 (add options to TableElement `delete()`, `cancelOrDelete()` and `confirmEditCreate()`)
+
+# 2.9.0
+- enh: Upgrade to Angular 17.3
+- fix: Replace zone.js `setTimeout()`, by rx-angular zone-less
+- fix: IFormControlPathTranslator : Rename interface IFormControlPathTranslator into IFormPathTranslator, and rename property `controlPathTranslator` into `pathTranslator`
+- fix: Remove deprecated validator `SharedValidators.double` (was renamed into `SharedValidators.decimal`)
+- fix: AppAsyncTable: re add `@Input() get filter`
+- fix: AppTable: clear selection when opening a row (like AppAsyncTable)
+- fix: MatAutocompleteField: Add `@Input() panelClass` (same as `class`)
+- fix: MatAutocompleteField: Allow boolean inputs from string (using `@Input({transform: booleanAttribute})`) 
+- fix: MatAutocompleteField: add `panelWidth` and `panelClass` to `MatAutocompleteFieldConfig`
+
+# 2.9.1
+- fix: MatAutocompleteField: revert `applyImplicitValue` default value `true`
+- fix: MatChipsField: fix usage of `suggestLengthThreshold` 
+- enh: MatChipsField: add `applyImplicitValue` (default: false)
+
+# 2.9.2
+- fix: Notification list: add an ion-text-wrap to the notification message
+
+# 2.9.3
+- fix: Home: Add a call to `markForCheck()` after removing a page history item
+
+# 2.9.4
+- fix: Form: reduce line height of row label (form-container > ion-row > ion-col > ion-label) 
+
+# 2.9.6
+- fix: MatAutocompleteField: Remove animation in searchbar (bad icon position in iOS) 
+
+# 2.9.7
+- fix: Form: fix field label position (form-container > ion-row > ion-col > ion-label) 
+
+# 2.9.8
+- enh: Add AppFormUtils.filterErrorsByPrefix() and AppFormUtils.filterErrors()
+
+# 2.9.13
+- fix: Home: when removing a page history, force settings to update
+
+# 2.9.17
+- fix: MatSelectPanel: add `--min-width: fit-content` to class `mat-select-panel-fit-content`
+
+# 2.9.20
+- enh: NamedFilterSelector: add `filterCleared` event
+
+# 2.9.22
+- enh(deps): Minor update to Angular 17.3.12
+- enh(theme): Dark theme: Move dark theme toggle into the settings form
+- enh(theme): Dark theme: Fix toggle field style, in dark theme
+- enh(settings): Add icons on each form fields
+- fix(config): When saving the remote config, do not return to the editor config's inherited properties
+
+# 2.9.23
+- fix(boolean-field): fix click on radio button 'no', when field has no value
+
+# 2.11.1
+- enh(deps): Upgrade to apollo-angular 7.1.2 and apollo 3.11 (+ fix breaking changes in graphql.service.ts)
+- fix(css): Dark theme: fix checkbox style, and autocomplete panel
+
+# 2.11.2
+- enh(app-text-form): Add new inputs `appearance` and `subscriptSizing` 
+- fix(css): Dark theme: fix style for outline field
+
+# 2.11.3
+- fix(app-text-form): Input `autoHeight` is now deprecated (use `autoSize` instead)
+- enh(app-text-form): Add new inputs `autoSizeMinRows` and `autoSizeMaxRows`
+
+# 2.11.7
+- fix(css): Dark theme: fix style
+
+# 2.11.8
+- enh(form-error): Add options to `IFormPathTranslator.translateFormPath()` 
+
+# 2.12.0
+- enh(form-error): Remove deprecated interface `IFormControlPathTranslator` 
+
+# 2.12.4
+- fix(date): Update formControl (and datePicker) when textControl value changes, and clean text input by regexp  
+- fix(date-time): Keep control as invalid is time is empty
+- enh(date-time): Add new `@Input() allowNoTime` to make time optional
+- fix(lat-long): Fix deletion, when press delete key
+
+# 2.12.7
+- fix: addShortcut handler use `KeyboardEvent` instead of a simple 'EVent'
+
+# 2.12.8
+- enh: function `toNumber()` will now return the default value, when input is `NaN`
+
+# 2.12.9
+- fix(paginator): Fix paginator style on mobile screen (align to the left, and hide page size, like before the Angular 17 migration)
+
+# 2.12.10
+- fix(autocomplete): Compute the panel width if not set (in mobile) - workaround for an issue in mat-select panel
+
+# 2.12.12
+- fix(theme): add all dark colors from material theme
+- fix(autocomplete): in mobile device, add a text-wrap and a max-height in mat-option
+
+# 2.12.13
+- fix(config): New option `sumaris.account.latLongFormat.enable` to replace the deprecated option `sumaris.defaultLatLongFormat.enabled` (key was not well named) 
+
+# 2.12.16
+- fix(autocomplete): Reload items when `showAllOnFocus = true`
+- fix(autocomplete): Use `??` operator, instead of `toBoolean()`, `toNumber()` etc.
+- enh(autocomplete): Add option `applyImplicitValue` to config
+- enh(pipe): add a `asBoolean` pipe, with an optional predicate function as option (e.g. to test any value)
+- enh(account): Allow to change password, if auth token is `token` (will update the pubkey)
+- fix(lat-long): Refactor component (remove maskito placeholder use)
+- enh(table): Add new component `<nav-actions-column>`
+
+# 2.12.19
+- fix(nav-actions-column): Fix when inside a `AppAsyncTable`
+
+# 2.12.26
+- enh(app-async-table): declare property `readonly cd: ChangeDetectorRef`
+- enh(app-async-table): implement `markForCheck()` and `detectCHanges()`
+- enh(app-table): declare property `readonly cd: ChangeDetectorRef`
+- fix(app-table): call `detectChanges()` inside `editRow()`, `addRowToTable()` and `toggleSelectRow()` - need by SUMARiS (e.g. samples tables)
+- fix(app-table): `toggleSelectRow()` should not call `event.preventDefault()` otherwise checkbox will not be checked
+
+# 2.12.27
+- enh(app-table): implement `markForCheck()` and `detectChanges()`
+
+# 2.12.29
+- fix(new-token-modal): Add a full form and fix save issue
+
+# 2.12.30
+- enh(platform): Add copy to clipboard return state
+
+# 2.12.29
+- fix(new-token-modal): Add a full form and fix save issue
+
+# 18.0.0
+- enh(deps) Upgrade to Angular 18.2.8 and Ionic 8.3
+- enh(deps) Remove zone.js (enable experimental zone-less config)
+- enh(app-properties-form): Use an autocomplete field to select an option, instead of a simple mat-select 
+- enh(app-properties-form): Add `@Input() showHintKey: boolean` to show option key (has a hint)
+- enh(network-service): Avoid to restart the service if peer has not changed
+- enh(AppFormArray): allow to use AppFormArray on any type (and not only Entity has before)
+- enh(AppFormUtils) add useful static functions to enable/disable control(s)
+- enh(mat-autocomplete-field): add option `selectInputContentOnFocus` to option, to select the input content on focus in
+- enh(app-named-filter-selector): Add `@Input() buttonsPosition: 'matSuffix'|'after'` to let user defined button position (inside the field, or after)
+- fix(AppForm and AppFormContainer) log error using the child path (if defined using `addForm()`)
+- fix(graphql) Fix pod error in JSON format, before parsing it (e.g. Oracle can return error on multiple lines) 
+- fix(nav-actions-column): Use `OnPush` changeDetection
+- fix(app-form-field): Emit `(keyup.enter)` event, when field's type is `double`
+
+# 18.0.5
+- enh(mat-autocomplete-field): 
+  - Change type of `MatAutocompleteFieldConfig.suggestFn` to use SuggestFn<T, F> (allow to pass more options - e.g. used to resolve entity in AppPropertiesUtils)
+  - Add `@Input() label`
+  - Add `@Input() hideRequiredMarker`
+- enh(app-form-field):
+  - Add `@Input() hideRequiredMarker`
+  - Fix the style when readonly and type `enum`
+  - interface `FormFieldDefinition`: Add property `serializeAttribute?: string` (instead of using autocomplete.filer.joinAttribute)
+  - add a static function `FormFieldDefinitionUtils.prepareDefinitions()` to resolve enum values, by `InjectionToken`
+- enh(app-properties-form): 
+  - Entity/Entities are now resolved from helper class AppPropertiesUtils
+  - Allow to change add button title
+  - Resolve enum item, when using InjectionToken for values
+- enh(shared) Add decorators `@RxStateRegister()` `@RxStateSelect()` and `@RxStateProperty()` to connect property to a `RxState`
+- fix(properties-utils): Add `opts?: {keepOrphan?: boolean}` to `AppPropertiesUtils.arrayFromObject` to be able to remove property without definition (`keepOrphan` is `true` by default)
+- fix(token-table): Fix error when no scopes defined (InjectToken `APP_USER_TOKEN_SCOPES` should be optional) 
+
+# 18.0.6
+- fix(scss): set flex-wrap to nowrap
+- enh(autocomplete-test): add test case with a button
+- fix(logout) Logout should be done AFTER home redirection, because of cache clearing - see issue #5
+
+# 18.0.7
+- fix(hotkeys) Fix default platform control key ('meta' on iOS)
+
+# 18.0.8
+- fix(hotkeys) Avoid to open many help modal
+- fix(hotkeys) Skip open help modal, if nothing to display
+- fix(form-buttons-bar) Fix shortcuts for iOS
+- fix(modal-toolbar) Fix shortcut for iOS
+
+# 18.0.9
+- fix(mat-latlong-field) Mark control as dirty, when text control changed
+- fix(about) Fix missing markdown module, to display config description
+- enh(about) Allow to override the "report an issue" link, using a config option `sumaris.reportIssue.url` 
+
+# 18.0.10
+- enh(utils) Add static functions `isFirefox()`, `isSafari()` and `isEdge()` to test user agent
+- enh(utils) Add static functions `EntityUtils.collectIds()` and `EntityUtils.splitById()`
+- fix(utils) Mark function `EntityUtils.collectById()` as deprecated (in flavor of `EntityUtils.splitById()`)
+
+# 18.1.0
+- enh(deps) Upgrade to angular 18.2.11 and other deps
+- fix(deps) move maildev library into dev dependencies
+
+# 18.1.1
+- enh(deps) Update angular-eslint to 18.4.0
+
+# 18.1.2
+- enh(deps) Revert to Ionic 7.8.6
+
+# 18.1.3
+- fix(settings) Add static function `isOnFieldMode()`
+- fix(menu) Make unpinned menu works, when reload app (F5) with a pinned menu 
+
+# 18.1.4
+- fix(tab) Keep default tab label style (e.g. min-width) when stretch tabs is enabled
+- fix(tab) Reduce tab label padding, on small screen
+
+# 18.1.7
+- enh(AppFormArray) Add `clone()` function
+
+# 18.2.0
+- enh(base-entity-service) Allow opts.toEntity to be a function (e.g. to be able to transform each element, also when fetching more items)
+- fix(graphql-service) Allow `opts.update` to use new Apollo type `MutationUpdaterFunction` (type `MutationUpdaterFn` is deprecated)
+
+# 18.2.6
+- fix(autocomplete-field) Fix arrow drop icon position, when mobile
+- fix(autocomplete-field) Use desktop arrow drop icon, when multiple and desktop
+- fix(BaseEntityService) simplify functions `fromObject()` and `fromObjects()` (move `toEntity` argument into `options`)
+- enh(services) Allow `suggestFromArray()` to search using `?` as wildcard (=match one character) in the search text
+- enh(HighlightPipe) Allow to use the character `?` as wildcard (=match one character) in the search text
+- enh(functions) Allow `suggestFromStringArray()` to search using `?` as wildcard (=match one character) in the search text
+- enh(shared) New helper class `RegExpUtils`
+
+# 18.2.7
+- enh(autocomplete-field) Add `@Input() selectInputContentOnFocusDelay` - workaround when input text selection is overridden by another event (e.g. see in SUMARiS, in the calendar component)
+
+# 18.2.9
+- enh(autocomplete-field): Add `@Input() reloadItemsOnFocus` : Reload items when focused, necessary if filtered items depends on an external source (e.g. see in SUMARiS, in the calendar component)
+
+# 18.2.11
+- enh(DateUtils): Add `DateUtils.diffAbs()` to compute duration between two dates
+
+# 18.2.19
+- enh(timepicker) MatDateTime : Migrate timepicker to new library Ngx Mat TimePicker (fix animation, cancel button, Angular 17 compatibility, etc.)
+
+# 18.2.21
+- enh(functions) Rename `selectInputContent` into `selectInputContentFromEvent`, and make `selectInputContent` that only use an <input> as argument
+- enh(autocomplete-field) Add `@Input() clearInvalidValueOnBlur: boolean` to reset the field when typing invalid search text (no match or no many matches)
+- fix(swipe-field) Fix swiper previous/next arrows
+
+# 18.2.23
+- enh(validators) add option skipIfNoTime to dateRange
+
+# 18.2.24
+- enh(pipe) add new pipe `isValidDate` with option `requiredTime` (to test date with noTime flag)
+
+# 18.2.26
+- enh(select-peer-modal) Allow to search on peers modal
+- enh(select-peer-modal) Allow to select peer by features (aka programs) - should set `enableSelectPeerByFeature: true` in the environment token (disabled by default)
+
+# 18.2.28
+- fix(mat-boolean-field) Small refactoring + simplify blur detection, using standard Angular outputs
+- enh(mat-latlong-field) Refactor the component, to use separate inputs (instead of using Maskito)
+- fix(entity-store) setEntities() should mark all entities as dirty, when id mode is enabled (because an optimization in `persist()` that skip pristine entities)
+
+# 18.2.29
+- enh(validators) add opts to dateMaxDuration to skip date with NoTime
+- fix(mat-boolean-field) Fix buttons layout (padding) to be same as sumaris QV pmfm buttons
+
+# 18.2.30
+- fix(forms) Fix error `TypeError: Cannot read properties of undefined (reading 'setControlEnabled')`
+
+# 18.2.31
+- fix(mat-latlong-field) Prevent NaN on component initialization