@sumaris-net/ngx-components 1.2.8 → 1.2.14

package/README.md

@@ -3,26 +3,28 @@
 Based components, for Angular App.
 
 Features :
-- Material design
-- Ionic framework
+- Angular 11+: 
+  - v1.x for Angular 11
+  - v2.0.x for Angular 14
+- Angular Material design
+- Ionic framework v5
 - i18n
 - New form field components:
   * Authentication forms
   * Extensible menu
-  * UI components :
+  * UI components (mobile or desktop) :
     * Autocomplete field, with search and highlight
     * Latitude and longitude field, with 3 entry format
     * Date + time
 
 ## Contribute
 
-See the [developer guide](./doc/build.md)
-
+See the [developer guide](https://github.com/sumaris-net/ngx-sumaris-components/blob/master/doc/build.md)
 
 ## Change log
 
-See the [change log](./doc/changelog.md)
+See the [change log](https://github.com/sumaris-net/ngx-sumaris-components/blob/master/doc/changelog.md)
 
 ## License
 
-Free software, distributed under a [AGPL v3 license](./LICENSE).
+Free software, distributed under a [AGPL v3 license](https://github.com/sumaris-net/ngx-sumaris-components/blob/master/LICENSE).

package/doc/build.md

@@ -8,9 +8,9 @@ This article will explain how to install your environment, then build the librar
 
 1. Install [NVM](https://github.com/nvm-sh/nvm)
 
-2. Install Node (v12) ex: 12.19.1
+2. Install Node (v14) ex: 14.20.0
 ```bash
-nvm install 12.19.1
+nvm install 14.20.0
 ```
 
 3. Install global dependency: 

package/doc/changelog.md

@@ -150,3 +150,405 @@
 ## 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()` with  shared function `getPropertyByPath()`